# macOS
<a name="odbc-v2-driver-getting-started-macos"></a>

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

## macOS 시스템 요구 사항
<a name="odbc-v2-driver-getting-started-macos-macos-system-requirements"></a>

드라이버를 설치하는 각 macOS 컴퓨터마다 다음 요구 사항을 만족해야 합니다.
+ macOS 버전 14 이상을 사용합니다.
+ 100MB의 디스크 공간을 사용할 수 있습니다.
+ [iODBC](https://www.iodbc.org/dataspace/doc/iodbc/wiki/iodbcWiki/WelcomeVisitors) 버전 3.52.16 이상을 사용합니다.

## macOS에 ODBC 데이터 커넥터 설치
<a name="odbc-v2-driver-getting-started-macos-installing-the-odbc-data-connector-on-macos"></a>

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

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

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

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

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

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

1. **설치**를 선택합니다.

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

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

   ```
   > pkgutil --pkgs | grep athena.odbc
   ```

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

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

## macOS에서 데이터 소스 이름 구성
<a name="odbc-v2-driver-getting-started-macos-configuring-a-data-source-name-on-macos"></a>

드라이버가 설치된 후 다음 위치에서 예제 `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
   ```

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

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

1. 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/
   ```

1. 다음 예제와 같이 `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
   ```

1. 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>
   ```