JDBC 드라이버와 함께 Athena 사용 - Amazon Athena

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

JDBC 드라이버와 함께 Athena 사용

JDBC 연결을 사용하여 AthenaSQL Workbench와 같은 비즈니스 인텔리전스 도구 및 기타 애플리케이션에 를 연결할 수 있습니다. 이를 위해 Amazon S3의 다음 링크를 사용해 Athena JDBC 드라이버를 다운로드, 설치하고 구성합니다.

JDBC 드라이버 다운로드 링크

JDBC 드라이버 버전 2.0.16는 JDBC API 4.1 및 4.2 데이터 표준을 준수합니다. 드라이버를 다운로드하려면 현재 사용하는 JRE(Java Runtime Environment) 버전을 먼저 확인하십시오. JRE 버전은 드라이버에 사용하는 JDBC API 버전에 따라 다릅니다. 잘 모르겠으면 드라이버의 최신 버전을 다운로드하십시오.

현재 JDK 버전 및 JDBC 데이터 표준에 맞는 드라이버를 다운로드하십시오.

JDBC 드라이버 출시 노트, 라이선스 계약, 고지 사항

필요한 버전을 다운로드한 후, 출시 정보를 읽고 라이선스 계약 및 고지 사항을 확인하십시오.

JDBC 드라이버 설명서

드라이버용 다음 설명서를 다운로드합니다.

중요

에서 여러 데이터 카탈로그에 JDBC 드라이버를 사용하려면(예: Athena외부 Hive 메타스토어 또는 연동 쿼리를 사용하는 경우) JDBC 연결 문자열에 를 포함시킵니다.MetadataRetrievalMethod=ProxyAPI

이전 버전의 JDBC 드라이버에서 마이그레이션

최신 JDBC 드라이버 버전 2.0.16는 이전 버전의 JDBC 드라이버 버전 2.0.9를 바로 대체할 수 있으며, 이전 버전인 JDBC 드라이버 버전 2.0.9와 호환됩니다. 드라이버를 실행하려면 다음 단계를 수행해야 합니다.

중요

JDBC 드라이버 버전 2.0.5 이상을 사용하려면 athena:GetQueryResultsStream 정책 작업을 허용하는 JDBC 드라이버를 사용하여 권한 정책을 IAM 보안 주체에 연결합니다. 이 정책 작업은 API를 통해 직접 노출되지 않습니다. 이 정책 작업은 스트리밍 결과 지원의 일부로 JDBC 드라이버에만 사용됩니다. 정책 예제는 AWSQuicksightAthenaAccess 관리형 정책을 참조하십시오.

또한 Athena가 쿼리 결과를 스트리밍하는 데 사용하는 포트 444가 아웃바운드 트래픽에 개방되어 있어야 합니다. 엔드포인트를 사용하여 PrivateLink에 연결하는 경우 Athena 엔드포인트에 연결된 보안 그룹이 포트 444의 인바운드 트래픽에 개방되어 있는지 확인합니다.PrivateLink 포트 444가 차단되면 오류 메시지가 표시될 수 있습니다.[Simba][AthenaJDBC](100123) An error has occurred. Exception during column initialization.

버전 2.0.2에서 버전 2.0.5 이상으로 업그레이드하는 방법에 대한 자세한 내용은 JDBC 드라이버 마이그레이션 가이드를 참조하십시오.

이전 버전의 JDBC 드라이버에 대한 자세한 내용은 이전 버전 JDBC 드라이버 사용 단원을 참조하십시오.

1.x 드라이버를 2.x 드라이버로 마이그레이션하는 경우 기존 구성을 새 구성으로 마이그레이션해야 합니다. 드라이버 버전 2.x로 마이그레이션하는 것이 좋습니다. 자세한 내용은 JDBC 드라이버 마이그레이션 가이드를 참조하십시오.