View a markdown version of this page

REST API 연결 - AWS Glue
AWS Glue에서 REST 연결 유형 생성

REST API 연결

AWS Glue 커넥터는 AWS 및 외부 모두에서 다양한 데이터 소스를 다룹니다. 그러나 네이티브 AWS Glue 커넥터가 지원하지 않는 독점 시스템 또는 새로운 플랫폼이 있을 수 있습니다. AWS Glue REST 커넥터는 기본적으로 지원되는 AWS Glue 커넥터와 동일한 방식으로 작동하는 REST 기반 API가 있는 모든 데이터 소스에 대해 사용자 지정 커넥터를 구성하는 메커니즘을 제공합니다. 이 기능을 사용하면 이러한 데이터 소스에 액세스하기 위해 사용자 지정 라이브러리 또는 ETL 스크립트를 빌드할 필요가 최소화됩니다.

REST API 커넥터를 활성화하기 위해 AWS Glue에 새로운 AWS 리소스 - 연결 유형이 도입되었습니다. 다음 작업을 사용하여 REST API 기반 데이터 소스에 대한 연결을 관리할 수 있습니다.

  • RegisterConnectionType - 제공된 구성을 기반으로 AWS Glue에 연결 유형을 등록합니다. 요청 구조는 RegisterConnectionType을 참조하세요.

  • DeleteConnectionType - AWS Glue에서 연결 유형 구성을 삭제합니다. DeleteConnectionType을 참조하세요.

  • DescribeConnectionType - AWS Glue에 지정된 연결 유형에 대해 지원되는 옵션에 대한 전체 세부 정보가 반환됩니다. DescribeConnectionType을 참조하세요.

  • ListConnectionTypes - 각 AWS Glue 연결 유형에 지원되는 항목에 대한 상위 수준 세부 정보가 포함된 연결 유형 목록이 반환됩니다. ListConnectionTypes를 참조하세요.

AWS Glue에서 REST 연결 유형 생성

REST 연결 유형을 생성하려면 AWS CLI, AWS SDK 또는 AWS API를 사용하여 RegisterConnectionType API를 호출합니다. 구성 세부 정보는 연결 중인 REST API를 기반으로 제공됩니다.

참고

AWS Glue 콘솔을 사용하여 REST 연결을 생성할 수 없습니다.

필수 조건

AWS Glue REST API 커넥터를 구성하기 전에 REST API의 내부 작업을 숙지해야 합니다. 데이터 소스에 대한 REST API 설명서와 요청/응답 구조를 검사하는 도구가 있는지 확인하는 데 도움이 됩니다.

REST API의 다음 속성을 식별해야 합니다.

  • REST 엔드포인트에 대한 호출에 사용되는 인증 메커니즘입니다. AWS Glue REST API 커넥터는 기본 인증, OAuth2 - ClientCredentials, OAuth2 - Authorization Code, OAuth2 - JWT 및 사용자 지정 인증을 지원합니다.

  • REST 엔드포인트 및 관련 메타데이터(예: 필드 이름 및 데이터 유형)를 통해 전송할 수 있는 엔터티(데이터 객체)

  • HTTP 요청 및 응답 구조 이 구조에는 HTTP 메서드, 엔드포인트 URL, 헤더, 쿼리 파라미터, 요청 본문 및 응답 페이로드의 형식이 포함됩니다.

  • 페이지 매김 체계입니다. AWS Glue REST API 커넥터는 cursor-based 및 offset-based 페이지 매김이라는 두 가지 페이지 매김 체계를 지원합니다.

RegisterConnectionType

제공된 구성을 기반으로 AWS Glue에 ConnectionType을 등록합니다. ConnectionType 리소스는 데이터 소스에서 요청 및 응답을 해석하는 방법에 대한 세부 정보를 저장하는 새로운 AWS Glue 리소스입니다. 현재는 REST 프로토콜만 지원됩니다. 다음과 같은 REST API 소스에 대한 세부 정보를 캡슐화합니다.

  • 연결 속성 - REST API에 연결할 BaseUrl과 AWS Glue CreateConnection 중에 입력을 받는 데 필요한 추가 요청 파라미터를 정의합니다.

  • 인증 구성 - REST API에 대한 요청이 인증되는 방법을 정의합니다. 이 구성은 연결 유형에 대한 AWS Glue 연결을 생성할 때 사용됩니다.

  • REST 구성 - REST API 소스에서 데이터를 읽기 위한 HTTP 요청 및 응답 구성을 정의합니다. 글로벌 또는 엔터티 수준에서 다음 속성을 구성해야 합니다.

    • 요청 방법 - REST HTTP 방법을 정의합니다.

    • 응답 구성 - API 응답을 해석하는 방법을 정의합니다(본문의 레코드 또는 오류 위치 포함).

    • 페이지 매김 구성 - REST API가 결과 레코드를 페이지 매김하는 데 사용하는 전략과 페이지 매김 속성을 전송/검색하는 방법을 정의합니다.

    • 검증 엔드포인트 구성 - AWS Glue 연결을 검증하기 위해 호출할 엔드포인트를 정의합니다.

    • 개체 구성 - 커넥터가 지원하는 REST 엔터티와 해당 스키마를 정의합니다.

RegisterConnectionType 요청 구문

RegisterConnectionType 참조

REST API 연결 유형이 등록되면 구성된 데이터 소스에 대한 연결을 생성하는 데 사용할 준비가 된 것입니다. 자세한 지침은 REST API에 연결을 참조하십시오.