View a markdown version of this page

macOS - Amazon Athena
macOS システム要件macOS への ODBC データコネクタのインストールmacOS でのデータソース名の設定

macOS

Amazon Athena へのアクセスに macOS クライアントコンピューターを使用する場合は、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. [インストール] を選択します。

  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. 以下の例にあるように、odbc.ini ファイルのフルパスとファイル名に ODBCINI 設定します。

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

  2. 以下の例にあるように、odbcinst.ini のファイルが含まれるディレクトリのフルパスに ODBCSYSINI を設定します。

    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>