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

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

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

## Linux 系統要求
<a name="odbc-v2-driver-getting-started-linux-linux-system-requirements"></a>

您安裝驅動器的每一台 Linux 電腦必須符合下列要求。
+ 您擁有根存取權。
+ 使用下列其中一個 Linux 發行版本：
  + Red Hat Enterprise Linux (RHEL) 7 或 8
  + CentOS 7 或 8。
+ 有 100 MB 的可用磁碟空間。
+ 使用 [unixODBC](https://www.unixodbc.org/) 版本 2.3.1 或更新版本。
+ 使用 [GNU C Library](https://www.gnu.org/software/libc/) (glibc) 版本 2.26 或更新版本。

## 在 Linux 上安裝 ODBC 資料連接器
<a name="odbc-v2-driver-getting-started-linux-installing-the-odbc-data-connector-on-linux"></a>

使用下列程序來在 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
   ```

1. 安裝完成後，輸入下列其中一個命令，以驗證驅動器已安裝：
   + 

     ```
     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 上設定資料來源名稱
<a name="odbc-v2-driver-getting-started-linux-configuring-a-data-source-name-on-linux"></a>

安裝驅動器後，您可以在下列位置中找到 `.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
   ```

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

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

1. 輸入下列命令，以驗證您使用的是 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
   ```

1. 如果您想要使用資料來源名稱 (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/
   ```

1. 設定 `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
   ```

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

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

## 驗證 ODBC 驅動器簽章
<a name="verify-odbc-linux-signature"></a>

**重要**  
我們建議您先驗證 Athena ODBC 驅動器 RPM 簽章，然後再將其安裝在您的電腦上。

依照以下步驟，驗證 Athena ODBC 驅動器 RPM 套件的簽章：

1. **準備範本**

   準備命令時，請使用適當的公有金鑰、RPM 簽章和 Amazon S3 儲存貯體中託管的 RPM 指令碼的對應存取連結。您必須將下列項目下載至您的裝置。
   +  [Athena ODBC 驅動器](https://downloads.athena.us-east-1.amazonaws.com/drivers/ODBC/v2.1.0.0/Linux/AmazonAthenaODBC-2.1.0.0.rpm) 
   +  [公有金鑰](https://downloads.athena.us-east-1.amazonaws.com/drivers/ODBC/v2.1.0.0/Linux/public_key.pem)
   +  [Athena ODBC RPM 簽章](https://downloads.athena.us-east-1.amazonaws.com/drivers/ODBC/v2.1.0.0/Linux/signature.bin) 

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

1. 執行下列命令，驗證 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 中提及的所有三個檔案都存在、路徑已正確指定，而且檔案自下載後未曾修改，然後重試驗證程序。