Utforska datatabeller med Flow Service API

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

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

Använda plattforms-API:er

Mer information om hur du kan anropa API:er för plattformar finns i handboken komma igång med plattforms-API:er.

Utforska era datatabeller

Du kan hämta information om strukturen för dina datatabeller genom att göra en GET-förfrågan till Flow Service API när du anger källans anslutnings-ID.

API-format

GET /connections/{BASE_CONNECTION_ID}/explore?objectType=root
Parameter
Beskrivning
{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. Hitta tabellen du vill ta med i Platform och notera path -egenskapen, 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
    }
]

Inspect tabellstrukturen

Utför en GET-förfrågan till Flow Service API när sökvägen för en tabell anges som en frågeparameter.

API-format

GET /connections/{BASE_CONNECTION_ID}/explore?objectType=table&object={TABLE_PATH}
Parameter
Beskrivning
{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 tabellens kolumner finns i element i columns array.

{
  "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"
        }
      }
    ]
  }
}

Nästa steg

Genom att följa den här självstudiekursen har du samlat in information om strukturen och innehållet i dina datatabeller. Dessutom har du hämtat sökvägen till tabellen som du vill importera till Platform. Du kan använda den här informationen för att skapa en källanslutning och ett dataflöde för att överföra data till plattformen. I följande självstudiekurser finns mer information om hur du skapar en källanslutning och ett dataflöde med Flow Service API:

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