Snowflake接続を作成する
ゼロコピーコネクタハブ で外部Snowflakeアカウントへのゼロコピー接続を確立します。
始める前に
テーブル統計を有効にすることで、Snowflakeへのクエリを最適化できます。ゼロコピーコネクタハブでこのオプションを有効にする前に、データソースアドミンに問い合わせて、Snowflakeでテーブル統計が有効になっているかどうかを確認してください。
必要なロール:df_connection_admin
このタスクについて
データソースアドミンと協力して、Snowflakeへの接続を作成します。Snowflakeへの接続の詳細については、 Snowflakeドキュメント.
手順
-
次のいずれかの方法で、 ゼロコピーコネクタハブ で使用可能なプライマリコネクタに移動します。
- 移動先 すべて > ゼロコピーコネクタハブ > 利用可能なコネクタ > プライマリコネクタ.
- 移動先 アドミン > ゼロコピーコネクタハブ > 利用可能なコネクタ > プライマリコネクタ.
- Snowflake コネクタを見つけて、 接続 を選択します。
-
フォームで、フィールドに入力します。
表 : 1. 新しい Snowflake 接続フォーム フィールド 説明 名前と説明 接続ラベル この接続の一意の名前。これは、システム内の接続を識別するのに役立ちます。 接続名 接続ラベルに基づいてシステムによって生成された名前。接続が確立されると、このフィールドは変更できません。 簡単な説明 接続の内容を説明する接続の説明。 接続属性 接続 URL 接続を確立するための JDBC URL。たとえば、次のようになります。 jdbc:snowflake://<account>.snowflakecomputing.com
データベース 接続先のデータベースの名前。 倉庫 接続先の倉庫の名前。 テーブル統計情報を有効にする テーブルの統計情報を有効にするオプション。 このオプションを選択すると、テーブル統計情報を使用して SQL クエリーが最適化されます。テーブル統計情報を有効にすると、行数、個別の値、データ サイズなどの保存されたデータの推定を使用して、クエリ処理を強化できます。
注:このオプションを選択する前に、データソースでテーブル統計情報の収集が有効になっていることを確認する必要があります。 -
Snowflake で使用する認証方法を設定します。
オプション 説明 JWT キーペア認証を使用するオプション。
- 次のいずれかのオプションを使用して秘密鍵を添付します。
- [ PEM ファイルを添付 ] を選択し、ファイルを選択して秘密鍵ファイルをアップロードします。
- PEM ファイルのコンテンツをコピーして貼り付け、コンテンツが次のように始まるようにします。
そして、次のように終わります。-----BEGIN PRIVATE KEY----------END PRIVATE KEY-----
- Snowflake に接続するための接続ユーザーを入力します。
- 秘密鍵がパスワードで保護されている場合は、パスフレーズを入力します。
- Snowflake 内の権限を決定するロールを入力します。
OAuth OAuth 認証を使用するオプション。
使用する OAuth 認証情報タイプを選択します。
- クライアント認証情報
ID プロバイダーから直接 OAuth 認証情報を入力するには、このオプションを選択します。
- OAuth ID プロバイダーからのクライアント ID を入力します。
- OAuth ID プロバイダーからのクライアントシークレットを入力します。
- OAuth ID プロバイダーからのトークン要求 URL を入力します。
- OAuth ID プロバイダーからスコープを入力します。
- アクセストークン
認証用の Snowflake または IdP サービスプリンシパルを使用してアプリケーションレジストリ [oauth_entity] テーブルにレコードを作成した場合は、このオプションを選択します。
このオプションは、認証情報をインスタンス内に保持し、トークンのライフサイクル管理に ServiceNow AI Platform OAuth フレームワークを使用します。OAuth エンティティプロファイルの作成の詳細については、「 Use a third-party OAuth provider」を参照してください。プロファイルを設定するときは、権限許可タイプとして [クライアント認証情報 ] を選択します。OAuth プロバイダーにスコープが必要な場合は、[OAuth エンティティスコープ] タブで追加します。必要なスコープ値については、データソースまたは ID プロバイダーのドキュメントを参照してください。
Snowflake または IdP サービスプリンシパルの OAuth エンティティプロファイルを選択します。
- 次のいずれかのオプションを使用して秘密鍵を添付します。
- [Connect (接続)] を選択します。
タスクの結果
外部データソースへのテスト接続が確立され、接続の詳細が正しいことと、データソースにアクセスできることが確認されます。
次のタスク
接続が成功した場合は、[ アクセス制御 ] タブでデータスチュワードアクセスを構成します。「ロールを使用した確立された接続へのアクセスの管理」を参照してください。
接続に失敗した場合は、データソースアドミニストレーターと接続の詳細を確認して、再試行してください。