データのインポート
このピースでできることGoogle BigQuery の接続方法方法 1:Google アカウント(OAuth2)で接続するステップ 1:workrun に接続を追加する方法 2:サービスアカウント(JSON キー)で接続するステップ 1:サービスアカウント JSON キーを取得するステップ 2:workrun に接続を追加するピースの設定項目1. プロジェクト(必須)2. データセット(必須)3. テーブル(必須)4. データ(必須)5. 無効な行をスキップ(任意)6. 不明なフィールドを無視(任意)
このピースでできること
- 大量の行データを Google BigQuery テーブルにインポートします。
- JSON 配列または改行区切りの JSON (NDJSON) 形式に対応しています。
- データが大きい場合は自動的に 500 行ずつのチャンクに分割して送信します。
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. データ(必須)
- インポートするデータを JSON 配列またはNDJSON形式で入力します。各オブジェクトのキーはテーブルの列名と一致させてください。
5. 無効な行をスキップ(任意)
- 有効にすると、バッチ内の一部の行が無効でも有効な行だけ挿入されます。無効(デフォルト)の場合、1件でも無効があるとバッチ全体が失敗します。
6. 不明なフィールドを無視(任意)
- 有効にすると、テーブルスキーマにないフィールドは黙って破棄されます。無効(デフォルト)の場合、未知のフィールドがあると行の挿入が失敗します。