Google BigQuery コネクタ構成ガイド

この記事では、Google BigQueryコネクタの構成方法について説明します。

API情報

このコネクタは以下のベンダーAPIを使用します：

API名：Google API
APIバージョン：v2
APIエンドポイント：https://bigquery.googleapis.com/bigquery/v2
ドキュメント：Google API

バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

最大リクエスト数：100,000
最古のリクエストからの最大時間：60分
リクエストの最大サイズ：90MB

構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタの追加方法については、コネクタについてを参照してください。

コネクタを追加した後、Googleに認証するために以下の手順を使用します：

認証タイプを選択します：
- Googleでサインイン
  1. Googleアカウントを選択し、TealiumがGoogleアカウントにアクセスすることを許可します。
  2. プロジェクトIDフィールドの下のリロードをクリックします。
- プライベートキーJSONファイル：（このオプションはレガシーコネクタインターフェースでは利用できません。）
  1. **IAM & Admin > サービスアカウント > サービスアカウントの作成（オプション）**に移動します。
  2. サービスアカウントのアクションメニュー（3つのドット）をクリックし、キーの管理 > キーの追加 > 新しいキーの作成 > JSON > 作成を選択します。
  3. サービスアカウント用に生成されたJSONキーの内容を貼り付けます。詳細については、Google: サーバー間アプリケーション用のOAuth 2.0の使用を参照してください。
接続するプロジェクトIDを選択します。
完了をクリックします。

アクション

アクション名	AudienceStream	EventStream
レコードの追加	✓	✓
レコードバッチの追加	✓	✓
カスタムステートメントの実行	✓	✓
イベントデータバッチ全体の送信	✗	✓
訪問データバッチ全体の送信	✓	✗

アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

レコードの追加

パラメータ

パラメータ	説明
データセット	接続するテーブルのコレクションのIDを選択します。
テーブル	接続するテーブル名を提供します。

イベントパラメータ

テーブルの列にパラメータをマッピングします。少なくとも1つのパラメータをマッピングする必要があります。

マッピング可能なパラメータは、コネクタが構成されたときに選択されたデータセットとテーブルに依存します。

レコードバッチの追加

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

最大リクエスト数：100,000
最古のリクエストからの最大時間：60分
リクエストの最大サイズ：90MB

パラメータ

パラメータ	説明
データセット	接続するテーブルのコレクションのIDを選択します。
テーブル	接続するテーブル名を提供します。

イベントパラメータ

パラメータ	説明
バッチの有効期限	バッチアクションが送信される頻度を指定するために、有効期限（TTL）を構成します。5分から60分の間で値を入力します。デフォルト値は60分です。

バッチ制限

最大リクエスト数：500
最古のリクエストからの最大時間：10分
リクエストの最大サイズ：1MB

カスタムステートメントの実行

このアクションを使用して、BigQueryテーブルに対してカスタムSQLステートメントを実行します。

この機能を使用するには、属性を名前付きプレースホルダーにマッピングし、SQLで @MY_PLACEHOLDER 形式を使用して参照します。次に、マッピングされた各プレースホルダーのデータタイプをマッピングします。たとえば、整数属性を MY_NUM_PARAM という名前のプレースホルダーにマッピングした場合、INT64 → MY_NUM_PARAM とマッピングします。

最後に、マッピングされた値を実行時に動的に置き換えるために、プレースホルダーを参照してSQLステートメントを書きます。

以下は、文字列値とブール値を持つ行を追加するための INSERT ステートメントを実行する方法を示す例です。

まず、属性をプレースホルダーにマッピングします：

次に、プレースホルダーにデータタイプをマッピングします：

その後、それらのプレースホルダーを参照するSQLステートメントを書きます：

INSERT INTO bigquery_table (my_string_col, my_bool_col)
VALUES ('@MY_STRING_PARAM', @MY_BOOLEAN_PARAM);

パラメータ

パラメータ	説明
データセット	(必須) 接続するテーブルのコレクションのIDを選択します。
クエリパラメータ	(必須) SQLクエリで使用されるプレースホルダー名に属性をマッピングします。少なくとも1つのパラメータをマッピングする必要があります。
クエリパラメータタイプ	(必須) マッピングされた各パラメータのタイプを指定します。有効な値は：`STRING`, `INT64`, `FLOAT64`, `BOOL`, `TIMESTAMP`, `DATE`, `TIME`, `DATETIME`, `ARRAY`, `STRUCT`です。たとえば、整数属性を `MY_PARAM` という名前のプレースホルダーにマッピングした場合、`INT64` を `MY_PARAM` にマッピングします。
クエリ	(必須) 実行するSQLステートメントを入力します。`INSERT`、`UPDATE`、`MERGE`の単一ステートメントのみが許可されます。マッピングされたパラメータを参照するには、`@`記号を使用します。たとえば、ブール属性を `MY_BOOLEAN_PARAM` にマッピングした場合、その値が表示されるべきSQLの場所で `@MY_BOOLEAN_PARAM` を使用します。
バッチの有効期限	1分から60分の間で有効期限（TTL）を構成します。デフォルト値は10分です。

イベントデータバッチ全体の送信

バッチ制限

最大リクエスト数：100,000
最古のリクエストからの最大時間：60分
リクエストの最大サイズ：90MB

パラメータ

パラメータ	説明
データセット	接続するテーブルのコレクションのIDを選択します。
テーブル	接続するテーブル名を提供します。
タイムスタンプを記録する列	タイムスタンプを記録する列を選択します。
ペイロードを記録する列	ペイロードを記録する列を選択します。
タイムスタンプ属性	デフォルトでは、アクションの現在のタイムスタンプが送信されます。異なる形式で送信したい場合は、タイムスタンプとして割り当てる属性を選択します。割り当てられた属性が空の値を生成した場合、コネクタは現在のタイムスタンプを送信します。
属性名の印刷	デフォルトでは、属性キーが使用されます。代わりに属性名をキーとして使用したい場合は、このチェックボックスを有効にします。属性名が更新されるとペイロード名が反映されることに注意してください。
バッチの有効期限	5分から60分の間で有効期限（TTL）を構成します。デフォルト値は60分です。

訪問データバッチ全体の送信

バッチ制限

リクエストの最大数：100,000
最も古いリクエストからの最大時間：60分
リクエストの最大サイズ：90MB

パラメータ

パラメータ	説明
データセット	接続するテーブルのコレクションのIDを選択します。
テーブル	接続するテーブル名を提供します。
タイムスタンプを記録する列	タイムスタンプを記録する列を選択します。
ペイロードを記録する列	ペイロードを記録する列を選択します。
タイムスタンプ属性	デフォルトでは、アクションの現在のタイムスタンプが送信されます。異なる形式で送信したい場合は、タイムスタンプとして割り当てる属性を選択します。属性が割り当てられ、空の値が生成された場合、コネクタは現在のタイムスタンプを送信します。
現在の訪問データを訪問データに含める	現在の訪問データを訪問データに含めます。
属性名を印刷	デフォルトでは、属性キーが使用されます。代わりに属性名をキーとして使用したい場合は、このチェックボックスを有効にします。属性名が更新されるとペイロード名が更新を反映することを考慮してください。
バッチの有効期限	バッチアクションが送信される頻度を指定するために、有効期限（TTL）を構成します。5分から60分の間で値を入力します。デフォルト値は60分です。