Linux - Amazon Athena
Linux 系統需求在 Linux 上安裝 ODBC 資料連接器在 Linux 上設定資料來源名稱驗證 ODBC 驅動程式簽章

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Linux

如果您想要使用 Linux 用戶端電腦存取 Amazon Athena，則需要 Amazon Athena ODBC 驅動程式。

Linux 系統需求

安裝驅動程式的每個 Linux 用戶端電腦都必須符合下列要求。

  • 您擁有根存取權。

  • 使用下列其中一個 Linux 發行版本：

    • Red Hat Enterprise Linux (RHEL) 7 或 8

    • CentOS 7 或 8。

  • 有 100 MB 的可用磁碟空間。

  • 使用 2.3.1 版或更新版本的 unixODBC。

  • 使用 2.26 版或更新版本的 GNU C 程式庫 (glibc)。

在 Linux 上安裝 ODBC 資料連接器

使用下列程序在 Linux 作業系統上安裝 Amazon Athena ODBC 驅動程式。

在 Linux 上安裝 Amazon Athena ODBC 驅動程式

  1. 輸入下列其中一個命令：

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

    或

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

  2. 安裝完成後，輸入下列其中一個命令來驗證驅動程式已安裝：

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

      輸出：

      amazon-athena-odbc-driver.x86_64 2.0.2.1-1.amzn2int installed
    • rpm -qa | grep amazon

      輸出：

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

在 Linux 上設定資料來源名稱

安裝驅動程式之後，您可以在下列位置找到範例.odbc.ini和.odbcinst.ini檔案：

  • /opt/athena/odbc/ini/.

使用此位置中的.ini檔案做為設定 Amazon Athena ODBC 驅動程式和資料來源名稱 (DSN) 的範例。

注意

預設情況下，ODBC 驅動程式管理員會使用隱藏的組態檔案 .odbc.ini和 .odbcinst.ini，其位於主目錄中。

若要使用 unixODBC 指定 .odbc.ini和 .odbcinst.ini 檔案的路徑，請執行下列步驟。

使用 unixODBC 指定 ODBC .ini 檔案位置

  1. ODBCINI 設定為odbc.ini檔案的完整路徑和檔案名稱，如下列範例所示。

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

  2. 將 ODBCSYSINI設定為包含 odbcinst.ini 檔案之目錄的完整路徑，如下列範例所示。

    export ODBCSYSINI=/opt/athena/odbc/ini

  3. 輸入下列命令以確認您使用的是 unixODBC 驅動程式管理員和正確的odbc*.ini檔案：

    username % odbcinst -j

    範例輸出

    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

  4. 如果您想要使用資料來源名稱 (DSN) 連接到資料存放區，請設定 odbc.ini 檔案以定義資料來源名稱 DSNs)。將 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              # 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/

  5. 設定 odbcinst.ini 檔案，如下列範例所示。

    [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

  6. 安裝和設定 Amazon Athena ODBC 驅動程式之後，請使用 unixODBC isql命令列工具來驗證連線，如下列範例所示。

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

驗證 ODBC 驅動程式簽章

重要

建議您先驗證 Athena ODBC 驅動程式 RPM 簽章，再將其安裝在您的機器上。

請依照下列步驟驗證 Athena ODBC 驅動程式 RPM 套件的簽章：

  1. 準備範本

    使用適當的公有金鑰、RPM 簽章和 Amazon S3 儲存貯體中託管的 RPM 指令碼的對應存取連結來準備命令。您必須將下列項目下載至您的裝置。

  2. 將 Athena ODBC 驅動程式、公有金鑰和 Athena ODBC RPM 簽章下載至您的裝置。

  3. 執行下列命令來驗證 ODBC 驅動程式簽章：

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

    如果驗證通過，您將會看到類似 的訊息Verified OK。這表示您現在可以繼續安裝 Athena ODBC 驅動程式。

    如果失敗並顯示訊息 Verification Failure，表示 RPM 上的簽章已遭到竄改。請確定步驟 1 中提及的所有三個檔案都存在，路徑已正確指定 ，而且自下載後尚未修改檔案，然後重試驗證程序。