アクションフローでのSnowflakeアクションの使い方

Suite、すべてのバージョン

Team、Growth、Professional、EnterpriseまたはEnterprise Plus

Support

Team、ProfessionalまたはEnterprise

要約：◀▼

OAuth 2.0認証を使用して、アクションフローをSnowflakeに接続することで、SQLクエリ、テーブル検索、スキーマ参照などのワークフローを自動化できます。安全なインテグレーションのため、専用のサービスアカウントを使用してください。利用可能なアクションにより、SQL文の実行、パターンフィルターによるテーブルの検索、詳細なテーブルスキーマ情報の取得が可能となり、プラットフォームをまたいだデータ管理やタスクの自動化を効果的に行うことができます。

アクションビルダーをSnowflakeなどの外部システムに接続すると、管理者は自動化ワークフロー内でZendeskと外部システムを連携させることができます。これにより、コラボレーションを強化し、複数のプラットフォームにまたがる一貫した利用体験を維持できます。

メモ：アクションフロー内の外部システムに関わるステップは、総称して「外部アクション」と呼ばれます。

この記事では、以下のトピックについて説明します。

アクションビルダーをSnowflakeに接続する
アクションフローでSnowflakeアクションを使用する

アクションビルダーをSnowflakeに接続する

外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。

外部システムに接続してアクションフローで外部アクションを使用する場合は、以下のベストプラクティスをお勧めします。

アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
すべてのインテグレーションでは、必要なスコープへのアクセスが要求されます。ただし、外部システムへの接続を承認する前に、スコープを確認し、妥当性を検証することが重要です。
OpenAIなどのAPIキーベースのツールの認証情報を管理する場合は、キーを安全な保管庫または認証情報マネージャーに保存することをお勧めします。

Snowflakeコネクションでは、認証コードグラント方式を使用するOAuth 2.0認証が採用されています。以下の3つの情報を指定する必要があります。

アカウント識別子：Snowflakeのアカウント識別子（例：APAC_DEV.AWS_AP_NORTHEAST_1）
OAuthクライアントID：Snowflakeセキュリティインテグレーションから取得したOAuthクライアントID
OAuthクライアントシークレット：Snowflakeセキュリティインテグレーションから取得したOAuthクライアントシークレット

SnowflakeでOAuth認証を設定するには

OAuth設定でSnowflakeにセキュリティインテグレーションを作成します。
クライアントIDとクライアントシークレットの認証情報を生成します。
アクションフロー用に適切なリダイレクトURIを設定します。

アクションビルダーをSnowflakeに接続するには

管理センターで、サイドバーにある「 アプリおよびインテグレーション」をクリックし、「アクション」>「アクションフロー」を選択します。
アクションフローを新規作成するか、既存のアクションフローを編集します。
ステップサイドバーを開きます。
「外部アクション」セクションで、「Snowflake」をクリックします。
「接続」をクリックします。
Snowflakeの指示に従って認証を行い、コネクションを完了します。
このコネクタは、認証時に refresh_token スコープを使用します。ロールとウェアハウスは実行時にアクションごとに指定されるため、ワークロードのニーズに応じて適切なリソースを柔軟に選択できます。

コネクションを承認する前に、要求されている権限を慎重に確認してください。クライアントシークレットは安全に保管し、他人と共有したり、バージョン管理システムにコミットしたりしないでください。

メモ：アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。

接続が完了すると、接続済みであることを示すインジケーター、接続先インスタンスの詳細、およびSnowflakeで利用可能なアクションが表示されます。

アクションフローでSnowflakeアクションを使用する

以下のSnowflakeアクションを使用できます。

クエリを実行
テーブルを検索
テーブルスキーマを参照

クエリを実行する

「クエリを実行」アクションを使用して、Snowflakeで任意のSQLステートメントを実行します。

このアクションには以下の入力と出力が含まれます。

変数

入力

	変数
入力	必須：`SQL statement`、`Warehouse`、`Role` オプション：`Timeout` 「クエリを実行」アクションを使用する際の注意点：「SQL statement」フィールドは、SELECT、INSERT、UPDATE、DELETE、CREATE、ALTERなど、すべてのSQLステートメントのタイプをサポートしています。「Warehouse」フィールドは、利用可能なウェアハウスを検索できるドロップダウンリストです。「Role」フィールドは、利用可能なロールを検索可能なドロップダウンリストで表示します。「Timeout」フィールドでは、クエリのタイムアウト時間を秒単位で指定します。 SELECTクエリの場合、データ配列には行データがキーと値のペアとして格納されます。 INSERT、UPDATE、またはDELETE操作の場合、「影響を受けた行数」フィールドに変更された行数が表示されます。
出力	クエリの実行結果：ステートメントハンドル、ステータスURL、実行メッセージ、行数、影響を受けた行数、およびSELECTクエリのデータ配列など。

必須：SQL statement、Warehouse、Role

オプション：Timeout

「クエリを実行」アクションを使用する際の注意点：

「SQL statement」フィールドは、SELECT、INSERT、UPDATE、DELETE、CREATE、ALTERなど、すべてのSQLステートメントのタイプをサポートしています。
「Warehouse」フィールドは、利用可能なウェアハウスを検索できるドロップダウンリストです。
「Role」フィールドは、利用可能なロールを検索可能なドロップダウンリストで表示します。
「Timeout」フィールドでは、クエリのタイムアウト時間を秒単位で指定します。
SELECTクエリの場合、データ配列には行データがキーと値のペアとして格納されます。
INSERT、UPDATE、またはDELETE操作の場合、「影響を受けた行数」フィールドに変更された行数が表示されます。

出力クエリの実行結果：ステートメントハンドル、ステータスURL、実行メッセージ、行数、影響を受けた行数、およびSELECTクエリのデータ配列など。

テーブルを検索する

「テーブルを検索」アクションを使用して、オプションのパターンフィルタリングを適用し、Snowflakeデータベーススキーマ内のテーブルを検出できます。

このアクションには以下の入力と出力が含まれます。

変数

入力

	変数
入力	必須：`Database`、`Schema`、`Warehouse`、`Role` オプション：`Table name pattern` 「テーブルを検索」アクションを使用する際の注意点：「Database」フィールドは、利用可能なデータベースをリストする、検索可能なドロップダウンです。「Schema」フィールドは、選択したデータベースに応じて表示内容が変化する、検索可能なドロップダウンです。「Table name pattern」フィールドには、フィルタリングのSQL LIKEパターンを指定できます（例：「USER%」と入力すると、USERで始まるテーブルが検索されます）。「Warehouse」および「Role」フィールドは、検索可能なドロップダウンリストです。
出力	テーブルオブジェクトの配列：名前、種類、行数、バイトサイズ、作成日、および総件数など。「種類」フィールドは、テーブルのタイプ（TABLE、VIEWなど）を示します。

必須：Database、Schema、Warehouse、Role

オプション：Table name pattern

「テーブルを検索」アクションを使用する際の注意点：

「Database」フィールドは、利用可能なデータベースをリストする、検索可能なドロップダウンです。
「Schema」フィールドは、選択したデータベースに応じて表示内容が変化する、検索可能なドロップダウンです。
「Table name pattern」フィールドには、フィルタリングのSQL LIKEパターンを指定できます（例：「USER%」と入力すると、USERで始まるテーブルが検索されます）。
「Warehouse」および「Role」フィールドは、検索可能なドロップダウンリストです。

出力

テーブルオブジェクトの配列：名前、種類、行数、バイトサイズ、作成日、および総件数など。

「種類」フィールドは、テーブルのタイプ（TABLE、VIEWなど）を示します。

テーブルスキーマを参照する

「テーブルスキーマを参照」アクションを使用して、特定のSnowflakeテーブルの列定義とメタデータを取得します。

このアクションには以下の入力と出力が含まれます。

変数

入力

	変数
入力	必須：`Database`、`Schema`、`Table`、`Warehouse`、`Role` 「テーブルスキーマを参照」アクションを使用する際の注意点：「Database」フィールドは、利用可能なデータベースをリストする、検索可能なドロップダウンです。「Schema」フィールドは、選択したデータベースに応じて表示内容が変化する、検索可能なドロップダウンです。「Table」フィールドは、データベースとスキーマの両方の選択内容に基づいて表示内容が変化する、検索可能なドロップダウンリストです。「Warehouse」および「Role」フィールドは、検索可能なドロップダウンリストです。
出力	列オブジェクトの配列：名前、データ型、NULL値の許容ステータス、デフォルト値、主キーかどうかを示す情報、および主キーの列名の配列など。列の出力には、データ型情報（例：VARCHAR、NUMBER、DATE）、各列がNULL値を許容するかどうか、デフォルト値（定義されている場合）、およびその列が主キーの一部であるかどうかが含まれる。「primary keys」フィールドには、すべての主キー列名が参照しやすいように別途一覧表示されます。

必須：Database、Schema、Table、Warehouse、Role

「テーブルスキーマを参照」アクションを使用する際の注意点：

「Database」フィールドは、利用可能なデータベースをリストする、検索可能なドロップダウンです。
「Schema」フィールドは、選択したデータベースに応じて表示内容が変化する、検索可能なドロップダウンです。
「Table」フィールドは、データベースとスキーマの両方の選択内容に基づいて表示内容が変化する、検索可能なドロップダウンリストです。
「Warehouse」および「Role」フィールドは、検索可能なドロップダウンリストです。

出力

列オブジェクトの配列：名前、データ型、NULL値の許容ステータス、デフォルト値、主キーかどうかを示す情報、および主キーの列名の配列など。

列の出力には、データ型情報（例：VARCHAR、NUMBER、DATE）、各列がNULL値を許容するかどうか、デフォルト値（定義されている場合）、およびその列が主キーの一部であるかどうかが含まれる。「primary keys」フィールドには、すべての主キー列名が参照しやすいように別途一覧表示されます。