レコードの検索または作成
このピースでできることGoogle BigQuery の接続方法方法 1：Google アカウント（OAuth2）で接続するステップ 1：workrun に接続を追加する方法 2：サービスアカウント（JSON キー）で接続するステップ 1：サービスアカウント JSON キーを取得するステップ 2：workrun に接続を追加するピースの設定項目1. プロジェクト（必須）2. データセット（必須）3. テーブル（必須）4. WHERE 条件（必須）5. 作成する行（見つからない場合）（必須）6. 場所（任意）
このピースでできること
- Google BigQuery のテーブルで WHERE 条件に一致する行を検索します。
- 一致する行が見つかった場合はその行を返します。
- 一致する行が見つからない場合は、指定したデータで新しい行を作成して返します。
Google BigQuery の接続方法
workrun と Google BigQuery を接続するには、Google アカウント または サービスアカウント JSON で認証します。
フローの用途に合わせて選んでください。
方法 1：Google アカウント（OAuth2）で接続する
個人の Google アカウントで認証する方法です。クイックに接続できます。
ステップ 1：workrun に接続を追加する
- workrun で Google BigQuery のアクション／トリガーをフローに追加します。
- 「接続を選択」の横にある 「＋ 新しい接続」 をクリックします。
- 認証タイプとして 「My Google Account」 を選択します。
- 「接続する」 をクリックすると、Google のログイン画面が表示されます。
- 使用する Google アカウントを選択してログインします。
- workrun へのアクセス許可を確認し、「許可」 をクリックします。
- 認証完了後、接続名が表示されたら 「保存」 をクリックして完了です。
方法 2：サービスアカウント（JSON キー）で接続する
サーバー間連携や自動化に適した方法です。Google Cloud のサービスアカウント JSON キーが必要です。
ステップ 1：サービスアカウント JSON キーを取得する
- Google Cloud Console を開き、対象のプロジェクトを選択します。
- IAM と管理 → サービスアカウント へ移動します。
- サービスアカウントを作成 をクリックします。
- 名前（例: ）を入力して 作成して続行 をクリックします。
- ロールとして BigQuery ユーザー （または完全アクセスの場合は BigQuery 管理者）を追加します。
- キー タブを開き、鍵を追加 → 新しい鍵を作成 → JSON → 作成 をクリックします。
- ダウンロードされた ファイルを開き、内容全体をコピーします。
ステップ 2：workrun に接続を追加する
- workrun で Google BigQuery のアクション／トリガーをフローに追加します。
- 「接続を選択」の横にある 「＋ 新しい接続」 をクリックします。
- 認証タイプとして 「Service Account JSON」 を選択します。
- 「Service Account JSON」 フィールドに、ステップ 1 でコピーした JSON 内容を貼り付けます。
- 「保存」 をクリックして接続を完了します。
ピースの設定項目
1. プロジェクト（必須）
- Google Cloud プロジェクトをドロップダウンから選択します。
2. データセット（必須）
- 対象のデータセットをドロップダウンから選択します。
3. テーブル（必須）
- 対象のテーブルをドロップダウンから選択します。
4. WHERE 条件（必須）
- 既存行を検索する SQL 条件を入力します。「WHERE」キーワードは含めないでください。
5. 作成する行（見つからない場合）（必須）
- 行が見つからない場合に挿入する列と値の JSON オブジェクトを入力します。
6. 場所（任意）
- データセットの地理的な場所を指定します（例: US、EU）。デフォルトを使用する場合は空白にします。