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

Athena와 함께 JDBC 드라이버 사용

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

JDBC 드라이버(AWS SDK 포함)

JDBC 드라이버 버전 2.0.25는 JDBC API 4.1 및 4.2 데이터 표준을 준수합니다. 사용하는 JRE(Java Runtime Environment) 버전을 확인하는 방법에 대한 자세한 내용은 Java 설명서를 참조하십시오. JRE 버전은 드라이버에 사용하는 JDBC API 버전에 따라 다릅니다.

다음 .zip 파일 다운로드는 JDBC 4.1과 4.2 모두에 대한 .jar 파일을 포함하고 AWS SDK을 포함합니다.

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

JDBC 드라이버 버전 2.0.25는 JDBC API 4.1 및 4.2 데이터 표준을 준수합니다. 사용하는 JRE(Java Runtime Environment) 버전을 확인하는 방법에 대한 자세한 내용은 Java 설명서를 참조하십시오. JRE 버전은 드라이버에 사용하는 JDBC API 버전에 따라 다릅니다.

다음 .zip 파일 다운로드는 JDBC 4.1과 4.2 모두에 대한 .jar 파일을 포함합니다. AWS SDK는 포함하지 않습니다.

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

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

JDBC 드라이버 설명서

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

중요

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

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

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

중요

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

또한 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 드라이버 마이그레이션 가이드를 참조하세요.