Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Jika Anda ingin menggunakan komputer klien macOS untuk mengakses Amazon Athena, driver ODBC Amazon Athena diperlukan.

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

Setiap komputer macOS tempat Anda menginstal driver harus memenuhi persyaratan berikut.
+ Gunakan macOS versi 14 atau yang lebih baru.
+ Memiliki 100 MB ruang disk yang tersedia.
+ [Gunakan versi 3.52.16 atau yang lebih baru dari iodBC.](https://www.iodbc.org/dataspace/doc/iodbc/wiki/iodbcWiki/WelcomeVisitors)

## Menginstal konektor data ODBC di macOS
<a name="odbc-v2-driver-getting-started-macos-installing-the-odbc-data-connector-on-macos"></a>

Gunakan prosedur berikut untuk mengunduh dan menginstal driver Amazon Athena ODBC untuk sistem operasi macOS.

**Untuk mengunduh dan menginstal driver Amazon Athena ODBC untuk macOS**

1. Unduh file `.pkg` paket.

1. Klik dua kali `.pkg` file tersebut.

1. Ikuti langkah-langkah di wizard untuk menginstal driver.

1. Pada halaman **Perjanjian Lisensi**, tekan **Lanjutkan**, lalu pilih **Setuju**.

1. Pilih **Instal**.

1. Ketika instalasi selesai, pilih **Selesai**.

1. Masukkan perintah berikut untuk memverifikasi bahwa driver diinstal:

   ```
   > pkgutil --pkgs | grep athenaodbc
   ```

   Tergantung pada sistem Anda, output dapat terlihat seperti salah satu dari berikut ini.

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

   atau

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

## Mengonfigurasi nama sumber data di macOS
<a name="odbc-v2-driver-getting-started-macos-configuring-a-data-source-name-on-macos"></a>

Setelah driver diinstal, Anda dapat menemukan contoh `.odbc.ini` dan `.odbcinst.ini` file di lokasi berikut:
+ Komputer prosesor Intel: `/opt/athena/odbc/x86_64/ini/`
+ Komputer prosesor ARM: `/opt/athena/odbc/arm64/ini/`

Gunakan `.ini` file di lokasi ini sebagai contoh untuk mengonfigurasi driver Amazon Athena ODBC dan nama sumber data (DSN).

**catatan**  
Secara default, manajer driver ODBC menggunakan file konfigurasi tersembunyi `.odbc.ini` dan`.odbcinst.ini`, yang terletak di direktori home.

Untuk menentukan jalur ke `.odbcinst.ini` file `.odbc.ini` dan menggunakan manajer driver IodBC, lakukan langkah-langkah berikut.

**Untuk menentukan lokasi `.ini` file ODBC menggunakan manajer driver iodBC**

1. Atur `ODBCINI` ke path lengkap dan nama file `odbc.ini` file.
   + Untuk komputer macOS yang memiliki prosesor Intel, gunakan sintaks berikut.

     ```
     export ODBCINI=/opt/athena/odbc/x86_64/ini/odbc.ini
     ```
   + Untuk komputer macOS yang memiliki prosesor ARM, gunakan sintaks berikut.

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

1. Atur `ODBCSYSINI` ke path lengkap dan nama file `odbcinst.ini` file.
   + Untuk komputer macOS yang memiliki prosesor Intel, gunakan sintaks berikut.

     ```
     export ODBCSYSINI=/opt/athena/odbc/x86_64/ini/odbcinst.ini
     ```
   + Untuk komputer macOS yang memiliki prosesor ARM, gunakan sintaks berikut.

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

1. Jika Anda ingin menggunakan nama sumber data (DSN) untuk terhubung ke penyimpanan data Anda, konfigurasikan `odbc.ini` file untuk menentukan nama sumber data (DSNs). Tetapkan properti dalam `odbc.ini` file untuk membuat DSN yang menentukan informasi koneksi untuk penyimpanan data Anda, seperti pada contoh berikut.

   ```
   [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/
   ```

1. Konfigurasikan `odbcinst.ini` file, seperti pada contoh berikut.

   ```
   [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
   ```

1. Setelah Anda menginstal dan mengkonfigurasi driver Amazon Athena ODBC, gunakan alat `iodbctest` baris perintah untuk memverifikasi koneksi, seperti pada contoh berikut.

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