View a markdown version of this page

에어테이블 통합 - Amazon Quick
시작하기 전 준비 사항Airtable 구성Amazon Quick에서 커넥터 설정사용 가능한 작업관리 및 문제 해결

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

에어테이블 통합

Airtable 작업 커넥터를 사용하면 자연어를 통해 Amazon Quick에서 직접 Airtable 플랫폼에 액세스할 수 있습니다. Amazon Quick을 벗어나지 않고도 레코드를 생성 및 업데이트하고, 기본 및 테이블을 관리하고, 보기를 필터링하고, 관계형 데이터 작업을 수행할 수 있습니다.

Amazon Quick은 Airtable에 대한 여러 인증 방법을 지원합니다. 조직의 보안 요구 사항에 가장 적합한 방법을 선택합니다.

  • 기본 OAuth 앱 AWS- 관리형 OAuth 애플리케이션을 사용합니다. 추가 자격 증명은 필요하지 않습니다. 사용자는 Airtable 계정으로 직접 인증합니다.

  • 사용자 지정 OAuth 앱 - Airtable에 등록된 고객 관리형 OAuth 애플리케이션을 사용합니다. 이 옵션을 사용하면 조직에서 OAuth 구성을 완전히 제어할 수 있습니다.

  • API 키 - 인증에 Airtable 개인 액세스 토큰을 사용합니다. 개별 사용 또는 테스트에 적합합니다.

Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요인증 방법.

시작하기 전 준비 사항

통합을 설정하기 전에 다음 사항이 있는지 확인합니다.

Airtable 구성

기본 OAuth 앱 인증을 사용하는 경우이 섹션을 건너뛰고 로 진행합니다Amazon Quick에서 커넥터 설정.

사용자 지정 OAuth 앱 또는 API 키 인증의 경우 Amazon Quick을 구성하기 전에 Airtable에서 해당 단계를 완료합니다.

OAuth 통합 등록(사용자 지정 OAuth 앱)

Airtable Builder Hub에서 OAuth 통합을 생성하여 Amazon Quick에 필요한 클라이언트 자격 증명을 가져옵니다.

  1. Airtable 웹 사이트에서 Airtable Builder Hub에 로그인하고 OAuth 통합을 선택합니다.

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

  3. 통합의 이름을 입력합니다.

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

  5. 통합 등록을 선택합니다.

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

  7. 다음 값을 기록합니다. Amazon Quick을 구성할 때 필요합니다.

    • 클라이언트 ID

    • 클라이언트 보안 암호(client secret)

  8. 범위에서 통합에 필요한 권한을 선택합니다. 권장 범위의 전체 목록은 섹션을 참조하세요권장 범위.

개인 액세스 토큰 생성(API 키)

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

  1. Airtable 웹 사이트에서 Airtable Builder Hub에 로그인하고 개인 액세스 토큰을 선택합니다.

  2. 토큰 생성을 선택합니다.

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

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

권장 범위

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에서 커넥터 설정

사용 가능 탭에서 연결

기본 OAuth 앱 인증을 사용하려면 추가 구성 없이 사용 가능 탭에서 직접 연결할 수 있습니다.

  1. Amazon Quick 콘솔에서 커넥터를 선택합니다.

  2. 사용 가능 탭에서 Airtable을 찾아 연결을 선택합니다.

  3. Airtable 로그인 흐름을 완료하고 요청된 권한을 부여합니다.

대신 사용자 지정 OAuth 앱 또는 API 키로 커넥터를 구성하려면 아래 설명과 같이 팀에 대해 생성 탭을 사용합니다.

팀에 대해 생성 탭에서 생성

필요한 Airtable 구성을 완료한 후 Amazon Quick에서 커넥터를 생성합니다.

  1. Amazon Quick 콘솔에서 커넥터를 선택합니다.

  2. 팀에 대해 생성 탭을 선택합니다.

  3. Airtable을 찾아 선택합니다.

    참고

    Airtable 커넥터가 이미 있는 경우 기존 커넥터와 함께 대화 상자가 나타납니다. 기존 커넥터를 사용하려면 선택합니다. 새로 생성하려면 아니요, 새로 생성을 선택합니다.

  4. 커넥터의 이름을 입력합니다. 선택적으로 + 설명 추가를 선택하여 설명을 추가합니다.

  5. 연결 유형에서 퍼블릭 네트워크를 선택합니다.

  6. OAuth 구성에서 다음 인증 방법 중 하나를 선택하고 필수 필드를 구성합니다.

    1. 기본 OAuth 앱의 경우:

      추가 자격 증명은 필요하지 않습니다. 다음을 선택하여 계속 진행합니다.

    2. 사용자 지정 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로 미리 채워집니다.

    3. API 키에서 다음 필드를 구성합니다.

      • 기본 URL(선택 사항) - Airtable API 기본 URL입니다. 예시: https://api.airtable.com

      • API 키 - Airtable 개인 액세스 토큰입니다.

      • 이메일(선택 사항) - Airtable 계정과 연결된 이메일 주소입니다.

  7. 다음을 선택합니다.

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

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

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

  11. 게시를 선택합니다.

사용 가능한 작업

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

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

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

관리 및 문제 해결

커넥터를 편집, 공유 또는 삭제하려면 섹션을 참조하세요기존 통합 관리.

인증 문제

  • 로그인 실패(기본 OAuth 앱 또는 사용자 지정 OAuth 앱) - Airtable 계정이 활성 상태이고 Airtable 웹 사이트에서 airtable.com 직접 로그인할 수 있는지 확인합니다. 사용자 지정 OAuth 앱의 경우 Airtable OAuth 통합의 리디렉션 URL이 Amazon Quick 콜백 URL과 일치하는지 확인합니다.

  • 잘못된 클라이언트 자격 증명(사용자 지정 OAuth 앱) - 클라이언트 ID와 클라이언트 보안 암호가 Airtable OAuth 통합의 값과 일치하는지 확인합니다. 클라이언트 보안 암호를 다시 생성한 경우 Amazon Quick에서 값을 업데이트합니다.

  • API 키 거부됨 - 개인 액세스 토큰이 활성 상태이고 필요한 범위가 있는지 확인합니다. 토큰은 Airtable Builder Hub에서 취소하거나 만료할 수 있습니다.

  • 권한 부족 - 인증 방법에 대해 구성된 범위에 사용하려는 작업에 필요한 권한이 포함되어 있는지 확인합니다. 권장 범위을(를) 참조하세요.