View a markdown version of this page

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 athena.odbc

    드라이버가 성공적으로 설치되면 출력은 다음과 유사합니다.

    com.amazon.athena.odbc.Runtime
com.amazon.athena.odbc.Documentation

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

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

  • /opt/amazon/athena-odbc/share/athena-odbc/

예제 파일을 구성 디렉터리에 복사하고 .example 확장을 제거합니다. 이 파일들을 Amazon Athena ODBC 드라이버와 데이터 소스 이름(DSN)을 구성하기 위한 시작점으로 사용합니다.

sudo mkdir -p /opt/amazon/athena-odbc/etc/athena-odbc
sudo cp /opt/amazon/athena-odbc/share/athena-odbc/odbc.ini.example /opt/amazon/athena-odbc/etc/athena-odbc/odbc.ini
sudo cp /opt/amazon/athena-odbc/share/athena-odbc/odbcinst.ini.example /opt/amazon/athena-odbc/etc/athena-odbc/odbcinst.ini
참고

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

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

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

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

    export ODBCINI=/opt/amazon/athena-odbc/etc/athena-odbc/odbc.ini

  2. 다음 예제와 같이 ODBCSYSINI를 odbcinst.ini 파일이 포함된 디렉토리의 전체 경로로 설정합니다.

    export ODBCSYSINI=/opt/amazon/athena-odbc/etc/athena-odbc

  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/amazon/athena-odbc/logs/ # Path to store the log files. Permissions to the location are required.

[athena_odbc_test]
Description=Amazon Athena ODBC (x64)
Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.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)]
Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.dylib
Setup=/opt/amazon/athena-odbc/lib/libathenaodbc.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.x.y.z (Amazon Athena ODBC Driver) 

SQL>