macOS - Amazon Athena
macOS 統需求在 macOS 上安裝ODBC資料連接器在 macOS 上設定資料來源名稱

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

macOS

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

macOS 統需求

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

在 macOS 上安裝ODBC資料連接器

請遵循下列程序來下載並安裝適用於 macOS 作業系統的 Amazon Athena ODBC 驅動程式。

下載並安裝適用於 macOS 的 Amazon Athena ODBC 驅動程序

  1. 下載.pkg套件檔案。

  2. 按兩下 .pkg 檔案。

  3. 依照精靈中的步驟安裝驅動程式。

  4. 在 [授權合約] 頁面上，按 [繼續]，然後選擇 [同意]。

  5. 選擇 Install (安裝)。

  6. 完成安裝時，請選擇完成。

  7. 輸入以下命令以確認驅動程式是否已安裝：

    > pkgutil --pkgs | grep athenaodbc

    根據您的系統而定，輸出可能如下所示之一。

    com.amazon.athenaodbc-x86_64.Config
com.amazon.athenaodbc-x86_64.Driver

    或

    com.amazon.athenaodbc-arm64.Config
com.amazon.athenaodbc-arm64.Driver

在 macOS 上設定資料來源名稱

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

  • 英特爾處理器電腦：/opt/athena/odbc/x86_64/ini/

  • ARM處理器電腦：/opt/athena/odbc/arm64/ini/

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

注意

根據預設，ODBC驅動程式管理員會使用隱藏的組態檔案.odbcinst.ini，以.odbc.ini及位於主目錄中。

若要使用 i ODBC 驅動程式管理員指定.odbc.ini和.odbcinst.ini檔案的路徑，請執行下列步驟。

使用 i ODBC 驅動程式管理員指定ODBC.ini檔案位置

  1. 將 ODBCINI 設定為 odbc.ini 檔案的完整路徑和檔案名稱。

    • 對於具有 Intel 處理器的 macOS 電腦，請使用下列語法。

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

    • 對於具有ARM處理器的 macOS 電腦，請使用下列語法。

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

  2. 將 ODBCSYSINI 設定為 odbcinst.ini 檔案的完整路徑和檔案名稱。

    • 對於具有 Intel 處理器的 macOS 電腦，請使用下列語法。

      export ODBCSYSINI=/opt/athena/odbc/x86_64/ini/odbcinst.ini

    • 對於具有ARM處理器的 macOS 電腦，請使用下列語法。

      export ODBCSYSINI=/opt/athena/odbc/arm64/ini/odbcinst.ini

  3. 如果要使用資料來源名稱 (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             # set to 1 to enable ODBC driver logs
UseAwsLogger=0         # set to 1 to enable AWS-SDK logs
LogPath=/opt/athena/odbc/logs/ # Path to store the log files. Permissions to the location are required. 

[athena_odbc_test]
Description=Amazon Athena ODBC (x64)
# For ARM:
Driver=/opt/athena/odbc/arm64/lib/libathena-odbc-arm64.dylib
# For Intel:
# Driver=/opt/athena/odbc/x86_64/lib/libathena-odbc-x86_64.dylib
AwsRegion=us-west-1
Workgroup=primary
Catalog=AwsDataCatalog
Schema=default
AuthenticationType=IAM Credentials
UID=
PWD=
S3OutputLocation=s3://amzn-s3-demo-bucket/

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

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

[Amazon Athena ODBC (x64)]
# For ARM:
Driver=/opt/athena/odbc/arm64/lib/libathena-odbc-arm64.dylib
Setup=/opt/athena/odbc/arm64/lib/libathena-odbc-arm64.dylib
# For Intel:
# Driver=/opt/athena/odbc/x86_64/lib/libathena-odbc-x86_64.dylib
# Setup=/opt/athena/odbc/x86_64/lib/libathena-odbc-x86_64.dylib

  5. 安裝並設定 Amazon Athena ODBC 驅動程式後，請使用iodbctest命令列工具驗證連線，如下列範例所示。

    username@ % iodbctest
iODBC Demonstration program
This program shows an interactive SQL processor
Driver Manager: 03.52.1623.0502 

Enter ODBC connect string (? shows list): ? 

DSN                              | Driver
------------------------------------------------------------------------------
athena_odbc_test                 | Amazon Athena ODBC (x64) 

Enter ODBC connect string (? shows list): DSN=athena_odbc_test;
Driver: 2.0.2.1 (Amazon Athena ODBC Driver) 

SQL>