Snowflake (プレビュー)

Snowflake は、従来の製品よりも高速で使いやすく、柔軟性の高いデータ ストレージ、処理、および分析ソリューションを実現します。

このコネクタは、次の製品および地域で利用可能です:

Snowflake

Snowflake は、従来の製品よりも高速で使いやすく、柔軟性の高いデータ ストレージ、処理、および分析ソリューションを実現します。

このコネクタは、次の製品および地域で利用可能です:

Snowflake コネクタは、Snowflake SQL REST API に基づいています。 Snowflake は、従来の製品よりも高速で使いやすく、柔軟性の高いデータ ストレージ、処理、および分析ソリューションを実現します。 コネクタは、Snowflake REST API V2 を使用して、同期および非同期クエリを送信し、対応する結果を取得します。

前提条件

• ユーザーは、外部認証の Microsoft Entra ID を持っていなければいけません。
• ユーザーは Premium Power Apps ライセンスを持っている必要があります。
• ユーザーは Snowflake アカウントを持っている必要があります。

資格情報を取得する方法

以下の手順で Snowflake の Azure AD 認証を設定します。

1. ステップ 1: Azure AD で OAuth リソースを構成する で、手順 1～10 に従い、説明書 の手順でスコープを SESSION:ROLE-ANY として定義します。
2. 手順 2: Azure AD で OAuth クライアントを作成する で、手順 1 から 13に従います。
3. 認証 -> プラットフォームの構成 -> プラットフォームの追加 -> 追加 "https://global.consent.azure-apim.net/redirect" -> クリック 保存 の順に移動します。 リダイレクト URL が Snowflake OAuth リソースではなく Snowflake OAuth クライアントに設定されていることを確認してください。
4. ステップ 1 で作成したリソースに移動し、API を公開する -> クライアント アプリケーションを追加する -> 追加 上記の手順 3 で取得したAPPLICATION_CLIENT_ID -> クリック 保存 に移動します
5. 手順 3: Snowflake の Azure AD 情報を収集する に従います。
6. すでに Snowflake 認定コネクタを使用して接続を確立している場合は、セクション Snowflake の既存のセキュリティ統合を更新する の手順に従ってください。 新しい接続を確立する場合は、セクション Snowflake に新しいセキュリティ統合を作成する の手順に従ってください。 クエリを実行する前に、ロールが ACCOUNTADMIN に設定されていることを確認してください。

Snowflake で新しいセキュリティ統合を作成する

1. Microsoft Azure で、Snowflake OAuth リソースアプリに移動し、エンドポイント をクリックします。

2. 5 行目の AZURE_AD_ISSUER を取得するには、フェデレーションメタデータドキュメント フィールドに入力し、新しいタブでリンクを開きます。https://sts.windows.net/90288a9b-97df-4c6d-b025-95713f21cef9/ のようなエンティティIDリンクをコピーします。 これをクエリに貼り付け、最後の引用符の前に / があることと、引用符が残っていることを確認します。

3. 6 行目のキー URL を取得するには、OpenID Connect メタデータドキュメント フィールドに入力し、新しいタブでリンクを開きます。https://login.microsoftonline.com/90288a9b-97df-4c6d-b025-95713f21cef9/discovery/v2.0/keys のように見える jwks_uri をコピーします。 これをクエリに貼り付け、引用符を必ず保持してください。

4. ステップ 1 から、7 行目の対象者リスト URL を アプリケーション ID URI で置き換えます。 引用符はそのままにしておきます。

5. Snowflake アカウントが Microsoft Azure アカウントの場合は、9 行目の login_name を email_address に置き換えます。 そうでない場合は、ログイン名を入力せずにそのままにしておきます。 引用符はそのままにしておきます。

CREATE SECURITY INTEGRATION <integration name>
type = external_oauth
enabled = true
external_oauth_type = azure
external_oauth_issuer = '<AZURE_AD_ISSUER>'     
external_oauth_jws_keys_url = '<Keys URL from section "How to get your credentials:step 6">'
 external_oauth_audience_list = ('<Application ID URI from registered resource app in Azure>')
external_oauth_token_user_mapping_claim = 'upn'
external_oauth_snowflake_user_mapping_attribute = 'login_name'
external_oauth_any_role_mode = 'ENABLE';

Snowflake で既存のセキュリティ統合を更新する

ALTER SECURITY INTEGRATION  <existing integration name>
set external_oauth_audience_list = ('<existing power bi audience list url>', '< Application ID URI from Step 1>')

資格情報を使用する

Power Platform で接続を作成するときは、以下のスナップショットに示す資格情報を使用します。

1. クライアント ID: Azure に登録されたクライアント アプリからの Snowflake OAuth クライアント ID
2. クライアント シークレット: Azure に登録されたクライアント アプリからの Snowflake OAuth クライアント シークレット
3. リソース URL: Azure に登録されたリソース アプリのアプリケーション ID URI

コネクタの使用を開始する

• 実行用に SQL ステートメントを送信する
• 状態を確認して結果を取得する
• ステートメントの実行をキャンセルする

既知の問題と制限事項

• "インスタンス URL" エラーがある場合は、アカウント識別子 ドキュメントを参照してください。
• コネクタは、大量のクエリ結果が原因でタイムアウトになる場合があります。
• Snowflake SQL API の制限。

スロットリング制限

Actions

ステートメントの実行をキャンセルする

操作 ID: キャンセル

ステートメントの実行をキャンセルする

Parameters

返品

状態を確認して結果を取得する

操作 ID: GetResults

ステートメントの実行状態を確認し、結果を取得します。 結果を取得する際、最初のパーティションは常にデータとともにスキーマを返し、それ以降のパーティションは結果セット アクションを使用して変換する必要がある可能性のあるデータのみを返します。

Parameters

返品

結果セットの行を配列からオブジェクトに変換する

操作 ID: 変換

結果セットの行を配列からオブジェクトに変換する

Parameters

返品

実行用に SQL ステートメントを送信する

操作 ID: ExecuteSqlStatement

実行用に SQL ステートメントを送信する

Parameters

返品

よくあるご質問

1. 応答とパーティションをどのように処理しますか?
   Snowflake SQL API ドキュメント こちら を参照してください
2. パーティション 1 以上をどのように処理しますか?
   コネクタの "結果セットの行を配列からオブジェクトに変換する" アクションを使用してデータを変換します。

接続を作成する

このコネクタは、次の認証タイプをサポートしています:

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

調整制限

アクション

ステートメントの実行をキャンセルする

実行用に SQL ステートメントを送信する

状態を確認して結果を取得する

結果セットの行を配列からオブジェクトに変換する