View a markdown version of this page

Linux - Amazon Athena
Persyaratan sistem LinuxMenginstal konektor data ODBC di LinuxMengkonfigurasi nama sumber data di LinuxVerifikasi tanda tangan driver ODBC

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

Linux

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

Persyaratan sistem Linux

Setiap komputer klien Linux tempat Anda menginstal driver harus memenuhi persyaratan berikut.

  • Anda memiliki akses root.

  • Gunakan salah satu distribusi Linux berikut:

    • Amazon Linux 2023

    • Red Hat Enterprise Linux(RHEL) 9 atau yang lebih baru. Pada RHEL 9, gunakan driver Amazon Athena ODBC versi 2.2.0.2 atau yang lebih baru. Versi 2.1.0.0 hingga 2.2.0.1 dapat gagal diinstal karena memerlukan versi GLIBCXX simbol yang tidak tersedia di repositori 9 standar. RHEL

  • Memiliki ruang disk 100 MB yang tersedia.

  • Gunakan versi 2.3.9 atau yang lebih baru dari Uni xODBC.

  • Gunakan versi 2.34 atau yang lebih baru dari GNU C Library (glibc).

Menginstal konektor data ODBC di Linux

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-x86_64.rpm

    atau

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

  2. 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.3.0.0-1.amzn2023 installed
    • rpm -qa | grep amazon

      Output:

      amazon-athena-odbc-driver-2.3.0.0-1.amzn2023.x86_64

Mengkonfigurasi nama sumber data di Linux

Setelah driver diinstal, Anda dapat menemukan contoh odbc.ini.example dan odbcinst.ini.example file di lokasi berikut:

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

Salin file contoh ke direktori konfigurasi dan hapus .example ekstensi. Gunakan file-file ini sebagai titik awal untuk mengonfigurasi driver Amazon Athena ODBC dan nama sumber data (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
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 ODBC .ini lokasi file menggunakan UnixODBC

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

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

  2. Atur ODBCSYSINI ke path lengkap direktori yang berisi odbcinst.ini file, seperti pada contoh berikut.

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

  3. Masukkan perintah berikut untuk memverifikasi bahwa Anda menggunakan manajer driver UnixODBC dan file yang benar: odbc*.ini

    username % odbcinst -j

    Output sampel

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

  4. Jika Anda ingin menggunakan nama sumber data (DSN) untuk terhubung ke penyimpanan data Anda, konfigurasikan odbc.ini file untuk menentukan nama sumber data (DSN). Tetapkan properti dalam odbc.ini file untuk membuat DSN yang menentukan informasi koneksi untuk penyimpanan data Anda, seperti dalam 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/amazon/athena-odbc/logs/ # Path to store the log files. Permissions to the location are required.

[athena_odbc_test]
Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.so
AwsRegion=us-west-1
Workgroup=primary
Catalog=AwsDataCatalog
Schema=default
AuthenticationType=IAM Credentials
UID=
PWD=
S3OutputLocation=s3://amzn-s3-demo-bucket/

  5. Konfigurasikan odbcinst.ini file, seperti pada contoh berikut.

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

[Amazon Athena ODBC (x64)]
Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.so
Setup=/opt/amazon/athena-odbc/lib/libathenaodbc.so

  6. Setelah Anda menginstal dan mengkonfigurasi 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

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 templat

    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.

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

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

    openssl dgst -sha256 -verify public_key.pem -signature signature.bin AmazonAthenaODBC-2.3.0.0-x86_64.rpm

    Jika verifikasi lulus, Anda akan melihat pesan yang mirip denganVerified OK. Ini berarti Anda sekarang dapat melanjutkan untuk menginstal driver Athena ODBC.

    Jika gagal dengan pesanVerification Failure, itu berarti tanda tangan pada RPM telah dirusak. Pastikan ketiga file yang disebutkan di langkah 1 ada, jalur ditentukan dengan benar, dan file belum dimodifikasi sejak mengunduh dan kemudian coba lagi proses verifikasi.