Snowflake (プレビュー)

リファレンス

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

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

サービス	クラス	地域
Logic Apps	標準	以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD)
Power Automate	プレミアム	以下を除くすべての Power Automate 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD)
Power Apps	プレミアム	以下を除くすべての Power Apps 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD)

お問い合わせ先
件名	Snowflake
[URL]	https://www.snowflake.com/support
メール	support@snowflake.com

Connector Metadata
発行者	Snowflake Inc.
Web サイト	https://www.snowflake.com
プライバシーポリシー	https://www.snowflake.com/privacy-policy
カテゴリー	日付

Snowflake

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

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

サービス	クラス	地域
Logic Apps	基準	以下を除くすべての Logic Apps 地域 : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD)
Power Automate	Premium	以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国クラウド - 米国国防総省 (DoD)
Power Apps	Premium	以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国クラウド - 米国国防総省 (DoD)

お問い合わせ先
件名	Snowflake
[URL]	https://www.snowflake.com/support
メール	support@snowflake.com

Connector Metadata
発行者	Snowflake Inc.
Web サイト	https://www.snowflake.com
プライバシーポリシー	https://www.snowflake.com/privacy-policy
カテゴリー	日付

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

前提条件

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

資格情報を取得する方法

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

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

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

Microsoft Azure で、Snowflake OAuth リソースアプリに移動し、エンドポイント をクリックします。
5 行目の AZURE_AD_ISSUER を取得するには、フェデレーションメタデータドキュメント フィールドに入力し、新しいタブでリンクを開きます。https://sts.windows.net/90288a9b-97df-4c6d-b025-95713f21cef9/ のようなエンティティIDリンクをコピーします。これをクエリに貼り付け、最後の引用符の前に / があることと、引用符が残っていることを確認します。
6 行目のキー URL を取得するには、OpenID Connect メタデータドキュメント フィールドに入力し、新しいタブでリンクを開きます。https://login.microsoftonline.com/90288a9b-97df-4c6d-b025-95713f21cef9/discovery/v2.0/keys のように見える jwks_uri をコピーします。これをクエリに貼り付け、引用符を必ず保持してください。
ステップ 1 から、7 行目の対象者リスト URL を アプリケーション ID URI で置き換えます。引用符はそのままにしておきます。
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 で接続を作成するときは、以下のスナップショットに示す資格情報を使用します。

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

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

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

既知の問題と制限事項

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

スロットリング制限

件名	呼び出し	更新期間
接続ごとの API 呼び出し	100	60 秒

Actions

Action	プロパティ
ステートメントの実行をキャンセルする	ステートメントの実行をキャンセルする
状態を確認して結果を取得する	ステートメントの実行状態を確認し、結果を取得する
結果セットの行を配列からオブジェクトに変換する	結果セットの行を配列からオブジェクトに変換する
実行用に SQL ステートメントを送信する	実行用に SQL ステートメントを送信する

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

操作 ID: キャンセル

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

Parameters

件名	Key	必須	タイプ	説明設定
Instance	インスタンス	True	String	Snowflake インスタンスの URI (https:// なし)
ステートメントハンドル	statementHandle	True	String	ステートメントハンドル
要求 ID	requestId		String	要求 ID

返品

件名	パス	タイプ	説明設定
コード	コード	String	コード
sqlState	sqlState	String	sqlState
Message	Message	String	Message
statementHandle	statementHandle	String	statementHandle
statementStatusUrl	statementStatusUrl	String	statementStatusUrl

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

操作 ID: GetResults

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

Parameters

件名	Key	必須	タイプ	説明設定
Instance	インスタンス	True	String	Snowflake インスタンスの URL
ステートメントハンドル	statementHandle	True	String	ステートメントハンドル
要求 ID	requestId		String	要求 ID
パーティション	パーティション		整数	パーティション

返品

件名	パス	タイプ	説明設定
コード	メタデータコード	String
SqlState	Metadata.SqlState	String
行	Metadata.Rows	整数	行の合計数
StatementHandle	Metadata.StatementHandle	String
CreatedOn	Metadata.CreatedOn	整数	ステートメントの実行開始時を特定するタイムスタンプ。タイムスタンプは、エポックからのミリ秒単位で表されます
StatementStatusUrl	Metadata.StatementStatusUrl	String
フォーマット	Metadata.Format	string	v2 エンドポイントの場合、このフィールドに指定できる値は jsonv2 のみです。
Partitions	Partitions	オブジェクトの配列	パーティション情報
RowCount	Partitions.RowCount	整数	パーティションが含む行数。
CompressedSize	Partitions.CompressedSize	整数	圧縮解除前のパーティションサイズ。これはパーティション内に存在する場合と存在しない場合があります。非圧縮サイズは常に存在することになります。
UncompressedSize	Partitions.UncompressedSize	整数	圧縮解除後のパーティションサイズ
日付	日付	配列の配列	結果のデータセット。
スキーマ	Schema	文字列の配列	結果セットのスキーマ

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

操作 ID: 変換

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

Parameters

件名	Key	必須	タイプ	説明設定
スキーマ	Schema		string
日付	日付		string

返品

件名	パス	タイプ	説明設定
日付	日付	オブジェクトの配列	結果のデータセット。
スキーマ	Schema	オブジェクトの配列	結果セットのスキーマ

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

操作 ID: ExecuteSqlStatement

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

Parameters

件名	Key	必須	タイプ	説明設定
Instance	インスタンス	True	string	Snowflake インスタンスの URL
要求 ID	requestId		string	要求の ID
非同期	非同期		ブール値	クエリを非同期で実行する必要があるかどうかを示します
Nullable	Nullable		ブール値	nullable が false の場合、null 値は文字列に置き換えられます
ステートメント	ステートメント		string	実行する SQL ステートメント - ステートメントのバッチはまだサポートされていません
タイムアウト	タイムアウト		整数	タイムアウトが発生するまでの秒数
データベース	データベース		string	データベース
スキーマ	スキーマ		string	Schema
倉庫	倉庫		string	倉庫
役割	役割		string	役割
タイムゾーン	タイムゾーン		string	ステートメントの実行時に使用するタイムゾーン。
クエリタグ	query_tag		string	SQL ステートメントに関連付けるクエリタグ。
バイナリの出力形式	binary_output_format		string	バイナリ値の出力形式。
日付の出力形式	date_output_format		string	日付値の出力形式。
時刻の出力形式	time_output_format		string	時刻値の出力形式。
タイムスタンプの出力形式	timestamp_output_format		string	タイムスタンプ値の出力形式。
タイムスタンプ ltz の出力形式	timestamp_ltz_output_format		string	TIMESTAMP_LTZ 値の出力形式。
timestamp_ntz_output_format	timestamp_ntz_output_format		string	TIMESTAMP_NTZ 値の出力形式。
タイムスタンプ tz の出力形式	timestamp_tz_output_format		string	TIMESTAMP_TZ 値の出力形式。
*複数ステートメント数*	multi_statement_count		integer	マルチステートメント機能を使用するときに実行するステートメントの数。0 は可変数のステートメントを意味します。負の数は許可されません。

返品

件名	パス	タイプ	説明設定
コード	メタデータコード	String
SqlState	Metadata.SqlState	String
StatementHandle	Metadata.StatementHandle	String
CreatedOn	Metadata.CreatedOn	整数	ステートメントの実行開始時を特定するタイムスタンプ。タイムスタンプは、エポックからのミリ秒単位で表されます
StatementStatusUrl	Metadata.StatementStatusUrl	String
フォーマット	Metadata.Format	String	v2 エンドポイントの場合、このフィールドに指定できる値は jsonv2 のみです。
Partitions	Partitions	オブジェクトの配列	パーティション情報
RowCount	Partitions.RowCount	整数	パーティションが含む行数。
CompressedSize	Partitions.CompressedSize	整数	圧縮解除前のパーティションサイズ。これは、partitionInfo に存在する場合と存在しない場合があります。非圧縮サイズは常に存在することになります。
UncompressedSize	Partitions.UncompressedSize	整数	圧縮解除後のパーティションサイズ
日付	日付	配列の配列	結果のデータセット。
スキーマ	Schema	文字列の配列	結果セットのスキーマ

よくあるご質問

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

接続を作成する

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


既定	接続を作成するためのパラメーター。	すべての地域	共有不可

既定

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

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

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

件名	タイプ	プロパティ	Required
Client ID	string	Snowflake OAuth のクライアント ID	True
Client Secret	securestring	Snowflake OAuth のクライアントシークレット	True
リソース URL	string	Snowflake OAuth 対象者用 URL (リソースの URL)	True

調整制限

名前	呼び出し	更新期間
接続ごとの API 呼び出し	100	60 秒

アクション

ステートメントの実行をキャンセルする	ステートメントの実行をキャンセルする
実行用に SQL ステートメントを送信する	実行用に SQL ステートメントを送信する
状態を確認して結果を取得する	ステートメントの実行状態を確認し、結果を取得する
結果セットの行を配列からオブジェクトに変換する	結果セットの行を配列からオブジェクトに変換する

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

操作 ID:: Cancel

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

パラメーター

名前	キー	必須	型	説明
インスタンス	Instance	True	string	Snowflake インスタンスの URI (https:// なし)
ステートメントハンドル	statementHandle	True	string	ステートメントハンドル
要求 ID	requestId		string	要求 ID

戻り値

名前	パス	型	説明
code	code	string	code
sqlState	sqlState	string	sqlState
message	message	string	message
statementHandle	statementHandle	string	statementHandle
statementStatusUrl	statementStatusUrl	string	statementStatusUrl

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

操作 ID:: ExecuteSqlStatement

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

パラメーター

名前	キー	必須	型	説明
インスタンス	Instance	True	string	Snowflake インスタンスの URI (https:// なし)
要求 ID	requestId		string	要求の ID
非同期	async		boolean	クエリを非同期で実行する必要があるかどうかを示します
nullable	nullable		boolean	nullable が false の場合、null 値は文字列に置き換えられます
statement	statement		string	実行する SQL ステートメント - ステートメントのバッチはまだサポートされていません
タイムアウト	timeout		integer	タイムアウトが発生するまでの秒数
データベース	database		string	データベース
スキーマ	schema		string	スキーマ
倉庫	warehouse		string	倉庫
role	role		string	role
タイムゾーン	timezone		string	ステートメントの実行時に使用するタイムゾーン。
クエリタグ	query_tag		string	SQL ステートメントに関連付けるクエリタグ。
バイナリの出力形式	binary_output_format		string	バイナリ値の出力形式。
日付の出力形式	date_output_format		string	日付値の出力形式。
時刻の出力形式	time_output_format		string	時刻値の出力形式。
タイムスタンプの出力形式	timestamp_output_format		string	タイムスタンプ値の出力形式。
タイムスタンプ ltz の出力形式	timestamp_ltz_output_format		string	TIMESTAMP_LTZ 値の出力形式。
timestamp_ntz_output_format	timestamp_ntz_output_format		string	TIMESTAMP_NTZ 値の出力形式。
タイムスタンプ tz の出力形式	timestamp_tz_output_format		string	TIMESTAMP_TZ 値の出力形式。
複数ステートメント数	multi_statement_count		integer	複数ステートメント機能の使用時に実行するステートメントの数。 0 はステートメントの変数を意味します。負の数は使用できません。

戻り値

名前	パス	型	説明
Partitions	Partitions	array of object	Partitions
RowCount	Partitions.RowCount	integer	RowCount
UncompressedSize	Partitions.UncompressedSize	integer	UncompressedSize
CompressedSize	Partitions.CompressedSize	integer	CompressedSize
Schema	Schema	array of object	Schema
名称	Schema.name	string	名称
データベース	Schema.database	string	データベース
スキーマ	Schema.schema	string	スキーマ
テーブル	Schema.table	string	テーブル
nullable	Schema.nullable	boolean	nullable
プレシジョン	Schema.precision	integer	プレシジョン
スケール	Schema.scale	integer	スケール
byteLength	Schema.byteLength	integer	byteLength
照合順序	Schema.collation	string	照合順序
length	Schema.length	integer	length
タイプ	Schema.type	string	タイプ
日付	Data	array of	日付
行	Metadata.Rows	integer	行
Format	Metadata.Format	string	Format
コード	Metadata.Code	string	コード
StatementStatusUrl	Metadata.StatementStatusUrl	string	StatementStatusUrl
RequestId	Metadata.RequestId	string	RequestId
SqlState	Metadata.SqlState	string	SqlState
StatementHandle	Metadata.StatementHandle	string	StatementHandle
CreatedOn	Metadata.CreatedOn	string	CreatedOn

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

操作 ID:: GetResults

ステートメントの実行状態を確認し、結果を取得する

パラメーター

名前	キー	必須	型	説明
インスタンス	Instance	True	string	Snowflake インスタンスの URI (https:// なし)
ステートメントハンドル	statementHandle	True	string	ステートメントハンドル
要求 ID	requestId		string	要求 ID
パーティション	partition		integer	パーティション

戻り値

名前	パス	型	説明
Partitions	Partitions	array of object	Partitions
RowCount	Partitions.RowCount	integer	RowCount
UncompressedSize	Partitions.UncompressedSize	integer	UncompressedSize
CompressedSize	Partitions.CompressedSize	integer	CompressedSize
Schema	Schema	array of object	Schema
名称	Schema.name	string	名称
データベース	Schema.database	string	データベース
スキーマ	Schema.schema	string	スキーマ
テーブル	Schema.table	string	テーブル
プレシジョン	Schema.precision	integer	プレシジョン
スケール	Schema.scale	integer	スケール
タイプ	Schema.type	string	タイプ
nullable	Schema.nullable	boolean	nullable
byteLength	Schema.byteLength	integer	byteLength
照合順序	Schema.collation	string	照合順序
length	Schema.length	integer	length
日付	Data	array of object	日付
ID	Data.ID	integer	ID
FIRSTNAME	Data.FIRSTNAME	string	FIRSTNAME
LASTNAME	Data.LASTNAME	string	LASTNAME
GENDER	Data.GENDER	string	GENDER
年齢	Data.AGE	integer	年齢
メールアドレス	Data.EMAIL	string	メールアドレス
PHONE	Data.PHONE	string	PHONE
学歴	Data.EDUCATION	string	学歴
行	Metadata.Rows	integer	行
Format	Metadata.Format	string	Format
コード	Metadata.Code	string	コード
StatementStatusUrl	Metadata.StatementStatusUrl	string	StatementStatusUrl
RequestId	Metadata.RequestId	string	RequestId
SqlState	Metadata.SqlState	string	SqlState
StatementHandle	Metadata.StatementHandle	string	StatementHandle
CreatedOn	Metadata.CreatedOn	string	CreatedOn

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

操作 ID:: Convert

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

パラメーター

名前	キー	必須	型	説明
スキーマ	schema		string	スキーマ
データ	data		string	データ

戻り値

名前	パス	型	説明
データ	data	array of object	データ

次の方法で共有

Snowflake (プレビュー)

Snowflake

前提条件

資格情報を取得する方法

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

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

資格情報を使用する

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

既知の問題と制限事項

スロットリング制限

Actions

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

Parameters

返品

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

Parameters

返品

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

Parameters

返品

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

Parameters

返品

よくあるご質問

接続を作成する

既定

調整制限

アクション

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

パラメーター

戻り値

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

パラメーター

戻り値

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

パラメーター

戻り値

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

パラメーター

戻り値

その他のリソース