기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 에어테이블 통합
<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)에 로그인하고 **OAuth 통합을** 선택합니다.

1. **새 OAuth 통합 등록**을 선택합니다.

1. 통합의 **이름을** 입력합니다.

1. **OAuth 리디렉션 URLs**에 Amazon Quick의 리디렉션 URL을 입력합니다. `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` 

1. **통합 등록**을 선택합니다.

1. 등록 후 클라이언트 보안 암호 **재생성을 선택하여 클라이언트 보안 암호를** 생성합니다.

1. 다음 값을 기록합니다. Amazon Quick을 구성할 때 필요합니다.
   + **클라이언트 ID**
   + **클라이언트 보안 암호(client secret)**

1. **범위에서** 통합에 필요한 권한을 선택합니다. 권장 범위의 전체 목록은 섹션을 참조하세요[권장 범위](#airtable-oauth-scopes).

### 개인 액세스 토큰 생성(API 키)
<a name="airtable-create-pat"></a>

API 키 인증을 위해 Airtable Builder Hub에서 개인 액세스 토큰을 생성합니다.

1. [Airtable 웹 사이트에서 Airtable Builder Hub](https://airtable.com/create/tokens)에 로그인하고 **개인 액세스 토큰을** 선택합니다.

1. **토큰 생성**을 선택합니다.

1. 사용 사례에 따라 토큰 이름, 범위 및 기본 액세스를 구성합니다.

1. 생성된 토큰을 복사하고 안전하게 저장합니다. Amazon Quick을 구성할 때 필요합니다.

### 권장 범위
<a name="airtable-oauth-scopes"></a>

OAuth 통합을 등록하거나 개인 액세스 토큰을 생성할 때 사용하려는 작업에 따라 다음 범위를 구성합니다.


**에어테이블 권장 범위**  

| 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**을 찾아 **연결을** 선택합니다.

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 앱**의 경우 다음 필드를 구성합니다.
      + **기본 URL**(선택 사항) - Airtable API 기본 URL입니다. 예시: `https://api.airtable.com`
      + **클라이언트 ID** - Airtable OAuth 통합의 클라이언트 ID입니다.
      + **클라이언트 보안 암호** - Airtable OAuth 통합의 클라이언트 보안 암호입니다.
      + **토큰 URL** - 토큰 엔드포인트입니다. 예시: `https://airtable.com/oauth2/v1/token`
      + **권한 부여 URL** - 권한 부여 엔드포인트입니다. 예시: `https://airtable.com/oauth2/v1/authorize`
      + **리디렉션 URL** - Amazon Quick 콜백 URL로 미리 채워집니다.

   1. **API 키**에서 다음 필드를 구성합니다.
      + **기본 URL**(선택 사항) - Airtable API 기본 URL입니다. 예시: `https://api.airtable.com`
      + **API 키** - Airtable 개인 액세스 토큰입니다.
      + **이메일**(선택 사항) - Airtable 계정과 연결된 이메일 주소입니다.

1. **다음**을 선택합니다.

1. **기본 OAuth 앱** 또는 **사용자 지정 OAuth 앱을** 선택하면 Airtable 권한 부여 창이 열립니다. 요청된 권한을 검토하고 액세스 권한을 부여할 기본 및 워크스페이스를 선택한 다음 **액세스 권한 부여**를 선택합니다.

1. **검토** 페이지에서 커넥터에 사용할 수 있는 작업을 검토합니다. **다음**을 선택합니다.

1. **게시** 페이지에서 커넥터에 액세스할 수 있는 사용자를 선택합니다. 조직의 모든 사람에 대해 액세스를 활성화하거나 특정 팀 또는 그룹을 검색할 수 있습니다.

1. **게시**를 선택합니다.

## 사용 가능한 작업
<a name="airtable-integration-actions"></a>

커넥터를 설정한 후 다음 작업을 사용할 수 있습니다.


**에어테이블 사용 가능한 작업**  

| 카테고리 | 작업 | 설명 | 
| --- | --- | --- | 
| 레코드 | 레코드 나열 | 선택적 필터링 및 정렬을 사용하여 테이블의 레코드를 나열합니다. | 
| 레코드 | 레코드 가져오기 | ID별로 특정 레코드를 검색합니다. | 
| 레코드 | 레코드 일괄 생성 | 테이블에 하나 이상의 새 레코드를 생성합니다. | 
| 레코드 | 레코드 업데이트 | 기존 레코드의 필드를 업데이트합니다. | 
| 레코드 | 배치 업데이트 레코드 | PATCH를 사용하여 단일 작업으로 여러 레코드를 업데이트합니다. | 
| 레코드 | 배치 배치 배치 레코드 | PUT을 사용하여 단일 작업으로 여러 레코드를 업서트합니다. | 
| 설명 | 설명 나열 | 레코드에 대한 설명을 나열합니다. | 
| 설명 | 설명 생성 | 레코드에 설명을 추가합니다. | 
| 설명 | 설명 업데이트 | 레코드에 대한 기존 설명을 편집합니다. | 
| 스키마 | 목록 기반 | 인증된 사용자가 액세스할 수 있는 모든 기본을 나열합니다. | 
| 스키마 | 기본 스키마 가져오기 | 테이블 및 필드 정의를 포함하여 기본의 스키마를 검색합니다. | 
| 스키마 | 테이블 생성 | 기본에 새 테이블을 생성합니다. | 
| 스키마 | 테이블 업데이트 | 이름 또는 설명과 같은 테이블 속성을 업데이트합니다. | 
| 스키마 | 필드 생성 | 테이블에 새 필드를 추가합니다. | 
| 스키마 | 필드 업데이트 | 이름 또는 유형과 같은 필드 속성을 업데이트합니다. | 
| 첨부 파일 | 첨부 파일 생성 | 레코드에 첨부 파일을 업로드합니다. | 
| Users | 사용자 정보 가져오기 | 인증된 사용자에 대한 정보를 검색합니다. | 

**참고**  
사용할 수 있는 작업은 인증된 사용자가 액세스할 수 있는 기본 및 워크스페이스에 따라 다릅니다.

## 관리 및 문제 해결
<a name="airtable-integration-troubleshooting"></a>

커넥터를 편집, 공유 또는 삭제하려면 섹션을 참조하세요[기존 통합 관리](integration-workflows.md#managing-existing-integrations).

### 인증 문제
<a name="airtable-troubleshooting-auth"></a>
+ **로그인 실패(기본 OAuth 앱 또는 사용자 지정 OAuth 앱)** - Airtable 계정이 활성 상태이고 Airtable 웹 사이트에서 [airtable.com](https://airtable.com) 직접 로그인할 수 있는지 확인합니다. 사용자 지정 OAuth 앱의 경우 Airtable OAuth 통합의 리디렉션 URL이 Amazon Quick 콜백 URL과 일치하는지 확인합니다.
+ **잘못된 클라이언트 자격 증명(사용자 지정 OAuth 앱)** - 클라이언트 ID와 클라이언트 보안 암호가 Airtable OAuth 통합의 값과 일치하는지 확인합니다. 클라이언트 보안 암호를 다시 생성한 경우 Amazon Quick에서 값을 업데이트합니다.
+ **API 키 거부**됨 - 개인 액세스 토큰이 활성 상태이고 필요한 범위가 있는지 확인합니다. 토큰은 Airtable Builder Hub에서 취소하거나 만료할 수 있습니다.
+ **권한 부족 **- 인증 방법에 대해 구성된 범위에 사용하려는 작업에 필요한 권한이 포함되어 있는지 확인합니다. [권장 범위](#airtable-oauth-scopes)을(를) 참조하세요.