詳細情報:
Google BigQuery 標準 SQL 接続
Google BigQuery Standard SQL コネクタを使用して、標準 SQL をサポートする大量の Google BigQuery データを CRM Analytics に取り込みます。
接続の作成
- [データマネージャー接続] タブで、[新しい接続] をクリックします。
- コネクタの名前をクリックし、[次へ] をクリックします。
- コネクタ設定を入力します。
- 設定を検証してソースへの接続を試みるには、[保存 & テスト] をクリックします。接続に失敗すると、考えられる理由が CRM Analytics に表示されます。
特に明記されていない限り、すべての設定で値が必要です。
| 接続設定 | 説明 |
|---|---|
| 接続名 | 接続を識別します。異なる接続を区別しやすい規則を使用します。 |
| API 参照名 | 接続の API 参照名。この名前にスペースを含めることはできません。API 参照名は、この接続を介して抽出されたデータをレシピで参照するために使用します。接続の作成後に API 参照名を変更することはできません。 |
| 説明 | 説明 |
| Schema (スキーマ) | 接続している Google BigQuery データセット ID の名前。 |
| Private Key (非公開鍵) | JSON ファイルの private_key 値を入力します。 |
| Client Email (クライアントメール) | JSON ファイルの キーの先頭に |
| Project ID (プロジェクト ID) | JSON ファイルの 同じサービスアカウントで複数のプロジェクトがある場合、接続するデータセットが含まれるプロジェクトの ID を入力します。 |
| Billing Project ID (請求プロジェクト ID) | この接続の活動の課金対象であるクラウド請求アカウントの ID。 |
| Use Storage API (ストレージ API を使用) | 省略可能な設定。 True: Google BigQuery Storage Read APIを使用します。予想される消費量を理解するには、Google の『BigQuery Storage Read API』ドキュメントを参照し、追加費用情報については Google の「データ抽出の料金」を参照してください。 False: ダイレクト抽出モードを使用します。このモードのデータ制限は 10 MB です。 |
Google BigQuery Standard SQL コネクタの考慮事項
Google BigQuery Standard SQL コネクタを使用するときは、次の点に留意してください。
- 接続済みオブジェクト名は、先頭が文字で、文字、数字、またはアンダースコアのみが含まれている必要があります。オブジェクト名の末尾をアンダースコアにすることはできません。
- 英数字、ドット、アンダースコア、ダッシュの文字を組み合わせた項目名のみがサポートされます。コネクタに、スペースや括弧などの他の文字を含んだ項目名がある場合、同期に失敗します。
- コネクタは、オブジェクトあたり最大 1 億行または 50 GB のいずれか先に制限に達したものを同期できます。
- [Staging (ステージング)] モードがサポートされます。[Direct (直接)] モードはサポートされません。
- Google ドライブから統合したデータを使用している BigQuery テーブルはサポートされません。Google ドライブのデータは BigQuery に移動する必要があります。
- コネクタでは、ネストされた項目はフラット化されません。ネストされたデータを読み込む前にプレビューすると、最上位項目のみが表示されます。
- 一次的な宛先テーブル
- コネクタは、データをクライアントに提供する前にデータをステージングするための一時的な宛先テーブルを BigQuery 内で作成します。このテーブルには、EA_TEMP_<5-character random string>_<objectName> 形式の名前が付けられます。通常、このテーブルは自動的に削除されます。Google BigQuery で追加のデータストレージコストが発生しないようにするには、すべての一時テーブルが削除されていることを確認し、削除されていないテーブルを手動で削除します。
- テーブルのサポート
- Google BigQuery 標準 SQL コネクタは、標準 SQL テーブル、従来の SQL テーブル、および標準 SQL ビューをサポートしますが、従来の SQL ビューはサポートしません。
| 設定 | 説明 |
|---|---|
| Storage Path (ストレージパス) | 従来のバージョンのコネクタにのみ適用されます。ローカルステージファイルを作成してデータを一時的に保存するための Google Cloud Storage のパス。バケット名、またはバケット名とフォルダー名を入力します。たとえば、<bucket_name> または <bucket_name>/<folder_name> と入力します。 このステージング領域にファイルを書き込むには、[Client Email (クライアントメール)] で指定したユーザーに、バケットに対するリスト、参照、および更新権限が必要です。 |
