Documentazione Experience Platform Guida ai connettori di origini

Ultimate

Connetti Azure Synapse Analytics ad Experience Platform utilizzando l'API Flow Service

Ultimo aggiornamento: 18 giugno 2025

Argomenti:

Creato per:

Sviluppatore

IMPORTANTE

L'origine Azure Synapse Analytics è disponibile nel catalogo delle origini per gli utenti che hanno acquistato Real-Time Customer Data Platform Ultimate.

Leggi questa guida per scoprire come collegare il tuo account Azure Synapse Analytics a Adobe Experience Platform utilizzando Flow Service API.

Introduzione

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

Origini: Experience Platform consente di acquisire dati da varie origini e allo stesso tempo 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 Experience Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.

Le sezioni seguenti forniscono informazioni aggiuntive che è necessario conoscere per connettersi correttamente a Azure Synapse Analytics utilizzando l'API Flow Service.

Raccogli le credenziali richieste

Per informazioni sull'autenticazione, leggere la Azure Synapse Analytics panoramica.

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.

Connetti Azure Synapse Analytics ad Experience Platform

Per informazioni su come creare una connessione di base e connettere l'account Azure Synapse Analytics ad Experience Platform, leggere quanto segue.

Creare una connessione di base

Una connessione di base memorizza le informazioni chiave che collegano il sistema di origine a Adobe Experience Platform. Ciò include:

Credenziali di autenticazione dell'origine
Stato corrente della connessione
Un ID di connessione di base univoco

L'ID connessione di base ti consente di sfogliare ed esplorare i file dall'origine, identificando gli elementi da acquisire, insieme ai relativi tipi di dati e formati.

Per creare un ID connessione di base, inviare una richiesta POST all'endpoint /connections, incluse le credenziali di autenticazione Azure Synapse Analytics nei parametri della richiesta.

Formato API

POST /connections

Autenticazione basata su stringa di connessione

Richiesta

La richiesta seguente crea una connessione di base per Azure Synapse Analytics utilizzando l'autenticazione basata su stringa di connessione.

Visualizza richiesta di esempio

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": "Connection for Azure Synapse Analytics",
      "description": "Connection for Azure Synapse Analytics",
      "auth": {
          "specName": "Connection String Based Authentication",
          "params": {
              "connectionString": "Server=tcp:{SERVER_NAME}.database.windows.net,1433;Database={DATABASE};User ID={USERNAME}@{SERVER_NAME};Password={PASSWORD};Trusted_Connection=False;Encrypt=True;Connection Timeout=30"
          }
      },
      "connectionSpec": {
          "id": "a49bcc7d-8038-43af-b1e4-5a7a089a7d79",
          "version": "1.0"
      }
  }'

Parametro

Descrizione

auth.params.connectionString

Stringa di connessione utilizzata per connettersi a Azure Synapse Analytics. Il modello di stringa di connessione Azure Synapse Analytics è

Server=tcp:{SERVER_NAME}.database.windows.net,1433;Database={DATABASE};User ID={USERNAME}@{SERVER_NAME};Password={PASSWORD};Trusted_Connection=False;Encrypt=True;Connection Timeout=30

.

connectionSpec.id

ID della specifica di connessione Azure Synapse Analytics: a49bcc7d-8038-43af-b1e4-5a7a089a7d79.

Risposta

In caso di esito positivo, la risposta restituisce i dettagli della connessione di base appena creata, incluso il relativo identificatore univoco (id).

Visualizza risposta di esempio

{
    "id": "6bc13a3b-3546-455f-813a-3b3546a55fb1",
    "etag": "\"3500866c-0000-0200-0000-5e83afa30000\""
}

Autenticazione basata su chiave dell'entità servizio

La richiesta seguente crea una connessione di base per Azure Synapse Analytics utilizzando l'autenticazione basata sulla chiave dell'entità servizio.

Richiesta

Visualizza richiesta di esempio

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": "Connection for Azure Synapse Analytics",
    "description": "Connection for Azure Synapse Analytics",
    "auth": {
      "specName": "Service Principal Key Based Authentication",
      "params": {
        "server": "yourworkspace.sql.azuresynapse.net",
        "database": "SalesDW",
        "tenant": "72f988bf-86f1-41af-91ab-2d7cd011db47",
        "servicePrincipalId": "e7b8c1f2-1234-4c9a-9f3e-abcdef123456",
        "servicePrincipalKey": "~XyZ1234abcDEF5678..."
      }
    },
    "connectionSpec": {
      "id": "a49bcc7d-8038-43af-b1e4-5a7a089a7d79",
      "version": "1.0"
    }
  }'

Credenziali

Descrizione

auth.params.server

Il nome di dominio completo dell'endpoint SQL Azure Synapse Analytics.

auth.params.database

Il nome del database specifico nell'area di lavoro Azure Synapse Analytics.

auth.params.tenant

L'ID tenant Azure Active Directory associato alla sottoscrizione Azure.

auth.params.servicePrincipalId

ID client di un'applicazione Azure Active Directory.

auth.params.servicePrincipalKey

Il segreto client o la password associati all'entità servizio.

connectSpec.id

ID della specifica di connessione di Azure Synapse Analytics.

Risposta

In caso di esito positivo, la risposta restituisce i dettagli della connessione di base appena creata, incluso il relativo identificatore univoco (id).

Visualizza risposta di esempio

{
    "id": "6bc13a3b-3546-455f-813a-3b3546a55fb1",
    "etag": "\"3500866c-0000-0200-0000-5e83afa30000\""
}

Passaggi successivi

Seguendo questa esercitazione, è stata creata una connessione di base Azure Synapse Analytics utilizzando l'API Flow Service. Puoi utilizzare questo ID connessione di base nelle seguenti esercitazioni:

recommendation-more-help