Utforska datatabeller med API:t Flow Service

Senast uppdaterad: 4 april 2025
  • Ämnen:

Skapat för:

  • Utvecklare

I den här självstudiekursen beskrivs hur du utforskar och förhandsgranskar strukturen och innehållet i datatabeller med hjälp av API:t Flow Service.

OBSERVERA
För att kunna utforska datatabellerna måste du redan ha ett giltigt ID för basanslutning för en tabellkälla. Om du inte har det här ID:t kan du följa de här självstudiekurserna för hur du skapar ett grundläggande anslutnings-ID för en tabellkälla:

Komma igång

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

  • Källor: Experience Platform tillåter att data kan hämtas från olika källor samtidigt som du kan strukturera, etikettera och förbättra inkommande data med Experience Platform-tjänster.
  • Sandlådor: Experience Platform innehåller virtuella sandlådor som partitionerar en enskild Experience Platform-instans till separata virtuella miljöer för att hjälpa till 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.

Utforska era datatabeller

Du kan hämta information om strukturen för dina datatabeller genom att göra en GET-begäran till Flow Service-API:t och samtidigt ange källans anslutnings-ID.

API-format

GET /connections/{BASE_CONNECTION_ID}/explore?objectType=root
ParameterBeskrivning
{BASE_CONNECTION_ID}Källans grundläggande anslutnings-ID.

Begäran

curl -X GET \
  'https://platform.adobe.io/data/foundation/flowservice/connections/5e73e5a2-dc36-45a8-9f16-93c7a43af318/explore?objectType=root' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Svar

Ett lyckat svar returnerar en array med tabeller från källan. Leta reda på tabellen som du vill hämta till Experience Platform och notera dess path-egenskap, eftersom du måste ange den i nästa steg för att inspektera dess struktur.

[
    {
        "type": "table",
        "name": "ACME Spring Campaign",
        "path": "acmeSpringCampaign",
        "canPreview": true,
        "canFetchSchema": true
    },
    {
        "type": "table",
        "name": "ACME Summer Campaign",
        "path": "acmeSummerCampaign",
        "canPreview": true,
        "canFetchSchema": true
    }
]

Inspektera strukturen i en tabell

Om du vill inspektera innehållet i datatabellerna utför du en GET-begäran till API:t Flow Service samtidigt som du anger sökvägen till en tabell som en frågeparameter.

API-format

GET /connections/{BASE_CONNECTION_ID}/explore?objectType=table&object={TABLE_PATH}
ParameterBeskrivning
{BASE_CONNECTION_ID}Källans grundläggande anslutnings-ID.
{TABLE_PATH}Egenskapen path för den tabell som du vill inspektera.

Begäran

curl -X GET \
  'https://platform.adobe.io/data/foundation/flowservice/connections/5e73e5a2-dc36-45a8-9f16-93c7a43af318/explore?objectType=table&object=acmeSpringCampaign' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Svar

Ett godkänt svar returnerar information om innehållet och strukturen i den angivna tabellen. Information om var och en av tabellens kolumner finns inom elementen i arrayen columns.

{
  "format": "flat",
  "schema": {
    "columns": [
      {
        "name": "TestID",
        "type": "string",
        "xdm": {
          "type": "string"
        }
      },
      {
        "name": "Name",
        "type": "string",
        "xdm": {
          "type": "string"
        }
      },
      {
        "name": "Datefield",
        "type": "string",
        "meta:xdmType": "date-time",
        "xdm": {
          "type": "string",
          "format": "date-time"
        }
      },
      {
        "name": "complaint_type",
        "type": "string",
        "xdm": {
          "type": "string"
        }
      },
      {
        "name": "complaint_description",
        "type": "string",
        "xdm": {
          "type": "string"
        }
      },
      {
        "name": "status",
        "type": "string",
        "xdm": {
          "type": "string"
        }
      },
      {
        "name": "status_change_date",
        "type": "string",
        "meta:xdmType": "date-time",
        "xdm": {
          "type": "string",
          "format": "date-time"
        }
      },
      {
        "name": "city",
        "type": "string",
        "xdm": {
          "type": "string"
        }
      },
      {
        "name": "Datefield2",
        "type": "string",
        "meta:xdmType": "date-time",
        "xdm": {
          "type": "string",
          "format": "date-time"
        }
      }
    ]
  }
}