Google BigQuery: データ追加 (Google BigQuery: Insert New Data)
BigQuery のテーブルにデータを1行追加します。
Configs
  • C1: OAuth2 設定 *
  • C2: プロジェクト ID *
  • C3: データセット ID *
  • C4: テーブル ID *
  • C5: テンプレートサフィックス(テンプレートテーブルの場合のみ)#{EL}
  • C6F: フィールド_1
  • C6V: 値_1#{EL}
  • C7F: フィールド_2
  • C7V: 値_2#{EL}
  • C8F: フィールド_3
  • C8V: 値_3#{EL}
  • C9F: フィールド_4
  • C9V: 値_4#{EL}
  • C10F: フィールド_5
  • C10V: 値_5#{EL}
  • C11F: フィールド_6
  • C11V: 値_6#{EL}
  • C12F: フィールド_7
  • C12V: 値_7#{EL}

Notes

  • このモデリング要素を使用する Google アカウントには、bigquery.dataEditor ロールなど、BigQuery のテーブルを更新する権限が必要です。BigQuery の権限(ロール)についての詳細は Google Cloud IAM のドキュメントを参照してください。
  • このモデリング要素がサポートするテーブルスキーマのデータ型は、STRING, BYTES, INTEGER, FLOAT, NUMERIC, BIGNUMERIC, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME です。
  • 値はテーブルスキーマのデータ型に一致する形式で入力する必要があります。例えば DATETIME 型のフィールドであれば、2015-03-17 10:20:00 のように入力します。詳細は BigQuery ドキュメントを参照してください。

Capture

See also

Script (click to open)
  • 下記のスクリプトを記述した XML ファイルをダウンロードできます
    • google-bigquery-data-insert.xml (C) Questetra, Inc. (MIT License)
    • Professional をご利用であればファイルの内容を改変することでオリジナルのアドオンとして活用できます


// OAuth2 config sample at [OAuth 2.0 Setting]
// - Authorization Endpoint URL: https://accounts.google.com/o/oauth2/auth?access_type=offline&approval_prompt=force
// - Token Endpoint URL: https://oauth2.googleapis.com/token
// - Scope: https://www.googleapis.com/auth/bigquery
// - Consumer Key: (Get by Google Developer Console)
// - Consumer Secret: (Get by Google Developer Console)

const FIELD_NUM = 7; // 扱えるフィールドの数

main();
function main(){
  //// == 工程コンフィグ・ワークフローデータの参照 / Config & Data Retrieving ==
  const oauth2 = configs.get("conf_auth");
  const projectId = configs.get("conf_projectId");
  const datasetId = configs.get("conf_datasetId");
  const tableId = configs.get("conf_tableId");
  const templateSuffix = configs.get("conf_templateSuffix");

  isValidProjectId( projectId );
  isValidDatasetId( datasetId );
  isValidTableId( `${tableId}${templateSuffix}` );

  const dataObj = retrieveDataObj();

  //// == 演算 / Calculating ==
  insertData( oauth2, projectId, datasetId, tableId, templateSuffix, dataObj );
}

/**
  * プロジェクト ID が不正な文字列であればエラー
  * @param {String} projectId  プロジェクト ID
  */
function isValidProjectId( projectId ) {
  const reg = new RegExp( '^[a-zA-Z][0-9a-zA-Z-]{4,28}[0-9a-zA-Z]$' );
  if ( !reg.test(projectId) ) {
    throw "Invalid Project ID.";
  }
}

/**
  * データセット ID が不正な文字列であればエラー
  * @param {String} datasetId  データセット ID
  */
function isValidDatasetId( datasetId ) {
  const reg = new RegExp( '^\\w{1,1024}$' );
  if ( !reg.test(datasetId) ) {
    throw "Invalid Dataset ID.";
  }
}

/**
  * テーブル ID (サフィックスを含む)が不正な文字列であればエラー
  * @param {String} tableId  テーブル ID
  */
function isValidTableId( tableId ) {
  if( encodeURIComponent(tableId).replace(/%../g,"x").length > 1024 ) {
    throw "Invalid Table ID and/or Template Suffix. Too long.";
  }
  const reg = new RegExp( '^[\\p{L}\\p{M}\\p{N}\\p{Pc}\\p{Pd}\\p{Zs}]+$' , 'u');
  if ( !reg.test(tableId) ) {
    throw "Invalid Table ID and/or Template Suffix. Includes an invalid character.";
  }
}

/**
  * フィールドが不正な文字列であればエラー
  * @param {String} field  フィールド
  */
function isValidField( field ) {
  const reg = new RegExp( '^(?!_TABLE_|_FILE_|_PARTITION)[a-zA-Z_]\\w{0,299}$' );
  if ( !reg.test(field) ) {
    throw `Invalid Field Name: ${field}.`;
  }
}

/**
  * config からフィールドと値の組を読み出し、JSON オブジェクトを返す
  * @return {Object} dataObj  データオブジェクト
  */
function retrieveDataObj() {
  const dataObj = {};
  for (let i = 0; i < FIELD_NUM; i++) {
    const field = configs.get(`conf_field${i+1}`);
    let value = configs.get(`conf_value${i+1}`);
    if ( field === "" || field === null ) { // フィールドが空
      continue;
    }
    isValidField( field );
    if ( dataObj[field] !== undefined ) { // フィールドコードの指定が重複
      throw `The same field ${field} is set multiple times.`;
    }
    if ( value === "" || value === null ) { // 値が空
      value = null;
    }
    dataObj[field] = value;
  }
  return dataObj;
}

/**
  * データ追加の POST リクエストを送信する
  * @param {String} oauth  OAuth2 認証設定
  * @param {String} projectId  プロジェクト ID
  * @param {String} datasetId  データセット ID
  * @param {String} tableId  テーブル ID
  * @param {String} templateSuffix  テンプレートサフィックス
  * @param {Object} dataObj  データオブジェクト
  */
function insertData( oauth2, projectId, datasetId, tableId, templateSuffix, dataObj ) {
  const uri = `https://bigquery.googleapis.com/bigquery/v2/projects/${projectId}/datasets/${datasetId}/tables/${tableId}/insertAll`;

  const body = {};
  body["kind"] = "bigquery#tableDataInsertAllRequest";
  body["rows"] = [{ "json": dataObj }];
  if ( templateSuffix !== "" && templateSuffix !== null ) {
    body["templateSuffix"] = templateSuffix;
  }

  const response = httpClient.begin()
    .authSetting( oauth2 )
    .body( JSON.stringify(body), "application/json; charset=UTF-8" )
    .post(encodeURI(uri));

  const status = response.getStatusCode();
  const responseStr = response.getResponseAsString();
  if ( status >= 300 ) { // when error thrown
    engine.log(responseStr);
    throw `Failed to insert data. status: ${status}`;
  }
  const errors = JSON.parse(responseStr)["insertErrors"];
  if ( errors !== undefined ) {
    engine.log(JSON.stringify(errors));
    throw "Failed to insert data.";
  }
}

  
    
%d人のブロガーが「いいね」をつけました。