[Ultimate]{class="badge positive"}
Google BigQuery ソースは、Real-Time Customer Data Platform Ultimateを購入したユーザーがソースカタログで利用できます。
このガイドでは、Flow Service APIを使用してGoogle BigQuery データベースをAdobe Experience Platformに接続する方法について説明します。
基本を学ぶ
このガイドは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
- ソース : Experience Platformを使用すると、様々なソースからデータを取り込むことができますが、Experience Platform サービスを使用して着信データを構造化、ラベル付け、強化することができます。
- サンドボックス : Experience Platformは、1つのExperience Platform インスタンスを個別のバーチャル環境に分割して、デジタルエクスペリエンスアプリケーションの開発と進化に役立つバーチャルサンドボックスを提供します。
Experience Platform APIの呼び出しを正常に行う方法について詳しくは、Experience Platform APIの概要に関するガイドを参照してください。
必要な資格情報の収集
Google BigQuery資格情報の取得手順の詳細については、Google BigQuery 認証ガイド を参照してください。
AzureでGoogle BigQuery ソースをExperience Platformに接続する方法について詳しくは、以下の手順を参照してください。
ベース接続は、ソースの認証情報、接続の現在の状態、一意のベース接続IDなど、ソースとExperience Platform間の情報を保持します。 ベース接続 ID により、ソース内からファイルを参照および移動し、データタイプやフォーマットに関する情報を含む、取り込みたい特定の項目を識別することができます。
ベース接続 ID を作成するには、/connections エンドポイントに POST リクエストを実行し、Google BigQuery 認証資格情報をリクエストパラメーターの一部として使用します。
API 形式
基本認証を使用
| accordion |
| リクエスト |
|
次のリクエストは、基本認証を使用してGoogle BigQueryのベース接続を作成します。
| code language-shell |
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Google BigQuery connection with basic authentication",
"description": "Google BigQuery connection with basic authentication",
"auth": {
"specName": "Basic Authentication",
"type": "OAuth2.0",
"params": {
"project": "{PROJECT}",
"clientId": "{CLIENT_ID},
"clientSecret": "{CLIENT_SECRET}",
"refreshToken": "{REFRESH_TOKEN}"
}
},
"connectionSpec": {
"id": "3c9b37f8-13a6-43d8-bad3-b863b941fedd",
"version": "1.0"
}
}'
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 |
|
| プロパティ |
説明 |
auth.params.project |
クエリする既定のGoogle BigQuery プロジェクトのプロジェクト ID。 対する。 |
auth.params.clientId |
更新トークンの生成に使用されるID値。 |
auth.params.clientSecret |
更新トークンの生成に使用されるクライアント値。 |
auth.params.refreshToken |
Googleから取得した更新トークンは、Google BigQueryへのアクセスの承認に使用されました。 |
connectionSpec.id |
Google BigQuery接続仕様ID: 3c9b37f8-13a6-43d8-bad3-b863b941fedd。 |
|
| accordion |
| 応答 |
|
リクエストが成功した場合は、一意の ID（id）を含む、新しく作成した接続の詳細が返されます。 このIDは、次のチュートリアルでデータを検索するために必要です。
| code language-json |
{
"id": "6990abad-977d-41b9-a85d-17ea8cf1c0e4",
"etag": "\"ca00acbf-0000-0200-0000-60149e1e0000\""
}
|
|
サービス認証を使用
| accordion |
| リクエスト |
|
次のリクエストは、サービス認証を使用してGoogle BigQueryのベース接続を作成します。
| code language-shell |
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Google BigQuery base connection with service account",
"description": "Google BigQuery connection with service account",
"auth": {
"specName": "Service Authentication",
"params": {
"projectId": "{PROJECT_ID}",
"keyFileContent": "{KEY_FILE_CONTENT},
"largeResultsDataSetId": "{LARGE_RESULTS_DATASET_ID}"
}
},
"connectionSpec": {
"id": "3c9b37f8-13a6-43d8-bad3-b863b941fedd",
"version": "1.0"
}
}'
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 |
|
| プロパティ |
説明 |
auth.params.projectId |
クエリする既定のGoogle BigQuery プロジェクトのプロジェクト ID。 対する。 |
auth.params.keyFileContent |
サービスアカウントの認証に使用されるキーファイル。 キーファイルの内容をBase64でエンコードする必要があります。 |
auth.params.largeResultsDataSetId |
（オプション）大規模な結果セットのサポートを有効にするために必要な、事前作成されたGoogle BigQuery データセット ID。 |
|
| accordion |
| 応答 |
|
リクエストが成功した場合は、一意の ID（id）を含む、新しく作成した接続の詳細が返されます。 このIDは、次のチュートリアルでデータを検索するために必要です。
| code language-json |
{
"id": "6990abad-977d-41b9-a85d-17ea8cf1c0e4",
"etag": "\"ca00acbf-0000-0200-0000-60149e1e0000\""
}
|
|
Google BigQuery データベースをAWS上のExperience Platformに接続する方法について詳しくは、以下の手順を参照してください。
この節は、Amazon Web Services（AWS）で動作するExperience Platformの実装に適用されます。 AWS上で動作するExperience Platformは、現在、一部のお客様にご利用いただけます。 サポートされているExperience Platform インフラストラクチャについて詳しくは、
Experience Platform マルチクラウドの概要を参照してください。
API 形式
リクエスト
次のリクエストは、AWS上のExperience PlatformにGoogle BigQueryを接続するためのベース接続を作成します。
| code language-shell |
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Google BigQuery base connection on AWS",
"description": "Google BigQuery base connection on AWS",
"auth": {
"specName": "Service Authentication",
"params": {
"projectId": "{PROJECT_ID}",
"keyFileContent": "{KEY_FILE_CONTENT},
"datasetId": "{DATASET_ID}"
},
"connectionSpec": {
"id": "3c9b37f8-13a6-43d8-bad3-b863b941fedd",
"version": "1.0"
}
}'
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 |
|
| プロパティ |
説明 |
auth.params.projectId |
クエリする既定のGoogle BigQuery プロジェクトのプロジェクト ID。 対する。 |
auth.params.keyFileContent |
サービスアカウントの認証に使用されるキーファイル。 キーファイルの内容をBase64でエンコードする必要があります。 |
auth.params.datasetId |
Google BigQuery ソースに対応するデータセット ID。 このIDは、データテーブルの場所を表します。 |
応答
リクエストが成功した場合は、一意の ID（id）を含む、新しく作成した接続の詳細が返されます。 このIDは、次のチュートリアルでストレージを探索するために必要です。
| code language-json |
{
"id": "6990abad-977d-41b9-a85d-17ea8cf1c0e4",
"etag": "\"ca00acbf-0000-0200-0000-60149e1e0000\""
}
|