View a markdown version of this page

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 athena.odbc

    如果驅動程式安裝成功，輸出類似以下內容。

    com.amazon.athena.odbc.Runtime
com.amazon.athena.odbc.Documentation

在 macOS 上設定資料來源名稱

安裝驅動器後，您可以在下列位置中找到 odbc.ini.example 和 odbcinst.ini.example 檔案的範例：

  • /opt/amazon/athena-odbc/share/athena-odbc/

將範例檔案複製到組態目錄並移除.example副檔名。使用這些檔案做為設定 Amazon Athena ODBC 驅動程式和資料來源名稱 (DSN) 的起點。

sudo mkdir -p /opt/amazon/athena-odbc/etc/athena-odbc
sudo cp /opt/amazon/athena-odbc/share/athena-odbc/odbc.ini.example /opt/amazon/athena-odbc/etc/athena-odbc/odbc.ini
sudo cp /opt/amazon/athena-odbc/share/athena-odbc/odbcinst.ini.example /opt/amazon/athena-odbc/etc/athena-odbc/odbcinst.ini
注意

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

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

使用 iODBC 驅動器管理員指定 ODBC .ini 檔案位置

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

    export ODBCINI=/opt/amazon/athena-odbc/etc/athena-odbc/odbc.ini

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

    export ODBCSYSINI=/opt/amazon/athena-odbc/etc/athena-odbc

  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/amazon/athena-odbc/logs/ # Path to store the log files. Permissions to the location are required.

[athena_odbc_test]
Description=Amazon Athena ODBC (x64)
Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.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)]
Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.dylib
Setup=/opt/amazon/athena-odbc/lib/libathenaodbc.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.x.y.z (Amazon Athena ODBC Driver) 

SQL>