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

macOS

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

macOS 系統要求

您安裝驅動器的每一台 macOS 電腦必須符合下列要求。

  • 使用 macOS 版本 14 或更新版本。

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

  • 使用 iODBC 版本 3.52.16 或更新版本。

在 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 檔案的範例：

  • Intel 處理器電腦：/opt/athena/odbc/x86_64/ini/

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

使用 .ini 檔案作為設定 Amazon Athena ODBC 驅動器和資料來源名稱 (DSN) 的範例。

注意

依預設，ODBC 驅動器管理員會使用隱藏的組態檔案 .odbc.ini 和 .odbcinst.ini，這些組態檔案位於主目錄中。

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

使用 iODBC 驅動器管理員指定 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 檔案來定義資料來源名稱 (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             # 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>