Snowflake
Snowflake Connector を使用すると、キャンバス アプリを構築し、仮想テーブルに Snowflake データを表示しながら、従来のソリューションと比較して高速なデータ処理と分析を実現できます。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Snowflake のサポート |
| URL | https://www.snowflake.com/support |
| support@snowflake.com |
| コネクタ メタデータ | |
|---|---|
| Publisher | Snowflake |
| Web サイト | https://www.snowflake.com |
| プライバシー ポリシー | https://www.snowflake.com/privacy-policy |
| カテゴリ | データ;マーケティング |
コネクタの詳細
この記事では、Snowflake コネクタの機能とアクションについて説明します。
Power Automate でサポートされている機能
- ユーザーはフローを作成し、Snowflake 接続を使用してカスタム SQL ステートメントの実行と結果の取得を行うアクションを追加できます。
Power Apps でサポートされている機能
- ユーザーはまず仮想テーブルを作成し、Snowflake 接続 ("サービス プリンシパル認証" のみを使用して作成された接続) を使用してアプリに読み込む必要があります。 仮想テーブルを作成する方法について説明します。 Microsoft Dataverse を使用して仮想テーブルを作成および編集する - Power Apps |Microsoft Learn。
Logic Apps でサポートされている機能
- ユーザーはフローを作成し、Snowflake 接続を使用してカスタム SQL ステートメントの実行と結果の取得を行うアクションを追加できます。
仮想ネットワークのサポート
Power Platform に対する Azure Virtual Network のサポートにより、ユーザーはパブリック インターネット経由で公開することなく、仮想ネットワーク内のリソースと Power Platform を統合できます。 Virtual Network に接続するには、次の両方の手順に従ってください。
- Azure Private Link と Snowflake をセットアップする方法について説明します
- Power Platform の Virtual Network サポートをセットアップする方法について説明します
仮想ネットワークの詳細については、 Virtual Network のサポートの概要を確認してください。
[前提条件]
- ユーザーは、外部承認のために Microsoft Entra ID を持っている必要があります。 PowerApps の承認フローではサービス プリンシパルが利用され、Power Automate では Service-Principal とユーザーの代理フローの両方がサポートされます。
- ユーザーは、Premium Power Apps ライセンスを持っている必要があります。
- ユーザーには Snowflake アカウントが必要です。
Snowflake コネクタを使用するための構成に関して留意する必要がある点
- 承認サーバーは、
DELEGATED BASED AUTHと呼ばれるユーザーに代わって OAuth クライアントにアクセス トークンを付与できます。 - 承認サーバーは、OAuth クライアントに、
SP BASED AUTHと呼ばれる OAuth クライアント自体のアクセス トークンを付与できます。 - Oauth クライアントの場合は、委任されたベースの
AUTHのリダイレクト URI (Web ベース) を必ず追加してください。
リダイレクト URI -https://global.consent.azure-apim.net/redirect/snowflakev2
- 対象ユーザーとのセキュリティ統合を作成する必要があります。
- 委任されたベースの認証の場合、
external_oauth_token_user_mapping_claim = 'upn' - sp ベースの認証の場合、
external_oauth_token_user_mapping_claim = 'sub' - セキュリティ統合の作成時に、作成された統合について説明し、Snowflake のユーザーに与えられたロールがブロックリストに含まれているかどうかを確認します。 ブロックリストに含まれている場合は、ブロックリスト内のユーザーのロールを変更または削除します。
- Snowflake アカウントで
login_nameとロールが正しく設定されていることを確認します。 これを確認するには、[管理者] タブ > [ユーザーとロール] > ユーザーを選択し、ユーザーの詳細を編集します。
構成手順
A。 Microsoft Entra ID で OAuth リソースを構成する
- Microsoft Azure Portal に移動して認証します。
- Microsoft Entra ID に移動します。
- [ アプリの登録] をクリックします。
- [ 新規登録] をクリックします。
- 「Snowflake OAuth リソース」または 「名前」と同様の値を入力します。
- [サポートされているアカウントの種類] が [シングル テナント] に設定されていることを確認します。
- [登録] をクリックします。
- [ API の公開] をクリックします。
- アプリケーション ID URI の横にあるリンクをクリックして、アプリケーション ID URI を追加します。 アプリケーション ID URI は、次の形式になります。
Application ID URI <api://9xxxxxxxxxxxxxxxxxx> -
委任された認証の場合 (ここのスクリーンショット):
- [ スコープの追加 ] をクリックして、Snowflake ロールを表すスコープを追加します。
- 同意できるユーザーを選択します。
- 説明を追加します。
- [スコープの追加] をクリックして保存します。
例:session:scope:analyst
OR
-
サービス プリンシパル認証の場合 (ここのスクリーンショット):
プログラム クライアントが自身のアクセス トークンを要求する OAuth フローのロールとして Snowflake ロールを追加するには:[マニフェスト] をクリックします。
appRoles要素を見つけます。次の設定で アプリ ロール を入力します。Snowflake ロールは、ウェアハウスにアクセスできるロールであり、スキーマに対する使用特権である必要があります (マニフェスト の詳細については 、こちらを 参照してください)。
以下のサンプル定義を参照してください。
アプリ ロール マニフェストは次のとおりです。ACCOUNTADMIN、SECURITYADMIN、ORGADMINなどの高い特権ロールを使用しないでください。"appRoles":[ { "allowedMemberTypes": [ "Application" ], "description": "Analyst.", "displayName": "Analyst", "id": "3ea51f40-2ad7-4e79-aa18-12c45156dc6a", "isEnabled": true, "lang": null, "origin": "Application", "value": "session:role:analyst" } ][保存] をクリックする
- 必要に応じて、セキュリティ統合が既に Snowflake で PowerBI などの別の Microsoft 製品と使用されており、要求マッピングが異なる場合は、マニフェストを変更する必要があります。 マニフェストは、一意の要求マッピングを使用して Snowflake で個別のセキュリティ統合を作成できるように、別の発行者を使用してトークンを出力する必要があります。
a. [マニフェスト] をクリックします。
b。 属性requestedAccessTokenVersionを見つけて、値を "2" に設定します。-
requestedAccessTokenVersionが "2" に設定されている場合、アクセス トークンには次の形式の発行者が含まれます。https://login.microsoftonline.com/<Tenant-ID>/v2.0 -
requestedAccessTokenVersionが "1" に設定されている場合、アクセス トークンには次の形式の発行者が含まれます。https://sts.windows.net/<tenant-ID>/
c. [保存] をクリックします。
-
B: Microsoft Entra ID で OAuth クライアントを作成する
- Microsoft Azure Portal に移動して認証します。
- Azure Active Directory に移動します。
- [ アプリの登録] をクリックします。
- [ 新規登録] をクリックします。
- "Snowflake OAuth Client" などのクライアントの名前を入力します。
- [サポートされているアカウントの種類] が [シングル テナント] に設定されていることを確認します。
- [登録] をクリックします。
- [概要] セクションで、[アプリケーション (クライアント) ID] フィールドから
ClientIDをコピーします。 これは、次の手順で<OAUTH_CLIENT_ID>と呼ばれます。 - [ 証明書とシークレット ] をクリックし、[ 新しいクライアント シークレット] をクリックします。
- シークレットの説明を追加します。
- テスト目的では、有効期間の長いシークレットを選択しますが、運用環境では必要なセキュリティ ポリシーに従います。
-
追加をクリックします。 シークレットをコピーします。 これは、次の手順で
<OAUTH_CLIENT_SECRET>と呼ばれます。 -
委任された認証の場合:
a. [ 管理 ] ->API のアクセス許可をクリックします。
b。 [ アクセス許可の追加] をクリックします。
c. [ マイ API] をクリックします。
d. 「Microsoft Entra ID での Oauth リソースの構成」で作成された Snowflake OAuth リソースをクリックします。
e. [ 委任されたアクセス許可 ] ボックスをクリックします。
f. このクライアントに付与するアプリケーションで手動で定義されているスコープに関連する アクセス許可 を確認します。
g. [ アクセス許可の追加] をクリックします。
h. [管理者の 同意の付与 ] ボタンをクリックして、クライアントにアクセス許可を付与します。 テストの目的で、アクセス許可はこのように構成されることに注意してください。 ただし、運用環境では、この方法でアクセス許可を付与することはお勧めしません。
一. [ はい] をクリックします。
j. [Manage -> Authentication]\(認証の管理\) をクリックし、プラットフォーム > Web を追加し、「リダイレクト URI」と入力します。
https://global.consent.azure-apim.net/redirect/snowflakev2
OR
-
サービス プリンシパル認証の場合:
a. [ 管理 ] ->API のアクセス許可をクリックします。
b。 [ アクセス許可の追加] をクリックします。
c. [ マイ API] をクリックします。
d. 「Microsoft Entra ID での Oauth リソースの構成」で作成された Snowflake OAuth リソースをクリックします。
e. [アプリケーションの アクセス許可 ] ボックスをクリックします。
f. このクライアントに付与するアプリケーションのマニフェストで手動で定義されたロールに関連するアクセス許可を確認します。
g. [ アクセス許可の追加] をクリックします。
h. [管理者の 同意の付与 ] ボタンをクリックして、クライアントにアクセス許可を付与します。 テストの目的で、アクセス許可はこのように構成されることに注意してください。 ただし、運用環境では、この方法でアクセス許可を付与することはお勧めしません。
一. [はい] をクリックします。
C. Snowflake の Azure AD 情報を収集する
- Microsoft Azure Portal に移動して認証します。
- Azure Active Directory に移動します。
- [ アプリの登録] をクリックします。
- 「 Microsoft Entra ID での Oauth リソースの構成」で作成された Snowflake OAuth リソースをクリックします。
- [概要] インターフェイスで [エンドポイント] をクリックします。
- 右側で、 OAuth 2.0 トークン エンドポイント (v2) をコピーし、 OpenID Connect メタデータ と フェデレーション接続メタデータの URL をメモします。
- OAuth 2.0 トークン エンドポイント (v2) は、次の構成手順で
<AZURE_AD_OAUTH_TOKEN_ENDPOINT>と呼ばれます。 エンドポイントは、https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/tokenのようになります。 -
OpenID Connect メタデータの場合は、新しいブラウザー ウィンドウで開きます。
-
jwks_uriパラメーターを見つけて、その値をコピーします。 - このパラメーター値は、次の構成手順で
<AZURE_AD_JWS_KEY_ENDPOINT>と呼ばれます。 エンドポイントは、https://login.microsoftonline.com/<tenant-id>/discovery/v2.0/keysのようになります。
-
-
フェデレーション メタデータ ドキュメントの場合は、新しいブラウザー ウィンドウで URL を開きます。
-
XML Root Elementで"entityID"パラメーターを見つけて、その値をコピーします。 - このパラメーター値は、次の構成手順で
<AZURE_AD_ISSUER>と呼ばれます。 entityID 値は、https://sts.windows.net/<tenant-id>/のようになります。
-
D: Entra Authorization のセットアップを検証する
この時点で構成をテストすることをお勧めします。以下の curl を使用し、Entra が、不眠症などの API テスト ツールを使用してトークンを発行しているかどうかを確認してください。
- 委任された認証: (省略可能)
コードを取得するには、前の手順を実行する必要があります。 このドキュメント に従うことができます
curl --request POST --url https://login.microsoftonline.com/<TENANT_ID>/oauth2/token --header 'Content-Type: multipart/form-data' --form client_id=<AAD_CLIENT_ID> --form client_secret=< AAD_CLIENT_SECRET> --form resource=< AAD_RESOURCE_ID> --formgrant_type=authorization_code --form code=<CODE_GENERATED_ABOVE> --form redirect_uri=https://localhost注: AAD クライアント アプリにリダイレクト URI を追加してください。
OR
サービス プリンシパル認証:
curl -X POST -H "Content-Type: application/x-www-form-urlencoded;charset=UTF-8" \ --data-urlencode "client_id=client_id from above B.8" \ --data-urlencode "client_secret=<Secret from above B.12>" \ --data-urlencode "grant_type=client_credentials" \ --data-urlencode "scope=api://<Appl_URI_ID>/.default" \'https://login.microsoftonline.com/<tenant_id>/oauth2/v2.0/token'
トークンを検証するには、Snowflake で次のコマンドを実行します。
select system$verify_external_oauth_token(‘<token>’);
E. 対象ユーザーとのセキュリティ統合を作成する
セキュリティ統合の external_oauth_audience_list パラメーターは、Microsoft Entra ID の構成中に指定されたアプリケーション ID URI と一致する必要があります。
委任された認証:
create security integration external_oauth_azure_1 type = external_oauth enabled = true external_oauth_type = azure external_oauth_issuer = '<AZURE_AD_ISSUER>' external_oauth_jws_keys_url = '<AZURE_AD_JWS_KEY_ENDPOINT>' external_oauth_audience_list = ('<SNOWFLAKE_APPLICATION_ID_URI>') external_oauth_token_user_mapping_claim = ‘upn’ external_oauth_snowflake_user_mapping_attribute = 'login_name or email address';
Azure AD のセキュリティ統合が既に設定されている場合は、次を使用します。
alter security integration external_oauth_azure_1 set external_oauth_token_user_mapping_claim = ('sub','upn');
委任された認証の場合、Snowflake ユーザーの login_name または email_address は、Power Automate フローを実行するユーザーの Entra 電子メールと一致する必要があります。
例:
ALTER USER SNOWSQL_DELEGATE_USER
LOGIN_NAME = '<ENTRA-USERID>' or EMAIL_ADDRESS = ‘ENTRA-USERID’
DISPLAY_NAME = 'SnowSQL Delegated User'
COMMENT = 'A delegate user for SnowSQL client to be used for OAuth based connectivity';
OR
サービス プリンシパル認証:
create security integration external_oauth_azure_2 type = external_oauth enabled = true external_oauth_type = azure external_oauth_issuer = '<AZURE_AD_ISSUER>' external_oauth_jws_keys_url = '<AZURE_AD_JWS_KEY_ENDPOINT>' external_oauth_audience_list = ('<SNOWFLAKE_APPLICATION_ID_URI>') external_oauth_token_user_mapping_claim = ‘sub’ external_oauth_snowflake_user_mapping_attribute = 'login_name';
サービス プリンシパル認証のセットアップについてのみ、以下に進みます。
サービス プリンシパル ベースの接続のユーザーを作成します。
サブ値は Snowflake のユーザーにマップする必要があります。高い特権アカウント Accountadmin、Orgadmin、Securityadmin の使用は避けてください。
CREATE OR REPLACE USER SNOWSQL_OAUTH_USER LOGIN_NAME = '<subvalue from decoded token>' DISPLAY_NAME = 'SnowSQL OAuth User' COMMENT = 'A system user for SnowSQL client to be used for OAuth based connectivity'; CREATE ROLE ANALYST; GRANT ROLE ANALYST TO USER SNOWSQL_OAUTH_USER;
F. Snowflake アクセスの検証 [省略可能]
委任された認証
snowsql -a organization-locator -u 'user@sandbox.onmicrosoft.com' --rolename <rolename> --authenticator oauth --token "<token-value>"
OR
サービス プリンシパル認証
snowsql -a <snowflake-accountname> -u ‘sub-value’ -r <snowflake-role from A.11.h above> –authenticator oauth –token <output from curl at step D>
Snowflake コネクタを使用しているお客様 [非推奨]
適用対象: すべてのリージョン
古い Snowflake コネクタから新しいコネクタに移行するには、次の手順に従ってください。
このオプションは、明示的な認証の種類のない古い接続にのみ適用され、下位互換性のためにのみ提供されます。
以前のコネクタを使用する Power Automate フローがビルドされている場合 (現在は非推奨とマークされています)、上記の構成手順に従って新しい接続を設定し、新しい接続を使用するように既存のフローを更新する必要があります。
"結果セットの行を配列からオブジェクトに変換する" アクションは、その機能が "状態の確認と結果の取得" にラップされているため、削除する必要もあります。
既知の問題と制限事項
現在、join コマンドの実行時に重複する列はサポートされていません。 回避策として、重複する列にエイリアスを追加します。
仮想テーブルに関するその他の制限事項を 次に示します。
仮想テーブルは、"サービス プリンシパル" 認証で作成された接続でのみサポートされます。
サービス プリンシパル認証を使用する場合、ユーザーは information_schema.columns テーブルへの読み取りアクセス権を持っている必要があります。
Canvas アプリで Snowflake 接続を直接作成することはできません。問題を解決するために必要なエラー情報と手順は次のとおりです。
- 次のスクリーンショットの接続接続の作成エラーに示すように、Snowflake 接続がキャンバス アプリで直接
された場合に
が表示されます - キャンバス アプリでコネクタを直接追加する代わりに、Canvas アプリの外部からサービス プリンシパル接続 (委任されていない) を作成します
- 上記で作成した Snowflake 接続を使用し、仮想テーブル
を作成する - その後、仮想テーブルをキャンバス アプリに読み込み、Canvas アプリからビルドすると
が発生する可能性があります - 上の ANIMALS テーブルは、上記のように Snowflake 接続を使用して作成された仮想テーブルです
- 次のスクリーンショットの接続接続の作成エラーに示すように、Snowflake 接続がキャンバス アプリで直接
注
- ユーザーは常に、すべての Snowflake アカウントの詳細 (ウェアハウス、ロール、スキーマ、データベース) が、接続/フロー アクションの構成中に Snowflake アカウントと同じ文字ケースにあることを確認する必要があります。
- 委任された接続とサービス プリンシパル ベースの接続の両方の検証手順として、Power Automate フローを作成して接続を検証してください。
一般的な制限
| 名前 | 価値 |
|---|---|
| コネクタによって同時に処理される要求の最大数 | 50 |
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| サービス プリンシパル (Microsoft Entra ID アプリケーション) | Microsoft Entra ID アプリケーションを使用して Snowflake データベースにアクセスします。 | すべてのリージョン | 共有可能 |
| サービス プリンシパルの委任された認証 (Microsoft Entra ID アプリケーション) | Microsoft Entra ID アプリケーションを使用して Snowflake データベースにアクセスします。 | すべてのリージョン | 共有可能 |
| 既定 [非推奨] | このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。 | すべてのリージョン | 共有不可 |
サービス プリンシパル (Microsoft Entra ID アプリケーション)
認証 ID: oauthSP
適用対象: すべてのリージョン
Microsoft Entra ID アプリケーションを使用して Snowflake データベースにアクセスします。
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| Tenant | 文字列 | 正しい | |
| クライアントID | 文字列 | 正しい | |
| クライアント シークレット | securestring | 正しい | |
| リソース URL | 文字列 | Snowflake OAuth Audience URL (リソース URL) | 正しい |
| Snowflake SaaS URL | 文字列 | HTTPS プレフィックスを含まない Snowflake URL (例: fnpuupu-in12345.snowflakecomputing.com) | 正しい |
| Snowflake データベース | 文字列 | 接続先のデータベースを指定する | 正しい |
| 倉庫名 | 文字列 | 接続する Snowflake ウェアハウス | 正しい |
| Role | 文字列 | 接続する Snowflake ロール | 正しい |
| Schema | 文字列 | 接続先の Snowflake スキーマ | 正しい |
サービス プリンシパルの委任された認証 (Microsoft Entra ID アプリケーション)
認証 ID: oauthSPUserDelegated
適用対象: すべてのリージョン
Microsoft Entra ID アプリケーションを使用して Snowflake データベースにアクセスします。
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| クライアントID | 文字列 | Snowflake OAuth クライアント ID | 正しい |
| クライアント シークレット | securestring | Snowflake OAuth クライアント シークレット | 正しい |
| リソース URL | 文字列 | Snowflake OAuth Audience URL(リソース URL) | 正しい |
既定 [非推奨]
適用対象: すべてのリージョン
このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| これは、MCS UI 接続ウィジェットのバグが原因で、当面必要なダミー プレースホルダーです。 connectionParameterSets で認証の変更を行う必要がある | 文字列 | これは、MCS UI 接続ウィジェットのバグが原因で、当面必要なダミー プレースホルダーです。 connectionParameterSets で認証の変更を行う必要がある |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 900 | 60 秒 |
アクション
| ステートメントの実行を取り消す |
ステートメントの実行を取り消す |
| 実行のために SQL ステートメントを送信する |
実行用の SQL ステートメントを送信する |
| 状態を確認して結果を取得する |
ステートメントの実行状態を確認し、結果を取得する |
ステートメントの実行を取り消す
ステートメントの実行を取り消す
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
事例
|
Instance | True | string |
Snowflake インスタンスの URI (https:// なし) |
|
ステートメント ハンドル
|
statementHandle | True | string |
ステートメント ハンドル |
|
リクエストID
|
requestId | string |
リクエストID |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コード
|
code | string |
コード |
|
sqlState
|
sqlState | string |
sqlState |
|
メッセージ
|
message | string |
メッセージ |
|
statementHandle
|
statementHandle | string |
statementHandle |
|
statementStatusUrl
|
statementStatusUrl | string |
statementStatusUrl |
実行のために SQL ステートメントを送信する
実行用の SQL ステートメントを送信する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
事例
|
Instance | True | string |
Snowflake インスタンスの URI (https:// なし) |
|
リクエストID
|
requestId | string |
要求の ID |
|
|
非同期
|
asyncexecution | boolean |
クエリを非同期的に実行する必要があるかどうかを示します |
|
|
ヌラブル
|
nullable | boolean |
null 許容値が false の場合、null 値は文字列に置き換えられます |
|
|
ステートメント
|
statement | string |
実行する SQL ステートメント - まだサポートされていないステートメントのバッチ |
|
|
timeout
|
timeout | integer |
タイムアウトが発生するまでの秒数 |
|
|
データベース
|
database | string |
データベース |
|
|
スキーマ
|
schema | string |
スキーマ |
|
|
warehouse
|
warehouse | string |
warehouse |
|
|
ロール
|
role | string |
ロール |
|
|
timezone
|
timezone | string |
ステートメントの実行時に使用するタイム ゾーン。 |
|
|
クエリ タグ
|
query_tag | string |
SQL ステートメントに関連付けるクエリ タグ。 |
|
|
バイナリ出力形式
|
binary_output_format | string |
バイナリ値の出力形式。 |
|
|
日付の出力形式
|
date_output_format | string |
DATE 値の出力形式。 |
|
|
時間出力形式
|
time_output_format | string |
TIME 値の出力形式。 |
|
|
timestamp 出力形式
|
timestamp_output_format | string |
TIMESTAMP 値の出力形式。 |
|
|
timestamp ltz 出力形式
|
timestamp_ltz_output_format | string |
TIMESTAMP_LTZ値の出力形式。 |
|
|
timestamp_ntz_output_format
|
timestamp_ntz_output_format | string |
TIMESTAMP_NTZ値の出力形式。 |
|
|
timestamp tz 出力形式
|
timestamp_tz_output_format | string |
TIMESTAMP_TZ値の出力形式。 |
|
|
multi ステートメントの数
|
MULTI_STATEMENT_COUNT | integer |
複数ステートメント機能を使用する場合に実行するステートメントの数。 0 は、ステートメントの可変数を意味します。 負の数は使用できません。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Partitions
|
Partitions | array of object |
Partitions |
|
RowCount
|
Partitions.RowCount | integer |
RowCount |
|
CompressedSize
|
Partitions.UncompressedSize | integer |
CompressedSize |
|
CompressedSize
|
Partitions.CompressedSize | integer |
CompressedSize |
|
Schema
|
Schema | array of object |
Schema |
|
名前
|
Schema.name | string |
名前 |
|
データベース
|
Schema.database | string |
データベース |
|
スキーマ
|
Schema.schema | string |
スキーマ |
|
テーブル
|
Schema.table | string |
テーブル |
|
Null 許容
|
Schema.nullable | boolean |
Null 許容 |
|
精度
|
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 |
データ |
|
Rows
|
Metadata.Rows | integer |
Rows |
|
Format
|
Metadata.Format | string |
Format |
|
Code
|
Metadata.Code | string |
Code |
|
StatementStatusUrl
|
Metadata.StatementStatusUrl | string |
StatementStatusUrl |
|
RequestId
|
Metadata.RequestId | string |
RequestId |
|
SqlState
|
Metadata.SqlState | string |
SqlState |
|
StatementHandle
|
Metadata.StatementHandle | string |
StatementHandle |
|
StatementHandles
|
Metadata.StatementHandles | array of string |
StatementHandles による複数のステートメントの実行 |
|
CreatedOn
|
Metadata.CreatedOn | string |
CreatedOn |
状態を確認して結果を取得する
ステートメントの実行状態を確認し、結果を取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
事例
|
Instance | True | string |
Snowflake インスタンスの URI (https:// なし) |
|
ステートメント ハンドル
|
statementHandle | True | string |
ステートメント ハンドル |
|
リクエストID
|
requestId | string |
リクエストID |
|
|
パーティション
|
partition | integer |
パーティション |
|
|
名前
|
name | string |
名前 |
|
|
データベース
|
database | string |
データベース |
|
|
スキーマ
|
schema | string |
スキーマ |
|
|
テーブル
|
table | string |
テーブル |
|
|
Null 許容
|
nullable | boolean |
Null 許容 |
|
|
精度
|
precision | integer |
精度 |
|
|
スケーリングする
|
scale | integer |
スケーリングする |
|
|
byteLength
|
byteLength | integer |
byteLength |
|
|
照合順序
|
collation | string |
照合順序 |
|
|
length
|
length | integer |
length |
|
|
型
|
type | string |
型 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Partitions
|
Partitions | array of object |
Partitions |
|
RowCount
|
Partitions.RowCount | integer |
RowCount |
|
CompressedSize
|
Partitions.UncompressedSize | integer |
CompressedSize |
|
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 |
型 |
|
Null 許容
|
Schema.nullable | boolean |
Null 許容 |
|
byteLength
|
Schema.byteLength | integer |
byteLength |
|
照合順序
|
Schema.collation | string |
照合順序 |
|
length
|
Schema.length | integer |
length |
|
データ
|
Data | array of |
データ |
|
StatementHandle
|
StatementHandle | string |
StatementHandle |
|
Rows
|
Metadata.Rows | integer |
Rows |
|
Format
|
Metadata.Format | string |
Format |
|
Code
|
Metadata.Code | string |
Code |
|
StatementStatusUrl
|
Metadata.StatementStatusUrl | string |
StatementStatusUrl |
|
RequestId
|
Metadata.RequestId | string |
RequestId |
|
SqlState
|
Metadata.SqlState | string |
SqlState |
|
CreatedOn
|
Metadata.CreatedOn | string |
CreatedOn |
|
StatementHandles
|
Metadata.StatementHandles | array of string |
StatementHandles による複数のステートメントの実行 |