macOS - Amazon Athena
macOS 시스템 요구 사항macOS에 ODBC 데이터 커넥터 설치macOS에서 데이터 소스 이름 구성

macOS

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

macOS 시스템 요구 사항

드라이버를 설치하는 각 macOS 컴퓨터마다 다음 요구 사항을 만족해야 합니다.

  • macOS 버전 14 이상을 사용합니다.

  • 100MB의 디스크 공간을 사용할 수 있습니다.

  • iODBC 버전 3.52.16 이상을 사용합니다.

macOS에 ODBC 데이터 커넥터 설치

macOS 운영 체제용 Amazon Athena ODBC 드라이버를 다운로드하여 설치하려면 다음 절차를 따르세요.

macOS용 Amazon Athena ODBC 드라이버 다운로드 및 설치

  1. .pkg 패키지 파일을 다운로드합니다.

  2. .pkg 파일을 두 번 클릭합니다.

  3. 마법사의 단계를 따라 드라이버를 설치합니다.

  4. 라이선스 계약 페이지에서 계속을 누른 다음 동의를 선택합니다.

  5. 설치를 선택합니다.

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

  7. 다음 명령을 입력하여 드라이버가 설치되었는지 확인:

    > pkgutil --pkgs | grep athenaodbc

    시스템에 따라 다음 중 하나와 같은 내용이 출력될 수 있습니다.

    com.amazon.athenaodbc-x86_64.Config
com.amazon.athenaodbc-x86_64.Driver

    또는

    com.amazon.athenaodbc-arm64.Config
com.amazon.athenaodbc-arm64.Driver

macOS에서 데이터 소스 이름 구성

드라이버가 설치된 후 다음 위치에서 예제 .odbc.ini 및 .odbcinst.ini 파일을 찾을 수 있습니다.

  • Intel 프로세서 컴퓨터: /opt/athena/odbc/x86_64/ini/

  • ARM 프로세서 컴퓨터: /opt/athena/odbc/arm64/ini/

여기에 있는 .ini 파일을 Amazon Athena ODBC 드라이버 및 DSN(데이터 소스 이름) 구성의 예제로 사용합니다.

참고

기본적으로 ODBC 드라이버 관리자는 홈 디렉터리에 있는 숨겨진 구성 파일인 .odbc.ini 및 .odbcinst.ini를 사용합니다.

iODBC 드라이버 관리자를 사용하여 .odbc.ini 및 .odbcinst.ini 파일의 경로를 지정하려면 다음 단계를 수행합니다.

iODBC 드라이버 관리자를 사용하여 ODBC .ini 파일 위치 지정

  1. ODBCINI를 odbc.ini 파일의 전체 경로 및 파일 이름으로 설정합니다.

    • Intel 프로세서가 탑재된 macOS 컴퓨터의 경우 다음 구문을 사용합니다.

      export ODBCINI=/opt/athena/odbc/x86_64/ini/odbc.ini

    • ARM 프로세서가 탑재된 macOS 컴퓨터의 경우 다음 구문을 사용합니다.

      export ODBCINI=/opt/athena/odbc/arm64/ini/odbc.ini

  2. ODBCSYSINI를 odbcinst.ini 파일의 전체 경로 및 파일 이름으로 설정합니다.

    • Intel 프로세서가 탑재된 macOS 컴퓨터의 경우 다음 구문을 사용합니다.

      export ODBCSYSINI=/opt/athena/odbc/x86_64/ini/odbcinst.ini

    • ARM 프로세서가 탑재된 macOS 컴퓨터의 경우 다음 구문을 사용합니다.

      export ODBCSYSINI=/opt/athena/odbc/arm64/ini/odbcinst.ini

  3. DSN(데이터 소스 이름)을 사용하여 데이터 스토어에 연결하려는 경우 odbc.ini 파일을 구성하여 DSN(데이터 소스 이름)을 정의합니다. 다음 예제와 같이 odbc.ini 파일의 속성을 설정하여 데이터 스토어에 대한 연결 정보를 지정하는 DSN을 생성합니다.

    [ODBC Data Sources]
athena_odbc_test=Amazon Athena ODBC (x64) 

[ATHENA_WIDE_SETTINGS] # Special DSN-name to signal driver about logging configuration.
LogLevel=0             # set to 1 to enable ODBC driver logs
UseAwsLogger=0         # set to 1 to enable AWS-SDK logs
LogPath=/opt/athena/odbc/logs/ # Path to store the log files. Permissions to the location are required. 

[athena_odbc_test]
Description=Amazon Athena ODBC (x64)
# For ARM:
Driver=/opt/athena/odbc/arm64/lib/libathena-odbc-arm64.dylib
# For Intel:
# Driver=/opt/athena/odbc/x86_64/lib/libathena-odbc-x86_64.dylib
AwsRegion=us-west-1
Workgroup=primary
Catalog=AwsDataCatalog
Schema=default
AuthenticationType=IAM Credentials
UID=
PWD=
S3OutputLocation=s3://amzn-s3-demo-bucket/

  4. 다음 예제와 같이 odbcinst.ini 파일을 구성합니다.

    [ODBC Drivers]
Amazon Athena ODBC (x64)=Installed 

[Amazon Athena ODBC (x64)]
# For ARM:
Driver=/opt/athena/odbc/arm64/lib/libathena-odbc-arm64.dylib
Setup=/opt/athena/odbc/arm64/lib/libathena-odbc-arm64.dylib
# For Intel:
# Driver=/opt/athena/odbc/x86_64/lib/libathena-odbc-x86_64.dylib
# Setup=/opt/athena/odbc/x86_64/lib/libathena-odbc-x86_64.dylib

  5. Amazon Athena ODBC 드라이버를 설치하고 구성한 후에는 다음 예제와 같이 iodbctest 명령줄 도구를 사용하여 연결을 확인합니다.

    username@ % iodbctest
iODBC Demonstration program
This program shows an interactive SQL processor
Driver Manager: 03.52.1623.0502 

Enter ODBC connect string (? shows list): ? 

DSN                              | Driver
------------------------------------------------------------------------------
athena_odbc_test                 | Amazon Athena ODBC (x64) 

Enter ODBC connect string (? shows list): DSN=athena_odbc_test;
Driver: 2.0.2.1 (Amazon Athena ODBC Driver) 

SQL>