ODBC 2.x 드라이버로 마이그레이션
대부분의 Athena ODBC 2.x 연결 파라미터는 ODBC 1.x 드라이버와 역호환되므로 대부분의 기존 연결 문자열을 Athena ODBC 2.x 드라이버에서 재사용할 수 있습니다. 하지만 다음 연결 파라미터는 수정이 필요합니다.
로그 수준
현재 ODBC 드라이버는 LOG_OFF (0)~LOG_TRACE (6)까지 다양한 사용 가능한 로깅 옵션을 제공하지만 Amazon Athena ODBC 2.x 드라이버에는 처음에 0(비활성화됨) 및 1(활성화됨)의 두 가지 값만 있습니다. 이제 버전 2.0.6.0부터 드라이버는 향상된 로깅 기능을 통해 보다 세분화된 로깅 수준을 지원합니다.
OFF- 로깅이 비활성화됨ERROR- 오류 메시지만 로깅됨WARN- 경고 메시지 및 오류가 로깅됨INFO– 정보 메시지, 경고 및 오류가 로깅됨DEBUG- 세부 디버그 정보와 모든 하위 수준 메시지가 로깅됨TRACE- 가장 세부적인 로깅 수준(모든 메시지 포함)
ODBC 2.x 드라이버 로깅에 대한 자세한 내용은 로깅 옵션 섹션을 참조하세요.
| ODBC 1.x 드라이버 | ODBC 2.x 드라이버 | |
|---|---|---|
| 연결 문자열 이름 | LogLevel |
LogLevel |
| 파라미터 유형 | 선택 사항 | 선택 사항 |
| 기본값 | 0 |
OFF |
| 가능한 값 | 0-6 |
2.0.6.0 이전 버전의 경우: 버전 2.0.6.0 이상의 경우: |
| 연결 문자열 예제 | LogLevel=6; |
LogLevel=INFO; |
참고
버전 2.0.6.0 이상에서는 운영 지연과 과도한 로그 파일 생성을 줄이면서 이러한 세분화된 로그 수준을 통해 자세한 진단 정보를 제공하도록 로깅 프레임워크가 최적화되었습니다. 각 수준에는 아래 수준의 모든 메시지가 포함됩니다.
MetadataRetrievalMethod
현재 ODBC 드라이버는 Athena에서 메타데이터를 검색하는 몇 가지 옵션을 제공합니다. Amazon Athena ODBC 드라이버는 MetadataRetrievalMethod를 더 이상 사용하지 않으며 항상 Amazon Athena API를 사용하여 메타데이터를 추출합니다.
Athena는 외부 카탈로그 쿼리를 위해 QueryExternalCatalogs 플래그를 도입했습니다. 현재 ODBC 드라이버로 외부 카탈로그를 쿼리하려면 MetadataRetrievalMethod를 ProxyAPI로 설정합니다. Athena ODBC 드라이버로 외부 카탈로그를 쿼리하려면 QueryExternalCatalogs를 1로 설정합니다.
| 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 버킷에 쿼리 결과가 생성되지 않습니다.
