Linux

如果您想使用 Linux 客戶端計算機訪問 Amazon Athena，則需要 Amazon Athena ODBC 驅動程序。

系統需求

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

• 您有根存取權限。

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

  • 紅帽企業版 (RHEL) 7 或 8

  • CentOS 7 或 8。

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

• 使用 unix ODBC 版本 2.3.1 或更高版本。

• 使用 GNUC 函式庫 (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驅動程式管理員會使用隱藏的組態檔案.odbcinst.ini，以.odbc.ini及位於主目錄中。

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

使用 unix 指定ODBC.ini文件位置 ODBC

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

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

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

   export ODBCSYSINI=/opt/athena/odbc/ini

3. 輸入下列命令以確認您使用的是 unix ODBC 驅動程式管理員和正確的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 驅動程式之後，請使用 unix ODBC isql 命令列工具驗證連線，如下列範例所示。

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