Windows - Amazon Athena

Windows

Windows 클라이언트 컴퓨터를 사용하여 Amazon Athena에 액세스하려면 Amazon Athena ODBC 드라이버가 필요합니다.

Windows 시스템 요구 사항

웹 브라우저를 사용하지 않고 Amazon Athena 데이터베이스에 직접 액세스하는 클라이언트 컴퓨터에 Amazon Athena ODBC 드라이버를 설치합니다.

사용하는 Windows 시스템에서 다음 요구 사항을 충족해야 합니다.

Amazon Athena ODBC 드라이버 설치

Windows용 Amazon Athena ODBC 드라이버를 다운로드하고 설치하려면
  1. AmazonAthenaODBC-2.x.x.x.msi 설치 파일을 다운로드합니다.

  2. 설치 파일을 실행하고 다음을 선택합니다.

  3. 라이선스 계약 조건에 동의하려면 확인란을 선택하고 다음을 선택합니다.

  4. 설치 위치를 변경하려면 찾아보기를 선택하고 원하는 폴더로 이동한 후 확인을 선택합니다.

  5. 설치 위치를 수락하려면 다음을 선택합니다.

  6. 설치를 선택합니다.

  7. 설치가 완료되면 완료를 선택합니다.

드라이버 구성 옵션을 설정하는 방법

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 항목을 만들려면
  1. Windows 시작 메뉴에서 ODBC 데이터 원본(64비트)을 마우스 오른쪽 버튼을 클릭하고 더 보기, 관리자 권한으로 실행을 선택합니다.

  2. ODBC 데이터 원본 관리자에서 드라이버 탭을 선택합니다.

  3. 이름 열에 Amazon Athena ODBC(x64)가 있는지 확인합니다.

  4. 다음 중 하나를 수행합니다.

    • 컴퓨터의 모든 사용자를 위한 드라이버를 구성하려면 시스템 DSN 탭을 선택합니다. 다른 계정을 사용하여 데이터를 로드하는 애플리케이션은 다른 계정의 사용자 DSN을 감지하지 못할 수 있으므로 시스템 DSN 구성 옵션을 사용하는 것이 좋습니다.

      참고

      시스템 DSN 옵션을 사용하려면 관리자 권한이 필요합니다.

    • 사용자 계정용으로만 드라이버를 구성하려면 사용자 DSN 탭을 선택합니다.

  5. 추가를 선택합니다. 새 데이터 원본 만들기 대화 상자가 열립니다.

  6. Amazon Athena ODBC(x64)를 선택하고 마침을 선택합니다.

  7. Amazon Athena ODBC 구성 대화 상자에 다음 정보를 입력합니다. 이러한 옵션에 대한 자세한 내용은 기본 ODBC 2.x 연결 파라미터 섹션을 참조하세요.

    • 데이터 소스 이름에는 데이터 소스를 식별하는 데 사용할 이름을 입력합니다.

    • 설명에는 데이터 소스를 식별하는 데 도움이 되는 설명을 입력합니다.

    • 리전에는 Athena를 사용할 AWS 리전의 이름을 입력합니다(예: us-west-1).

    • 카탈로그에는 Amazon Athena 카탈로그의 이름을 입력합니다. 기본값은 AWS Glue에서 사용하는 AwsDataCatalog입니다.

    • 데이터베이스에는 Amazon Athena 데이터베이스 이름을 입력합니다. 기본값은 기본값입니다.

    • 작업 그룹의 경우 Amazon Athena 작업 그룹의 이름을 입력합니다. 기본값은 프라이머리입니다.

    • S3 출력 위치의 경우 쿼리 결과가 저장될 Amazon S3의 위치를 입력합니다(예: s3://amzn-s3-demo-bucket/).

    • (선택 사항) 암호화 옵션에서 암호화 옵션을 선택합니다. 기본값은 NOT_SET입니다.

    • (선택 사항) KMS 키에서 필요하면 암호화 KMS 키를 선택합니다.

  8. IAM 인증을 위한 구성 옵션을 지정하려면 인증 옵션을 선택합니다.

  9. 다음 정보를 입력합니다.

    • 인증 유형에서 IAM 보안 인증을 선택합니다. 이 값이 기본값입니다. 사용할 수 있는 인증 유형에 대한 자세한 내용은 인증 옵션 섹션을 참조하세요.

    • 사용자 이름에는 사용자 이름을 입력합니다.

    • 암호에는 암호를 입력합니다.

    • 임시 AWS 보안 인증을 사용하려는 경우 세션 토큰에 세션 토큰을 입력합니다. 임시 보안 인증에 대한 자세한 내용은 IAM 사용 설명서AWS 리소스에서 임시 자격 증명 사용을 참조하세요.

  10. 확인을 선택합니다.

  11. Amazon Athena ODBC 구성 대화 상자 하단에서 테스트를 선택합니다. 클라이언트 컴퓨터가 Amazon Athena에 연결되면 연결 테스트 상자에 연결 성공이 보고됩니다. 그렇지 않으면 상자에 해당 오류 정보와 함께 연결 실패가 보고됩니다.

  12. 확인을 선택하여 연결 테스트를 닫습니다. 이제 생성한 데이터 소스가 데이터 소스 이름 목록에 표시됩니다.

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://amzn-s3-demo-bucket/;AuthenticationType=IAM Credentials;UID=YOUR_UID;PWD=YOUR_PWD;