[Ultimate]{class="badge positive"}

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

IMPORTANT
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.

accordion
Visualizza richiesta di esempio
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": "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"
      }
  }'
table 0-row-2 1-row-2 2-row-2
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).

accordion
Visualizza risposta di esempio
code language-json
{
    "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

accordion
Visualizza richiesta di esempio
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": "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"
    }
  }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
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).

accordion
Visualizza risposta di esempio
code language-json
{
    "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
337b99bb-92fb-42ae-b6b7-c7042161d089