[Ultimate]{class="badge positive"}

Anslut Google BigQuery till Experience Platform med API:t Flow Service

IMPORTANT
Källan Google BigQuery är tillgänglig i källkatalogen för användare som har köpt Real-Time Customer Data Platform Ultimate.

Läs den här vägledningen när du vill lära dig hur du ansluter din Google BigQuery-databas till Adobe Experience Platform med Flow Service API.

Kom igång

Handboken kräver en fungerande förståelse av följande komponenter i Experience Platform:

  • Källor: Med Experience Platform kan data hämtas från olika källor samtidigt som du kan strukturera, etikettera och förbättra inkommande data med hjälp av Experience Platform tjänster.
  • Sandlådor: Experience Platform tillhandahåller virtuella sandlådor som partitionerar en enda Experience Platform-instans till separata virtuella miljöer för att utveckla och utveckla program för digitala upplevelser.

Använda Experience Platform API:er

Information om hur du kan anropa Experience Platform API:er finns i guiden Komma igång med Experience Platform API:er.

Samla in nödvändiga inloggningsuppgifter

Läs Google BigQuery autentiseringsguiden om du vill ha mer information om hur du hämtar dina Google BigQuery-autentiseringsuppgifter.

Anslut Google BigQuery till Experience Platform på Azure azure

Läs stegen nedan om du vill ha information om hur du ansluter din Google BigQuery-källa till Experience Platform på Azure.

Skapa en basanslutning för Google BigQuery på Experience Platform på Azure azure-base

En basanslutning bevarar information mellan källan och Experience Platform, inklusive autentiseringsuppgifter för källan, anslutningens aktuella tillstånd och ditt unika basanslutnings-ID. Med det grundläggande anslutnings-ID:t kan du utforska och navigera bland filer inifrån källan och identifiera de specifika objekt som du vill importera, inklusive information om deras datatyper och format.

Om du vill skapa ett basanslutnings-ID skickar du en POST-begäran till /connections-slutpunkten och anger dina Google BigQuery-autentiseringsuppgifter som en del av parametrarna för begäran.

API-format

POST /connections
Använd grundläggande autentisering
accordion
Begäran

Följande begäran skapar en basanslutning för Google BigQuery med grundläggande autentisering.

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
Egenskap Beskrivning
auth.params.project Projekt-ID för standardprojektet Google BigQuery som ska frågas. mot.
auth.params.clientId ID-värdet som används för att generera uppdateringstoken.
auth.params.clientSecret Klientvärdet som används för att generera uppdateringstoken.
auth.params.refreshToken Uppdateringstoken från Google som används för att auktorisera åtkomst till Google BigQuery.
connectionSpec.id Anslutningsspecifikations-ID Google BigQuery: 3c9b37f8-13a6-43d8-bad3-b863b941fedd.
accordion
svar

Ett lyckat svar returnerar information om den nyligen skapade anslutningen, inklusive dess unika identifierare (id). Detta ID krävs för att utforska dina data i nästa självstudiekurs.

code language-json
{
    "id": "6990abad-977d-41b9-a85d-17ea8cf1c0e4",
    "etag": "\"ca00acbf-0000-0200-0000-60149e1e0000\""
}
Använd tjänstautentisering
accordion
Begäran

Följande begäran skapar en basanslutning för Google BigQuery med tjänstautentisering:

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
Egenskap Beskrivning
auth.params.projectId Projekt-ID för standardprojektet Google BigQuery som ska frågas. mot.
auth.params.keyFileContent Nyckelfilen som används för att autentisera tjänstkontot. Du måste koda nyckelfilens innehåll i Base64.
auth.params.largeResultsDataSetId (Valfritt) Det förskapade Google BigQuery-datauppsättnings-ID som krävs för att aktivera stöd för stora resultatuppsättningar.
accordion
svar

Ett lyckat svar returnerar information om den nyligen skapade anslutningen, inklusive dess unika identifierare (id). Detta ID krävs för att utforska dina data i nästa självstudiekurs.

code language-json
{
    "id": "6990abad-977d-41b9-a85d-17ea8cf1c0e4",
    "etag": "\"ca00acbf-0000-0200-0000-60149e1e0000\""
}

Anslut Google BigQuery till Experience Platform på Amazon Web Services (AWS) aws

Läs stegen nedan om du vill ha information om hur du ansluter din Google BigQuery-databas till Experience Platform på AWS.

Skapa en basanslutning för Google BigQuery på Experience Platform på AWS

AVAILABILITY
Detta avsnitt gäller implementeringar av Experience Platform som körs på Amazon Web Services (AWS). Experience Platform som körs på AWS är för närvarande tillgängligt för ett begränsat antal kunder. Mer information om den Experience Platform-infrastruktur som stöds finns i Experience Platform översikt över flera moln.

API-format

POST /connections

Begäran

Följande begäran skapar en basanslutning för att ansluta Google BigQuery till Experience Platform på AWS.

Markera för att visa exempel
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
Egenskap Beskrivning
auth.params.projectId Projekt-ID för standardprojektet Google BigQuery som ska frågas. mot.
auth.params.keyFileContent Nyckelfilen som används för att autentisera tjänstkontot. Du måste koda nyckelfilens innehåll i Base64.
auth.params.datasetId Det datauppsättnings-ID som motsvarar din Google BigQuery-källa. Detta ID representerar var datatabellerna finns.

Svar

Ett lyckat svar returnerar information om den nyligen skapade anslutningen, inklusive dess unika identifierare (id). Detta ID krävs för att du ska kunna utforska ditt lagringsutrymme i nästa självstudiekurs.

Markera för att visa exempel
code language-json
{
    "id": "6990abad-977d-41b9-a85d-17ea8cf1c0e4",
    "etag": "\"ca00acbf-0000-0200-0000-60149e1e0000\""
}

Nästa steg

Genom att följa den här självstudiekursen har du skapat en Google BigQuery-basanslutning med API:t Flow Service. Du kan använda detta grundläggande anslutnings-ID i följande självstudier:

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