新規作業完了(トリガー)

このピースでできること

  • Google BigQuery のジョブ(クエリ・ロード・コピー・エクスポート)が完了したときにフローを開始します。
  • ジョブのメタデータ(ステータス・種別・実行時間)が得られます。
  • 失敗したジョブも含めるか否かを選べます。

Google BigQuery の接続方法

workrun と Google BigQuery を接続するには、Google アカウント または サービスアカウント JSON で認証します。
フローの用途に合わせて選んでください。

方法 1:Google アカウント(OAuth2)で接続する

個人の Google アカウントで認証する方法です。クイックに接続できます。

ステップ 1:workrun に接続を追加する

  1. workrun で Google BigQuery のアクション/トリガーをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 認証タイプとして 「My Google Account」 を選択します。
  1. 「接続する」 をクリックすると、Google のログイン画面が表示されます。
  1. 使用する Google アカウントを選択してログインします。
  1. workrun へのアクセス許可を確認し、「許可」 をクリックします。
  1. 認証完了後、接続名が表示されたら 「保存」 をクリックして完了です。

方法 2:サービスアカウント(JSON キー)で接続する

サーバー間連携や自動化に適した方法です。Google Cloud のサービスアカウント JSON キーが必要です。

ステップ 1:サービスアカウント JSON キーを取得する

  1. Google Cloud Console を開き、対象のプロジェクトを選択します。
  1. IAM と管理 → サービスアカウント へ移動します。
  1. サービスアカウントを作成 をクリックします。
  1. 名前(例: )を入力して 作成して続行 をクリックします。
  1. ロールとして BigQuery ユーザー (または完全アクセスの場合は BigQuery 管理者)を追加します。
  1. キー タブを開き、鍵を追加 → 新しい鍵を作成 → JSON → 作成 をクリックします。
  1. ダウンロードされた ファイルを開き、内容全体をコピーします。

ステップ 2:workrun に接続を追加する

  1. workrun で Google BigQuery のアクション/トリガーをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 認証タイプとして 「Service Account JSON」 を選択します。
  1. 「Service Account JSON」 フィールドに、ステップ 1 でコピーした JSON 内容を貼り付けます。
  1. 「保存」 をクリックして接続を完了します。

ピースの設定項目

1. プロジェクト(必須)

  • Google Cloud プロゲクトをドロップダウンから選択します。

2. 失敗した作業を含める(任意)

  • 有効にすると、エラーで完了したジョブも対象に含まれます。無効(デフォルト)は正常完了ジョブのみが対象です。

取得できる情報

完了した BigQuery ジョブのメタデータを、後続ステップで利用できます。主な実キーは次のとおりです。
  • / / :ジョブID・プロジェクト・実行ロケーション
  • :ジョブ種別(QUERY / LOAD / COPY / EXTRACT など)
  • :SUCCESS または FAILED
  • / :失敗時のエラー情報
  • :クエリジョブの場合のSQL
  • / / :作成・開始・完了日時
  • / :処理バイト数・キャッシュ利用有無
  • / / :DML処理件数
  • :実行ユーザー
「失敗した作業を含める」が無効の場合は、正常完了したジョブのみが対象です。