[Ultimate]{class="badge positive"}

Google BigQuery ソース

IMPORTANT
Google BigQuery ソースは、Real-Time Customer Data Platform Ultimateを購入したユーザーがソースカタログで利用できます。

AzureまたはAmazon Web Services(AWS)でGoogle BigQuery アカウントをAdobe Experience Platformに正常に接続するために必要な前提条件の手順については、このドキュメントを参照してください。

前提条件 prerequisites

Google BigQuery アカウントをExperience Platformに接続する前に完了する必要がある前提条件の設定については、次の節を参照してください。

IP アドレスの許可リスト

AzureまたはAmazon Web Services(AWS)のExperience Platformにソースを接続する前に、リージョン固有のIP アドレスを許可リストに追加する必要があります。 詳しくは、AzureおよびAWS上のExperience Platformに接続するためのIP アドレスの許可リストに加えるに関するガイドを参照してください。

AzureでのExperience Platformへの認証 azure

Google BigQuery アカウントをAzure上のExperience Platformに接続するには、次の資格情報を指定する必要があります。

基本認証

OAuth 2.0と基本認証を組み合わせて認証するには、次の資格情報に適切な値を指定します。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
資格情報 説明
project プロジェクトは、Google Cloudを含むGoogle BigQuery リソースの基本レベルの整理エンティティです。
clientID クライアント IDは、Google BigQuery OAuth 2.0資格情報の半分です。
clientSecret クライアントの秘密鍵は、Google BigQuery OAuth 2.0資格情報の残りの半分です。
refreshToken

更新トークンを使用すると、APIの新しいアクセストークンを取得できます。 アクセストークンの有効期間は限られており、プロジェクトの期間中に失効する可能性があります。 更新トークンを使用すると、必要に応じてプロジェクトのその後のアクセストークンを認証してリクエストできます。 更新トークンに次のGoogle個のOAuth スコープが含まれていることを確認します。

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

これらのスコープを使用すると、Experience PlatformはBigQuery ジョブを送信し、設定されたプロジェクトからデータを読み取ることができます。

largeResultsDataSetId

(オプション)大規模な結果セットのサポートを有効にするために必要な、事前作成されたGoogle BigQuery データセット ID。

  • largeResultsDataSetIdは、大規模な結果セットの一時テーブルを保存するために使用される、事前作成されたBigQuery データセットを参照する必要があります。
  • 値には、プロジェクトに適格な名前(marketing_temp_resultsを使用しない)ではなく、データセット ID (my-project.marketing_temp_resultsなど)のみを含める必要があります。
  • largeResultsDataSetIdで指定されたデータセットの場所(地域)は、クエリするテーブルの場所と一致する必要があります。
  • コネクタで使用されるアカウントには、このデータセットの一時的な結果を読み取り、書き込むための権限が必要です。 少なくとも、BigQuery Data Editorで指定されたデータセットにlargeResultsDataSetIdの役割を割り当てます。

Google IDに必要なIAM役割

OAuth資格情報(クライアント ID、クライアント秘密鍵、およびrefreshToken)の生成に使用されるGoogle IDには、ターゲット Google Cloud プロジェクトで次のIAM ロールが必要です。

  • BigQuery Job User
  • BigQuery Data Viewer
  • BigQuery Read Session User

これらの役割により、Experience PlatformでBigQuery件のジョブを作成および実行し、設定されたテーブルからデータを読み取り、コネクタで必要に応じて読み取りセッションを使用できるようになります。 これらの役割は、ソースで使用する予定のBigQuery データセットを含む同じプロジェクトで付与されていることを確認してください。

Google APIのOAuth 2.0資格情報を生成する方法の詳細な手順については、次のGoogle OAuth 2.0認証ガイド ​を参照してください。

サービス認証

サービス認証を使用して認証を行うには、次の資格情報に適切な値を指定します。

: サービス認証で正常に認証するには、サービス アカウントに十分な権限(例:BigQuery Job UserBigQuery Data ViewerBigQuery Read Session UserBigQuery Data Owner)が必要です。

table 0-row-2 1-row-2 2-row-2 3-row-2
資格情報 説明
projectId クエリの対象となるGoogle BigQueryのID。
keyFileContent サービスアカウントの認証に使用されるキーファイル。 この値は、Google Cloud service accounts ダッシュボード ​から取得できます。 キーファイルの内容はJSON形式です。 Experience Platformに認証する場合は、これをBase64にエンコードする必要があります。
largeResultsDataSetId

(オプション)大規模な結果セットのサポートを有効にするために必要な、事前作成されたGoogle BigQuery データセット ID。

  • largeResultsDataSetIdは、大規模な結果セットの一時テーブルを保存するために使用される、事前作成されたBigQuery データセットを参照する必要があります。
  • 値には、プロジェクトに適格な名前(marketing_temp_resultsを使用しない)ではなく、データセット ID (my-project.marketing_temp_resultsなど)のみを含める必要があります。
  • largeResultsDataSetIdで指定されたデータセットの場所(地域)は、クエリするテーブルの場所と一致する必要があります。
  • コネクタで使用されるアカウントには、このデータセットの一時的な結果を読み取り、書き込むための権限が必要です。 少なくとも、BigQuery Data Editorで指定されたデータセットにlargeResultsDataSetIdの役割を割り当てます。

Google BigQueryでのサービスアカウントの使用について詳しくは、​ Google BigQueryでの サービスアカウントの使用に関するガイドを参照してください。

AWSでのExperience Platformへの認証 aws

Google BigQuery アカウントをAWS上のExperience Platformに接続するには、次の資格情報を指定する必要があります。

資格情報
説明
projectId
クエリの対象となるGoogle BigQueryのID。
keyFileContent
サービスアカウントの認証に使用されるキーファイル。 この値は、Google Cloud service accounts ダッシュボード ​から取得できます。 キーファイルの内容はJSON形式です。 Experience Platformに認証する場合は、これをBase64にエンコードする必要があります。
datasetId
Google BigQuery データセット ID。 このIDは、データテーブルの場所を表します。

Google BigQueryをExperience Platformに接続

以下のドキュメントでは、APIまたはユーザーインターフェイスを使用してGoogle BigQueryをExperience Platformに接続する方法について説明します。

API の使用

UI の使用

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089