JDBC 드라이버로 Athena 사용 - Amazon Athena

JDBC 드라이버로 Athena 사용

JDBC 연결을 사용하여 Athena를 비즈니스 인텔리전스 도구 및 SQL 워크벤치와 같은 다른 애플리케이션에 연결할 수 있습니다. 이를 위해 이 페이지의 Amazon S3 링크를 사용해 Athena JDBC 드라이버를 다운로드, 설치 및 구성합니다. 권한에 대한 자세한 내용은 JDBC 및 ODBC 연결을 통한 액세스 섹션을 참조하세요. 버전 2.0.24부터는 두 가지 버전(AWS SDK가 포함된 버전과 그렇지 않은 버전)의 드라이버를 사용할 수 있습니다.

JDBC 드라이버(AWS SDK 포함)

JDBC 드라이버 버전 2.0.30은 JDBC API 4.2 데이터 표준을 준수합니다.

  • AthenaJDBC42.jar는 JDBC 4.2와 호환되며 JDK 8.0 이상이 필요합니다.

다음 .zip 파일 다운로드는 JDBC 4.2를 위한 .jar 파일과 AWS SDK를 포함합니다.

JDBC 드라이버(AWS SDK 미포함)

JDBC 드라이버 버전 2.0.30은 JDBC API 4.2 데이터 표준을 준수합니다.

다음 파일은 AWS SDK를 포함하지 않습니다.

  • AthenaJDBC42.jar는 JDBC 4.2와 호환되며 JDK 8.0 이상이 필요합니다.

다음 .zip 파일 다운로드는 JDBC 4.2를 위한 .jar 파일을 포함합니다. AWS SDK는 포함하지 않습니다.

JDBC 드라이버 릴리스 정보, 라이선스 계약, 고지 사항

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

JDBC 드라이버 설명서

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

중요

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

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

최신 JDBC 드라이버 버전 2.0.30은 이전 버전의 JDBC 드라이버를 드롭인 방식으로 대체하며, 이전 2.x 버전의 JDBC 드라이버와 호환됩니다. 드라이버를 실행하려면 다음 단계를 수행해야 합니다.

중요

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

또한 Athena가 쿼리 결과를 스트리밍하는 데 사용하는 포트 444가 아웃바운드 트래픽에 개방되어 있어야 합니다. PrivateLink 엔드포인트를 사용하여 Athena에 연결하는 경우, PrivateLink 엔드포인트에 연결된 보안 그룹이 포트 444의 인바운드 트래픽에 개방되어 있는지 확인합니다. 포트 444가 차단되면 다음과 같은 오류 메시지가 표시될 수 있습니다. [Simba][AthenaJDBC](100123) 오류가 발생했습니다. 열 초기화 중 예외가 발생했습니다.

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

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

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