Google BigQuery - カスタムSQLを実行アクション
カスタムSQLを実行アクションを使用すると、SQL文字列をGoogle BigQueryに送信して実行できます。 SQLトランザクションが複数のクエリにまたがる場合、またはDMLステートメントを実行する必要がある場合に、このアクションを使用できます。
1 MBのクエリサイズ制限
1 December 2025以降、このコネクターのRun custom SQLアクションでは、1 MBのクエリサイズ制限が適用されます。 この変更により、プラットフォームの信頼性が向上し、パフォーマンスが向上し、データベースコネクションを過負荷にしたり、アップストリームシステムに影響を与えたりする大規模なクエリを回避できます。
出力に行は含まれません
このアクションは行データを返しません。 行を返すカスタムSQLの場合は、結果の行を取得するためにJob IDで行のバッチを取得アクションを使用します。
入力
| 入力フィールド | 説明 |
|---|---|
| プロジェクト | クエリに課金するプロジェクトを選択します。 |
| データセット | テーブルの取得元となるデータセットを選択します。 |
| 場所 | ジョブを実行する地理的ロケーションを選択します。 ほとんどの場合、このフィールドは必須ではありません。 |
| クエリ | 実行するSQLステートメントを入力します。 クエリサイズは1 MBに制限されています。 |
| レガシーSQLを使用 | レガシーSQLを使用するにはtrueに切り替えます。 通常は設定しません。 |
出力
| 出力フィールド | 説明 |
|---|---|
| ID | 完了したジョブのID。 |
| 種類 | Google BigQueryジョブのタイプ。 |
| ジョブ参照 | プロジェクトID、ジョブID、場所など、ジョブに関する情報が含まれます。 |
| 状態 | ジョブの状態。 多くの場合、この値は"DONE"になります。 |
| 統計 | クエリ時間と、ジョブで処理された合計バイト数に関する情報が含まれます。 |
| 設定 | クエリ設定に関する情報が含まれます。 |
| Status | エラー結果とメッセージがある場合、それらが含まれます。 |
| ユーザーのメールアドレス | ジョブを実行したユーザーのメールアドレス。 |
Drive認証情報の取得中に権限が拒否されました
Google BigQueryでカスタムSQLを実行アクションを実行すると、次のエラーが表示される場合があります:
Access Denied: BigQuery BigQuery: Permission denied while getting Drive credentials発生する理由
BigQueryサービスアカウントに、クエリで参照されているGoogle Driveファイルにアクセスする権限がない場合に、このエラーが発生します。
トラブルシューティング方法
問題を解決するには、次の手順を実行します。
SQLクエリが、Google Driveに保存されている外部テーブルまたはファイルを参照しているかどうかを確認します。
Google Driveでリンクされた各ファイルを開き、共有をクリックして、ViewerまたはEditorアクセス権を持つBigQueryサービスアカウントのメールアドレスを追加します。
Google Cloud Consoleに移動し、BigQueryプロジェクトでDriveアクセスが有効になっていることを確認します。
問題が解決しない場合は、Google Cloud管理者またはサポートに連絡して、Driveアクセス設定を確認してください。
Last updated: