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

JDBC 드라이버로 Athena 사용

JDBC 연결을 사용하여 Athena를 비즈니스 인텔리전스 도구 및 SQL 워크벤치와 같은 다른 애플리케이션에 연결할 수 있습니다. 이를 위해 이 페이지의 Amazon S3 링크를 사용해 Athena JDBC 드라이버를 다운로드, 설치 및 구성합니다. JDBC 연결 URL 구축에 대한 자세한 내용은 다운로드 가능한 JDBC 드라이버 설치 및 구성 가이드를 참조하세요. 권한에 대한 자세한 내용은 JDBC 및 ODBC 연결을 통한 액세스 섹션을 참조하세요. 버전 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 섹션을 참조하세요.

  • 4.1 드라이버 - JDBC 버전 4.1에 대한 드라이버 지원이 중단되고 추가 업데이트는 릴리스되지 않습니다. JDBC 4.1 드라이버를 사용 중인 경우 4.2 드라이버로 마이그레이션하는 것이 좋습니다. 4.1 JDBC 버전에 대한 링크는 다음 연도부터 제거됩니다.

JDBC 드라이버(AWS SDK 포함)

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

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

  • AthenaJDBC41.jar는 JDBC 4.1과 호환되며 JDK 7.0 이상이 필요합니다.

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

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

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

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

현재 JDK 버전 및 JDBC 데이터 표준에 맞는 드라이버를 다운로드하세요. 이러한 파일에는 AWS SDK가 포함되어 있지 않습니다.

  • AthenaJDBC41.jar는 JDBC 4.1과 호환되며 JDK 7.0 이상이 필요합니다.

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

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

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

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

JDBC 드라이버 설명서

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

JDBC 드라이버 참고

여러 데이터 카탈로그에 JDBC 드라이버 사용

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