Windows
Windows 클라이언트 컴퓨터를 사용하여 Amazon Athena에 액세스하려면 Amazon Athena ODBC 드라이버가 필요합니다.
Windows 시스템 요구 사항
웹 브라우저를 사용하지 않고 Amazon Athena 데이터베이스에 직접 액세스하는 클라이언트 컴퓨터에 Amazon Athena ODBC 드라이버를 설치합니다.
사용하는 Windows 시스템에서 다음 요구 사항을 충족해야 합니다.
-
관리자 권한 보유
-
다음 운영 체제 중 하나:
-
Windows 11, 10 또는 8.1
-
Windows Server 2019, 2016 또는 2012
-
-
사용 가능한 디스크 공간 100MB 이상
-
64비트 Windows용 Microsoft Visual C++ for Visual Studio 재배포 가능 패키지
가 설치됨
Amazon Athena ODBC 드라이버 설치
Windows용 Amazon Athena ODBC 드라이버를 다운로드하고 설치하려면
-
AmazonAthenaODBC-2.설치 파일을 다운로드합니다.x.x.x.msi -
설치 파일을 실행하고 다음을 선택합니다.
-
라이선스 계약 조건에 동의하려면 확인란을 선택하고 다음을 선택합니다.
-
설치 위치를 변경하려면 찾아보기를 선택하고 원하는 폴더로 이동한 후 확인을 선택합니다.
-
설치 위치를 수락하려면 다음을 선택합니다.
-
설치를 선택합니다.
-
설치가 완료되면 완료를 선택합니다.
드라이버 구성 옵션을 설정하는 방법
Windows에서 Amazon Athena ODBC 드라이버의 동작을 제어하기 위해 다음과 같은 방법으로 드라이버 구성 옵션을 설정할 수 있습니다.
-
ODBC 데이터 원본 관리자 프로그램에서 데이터 소스 이름(DSN)을 구성하는 경우.
-
다음 위치에서 Windows 레지스트리 키를 추가하거나 변경합니다.
HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\YOUR_DSN_NAME -
프로그래밍 방식으로 연결할 때 연결 문자열에서 드라이버 옵션을 설정합니다.
Windows에서 데이터 소스 이름 구성
ODBC 드라이버를 다운로드하여 설치한 후에는 데이터 소스 이름(DSN) 항목을 클라이언트 컴퓨터 또는 Amazon EC2 인스턴스에 추가해야 합니다. SQL 클라이언트 도구는 이 데이터 소스를 사용하여 Amazon Athena 데이터베이스에 연결하고 쿼리합니다.
시스템 DSN 항목을 만들려면
-
Windows 시작 메뉴에서 ODBC 데이터 원본(64비트)을 마우스 오른쪽 버튼을 클릭하고 더 보기, 관리자 권한으로 실행을 선택합니다.
-
ODBC 데이터 원본 관리자에서 드라이버 탭을 선택합니다.
-
이름 열에 Amazon Athena ODBC(x64)가 있는지 확인합니다.
-
다음 중 하나를 수행하십시오.
-
컴퓨터의 모든 사용자를 위한 드라이버를 구성하려면 시스템 DSN 탭을 선택합니다. 다른 계정을 사용하여 데이터를 로드하는 애플리케이션은 다른 계정의 사용자 DSN을 감지하지 못할 수 있으므로 시스템 DSN 구성 옵션을 사용하는 것이 좋습니다.
참고
시스템 DSN 옵션을 사용하려면 관리자 권한이 필요합니다.
-
사용자 계정용으로만 드라이버를 구성하려면 사용자 DSN 탭을 선택합니다.
-
-
추가를 선택합니다. 새 데이터 원본 만들기 대화 상자가 열립니다.
-
Amazon Athena ODBC(x64)를 선택하고 마침을 선택합니다.
-
Amazon Athena ODBC 구성 대화 상자에 다음 정보를 입력합니다. 이러한 옵션에 대한 자세한 내용은 기본 ODBC 2.x 연결 파라미터 섹션을 참조하세요.
-
데이터 소스 이름에는 데이터 소스를 식별하는 데 사용할 이름을 입력합니다.
-
설명에는 데이터 소스를 식별하는 데 도움이 되는 설명을 입력합니다.
-
리전에는 Athena를 사용할 AWS 리전의 이름을 입력합니다(예:
us-west-1). -
카탈로그에는 Amazon Athena 카탈로그의 이름을 입력합니다. 기본값은 AWS Glue에서 사용하는 AwsDataCatalog입니다.
-
데이터베이스에는 Amazon Athena 데이터베이스 이름을 입력합니다. 기본값은 기본값입니다.
-
작업 그룹의 경우 Amazon Athena 작업 그룹의 이름을 입력합니다. 기본값은 프라이머리입니다.
-
S3 출력 위치의 경우 쿼리 결과가 저장될 Amazon S3의 위치를 입력합니다(예:
s3://DOC-EXAMPLE-BUCKET/). -
(선택 사항) 암호화 옵션에서 암호화 옵션을 선택합니다. 기본값은
NOT_SET입니다. -
(선택 사항) KMS 키에서 필요하면 암호화 KMS 키를 선택합니다.
-
-
IAM 인증을 위한 구성 옵션을 지정하려면 인증 옵션을 선택합니다.
-
다음 정보를 입력합니다.
-
인증 유형에서 IAM 보안 인증을 선택합니다. 이 값이 기본값입니다. 사용할 수 있는 인증 유형에 대한 자세한 내용은 인증 옵션 섹션을 참조하세요.
-
사용자 이름에는 사용자 이름을 입력합니다.
-
암호에는 암호를 입력합니다.
-
임시 AWS 보안 인증을 사용하려는 경우 세션 토큰에 세션 토큰을 입력합니다. 임시 보안 인증에 대한 자세한 내용은 IAM 사용 설명서의 AWS 리소스에서 임시 자격 증명 사용을 참조하세요.
-
-
확인을 선택합니다.
-
Amazon Athena ODBC 구성 대화 상자 하단에서 테스트를 선택합니다. 클라이언트 컴퓨터가 Amazon Athena에 연결되면 연결 테스트 상자에 연결 성공이 보고됩니다. 그렇지 않으면 상자에 해당 오류 정보와 함께 연결 실패가 보고됩니다.
-
확인을 선택하여 연결 테스트를 닫습니다. 이제 생성한 데이터 소스가 데이터 소스 이름 목록에 표시됩니다.
Windows에서 DSN이 없는 연결 사용
DSN이 없는 연결을 사용하면 데이터 소스 이름(DSN) 없이 데이터베이스에 연결할 수 있습니다. 다음 예제에서는 Amazon Athena에 연결하는 Amazon Athena ODBC(x64) ODBC 드라이버의 연결 문자열을 보여줍니다.
DRIVER={Amazon Athena ODBC (x64)};Catalog=AwsDataCatalog;AwsRegion=us-west-1;Schema=test_schema;S3OutputLocation= s3://DOC-EXAMPLE-BUCKET/;AuthenticationType=IAM Credentials;UID=YOUR_UID;PWD=YOUR_PWD;
