Amazon Redshift は、2025 年 11 月 1 日以降、新しい Python UDF の作成をサポートしなくなります。Python UDF を使用する場合は、その日付より前に UDF を作成してください。既存の Python UDF は引き続き通常どおり機能します。詳細については、ブログ記事を参照してください。

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

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

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

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

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

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

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

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

odbc.ini および odbcinst.ini ファイルについては、ユーザーのホームディレクトリにある設定ファイルを使用するか、別のディレクトリに新しいバージョンを作成します。デフォルトでは、macOS X オペレーティングシステムには、ユーザーのホームディレクトリ (odbc.ini または odbcinst.ini) に /home/$USER ファイルと ~/ ファイルが必要です。これらの既定のファイルは隠しファイルで、各ファイル名の前にドット (.) が表示されます。これらのファイルは、-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 connector installation and configuration guide」の「Creating a Data Source Name on a Non-Windows Machine」を参照してください。

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

[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 X オペレーティングシステムでの odbc.ini の設定を示しています。

[ODBC Data Sources]
Amazon_Redshift_dylib=Amazon Redshift DSN for macOS X

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

macOS X オペレーティングシステムで 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 X オペレーティングシステムでは次の形式を使用します。

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

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

[ODBC Drivers]
Amazon RedshiftODBC DSN=Installed

[Amazon RedshiftODBC DSN]
Description=Amazon Redshift ODBC Driver for macOS X
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 connector installation and configuration guide を参照してください。