Snowflakeに接続するためのクライアント、ドライバー、ライブラリ、またはサードパーティアプリケーションの構成¶
クライアント、ドライバー、ライブラリ、アプリケーションをSnowflakeに接続するように構成するには、Snowflakeアカウント識別子を指定する必要があります。さらに、使用するウェアハウス、データベース、スキーマ、ロールを指定する必要があるかもしれません。
使用するアカウントの指定¶
クライアント、コネクタ、およびドライバーは、さまざまな構文を使用してSnowflakeに接続します。通常、組織名(orgname
)とアカウント名(account_name
)を含むバリエーションを使用する必要がありますが、以下の例外があります: クライアントリダイレクト 機能を使用する場合は、アカウント名(account_name
)を接続名(connection_name
)に置き換えます。この構文の例については、 接続 URL の使用 をご参照ください。
Snowflakeサービスへのプライベート接続を構成するには、アカウント名またはアカウントロケーター構文のいずれかに .privatelink
を追加します。プライベート接続を使用する際にSnowflakeへの接続に使用する値を決定するには、Snowflakeアカウントで SYSTEM$GET_PRIVATELINK_CONFIG 関数を呼び出します。
アカウントロケーターを使用する必要がある場合は、アカウントロケーターの後に追加セグメントとして、クラウドのリージョン ID、クラウド、政府準拠レベルを指定する必要がある場合もあります。使用する形式については、 形式2: リージョン内のアカウントロケーター を参照してください。以下の例では、 account_locator_with_additional_segments
は必要な追加セグメントを含むアカウントの場所を表しています。
- SnowSQL:
アカウント名:
snowsql -a orgname-account_name
アカウントロケーター:
snowsql -a account_locator_with_additional_segments
詳細については、 接続構文 をご参照ください。
- JDBC:
アカウント名:
jdbc:snowflake://orgname>-<account_name.snowflakecomputing.com/?connection_paramsr
アカウントロケーター:
jdbc:snowflake://account_locator_with_additional_segments.snowflakecomputing.com/?connection_params
詳細については、 JDBC ドライバー接続文字列 をご参照ください。
- ODBC:
アカウント名:
サーバー:
orgname-account_name.snowflakecomputing.com
アカウントロケーター:
サーバー:
account_locator_with_additional_segments.snowflakecomputing.com}
詳細については、 ODBC 構成および接続パラメーター をご参照ください。
- Python:
アカウント名:
ACCOUNT
パラメーター値をorgname-account_name
としてセットします。
アカウントロケーター:
ACCOUNT
パラメーター値をaccount_locator_with_additional_segments
としてセットします。
詳細については、 PythonコネクタによるSnowflakeへの接続 をご参照ください。
- .Net:
アカウント名:
ACCOUNT
パラメーター値をorgname-account_name
としてセットします。HOST
パラメーター値をデフォルト(.snowflakecomputing.com
)として設定します。
アカウントロケーター:
ACCOUNT
パラメーター値をaccount_locator_with_additional_segments
としてセットします。HOST
パラメーター値をデフォルトの.snowflakecomputing.com
として設定します。Snowflakeアカウントがus-west
リージョンにない場合に指定します。
追加情報については、 接続 をご覧ください。
- Go言語:
アカウント名:
db, err := sql.Open("snowflake", "jsmith:mypassword@orgname-account_name/mydb/testschema?warehouse=mywh")
アカウントロケーター:
sql.Open("snowflake", "jsmith:mypassword@account_locator_with_additional_segments/mydb/testschema?warehouse=mywh")
追加情報については、 接続文字列 を参照してください。
- node.js:
アカウント名:
ACCOUNT
パラメーター値をorgname-account_name
としてセットします。アカウントロケーター:
ACCOUNT
パラメーター値をaccount_locator_with_additional_segments
としてセットします。
詳細については、 接続の管理 をご参照ください。
- Spark(コネクタ):
アカウント名: JDBC と同一
アカウントロケーター: JDBC と同一
詳細については、 コネクタの構成オプションの設定 をご参照ください。
- Spark(Databricks):
アカウント名:
Account URL for Snowflake account
アカウントロケーター:
Account Locator URL for Snowflake account
詳細については、 DatabricksでのSpark用Snowflakeの構成 をご参照ください。
- Spark(Qubole):
アカウント名: Host Address フィールド値を
orgname-account_name.snowflakecomputing.com
としてセットします。アカウントロケーター: Host Address フィールド値を
account_locator_with_additional_segments.snowflakecomputing.com
としてセットします。
詳細については、 QuboleでのSpark用Snowflakeの構成 をご参照ください。
- PHP:
アカウント名:
ACCOUNT
パラメーター値をorgname-account_name
としてセットします。すべてのリージョンで
REGION
パラメーター値を空白のままにします。
アカウントロケーター:
ACCOUNT
パラメーター値をaccount_locator
としてセットします。Snowflakeアカウントが
us-west
リージョンに ない 場合は、REGION
パラメータ値を設定します。
追加情報については、 Snowflakeデータベースへの接続 を参照してください。
- SQLAchemy:
アカウント名:
snowflake://user_login_name:password@orgname-account_name
アカウントロケーター:
snowflake://user_login_name:password@account_locator_with_additional_segments
詳細については、 Snowflake SQLAlchemy ツールキットでのPythonコネクタの使用 をご参照ください。
SQL ステートメントを使用してアカウント識別子を検索する¶
organization_name-account_name
形式のアカウント識別子を取得するには、次の SQL コマンドを実行します。
SELECT CURRENT_ORGANIZATION_NAME() || '-' || CURRENT_ACCOUNT_NAME();
アカウント識別子の アカウントロケーター 形式を取得するには、次の SQL コマンドを実行します。
SELECT CURRENT_ACCOUNT();
追加の構成ステップ¶
次のトピックでは、接続の構成の具体的な領域について説明します。