View a markdown version of this page

ODBC ドライバーマネージャーを使用してドライバーを設定する - Amazon Redshift

Amazon Redshift は、2026 年 6 月 30 日以降、Python UDF の使用をサポートしなくなります。これは段階的に実施されます。Python のサポート終了と移行オプションの詳細については、2025 年 6 月 30 日に公開されたブログ記事を参照してください。

ODBC ドライバーマネージャーを使用してドライバーを設定する

macOS オペレーティングシステムでは、ODBC ドライバーマネージャーを使用して ODBC 接続を設定します。ODBC ドライバーマネージャーは設定ファイルを使用して ODBC データソースおよびドライバーを定義および設定します。使用する ODBC ドライバーマネージャーは、使用するオペレーティングシステムによって異なります。macOS オペレーションシステムの場合、iODBC ドライバーマネージャーです。

Amazon Redshift ODBC ドライバーの設定がサポートされている ODBC ドライバーマネージャーの詳細については、macOS オペレーティングシステム向けの「macOS での Amazon Redshift ODBC ドライバーの使用」を参照してください。詳細については、「Amazon Redshift ODBC connector installation and configuration guide」の「Specifying ODBC Driver Managers on Non- Windows Machines」を参照してください。

Amazon Redshift ODBC ドライバーを設定するには、amazon.redshiftodbc.iniodbc.ini、および odbcinst.ini の 3 つのファイルが必要です。

デフォルトの場所にインストールした場合、amazon.redshiftodbc.ini 設定ファイルは /opt/amazon/redshift/lib にあります。

さらに、macOS では、/opt/amazon/redshift/Setup の下に odbc.iniodbcinst.ini のサンプルファイルがあります。これらのファイルは、Amazon Redshift ODBC ドライバーとデータソース名 (DSN) の設定例として使用できます。

設定ファイルに Amazon Redshift ODBC ドライバーのインストールディレクトリを使用することは推奨されません。Setup ディレクトリのサンプルファイルは例示のみを目的としています。Amazon Redshift ODBC ドライバーを後で再インストールするか、新しいバージョンにアップグレードすると、インストールディレクトリが上書きされます。その後、これらのファイルに加えた変更はすべて失われます。

これを回避するには、インストールディレクトリ以外のディレクトリに amazon.redshiftodbc.ini ファイルをコピーします。このファイルをユーザーのホームディレクトリにコピーする場合は、隠しファイルにするためにファイル名の先頭にピリオド (.) を追加します。

odbc.ini および odbcinst.ini ファイルについては、ユーザーのホームディレクトリにある設定ファイルを使用するか、別のディレクトリに新しいバージョンを作成します。デフォルトでは、macOS オペレーティングシステムには、ユーザーのホームディレクトリ (/home/$USER または ~/) に odbc.ini ファイルと odbcinst.ini ファイルが必要です。これらの既定のファイルは隠しファイルで、各ファイル名の前にドット (.) が表示されます。これらのファイルは、-aフラグを使用してディレクトリの内容をリストした場合にのみ表示されます。

odbc.ini ファイルと odbcinst.ini ファイルに対してどちらのオプションを選択しても、ファイルを変更してドライバーと DSN 設定情報を追加します。新しいファイルを作成する場合は、これらの設定ファイルの場所を指定する環境変数を設定する必要もあります。

デフォルトでは、ODBC ドライバーマネージャーは、隠しバージョンの odbc.ini および odbcinst.ini 設定ファイル (.odbc.ini と .odbcinst.iniという名前) をホームディレクトリに配置します。また、ドライバーのインストールディレクトリの amazon.redshiftodbc.ini サブフォルダにある /lib ファイルを使用するように設定されています。これらの設定ファイルを他の場所に保存する場合は、ドライバーマネージャーがファイルを見つけることができるように、次に説明する環境変数を設定します。詳細については、Amazon Redshift ODBC connector installation and configuration guide の「Specifying the Locations of the Driver Configuration Files」を参照してください。

macOS X オペレーティングシステムでのデータソース名の作成

データソース名 (DSN) を使用してデータストアに接続する場合は、DSN を定義するように odbc.ini ファイルを設定します。odbc.ini ファイルのプロパティを設定して、データストアの接続情報を指定する DSN を作成します。

odbc.ini ファイルの設定方法については、Amazon Redshift ODBC コネクタのインストールおよび設定ガイドの「Windows 以外のマシンでデータソース名を作成する」を参照してください。

macOS オペレーティングシステムでは次の形式を使用します。

[ODBC Data Sources] driver_name=dsn_name [dsn_name] Driver=path/lib/amazonredshiftodbc.dylib Host=cluster_endpoint Port=port_number Database=database_name locale=locale

次の例は、macOS オペレーティングシステムでの odbc.ini の設定を示しています。

[ODBC Data Sources] Amazon_Redshift_dylib=Amazon Redshift DSN for macOS [Amazon Redshift DSN for macOS] Driver=/opt/amazon/redshift/lib/amazonredshiftodbc.dylib Host=examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com Port=5932 Database=dev locale=en-US

macOS オペレーティングシステムで DSN を使用しない接続を設定する

DSN を使用しない接続を介してデータストアに接続するには、odbcinst.ini ファイルでドライバーを定義します。次に、アプリケーションに DSN を使用しない接続文字列を指定します。

この場合の odbcinst.ini ファイルの設定方法については、「Amazon Redshift ODBC connector installation and configuration guide」の「Configuring a DSN-less Connection on a Non-Windows Machine」を参照してください。

macOS オペレーティングシステムでは次の形式を使用します。

[ODBC Drivers] driver_name=Installed ... [driver_name] Description=driver_description Driver=path/lib/amazonredshiftodbc.dylib ...

次の例は、macOS オペレーティングシステムでデフォルトのディレクトリにインストールされたドライバーの odbcinst.ini 設定を示しています。

[ODBC Drivers] Amazon RedshiftODBC DSN=Installed [Amazon RedshiftODBC DSN] Description=Amazon Redshift ODBC Driver for macOS Driver=/opt/amazon/redshift/lib/amazonredshiftodbc.dylib

環境変数の設定

正しい ODBC ドライバーマネージャーを使用して、正しいドライバーをロードします。これを行うには、ライブラリパス環境変数を設定します。詳細については、Amazon Redshift ODBC connector installation and configuration guide の「Specifying ODBC Driver Managers on Non-Windows Machines」を参照してください。

デフォルトでは、ODBC ドライバーマネージャーは、隠しバージョンの odbc.ini および odbcinst.ini 設定ファイル (.odbc.ini と .odbcinst.iniという名前) をホームディレクトリに配置します。また、ドライバーのインストールディレクトリの amazon.redshiftodbc.ini サブフォルダにある /lib ファイルを使用するように設定されています。これらの設定ファイルを他の場所に保存する場合は、ドライバーマネージャーがファイルを検索できるように環境変数を設定します。詳細については、Amazon Redshift ODBC Connector Installation and Configuration Guide の「Specifying the Locations of the Driver Configuration Files」を参照してください。

接続機能の設定

ODBC 設定には、次の接続機能を設定できます。

  • 認証情報を提供し、Amazon Redshift データベースへの接続を認証するように ODBC ドライバーを設定します。

  • SSL が有効な Amazon Redshift サーバーに接続している場合は、Secure Sockets Layer (SSL) で有効なソケットに接続するように ODBC ドライバーを設定します。

  • プロキシサーバー経由で Amazon Redshift に接続するように ODBC ドライバーを設定します。

  • クエリ処理モードを使用するように ODBC ドライバーを設定して、クエリが大量のメモリを消費しないようにします。

  • IAM 認証プロセスをプロキシサーバー経由で渡すように ODBC ドライバーを設定します。

  • 接続のタイムアウトを防ぐために TCP キープアライブを使用するように ODBC ドライバーを設定します。

これらの接続機能の詳細については、Amazon Redshift ODBC connector installation and configuration guide を参照してください。