View a markdown version of this page

Linux - Amazon Athena

Linux

Amazon Athena へのアクセスに Linux クライアントコンピューターを使用する場合は、Amazon Athena ODBC ドライバーが必要です。

Linux システム要件

ドライバーをインストールする Linux コンピューターは、それぞれ以下の最小要件を満たしている必要があります。

  • ルートアクセス権がある。

  • 以下の Linux ディストリビューションのいずれかを使用している。

    • Amazon Linux 2023

    • Red Hat Enterprise Linux (RHEL) 9 以降

  • 100 MB のディスク空き容量がある。

  • unixODBC のバージョン 2.3.9 以降を使用している。

  • GNU C ライブラリ (glibc) のバージョン 2.34 以降を使用している。

Linux への ODBC データコネクタのインストール

Linux オペレーティングシステムに Amazon Athena ODBC ドライバーをインストールするには、以下の手順を実行します。

Amazon Athena ODBC ドライバーを Linux にインストールする
  1. 次のいずれかのコマンドを入力します。

    sudo rpm -Uvh AmazonAthenaODBC-2.X.Y.Z-x86_64.rpm

    または

    sudo yum --nogpgcheck localinstall AmazonAthenaODBC-2.X.Y.Z-x86_64.rpm
  2. インストールが完了したら、以下のコマンドのいずれかを入力して、ドライバーがインストールされていることを確認します。

    • yum list | grep amazon-athena-odbc-driver

      出力:

      amazon-athena-odbc-driver.x86_64 2.2.0.0-1.amzn2023 installed
    • rpm -qa | grep amazon

      出力:

      amazon-athena-odbc-driver-2.2.0.0-1.amzn2023.x86_64

Linux でのデータソース名の設定

ドライバーがインストールされると、以下の場所に 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 を使用します。

unixODBC を使用して odbc.iniodbcinst.ini ファイルへのパスを指定するには、次の手順を実行します。

unixODBC を使用して 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. 以下のコマンドを入力して、unixODBC ドライバーマネージャーと正しい odbc*.ini ファイルを使用していることを確認します。

    username % odbcinst -j

    サンプル出力

    unixODBC 2.3.1 DRIVERS............: /opt/amazon/athena-odbc/etc/athena-odbc/odbcinst.ini SYSTEM DATA SOURCES: /opt/amazon/athena-odbc/etc/athena-odbc/odbc.ini FILE DATA SOURCES..: /opt/amazon/athena-odbc/etc/athena-odbc/ODBCDataSources USER DATA SOURCES..: /opt/amazon/athena-odbc/etc/athena-odbc/odbc.ini SQLULEN Size.......: 8 SQLLEN Size........: 8 SQLSETPOSIROW Size.: 8
  4. データソース名 (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/amazon/athena-odbc/logs/ # Path to store the log files. Permissions to the location are required. [athena_odbc_test] Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.so AwsRegion=us-west-1 Workgroup=primary Catalog=AwsDataCatalog Schema=default AuthenticationType=IAM Credentials UID= PWD= S3OutputLocation=s3://amzn-s3-demo-bucket/
  5. 以下の例にあるように、odbcinst.ini ファイルを設定します。

    [ODBC Drivers] Amazon Athena ODBC (x64)=Installed [Amazon Athena ODBC (x64)] Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.so Setup=/opt/amazon/athena-odbc/lib/libathenaodbc.so
  6. Amazon Athena ODBC ドライバーをインストールして設定したら、以下の例にあるように、unixODBC isql コマンドラインツールを使用して接続を確認します。

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

ODBC ドライバーの署名を確認する

重要

Athena ODBC ドライバーの RPM 署名をマシンにインストールする前に検証することをお勧めします。

Athena ODBC ドライバー RPM パッケージの署名を確認するには、次の手順に従います。

  1. テンプレートを準備する

    適切なパブリックキー、RPM 署名、および Amazon S3 バケットでホストされている RPM スクリプトへの対応するアクセスリンクを使用してコマンドを準備します。デバイスに以下をダウンロードする必要があります。

  2. Athena ODBC ドライバー、パブリックキー、および Athena ODBC RPM 署名をデバイスにダウンロードします。

  3. 次のコマンドを実行して、ODBC ドライバーの署名を検証します。

    openssl dgst -sha256 -verify public_key.pem -signature signature.bin AmazonAthenaODBC-2.1.0.0-x86_64.rpm

    検証に成功すると、Verified OK のようなメッセージが表示されます。これで、Athena ODBC ドライバーのインストールに進むことができます。

    Verification Failure のメッセージで失敗した場合、RPM の署名が改ざんされたことを意味します。ステップ 1 で説明した 3 つのファイルがすべて存在し、パスが正しく指定され、ダウンロード後にファイルが変更されていないことを確認し、検証プロセスを再試行してください。