Snowflakeに接続するためのクライアント、ドライバー、ライブラリ、またはサードパーティアプリケーションの構成

クライアント、ドライバー、ライブラリ、またはサードパーティアプリケーションが Snowflake に接続するように構成するには、Snowflake アカウント識別子を指定する必要があります。さらに、使用するウェアハウス、データベース、スキーマ、ロールを指定する必要があるかもしれません。

この情報は Snowsight、または SQL コマンドを実行することで見つけることができます：

Snowsight を使用して接続設定を取得します。

クライアント、ドライバー、ライブラリ、またはサードパーティ製アプリケーションの構成に使用できるセットを取得します。

  1. Snowsight に サインイン する。

  2. ユーザー名を選択し、ユーザーメニューを開きます。

    アカウントメニュー

  3. ユーザーメニューから、 Connect a tool to Snowflake を選択し、 Account Details ダイアログを表示します。

    Tip

    アカウントの詳細は、 アカウントセレクター からも表示できます。

  4. 以下のタブのいずれかを選択します。

    • クライアント、ドライバー、ライブラリ、またはサードパーティアプリケーションが TOML 構成ファイルの使用をサポートしている場合 (たとえば、 Snowflake CLI、 Snowflake Python APIs、または Snowflake Connector for Python:

      1. Config file タブを選択します。

      2. 構成ファイルでウェアハウスを指定するには、 Warehouse メニューからウェアハウスを選択します。

      3. 構成ファイルでデータベースとスキーマを指定するには、 Database メニューを使用してデータベースとスキーマを選択します。

      4. Connection Method メニューから、認証コードに使用する方法を選択します。

        注釈

        クライアント、ドライバー、ライブラリ、およびサードパーティアプリケーションは、メニューにリストされていない認証方法もサポートしています。詳細については、 Snowflakeのセキュリティ保護 をご参照ください。

      5. コピーアイコン (支援技術の場合はコピーボタン。) を選択して、構成ファイルの内容をコピーします。

      注釈

      Snowflake Python APIs では、 account の設定でアンダースコアはサポートされていません。アカウント識別子にアンダースコアが含まれている場合は、ダッシュに置き換えてください。

    • クライアント、ドライバ、ライブラリ、またはサードパーティアプリケーションが接続文字列の指定をサポートしている場合 (例えば、 ODBC Driver, JDBC Driver, Go Snowflake Driver, または .NET ドライバー):

      1. Connectors/Drivers タブを選択します。

      2. Select Connector or Driver メニューから、使用するドライバーを選択します。

      3. 接続文字列でウェアハウスを指定するには、 Warehouse メニューからウェアハウスを選択します。(このメニューは ODBC と.NET にはありません。)

      4. 接続文字列でデータベースとスキーマを指定するには、 Database メニューを使用してデータベースとスキーマを選択します。

      5. Connection Method メニューから、認証コードに使用する方法を選択します。

        注釈

        クライアント、ドライバー、ライブラリ、およびサードパーティアプリケーションは、メニューにリストされていない認証方法もサポートしています。詳細については、 Snowflakeのセキュリティ保護 をご参照ください。

      6. コピーアイコン (支援技術の場合はコピーボタン。) を選択し、結果の接続文字列をコピーします。

    • SQL コマンドを実行して構成情報を取得します。

      1. SQL Commands タブを選択します。

      2. 必要な情報を提供するコマンドの横にあるコピーアイコン (支援技術の場合はコピーボタン。) を選択し、コマンドをワークシートに貼り付け、コマンドを実行します。

SQL コマンドによる接続設定の取得

SQL コマンドを実行すると、クライアント、ドライバー、ライブラリ、またはアプリケーションの構成に必要な以下の情報を取得できます。

設定

SQL コマンド

現在のアカウントのアカウント識別子

  • organization_name-account_name 形式のアカウント識別子を取得します。

    SELECT CURRENT_ORGANIZATION_NAME() || '-' || CURRENT_ACCOUNT_NAME();
    Copy

  • アカウント識別子の アカウントロケーター 形式を取得します。

    SELECT CURRENT_ACCOUNT();
    Copy

現在のユーザー名

 
SELECT CURRENT_USER();
Copy

現在のロール

 
SELECT CURRENT_ROLE();
Copy

現在のリージョン

 
SELECT CURRENT_REGION();
Copy

現在のウェアハウス

 
SELECT CURRENT_WAREHOUSE();
Copy

現在のデータベース

 
SELECT CURRENT_DATABASE();
Copy

現在のスキーマ

 
SELECT CURRENT_SCHEMA();
Copy

クライアントとドライバーが使用するアカウント形式

クライアントやドライバーによって、アカウントを指定する構文が異なります。

一般的に、組織名 (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データベースへの接続 を参照してください。

SQLAlchemy:

  • アカウント名: snowflake://user_login_name:password@orgname-account_name

  • アカウントロケーター: snowflake://user_login_name:password@account_locator_with_additional_segments

詳細については、 Snowflake SQLAlchemy ツールキットでのPythonコネクタの使用 をご参照ください。

追加の構成ステップ

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

言語: 日本語