

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

# Linux
<a name="odbc-v2-driver-getting-started-linux"></a>

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

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

Setiap komputer klien Linux tempat Anda menginstal driver harus memenuhi persyaratan berikut.
+ Anda memiliki akses root.
+ Gunakan salah satu distribusi Linux berikut:
  + Red Hat Enterprise Linux (RHEL) 7 atau 8
  + CentOS 7 atau 8.
+ Memiliki 100 MB ruang disk yang tersedia.
+ Gunakan [UnixODBC](https://www.unixodbc.org/) versi 2.3.1 atau yang lebih baru.
+ Gunakan versi 2.26 atau yang lebih baru dari [Perpustakaan GNU C](https://www.gnu.org/software/libc/) (glibc).

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

Gunakan prosedur berikut untuk menginstal driver Amazon Athena ODBC pada sistem operasi Linux.

**Untuk menginstal driver Amazon Athena ODBC di Linux**

1. Masukkan salah satu perintah berikut:

   ```
   sudo rpm -Uvh AmazonAthenaODBC-2.X.Y.Z.rpm
   ```

   atau

   ```
   sudo yum --nogpgcheck localinstall AmazonAthenaODBC-2.X.Y.Z.rpm
   ```

1. Setelah instalasi selesai, masukkan salah satu perintah berikut untuk memverifikasi bahwa driver diinstal:
   + 

     ```
     yum list | grep amazon-athena-odbc-driver
     ```

     Output:

     ```
     amazon-athena-odbc-driver.x86_64 2.0.2.1-1.amzn2int installed
     ```
   + 

     ```
     rpm -qa | grep amazon
     ```

     Output:

     ```
     amazon-athena-odbc-driver-2.0.2.1-1.amzn2int.x86_64
     ```

## Mengkonfigurasi nama sumber data di Linux
<a name="odbc-v2-driver-getting-started-linux-configuring-a-data-source-name-on-linux"></a>

Setelah driver diinstal, Anda dapat menemukan contoh `.odbc.ini` dan `.odbcinst.ini` file di lokasi berikut:
+ `/opt/athena/odbc/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 UnixODBC, lakukan langkah-langkah berikut.

**Untuk menentukan lokasi `.ini` file ODBC menggunakan UnixODBC**

1. Atur `ODBCINI` ke path lengkap dan nama file `odbc.ini` file, seperti pada contoh berikut.

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

1. Setel `ODBCSYSINI` ke path lengkap direktori yang berisi `odbcinst.ini` file, seperti pada contoh berikut.

   ```
   export ODBCSYSINI=/opt/athena/odbc/ini
   ```

1. Masukkan perintah berikut untuk memverifikasi bahwa Anda menggunakan pengelola driver UnixODBC dan file yang benar: `odbc*.ini`

   ```
   {{username}} % odbcinst -j
   ```

   Output sampel

   ```
   unixODBC 2.3.1
   DRIVERS............: /opt/athena/odbc/ini/odbcinst.ini
   SYSTEM DATA SOURCES: /opt/athena/odbc/ini/odbc.ini
   FILE DATA SOURCES..: /opt/athena/odbc/ini/ODBCDataSources
   USER DATA SOURCES..: /opt/athena/odbc/ini/odbc.ini
   SQLULEN Size.......: 8
   SQLLEN Size........: 8
   SQLSETPOSIROW Size.: 8
   ```

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              # To enable ODBC driver logs, set this to 1.
   UseAwsLogger=0          # To enable AWS-SDK logs, set this to 1.
   LogPath=/opt/athena/odbc/logs/ # Path to store the log files. Permissions to the location are required. 
   
   [athena_odbc_test]
   Driver=/opt/athena/odbc/lib/libathena-odbc.so
   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)]
   Driver=/opt/athena/odbc/lib/libathena-odbc.so
   Setup=/opt/athena/odbc/lib/libathena-odbc.so
   ```

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

   ```
   {{username}} % isql -v "athena_odbc_test" 
   +---------------------------------------+
   | Connected!                            |
   |                                       |
   | sql-statement                         |
   | help [tablename]                      |
   | quit                                  |
   |                                       |
   +---------------------------------------+
   SQL>
   ```

## Verifikasi tanda tangan driver ODBC
<a name="verify-odbc-linux-signature"></a>

**penting**  
Sebaiknya verifikasi tanda tangan RPM driver Athena ODBC sebelum menginstalnya di mesin Anda.

Ikuti langkah-langkah berikut untuk memverifikasi tanda tangan paket RPM driver Athena ODBC:

1. **Siapkan template**

   Siapkan perintah dengan kunci publik yang sesuai, tanda tangan RPM, dan tautan akses yang sesuai ke skrip RPM yang dihosting di bucket Amazon S3. Anda harus mengunduh yang berikut ini ke perangkat Anda.
   +  
   +  [Kunci Publik Kunci](https://downloads.athena.us-east-1.amazonaws.com/drivers/ODBC/v2.1.0.0/Linux/public_key.pem) 
   +  [Athena ODBC RPM tanda tangan Athena ODBC](https://downloads.athena.us-east-1.amazonaws.com/drivers/ODBC/v2.1.0.0/Linux/signature.bin) 

1. Unduh driver Athena ODBC, kunci publik, dan tanda tangan Athena ODBC RPM ke perangkat Anda. 

1. Jalankan perintah berikut untuk memverifikasi tanda tangan driver ODBC:

   ```
   openssl dgst -sha256 -verify public_key.pem -signature signature.bin AmazonAthenaODBC-2.1.0.0.rpm
   ```

   Jika verifikasi lolos, Anda akan melihat pesan yang mirip dengan`Verified OK`. Ini berarti Anda sekarang dapat melanjutkan untuk menginstal driver Athena ODBC. 

   Jika gagal dengan pesan`Verification Failure`, itu berarti tanda tangan pada RPM telah dirusak. Pastikan bahwa ketiga file yang disebutkan dalam langkah 1 ada, jalur ditentukan dengan benar, dan file belum dimodifikasi sejak diunduh dan kemudian coba lagi proses verifikasi.