スノーフレーク・コネクター

Snowflakeから情報を照会してTulipアプリで使用する

Snowflakeコネクタは、Snowflake Data Cloudから情報をクエリする方法を効率化します。Snowflake SQL REST APIのドキュメントはこちらをご覧ください。

サポート窓口

このコネクタはSpaulding Ridgeとのコラボレーションによって作成されました。詳細やご質問については、info@spauldingridge.com までお問い合わせください。

コネクタの注意事項

Snowflake コネクタは単一レコードを比較的簡単に操作できます。複数行のデータを照会したり、Tulip の出力（対話型テーブルなど）を操作したりするには、カスタムウィジェットが必要になる場合があります。

Snowflake OAuthはSnowflakeの組み込みOAuthサービスを使用し、カスタムクライアントとしてTulipをサポートします。Snowflake OAuthのドキュメントはこちらにあります。カスタムクライアント設定の詳細はこちらをご覧ください。

セットアップ

このセクションでは、クライアントとしてTulipとの接続を確立するために、SnowflakeのOAuthサーバからOAuthトークンを設定する手順と、TulipでSnowflakeコネクタを設定する手順を説明します。

SnowflakeにクライアントアプリケーションとしてTulipを登録する

1. Security Integrationsを作成および管理するロール/権限を持つユーザー（ACCOUNTADMIN）でSnowflakeインスタンスにログインします。
2. COMPUTE_WH ウェアハウスに新しい SQL ワークシートを作成します。
3. 以下のスクリプトを実行して、OAuth タイプのセキュリティ統合を作成します。INTEGRATION_NAME、TULIP_INSTANCE_NAME、TIME_IN_SECONDS の値を更新することを忘れないでください。

Create or replace security integration <integration_name>type = oauthenabled = trueoauth_client = customoauth_client_type = 'confidential'oauth_redirect_uri = 'https://<tulip_instance_name>.tulip.co/oauth-redirect-handler'OAUTH_ISSUE_REFRESH_TOKENS = TRUEOAUTH_ISSUE_REFRESH_TOKEN_VALIDITY = <TIME_IN_SECONDS>；

注：リフレッシュ・トークンの有効期限は、1日（86400秒）まで可能です。

TulipでOAuth設定の詳細を収集する

1. 次のコマンドを実行して、作成したばかりのセキュリティ統合について説明します。 ；
2. OAUTH_CLIENT_IDOUTH_REDIRECT_URIOUTH_AUTHORIZATION_ENDPOINTAUTH_TOKEN_ENDPOINT。
3. 実行:SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('<INTEGRATION_NAME>')；

例えば、tulip_intergationではなく、TULIP_INTEGRATIONです。

1. OAUTH_CLIENT_SECRETを記述します。

Snowflakeコネクタを設定する

1. Tulipにログインし、TulipライブラリからSnowflakeコネクタをここに追加します（Webまたは埋め込み）。
2. 本番環境にクリックします。
3. 以下の設定を行います：

Running On：Cloud Connector HostServerアドレス：あなたのスノーフレークアカウントサーバのURL形式.snowflakecomputing.comBase path: api/v2AuthenticationSelect either service or user OAuthAuthorization code URL - OAUTH_AUTHORIZATION_ENDPOINT from step 2Access token URL - OAUTH_TOKEN_ENDPOINT from step 2Client ID - OAUTH_CLIENT_ID from step 2Client Secret - OAUTH_CLIENT_SECRET from step 2Select check boxes forSend authentication headerEncode client ID during authentication.

1. Testをクリックします。Snowflakeアカウントのログインウィンドウが表示されます。

ユーザーがログインする必要があります。デフォルトのロールがACCOUNTADMIN、SECURITYADMIN、またはORGADMINであってはならないことに注意してください。このSnowflakeリソースで詳しく説明されているように、OAuthのためにユーザのデフォルトのロールを変更することができます：詳しくは、Snowflakeリソース：OAuthのユーザー同意の管理 を参照してください。

1. 認証に成功すると、同意を求めるメッセージが表示されます。それをよく読んで、実行される操作を理解し、Allowをクリックしてください。

これでTulipからSnowflakeに安全に接続できるようになりました！

利用方法

コネクタを使い始めるには2つの方法があります：

まず、コネクタテンプレートの関数を特定の要件に合わせてカスタマイズします。

TulipのSnowflakeテーブルからすべてのテーブルレコードを取得する、新しいレコードを作成する、既存のレコードを更新する、レコードを削除する、などのタスクでコネクタを使用する方法を実践的に示すSnowflakeユニットテストの手順に従ってください。

テンプレート関数

Library コネクタには以下のテンプレート関数があります：クエリ・データベースDescription：1つ以上の SQL 文を送信して実行できるようにします：メソッド： POSTEエンドポイント：/api/v2/statements参照：https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statementsTemplate：クエリステータスの確認説明ステートメントの実行ステータスを確認できます：GETエンドポイント：メソッド：GETエンドポイント：/api/v2/statements/{statementHandle}参照：https://docs.snowflake.com/en/developer-guide/sql-api/reference#get-api-v2-statements-statementhandleTemplate：クエリのキャンセルステートメントの実行をキャンセルできます：POSTエンドポイント：/api/v2/statements/{statementHandle}/cancelReference: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statements-statementhandle-cancel

その他のリファレンス

この Snowflake Community ガイドでは、Snowflake 統合に関する追加情報を提供しています。