Snowflake

​

前提条件

​

CData IP をホワイトリストに登録

Snowflake への接続を確立するには、CData のIP 経由でSnowflake へのアクセスを許可する必要があります。Snowflake をファイアウォールの内側でホスティングする場合は、これらのIP アドレスをファイアウォールの許可リストに登録する必要があります。

• 範囲：52.224.0.160～52.224.0.175 および4.154.117.160～4.154.117.175
• CIDR 表記：52.224.0.160/28 および4.154.117.160/28

​

Snowflake が一般にアクセス可能であることを確認

パブリックフェイシングIP / ドメインを指定して、このデータソースに接続します。次のプライベートIP の範囲は機能しません。

• 10.0.0.0 to 10.255.255.255
• 172.16.0.0 to 172.31.255.255
• 192.168.0.0 to 192.168.255.255
• 127.0.0.1 (aka ‘localhost’)

​

セットアップガイド

以下の手順で、Snowflake をConnect AI アカウントに接続します。

1. Connect AI のダッシュボードからConnections ページを開きます。

2. 右上の + Add Connection をクリックします。

3. 検索フィールドに Snowflake と入力し、データソース名をクリックします。

4. 新しいコネクションのBasic Settings タブで、コネクション名を入力するかデフォルトの名前をそのまま使用します。

5. Enter the Snowflake Warehouse.

6. Enter the URL of the Snowflake database. Snowflake supports URLs in either the account name or connection name format.

   • To use the account name, refer to Finding the organization and account name for an account in the Snowflake documentation.
   • To use the connection name, use the SHOW CONNECTIONS command. The URL format depends on how you are connecting. Refer to the Connecting with a URL in the Snowflake documentation for help in entering the URL correctly. The following are a few examples of formatting the URL:
   • Standard URL with account name: https://<orgname>-<account_name>.snowflakecomputing.com.
   • Standard URL with connection name: https://<orgname>-<connectionname>.snowflakecomputing.com.
   • Okta SSO: https://<orgname>-<account-name>.snowflakecomputing.com (if your account name contains an underscore, change the underscore to a hyphen).
7. Select the Authentication method, then proceed to the relevant section and follow those instructions.

8. Under Data Credentials, determine if you want to allow shared credentials or to require users to use their own credentials.

​

Authentication Methods

OAuth

1. In the User field, enter your Snowflake user name.

2. The Callback URL, or Redirect URL, is the URL you need (https://oauth.cdata.com/oauth/) when setting up your OAuth app. Copy this URL and paste it into your OAuth app.

3. Enter the OAuth Client Id assigned when you registered your Snowflake account.

4. Enter the OAuth Client Secret for your Snowflake account for OAuth.

5. Select the OAuth Authenticator that the OAuth application requests from Snowflake. If there is no authenticator, use the default None.

6. (Optional) Enter the Snowflake Database and Schema. Selecting a schema may improve performance for some applications.

7. OAuth でセキュアに接続するには、Sign in をクリックします。これにより、Snowflake のサインインページが新しいタブで開かれます。

8. Snowflake アカウントにログインし、リクエストされた権限を設定します（該当する場合）。

9. Connect AI Connection ページ上部の、Save & Test をクリックします。

   • 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
   • 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
   • 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。

Password

Important: Any new Snowflake account starting with bundle “2024_08” will no longer support Password authentication. Please use other authentication methods, such as OAuth or Private Key.

1. Enter your user name in the User field and password in the Password field.

2. In the Database section, enter the name of the Snowflake database to connect to.

3. (Optional) Enter the schemas of the Snowflake database to connect to. If this is left blank, the connector has access to all schemas in the database.

4. Connect AI Connection ページ上部の、Save & Test をクリックします。

   • 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
   • 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
   • 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
5. Snowflake で、Connect AI 静的IP アドレスを接続のホワイトリストに追加します。

Private Key

Follow these steps to configure private key authentication:

1. Open your Snowflake keyfile (which ends in .p8) in a text editor.

2. Copy the entire contents of the file.

3. Enter the copied contents of your private key into the Private Key field.

4. If your private key has a password, enter it in the Private Key Password field.

5. Select the correct Private Key Type from the drop down.

6. In the Database section, enter the name of the Snowflake database to connect to.

7. (Optional) Enter the schemas of the Snowflake database to connect to. If this is left blank, the connector has access to all schemas in the database.

8. Connect AI Connection ページ上部の、Save & Test をクリックします。

   • 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
   • 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
   • 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
9. Snowflake で、Connect AI 静的IP アドレスを接続のホワイトリストに追加します。

Okta

1. Enter the following information:

   • User— The Okta user account.
   • Password— The password associated with the Okta account.
   • MFA Passcode— Set this to the OTP code that was sent to your device. This property should be used only when Multi-Factor Authentication is required for Okta sign on.
   • SSO Properties— are needed to authenticate to Okta:
     • Domain: Set this to the OKTA org domain name.
     • MFAType (optional): Set this to the multi-factor type. This property should be used only when the MFA is required for Okta sign on. This property accepts one of the following values:
       • OKTAVerify
       • Email
       • SMS
     • APIToken (optional): Set this to the API Token created by Okta. This is used when authenticating a user via a trusted application or proxy that overrides the Okta client request context.
2. In the Database section, enter the name of the Snowflake database to connect to.

3. (Optional) Enter the schemas of the Snowflake database to connect to. If this is left blank, the connector has access to all schemas in the database.

4. Connect AI Connection ページ上部の、Save & Test をクリックします。

   • 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
   • 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
   • 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
5. Snowflake で、Connect AI 静的IP アドレスを接続のホワイトリストに追加します。

PingFederate

1. In the User field, enter 認証用のSnowflake ユーザー名.

2. In the Password field, enter ユーザーパスワード.

3. (Optional) Enter the Proof Key. You must specify this if you want to connect to PingFederate without using a browser.

4. (Optional) Enter the External Token. You must specify this if you want to connect to PingFederate without using a browser. For more information about the Proof Key and External Token, follow the steps here.

5. (Optional) Enter the Database and Schema. Selecting a schema may improve performance for some applications.

6. Connect AI Connection ページ上部の、Save & Test をクリックします。

   • 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
   • 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
   • 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。

​

詳細について

Connect AI とSnowflake の連携の詳細動作については、こちらのページを参照してください。