本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Airtable 集成
<a name="airtable-integration"></a>

使用 Airtable 操作连接器，你可以通过自然语言直接在 Amazon Quick 中访问 Airtable 平台。您无需离开 Amazon Quick 即可创建和更新记录、管理基础和表、筛选视图以及执行关系数据操作。

Amazon Quick 支持 Airtable 的多种身份验证方法。选择最适合您组织安全要求的方法。
+ **默认 OAuth 应用程序**-使用 AWS由托管的 OAuth 应用程序。无需其他凭证。用户直接使用自己的 Airtable 账户进行身份验证。
+ **自定义 OAuth 应用程序** — 使用在 Airtable 中注册的客户管理的 OAuth 应用程序。此选项可让您的组织完全控制 OAuth 配置。
+ **API 密钥** — 使用 Airtable 个人访问令牌进行身份验证。适合个人使用或测试。

有关 Amazon Quick 支持的身份验证方法的更多信息，请参阅[身份验证方法](quick-action-auth.md)。

## 开始前的准备工作
<a name="airtable-integration-prerequisites"></a>

在设置集成之前，请确保您具备以下条件。
+ 一个活跃的Airtable账户，可以访问你想要使用的基础和数据。
+ 对于**自定义 OAuth 应用程序**：访问 Airtable 网站上的 [Airtable Builder Hub](https://airtable.com/create/oauth) 以注册 OAuth 集成。
+ 对于 **API 密钥**：来自 Airtable 网站上 [Airtable Builder Hub](https://airtable.com/create/tokens) 的个人访问令牌。
+ 有关 Amazon Quick 订阅要求，请参阅[在控制台中设置集成](integration-console-setup-process.md)。

## 配置 Airtable
<a name="airtable-source-setup"></a>

如果您使用的是**默认 OAuth 应用程序**身份验证，请跳过本节并继续。[在 Amazon Quick 中设置连接器](#airtable-quicksuite-setup)

要进行自定义 OAuth 应用程序或 API 密钥身份验证，请在配置 Amazon Quick 之前在 Airtable 中完成相应的步骤。

### 注册 OAuth 集成（自定义 OAuth 应用程序）
<a name="airtable-register-oauth"></a>

在 Airtable Builder Hub 中创建 OAuth 集成，以获取 Amazon Quick 所需的客户证书。

1. 登录 Airtable 网站上的 [Airtable Builder Hub](https://airtable.com/create/oauth)，然后选择 **O** Auth 集成。

1. 选择**注册新的 OAuth 集成。**

1. 输入集成的**名称**。

1. 对于 **OAuth 重定向网址**，请输入来自 Amazon Quick 的重定向网址：`https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

1. 选择**注册集成**。

1. 注册后，通过选择 “**重新生成客户端密钥” 来生成客户端密钥**。

1. 记录以下值。在配置 Amazon Quick 时，您需要它们。
   + **客户端 ID**
   + **客户端密钥**

1. 在 “**范围**” 下，选择您的集成所需的权限。有关推荐范围的完整列表，请参阅[推荐瞄准镜](#airtable-oauth-scopes)。

### 创建个人访问令牌（API 密钥）
<a name="airtable-create-pat"></a>

在 Airtable Builder Hub 中创建个人访问令牌以进行 API 密钥身份验证。

1. 登录 Airtable 网站上的 [Airtable Builder Hub](https://airtable.com/create/tokens)，然后选择**个人访问令**牌。

1. 选择**创建令牌**。

1. 根据您的用例的需要配置令牌名称、范围和基本访问权限。

1. 复制并安全地存储生成的令牌。您在配置 Amazon Quick 时需要它。

### 推荐瞄准镜
<a name="airtable-oauth-scopes"></a>

注册 OAuth 集成或创建个人访问令牌时，请根据要使用的操作配置以下范围。


**Airtable 推荐瞄准镜**  

| Scope | 说明 | 
| --- | --- | 
| data.records:read | 读取记录中的数据。 | 
| data.records:write | 创建、编辑和删除记录。 | 
| data.recordComments:read | 阅读记录中的评论。 | 
| data.recordComments:write | 创建、编辑和删除记录评论。 | 
| schema.bases:read | 阅读基础结构，包括表名和字段类型。 | 
| schema.bases:write | 编辑基础结构，包括表名和字段类型。 | 
| user.email:read | 阅读经过身份验证的用户的电子邮件地址。 | 

## 在 Amazon Quick 中设置连接器
<a name="airtable-quicksuite-setup"></a>

### 从 “可用” 选项卡连接
<a name="airtable-quick-connect"></a>

如果要使用默认 OAuth 应用程序身份验证，则无需额外配置即可直接从 “**可用**” 选项卡进行连接。

1. 在 Amazon Quick 控制台中，选择**连接器**。

1. 在 “**可用**” 选项卡上，找到 **Airtable**，然后选择 **Connect**。

1. 完成 Airtable 登录流程并授予所请求的权限。

要改为使用自定义 OAuth 应用程序或 API 密钥配置连接器，请使用**为团队创建**选项卡，如下所述。

### 从 “为你的团队创建” 选项卡创建
<a name="airtable-full-setup"></a>

完成所有必需的 Airtable 配置后，请在 Amazon Quick 中创建连接器。

1. 在 Amazon Quick 控制台中，选择**连接器**。

1. 选择 “**为你的团队创建**” 选项卡。

1. 找到并选择 **Airtable**。
**注意**  
如果 Airtable 连接器已经存在，则会出现一个包含现有连接器的对话框。要使用现有的连接器，请选择它。要创建新的，请选择 “**否，新建**”。

1. 输入连接器的**名称**。（可选）选择 **\+ 添加描述**以添加描述。

1. 在 “**连接类型**” 中，选择 “**公共网络**”。

1. 对于 **OAuth 配置**，请选择以下身份验证方法之一并配置必填字段。

   1. 对于**默认 OAuth 应用程序：**

      无需其他凭证。选择**下一步**以继续。

   1. 对于**自定义 OAuth 应用程序**，请配置以下字段：
      + **基本网址**（可选）— Airtable API 基本网址。示例：`https://api.airtable.com`
      + **客户端 ID** — 来自你的 Airtable OAuth 集成中的客户端 ID。
      + **客户密钥** — 来自你的 Airtable OAuth 集成中的客户端密钥。
      + **令牌网址**-令牌端点。示例：`https://airtable.com/oauth2/v1/token`
      + **授权 URL**-授权端点。示例：`https://airtable.com/oauth2/v1/authorize`
      + **重定向 URL** — Pre-filled 使用 Amazon 快速回传网址。

   1. 对于 **API 密钥**，请配置以下字段：
      + **基本网址**（可选）— Airtable API 基本网址。示例：`https://api.airtable.com`
      + **API 密钥** — 您的 Airtable 个人访问令牌。
      + **电子邮件**（可选）-与您的Airtable帐户关联的电子邮件地址。

1. 选择**下一步**。

1. 如果您选择**默认 OAuth 应用程序或自定义 OAuth 应用程序****，则会打开 Airtab** le 授权窗口。查看请求的权限，选择要授予访问权限的基础和工作空间，然后选择**授予访问权限**。

1. 在 “**查看**” 页面上，查看连接器的可用操作。选择**下一步**。

1. 在 “**发布**” 页面上，选择谁可以访问连接器。您可以为组织中的所有人启用访问权限，也可以搜索特定的团队或群组。

1. 选择**发布**。

## 可用操作
<a name="airtable-integration-actions"></a>

设置连接器后，可以执行以下操作。


**Airtable 可用操作**  

| 类别 | 处理建议 | 说明 | 
| --- | --- | --- | 
| 记录 | 列出记录 | 列出带有可选筛选和排序功能的表中的记录。 | 
| 记录 | 获取记录 | 按 ID 检索特定记录。 | 
| 记录 | Batch 创建记录 | 在表中创建一条或多条新记录。 | 
| 记录 | 更新记录 | 更新现有记录上的字段。 | 
| 记录 | 批量更新记录 | 使用 PATCH 在单个操作中更新多条记录。 | 
| 记录 | Batch Put 记录 | 使用 PUT 在单个操作中更新多条记录。 | 
| 评论 | 列出评论 | 列出记录中的评论。 | 
| 评论 | 创建评论 | 向记录添加注释。 | 
| 评论 | 更新评论 | 编辑记录中的现有评论。 | 
| 架构 | 列出基地 | 列出经过身份验证的用户可以访问的所有基础。 | 
| 架构 | 获取基本架构 | 检索基础架构，包括表和字段定义。 | 
| 架构 | 创建表 | 在底座中创建新表。 | 
| 架构 | 更新表 | 更新表格属性，例如名称或描述。 | 
| 架构 | 创建字段 | 向表中添加新字段。 | 
| 架构 | 更新字段 | 更新字段属性，例如名称或类型。 | 
| 附件 | 创建附件 | 上传记录的附件。 | 
| Users | 获取用户信息 | 检索有关经过身份验证的用户的信息。 | 

**注意**  
您可以使用的操作取决于经过身份验证的用户可访问的基础和工作区。

## 管理和故障排除
<a name="airtable-integration-troubleshooting"></a>

要编辑、共享或删除您的连接器，请参阅[管理现有集成](integration-workflows.md#managing-existing-integrations)。

### 身份验证问题
<a name="airtable-troubleshooting-auth"></a>
+ **Sign-in 失败（默认 OAuth 应用程序或自定义 OAuth 应用程序）**— 验证您的 Airtable 账户是否处于活动状态，并且可以直接在 Airtable 网站上登录 a [irtable.co](https://airtable.com) m。对于自定义 OAuth 应用程序，请确认您的 Airtable OAuth 集成中的重定向网址是否与 Amazon Quick 回传网址相匹配。
+ **无效的客户端凭证（自定义 OAuth 应用程序）**-验证客户端 ID 和客户端密钥是否与 Airtable OAuth 集成中的值相匹配。如果您重新生成了客户端密钥，请在 Amazon Quick 中更新该值。
+ **API 密钥被拒绝** — 验证您的个人访问令牌是否处于活动状态且具有所需的范围。代币可以在 Airtable Builder Hub 中撤销或过期。
+ **权限不足**-验证为您的身份验证方法配置的范围是否包含您要使用的操作所需的权限。请参阅[推荐瞄准镜](#airtable-oauth-scopes)。