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を返します。 |
最終更新日: