Google BigQueryコネクタ構成ガイド

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

API情報

このコネクタは、次のベンダーAPIを使用します。

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

バッチ制限

このコネクタは、ベンダーへの大量のデータ転送に対応するため、リクエストをバッチ処理します。詳細については、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに追加されます。

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

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

コネクタを追加したら、次の手順に従ってGoogleに対する認証を行います。

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

アクション

アクション名	訪問プロファイル	イベントデータ
レコードを追加	✓	✓
レコードをバッチ追加	✓	✓
カスタムステートメントを実行	✓	✓
イベントデータ全体をバッチ送信	✗	✓
訪問データ全体をバッチ送信	✓	✗
ログイベント全体を送信	✗	✓
ログイベントを送信	✗	✓

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

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

レコードを追加

パラメータ

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

イベントパラメータ

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

マッピングに使用できるパラメータは、コネクタの構成時に選択したデータセットとテーブルによって異なります。

レコードをバッチ追加

バッチ制限

このアクションは、ベンダーへの大量のデータ転送に対応するため、リクエストをバッチ処理します。詳細については、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに追加されます。

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

パラメータ

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

イベントパラメータ

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

バッチ制限

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

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

このアクションを使用して、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`を使用します。
バッチの有効期間	有効期間（TTL）を1～60分の値で構成します。デフォルト値は10分です。

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

バッチ制限

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

パラメータ

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

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

バッチ制限

このアクションは、ベンダーへの大量データ転送に対応するため、バッチリクエストを使用します。詳細については、バッチアクションを参照してください。以下のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに格納されます。

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

パラメータ

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

ログイベント全体を送信

パラメータ

パラメータ	説明
データセット	接続するテーブルコレクションのIDを選択します。
テーブル	接続するテーブル名を指定します。
タイムスタンプを記録する列	タイムスタンプを記録する列を選択します。
ペイロードを記録する列	ペイロードを記録するJSON列を選択します。
タイムスタンプ属性	デフォルトでは、アクションの現在のタイムスタンプが送信されます。別の形式で送信する場合は、タイムスタンプとして割り当てる属性を選択します。属性が割り当てられていて、その値が空の場合、コネクタは現在のタイムスタンプを送信します。

ログイベントを送信

パラメータ

パラメータ	説明
データセット	接続するテーブルコレクションのIDを選択します。
テーブル	接続するテーブル名を指定します。
ログイベントのリソース属性	テレメトリが記録される対象エンティティの情報を取得するフィールドです。
ログイベントのHTTP属性	ロギングシステムでHTTPリクエストとレスポンスを記録するフィールドです。HTTP配列全体を単一の列にマッピングするには、`http`属性をマッピングします。ターゲット列の型がJSONの場合は、生の配列が送信されます。それ以外の場合、配列は文字列に変換されます。
ログイベントの結果属性	操作が成功したか、またはエラーが発生したかなど、操作の結果を詳細に記録するフィールドです。
ログイベントのその他の属性	記録されたイベントに関する追加のメタデータを提供するフィールドです。