macOS用 ODBC ドライバーのインストールと構成¶
Windowsと同様に、 macOS は ODBC ベースのクライアントアプリケーションをSnowflakeに接続するために名前付きデータソース(DSNs)を利用します。
このトピックの内容:
前提条件¶
オペレーティングシステム¶
Snowflakeクライアントでサポートされているオペレーティングシステムのリストについては、 オペレーティングシステムのサポート をご参照ください。
ODBC バージョン3.0.1より、ドライバーは MacOS 10.14および10.15バージョンをサポートしなくなりました。
iODBC¶
Mac用Snowflake ODBC ドライバーには iODBCが必要です。これは次からダウンロードできます。
iODBC をインストールするには、
iODBC をダウンロードした後、ダウンロードした.dmgファイルをダブルクリックします。
インストーラーファイル
iODBC-SDK.pkg
をダブルクリックし、プロンプトに従います。デフォルトでは、パッケージはソフトウェアを
/Library/Application Support/iODBC/bin
ディレクトリにインストールします。このディレクトリを$PATH
環境変数に追加すると、 iODBC コマンドを実行するために完全なパス名を指定する必要がなくなります。
注釈
iODBC は、ドライバーと DSNs を構成するための GUI 管理者ツールを提供します。ただし、このツールはSnowflakeでの使用についてはテストされていないため、 DSNs の作成または管理には使用しないでください。
ステップ1: ODBC ドライバーをインストールする¶
macOS のSnowflake ODBC ドライバーをインストールするには、
ドライバーをまだダウンロードしていない場合は、今すぐダウンロードします。詳細については、 ODBC ドライバーのダウンロード をご参照ください。
ダウンロードした.dmgファイル
snowflake_odbc_mac-<バージョン>.dmg
をダブルクリックします。インストーラーファイル
snowflakeODBC_<バージョン>.pkg
をダブルクリックし、プロンプトに従います。ドライバーをインストールするマシンの管理者/sudoパスワードの入力を求められる場合があります。
プロンプトが表示されたときにデフォルトのディレクトリを選択すると、インストーラーは次のディレクトリに ODBC ドライバーファイルをインストールします。
/opt/snowflake/snowflakeodbc
/Library/ODBC
ステップ2: ODBC ドライバーを構成する¶
macOS 用 ODBC ドライバーを構成するには、作成する DSN のタイプに応じて、次のファイルに保存される1つ以上のデータソース(DSNs)を作成します。
ユーザー DSNs :
~/Library/ODBC/odbc.ini
システム DSNs:
/Library/ODBC/odbc.ini
DSN を作成するには、適切な odbc.ini
ファイルを編集します。
odbc.ini
ファイルへのエントリの追加による DSN の作成¶
ユーザーまたはシステム DSN がドライバー用に既に作成されている場合、作成中の DSN のタイプに対応するディレクトリに既に存在する odbc.ini
ファイルに、新しいエントリを追加します。ドライバーの最初の DSN を作成する場合は、 odbc.ini
ファイルを手動で作成し、ファイルにエントリを追加する必要があります。
DSN ごとに、次を指定します。
<DSN名> = <ドライバー名>
形式の DSN 名とドライバー名(Snowflake) 。Driver = /opt/snowflake/snowflakeodbc/lib/universal/libSnowflake.dylib
形式のドライバーファイルのディレクトリパスおよび名前。server
およびuid
(ユーザーログイン名)などの接続パラメーター。DSN に追加する接続パラメーターは、 ODBC 接続文字列で指定する必要はありません。デフォルトの
role
、database
、warehouse
などの追加パラメーター。
パラメーターは <パラメーター名> = <値>
形式で指定されます。各 DSN に設定できるパラメーターの詳細については、 ODBC 構成および接続パラメーター をご参照ください。
次の例は、 server
URL で異なる形式の アカウント識別子 を使用する、2つのデータソースを構成する odbc.ini
ファイルを示しています。
testodbc1
はアカウント識別子として、組織myorganization
でアカウントmyaccount
を指定する アカウント識別子 を使用します。testodbc2
は、アカウント識別子として アカウントロケーターxy12345
を使用します。testodbc2
は、 AWS US 西部(オレゴン)リージョンのアカウントを使用しています。アカウントが別のリージョンにある場合、またはアカウントが別のクラウドプロバイダーを使用している場合は、 アカウントロケーターの後に追加のセグメントを指定する 必要があります。[ODBC Data Sources] testodbc1 = Snowflake testodbc2 = Snowflake [testodbc1] Driver = /opt/snowflake/snowflakeodbc/lib/universal/libSnowflake.dylib Description = uid = peter server = myorganization-myaccount.snowflakecomputing.com role = sysadmin [testodbc2] Driver = /opt/snowflake/snowflakeodbc/lib/universal/libSnowflake.dylib Description = uid = mary server = xy12345.snowflakecomputing.com role = analyst database = sales warehouse = analysis
次の点にご注意ください。
testodbc1
とtestodbc2
の両方に既定のロールがあることtestodbc2
にも、既定のデータベースとウェアハウスがあること
ステップ3: ODBC をテストする¶
iODBC に付属の iodbctest
コマンドラインユーティリティを使用して、作成した DSNs をテストできます。
ODBC 接続文字列の入力を求められたら、必要な接続パラメーター(DSN 名、サーバー、ユーザーログイン名、パスワード)、および接続文字列の一部として入力する他のパラメーターを入力します。接続文字列は、 dsn=testodbc2
などの <パラメーター名>=<値>
形式を持つパラメーターを受け入れます。各パラメーターは、セミコロン(;
)で区切られ、空白は含まれません。サポートされているパラメーターのリストについては、 ODBC 構成および接続パラメーター をご参照ください。
注釈
サーバーとユーザーログイン名を DSN に設定した場合、接続文字列に必要なパラメーターは DSN 名とユーザーパスワードのみです。
例:
$ "/Library/Application Support/iODBC/bin/iodbctest"
iODBC Demonstration program
This program shows an interactive SQL processor
Driver Manager: 03.52.0607.1008
Enter ODBC connect string (? shows list): dsn=testodbc2;pwd=<password>
Dec 14 20:16:08 INFO 1299 SFConnection::connect: Tracing level: 4
Driver: 2.12.36 (Snowflake - Latest version supported by Snowflake: 2.12.38)
SQL>