ODBC 2.x 드라이버로 마이그레이션 - Amazon Athena

ODBC 2.x 드라이버로 마이그레이션

대부분의 Athena ODBC 2.x 연결 파라미터는 ODBC 1.x 드라이버와 역호환되므로 대부분의 기존 연결 문자열을 Athena ODBC 2.x 드라이버에서 재사용할 수 있습니다. 하지만 다음 연결 파라미터는 수정이 필요합니다.

로그 수준

현재 ODBC 드라이버는 LOG_OFF (0)~LOG_TRACE (6)까지 다양한 사용 가능한 로깅 옵션을 제공하지만 Amazon Athena ODBC 드라이버에는 0(비활성화됨) 및 1(활성화됨)의 두 가지 값만 있습니다.

ODBC 2.x 드라이버 로깅에 대한 자세한 내용은 로깅 옵션 섹션을 참조하세요.

ODBC 1.x 드라이버 ODBC 2.x 드라이버
연결 문자열 이름 LogLevel LogLevel
파라미터 유형 선택 사항 선택 사항
기본값 0 0
가능한 값 0-6 0,1
연결 문자열 예제 LogLevel=6; LogLevel=1;

MetadataRetrievalMethod

현재 ODBC 드라이버는 Athena에서 메타데이터를 검색하는 몇 가지 옵션을 제공합니다. Amazon Athena ODBC 드라이버는 MetadataRetrievalMethod를 더 이상 사용하지 않으며 항상 Amazon Athena API를 사용하여 메타데이터를 추출합니다.

Athena는 외부 카탈로그 쿼리를 위해 QueryExternalCatalogs 플래그를 도입했습니다. 현재 ODBC 드라이버로 외부 카탈로그를 쿼리하려면 MetadataRetrievalMethodProxyAPI로 설정합니다. Athena ODBC 드라이버로 외부 카탈로그를 쿼리하려면 QueryExternalCatalogs1로 설정합니다.

ODBC 1.x 드라이버 ODBC 2.x 드라이버
연결 문자열 이름 MetadataRetrievalMethod QueryExternalCatalogs
파라미터 유형 선택 사항 선택 사항
기본값 Auto 0
가능한 값 Auto, AWS Glue, ProxyAPI, Query 0,1
연결 문자열 예제 MetadataRetrievalMethod=ProxyAPI; QueryExternalCatalogs=1;

연결 테스트

ODBC 1.x 드라이버 연결을 테스트할 때 드라이버는 Amazon S3 버킷에서 두 개의 파일(결과 세트에 대한 파일 및 메타데이터에 대한 파일)을 생성하는 SELECT 1 쿼리를 실행합니다. 테스트 연결 요금은 Amazon Athena 요금 정책에 따라 부과됩니다.

ODBC 2.x 드라이버 연결을 테스트하는 경우 드라이버는 GetWorkGroup Athena API 작업을 직접적으로 호출합니다. 직접 호출은 보안 인증 정보를 검색하기 위해 지정한 인증 유형 및 해당 보안 인증 제공업체를 사용합니다. ODBC 2.x 드라이버를 사용하는 경우 연결 테스트에 요금이 부과되지 않으며, 테스트할 때 Amazon S3 버킷에 쿼리 결과가 생성되지 않습니다.