# Athena JDBC 3.x 드라이버
<a name="jdbc-v3-driver"></a>

Athena JDBC 드라이버를 사용하여 여러 서드 파티 SQL 클라이언트 도구와 사용자 지정 애플리케이션에서 Amazon Athena에 연결할 수 있습니다.

## 시스템 사양
<a name="jdbc-v3-driver-system-requirements"></a>
+ Java 8 이상의 런타임 환경
+ 사용 가능한 디스크 공간 20MB 이상

## 고려 사항 및 제한 사항
<a name="jdbc-v3-driver-considerations-and-limitations"></a>

다음은 Athena JDBC 3.x 드라이버에 대한 몇 가지 고려 사항과 제한 사항입니다.
+ **로깅** - 3.x 드라이버는 런타임 시 여러 로깅 시스템 중 하나를 사용할 수 있게 하는 추상화 계층인 [SLF4J](https://www.slf4j.org/manual.html)를 사용합니다.
+ **암호화** – `CSE_KMS` 암호화 옵션과 함께 Amazon S3 페처를 사용하는 경우 Amazon S3 클라이언트는 Amazon S3 버킷에 저장된 결과를 해독할 수 없습니다. `CSE_KMS` 암호화가 필요한 경우 스트리밍 페처를 계속 사용할 수 있습니다. Amazon S3 페처를 사용한 `CSE_KMS` 암호화 지원이 계획되어 있습니다.

## JDBC 3.x 드라이버 다운로드
<a name="jdbc-v3-driver-download"></a>

이 섹션에는 JDBC 3.x 드라이버의 다운로드 및 라이선스 정보가 들어 있습니다.

**중요**  
JDBC 3.x 드라이버를 사용할 때는 다음 요구 사항에 유의하세요.  
**포트 444 개방** – Athena가 쿼리 결과를 스트리밍하는 데 사용하는 포트 444를 유지하고 아웃바운드 트래픽에 개방합니다. PrivateLink 엔드포인트를 사용하여 Athena에 연결하는 경우, PrivateLink 엔드포인트에 연결된 보안 그룹이 포트 444의 인바운드 트래픽에 개방되어 있는지 확인합니다.
**athena:GetQueryResultsStream 정책** – JDBC 드라이버를 사용하는 IAM 보안 주체에 대한 `athena:GetQueryResultsStream` 정책 작업을 추가합니다. 이 정책 작업은 API를 통해 직접 노출되지 않습니다. 이 정책 작업은 스트리밍 결과 지원의 일부로 ODBC 및 JDBC 드라이버에만 사용됩니다. 정책 예제는 [AWS 관리형 정책: AWSQuicksightAthenaAccess](security-iam-awsmanpol.md#awsquicksightathenaaccess-managed-policy)을 참조하세요.

Amazon Athena 3.x JDBC 드라이버를 다운로드하려면 다음 링크를 방문하세요.

### JDBC 드라이버 uber jar
<a name="jdbc-v3-driver-download-uber-jar"></a>

다음 다운로드는 드라이버와 모든 종속 항목을 동일한 `.jar` 파일에 패키징합니다. 이 다운로드는 일반적으로 서드 파티 SQL 클라이언트에 사용됩니다.

[3.7.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.7.0/athena-jdbc-3.7.0-with-dependencies.jar)

### JDBC 드라이버 lean jar
<a name="jdbc-v3-driver-download-lean-jar"></a>

다음 다운로드는 드라이버를 위한 lean `.jar`와 드라이버의 종속 항목을 위한 별도의 `.jar` 파일이 포함된 `.zip` 파일입니다. 이 다운로드는 드라이버가 사용하는 종속 항목과 충돌하는 종속 항목이 있을 수 있는 사용자 지정 애플리케이션에 주로 사용됩니다. 이 다운로드는 lean jar에 포함할 드라이버 종속 항목과 사용자 지정 애플리케이션에 이미 하나 이상의 드라이버 종속 항목이 포함되어 있는 경우 제외할 드라이버 종속 항목을 선택하려는 경우에 유용합니다.

[3.7.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.7.0/athena-jdbc-3.7.0-lean-jar-and-separate-dependencies-jars.zip)

### 라이선스
<a name="jdbc-v3-driver-license"></a>

다음 링크에는 JDBC 3.x 드라이버에 대한 라이선스 계약이 포함되어 있습니다.

[라이선스](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.7.0/LICENSE.txt)

## JDBC를 통해 신뢰할 수 있는 ID 전파
<a name="jdbc-v3-driver-trusted-identity"></a>

이제 AWS Identity and Access Management Identity Center를 통해 Single Sign-On 기능이 있는 JDBC 드라이버를 사용하여 Amazon Athena에 연결할 수 있습니다. PowerBI, Tableau 또는 DBeaver와 같은 도구에서 Athena에 액세스하면 ID와 권한이 IAM Identity Center를 통해 Athena에 자동으로 전파됩니다. 자세한 내용은 [Amazon Athena 드라이버로 신뢰할 수 있는 ID 전파 사용](using-trusted-identity-propagation.md) 섹션을 참조하세요.

**Topics**
+ [시스템 사양](#jdbc-v3-driver-system-requirements)
+ [고려 사항 및 제한 사항](#jdbc-v3-driver-considerations-and-limitations)
+ [JDBC 3.x 드라이버 다운로드](#jdbc-v3-driver-download)
+ [JDBC를 통해 신뢰할 수 있는 ID 전파](#jdbc-v3-driver-trusted-identity)
+ [JDBC 3.x 드라이버 시작하기](jdbc-v3-driver-getting-started.md)
+ [Amazon Athena JDBC 3.x 연결 파라미터](jdbc-v3-driver-connection-parameters.md)
+ [기타 JDBC 3.x 구성](jdbc-v3-driver-other-configuration.md)
+ [Amazon Athena JDBC 3.x 릴리스 정보](jdbc-v3-driver-release-notes.md)
+ [Athena JDBC 3.x 드라이버 이전 버전](jdbc-v3-driver-previous-versions.md)