JDBC 2.x 드라이버(AWS SDK 포함)JDBC 2.x 드라이버(AWS SDK 미포함)JDBC 2.x 드라이버 릴리스 정보, 라이선스 계약, 고지 사항 JDBC 2.x 드라이버 설명서

Athena JDBC 2.x 드라이버

JDBC 연결을 사용하여 Athena를 비즈니스 인텔리전스 도구 및 SQL 워크벤치와 같은 다른 애플리케이션에 연결할 수 있습니다. 이를 위해 이 페이지의 Amazon S3 링크를 사용해 Athena JDBC 2.x 드라이버를 다운로드, 설치 및 구성합니다. JDBC 연결 URL 구축에 대한 자세한 내용은 다운로드 가능한 JDBC 드라이버 설치 및 구성 가이드를 참조하세요. 권한에 대한 자세한 내용은 JDBC 및 ODBC 연결을 통한 액세스 제어 단원을 참조하세요. JDBC 드라이버에 관한 피드백을 제출하려면 athena-feedback@amazon.com으로 이메일을 보내주세요. 버전 2.0.24부터는 두 가지 버전(AWS SDK가 포함된 버전과 그렇지 않은 버전)의 드라이버를 사용할 수 있습니다.

중요

JDBC 드라이버를 사용할 때는 다음 요구 사항에 유의하십시오.

포트 444 개방 – Athena가 쿼리 결과를 스트리밍하는 데 사용하는 포트 444를 유지하고 아웃바운드 트래픽에 개방합니다. PrivateLink 엔드포인트를 사용하여 Athena에 연결하는 경우, PrivateLink 엔드포인트에 연결된 보안 그룹이 포트 444의 인바운드 트래픽에 개방되어 있는지 확인합니다. 포트 444가 차단되면 다음과 같은 오류 메시지가 표시될 수 있습니다. [Simba][AthenaJDBC](100123) 오류가 발생했습니다. 열 초기화 중 예외가 발생했습니다.
athena:GetQueryResultsStream 정책 – JDBC 드라이버를 사용하는 IAM 보안 주체에 대한 athena:GetQueryResultsStream 정책 작업을 추가합니다. 이 정책 작업은 API를 통해 직접 노출되지 않습니다. 이 정책 작업은 스트리밍 결과 지원의 일부로 ODBC 및 JDBC 드라이버에만 사용됩니다. 정책 예제는 AWS 관리형 정책: AWSQuicksightAthenaAccess을 참조하세요.
여러 데이터 카탈로그에 JDBC 드라이버 사용 - Athena와 함께 여러 데이터 카탈로그에 JDBC 드라이버를 사용하려면(예를 들어 외부 Hive 메타스토어 또는 연합 쿼리 사용 시) JDBC 연결 문자열에 MetadataRetrievalMethod=ProxyAPI를 포함시킵니다.
4.1 드라이버 - 2023년부터 JDBC 버전 4.1에 대한 드라이버 지원이 중단됩니다. 추가 업데이트는 릴리스되지 않습니다. JDBC 4.1 드라이버를 사용 중인 경우 4.2 드라이버로 마이그레이션하는 것이 좋습니다.