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 的可用磁碟空間。

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

  • 使用 GNU C Library (glibc) 版本 2.26 或更新版本。

在 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 檔案來定義資料來源名稱 (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              # 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.1.0.0.rpm

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

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