Esplora le tabelle di dati utilizzando l'API Flow Service

Ultimo aggiornamento: 4 aprile 2025
  • Argomenti:

Creato per:

  • Sviluppatore

Questo tutorial illustra come esplorare e visualizzare in anteprima la struttura e il contenuto delle tabelle dati utilizzando l'API Flow Service.

NOTA
Per esplorare le tabelle dati, è necessario disporre già di un ID connessione di base valido per un'origine tabulare. Se non disponi di questo ID, consulta i seguenti tutorial per i passaggi su come creare un ID connessione di base per una sorgente tabulare:

Introduzione

Questa guida richiede una buona conoscenza dei seguenti componenti di Adobe Experience Platform:

  • Origini: Experience Platform consente l'acquisizione di dati da varie origini e consente di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi Experience Platform.
  • Sandbox: Experience Platform fornisce sandbox virtuali che suddividono una singola istanza di Experience Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.

Utilizzo delle API di Experience Platform

Per informazioni su come effettuare correttamente chiamate alle API di Experience Platform, consulta la guida introduttiva alle API di Experience Platform.

Esplora le tabelle di dati

È possibile recuperare informazioni sulla struttura delle tabelle dati effettuando una richiesta GET all'API Flow Service e fornendo l'ID connessione di base dell'origine.

Formato API

GET /connections/{BASE_CONNECTION_ID}/explore?objectType=root
ParametroDescrizione
{BASE_CONNECTION_ID}ID della connessione di base dell'origine.

Richiesta

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}'

Risposta

In caso di esito positivo, la risposta restituisce un array di tabelle dall’origine. Individua la tabella da inserire in Experience Platform e prendi nota della relativa proprietà path, in quanto è necessario fornirla nel passaggio successivo per esaminarne la struttura.

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

Controllare la struttura di una tabella

Per verificare il contenuto delle tabelle dati, eseguire una richiesta GET all'API Flow Service specificando il percorso di una tabella come parametro di query.

Formato API

GET /connections/{BASE_CONNECTION_ID}/explore?objectType=table&object={TABLE_PATH}
ParametroDescrizione
{BASE_CONNECTION_ID}ID della connessione di base dell'origine.
{TABLE_PATH}La proprietà path della tabella che si desidera controllare.

Richiesta

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}'

Risposta

In caso di esito positivo, la risposta restituisce informazioni sul contenuto e sulla struttura della tabella specificata. I dettagli relativi a ciascuna colonna della tabella si trovano all'interno di elementi dell'array 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"
        }
      }
    ]
  }
}

Passaggi successivi

Seguendo questa esercitazione, sono state raccolte informazioni sulla struttura e sul contenuto delle tabelle di dati. Inoltre, è stato recuperato il percorso della tabella da acquisire in Experience Platform. Puoi utilizzare queste informazioni per creare una connessione sorgente e un flusso di dati per portare i dati in Experience Platform. Per i passaggi specifici su come creare una connessione di origine e un flusso di dati utilizzando l'API Flow Service, consulta i seguenti tutorial:

Pagina precedenteEsplora i dati del protocollo
Pagina successivaRaccogliere dati pubblicitari

Experience Platform