Google BigQuery - カスタムSQLを使用した行の選択アクション（バッチ）
カスタムSQLを使用した行の選択バッチアクションでは、カスタムSQLクエリを実行し、Google BigQueryから一致する行を取得できます。 このアクションは、バインド変数を使用したパラメーター化クエリをサポートしています。 クエリの実行が60秒を超え、クエリの完了を待機しますか？がいいえに設定されている場合、アクションはジョブIDを返し、非同期で完了します。 後で結果を取得するには、ジョブIDによる行のバッチ取得アクションを使用します。
50,000件のレコード制限
2026年2月8日以降、カスタムSQLを使用して行を選択アクションは、新規レシピおよび現在この制限を超えていない既存レシピについて、最大50,000件のレコードを返します。 2026年3月15日以降、この制限は、現在制限を超えている既存レシピを含め、このアクションを使用するすべてのレシピに拡張されます。
50,000件を超えるレコードを取得するように設定されたレシピでは、返される結果がこの制限まで切り詰められます。
この変更により、プラットフォームの信頼性とパフォーマンスが向上し、大規模なクエリによってデータベースコネクションに過負荷がかかったり、アップストリームシステムに影響が及んだりすることを防ぎます。
入力
| 入力フィールド | 説明 |
|---|---|
| プロジェクト | クエリに課金するプロジェクトを選択します。 |
| クエリ | 実行するSQLクエリを入力します。 バインド変数を宣言するには、@記号を使用します。 |
| パラメーター | クエリで使用されるバインド変数をマッピングします。 たとえば、select * from table where id = @idの場合は、idという名前のパラメーターを指定します。 |
| 出力フィールド | 想定される出力フィールドを定義します。 名前は、クエリによって返される列と一致している必要があります。 |
| 場所 | クエリを実行するリージョンを選択します。 ほとんどの場合、省略可能です。 |
| クエリの完了を待機しますか？ | クエリの完全な実行を待機するには、trueに設定します。 60秒後にジョブIDのみを返すには、falseに設定します。 結果を取得するには、ジョブIDによる行のバッチ取得アクションを使用します。 |
出力
| 出力フィールド | 説明 |
|---|---|
| 出力に行が含まれていますか？ | 結果に行データが含まれているかどうかを示します。 |
| 行 | 行オブジェクトの配列。 各データピルは結果内の列に対応します。 |
| 種類 | 実行されたジョブのタイプ。 これはqueryResponseである必要があります。 |
| ジョブ参照 | ジョブのプロジェクトID、ジョブID、およびロケーションが含まれます。 さらに多くの行を取得するには、これをジョブIDによる行のバッチ取得アクションと一緒に使用します。 |
| 合計行数 | クエリによって返された行の合計数。 |
| ページトークン | 結果の次のページを取得するためのトークン。 |
| スキーマ | 列名と型を含む、クエリ結果のスキーマ。 |
| Etag | 結果スキーマを表すハッシュ。 |
| 処理された合計バイト数 | クエリによって処理されたバイト数。 これはBigQueryの請求対象に含まれます。 |
| ジョブ完了 | クエリジョブのステータス。 ジョブが正常に完了した場合はDoneを返します。 ジョブがまだ実行中の場合はPendingを返します。 |
| キャッシュヒット | クエリ結果がキャッシュから提供された場合はtrueを返します。 それ以外の場合はfalseを返します。 |
Last updated: