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();
Copy

アカウント識別子の アカウントロケーター 形式を取得するには、次の SQL コマンドを実行します。

SELECT CURRENT_ACCOUNT();
Copy

追加の構成ステップ

次のトピックでは、接続の構成の具体的な領域について説明します。