Verbinden von Azure Synapse Analytics mit Experience Platform mithilfe der Flow Service-API

Last update: Wed Jun 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:

Erstellt für:

Entwickler

IMPORTANT

Die Azure Synapse Analytics ist im Quellkatalog für Benutzende verfügbar, die Real-Time Customer Data Platform Ultimate erworben haben.

Lesen Sie dieses Handbuch, um zu erfahren, wie Sie Ihr Azure Synapse Analytics-Konto mithilfe der Flow Service API mit Adobe Experience Platform verbinden.

Erste Schritte

Dieses Handbuch setzt ein Verständnis der folgenden Komponenten von Experience Platform voraus:

Quellen: Experience Platform ermöglicht die Aufnahme von Daten aus verschiedenen Quellen und bietet Ihnen die Möglichkeit, die eingehenden Daten mithilfe von Experience Platform-Services zu strukturieren, zu kennzeichnen und anzureichern.
Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Experience Platform-Instanz in separate virtuelle Umgebungen unterteilen, damit Sie Programme für digitale Erlebnisse besser entwickeln und weiterentwickeln können.

Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie benötigen, um mithilfe der Flow Service-API eine Verbindung zu Azure Synapse Analytics herstellen zu können.

Sammeln erforderlicher Anmeldedaten

Informationen zur Authentifizierung Azure Synapse Analytics Sie inÜbersicht“.

Verwenden von Experience Platform-APIs

Informationen zum erfolgreichen Aufrufen von Experience Platform-APIs finden Sie im Handbuch unter mit Experience Platform-APIs.

Verbinden von Azure Synapse Analytics mit Experience Platform

Im Folgenden erfahren Sie, wie Sie eine Basisverbindung erstellen und Ihr Azure Synapse Analytics-Konto mit Experience Platform verbinden.

Erstellen einer Basisverbindung

Eine Basisverbindung speichert wichtige Informationen, die Ihr Quellsystem mit Adobe Experience Platform verknüpfen. Dazu gehören:

Authentifizierungsdaten Ihrer Quelle
Der aktuelle Status der Verbindung
Eine eindeutige Basisverbindungs-ID

Mit Basisverbindungs-ID können Sie Dateien aus Ihrer Quelle durchsuchen und untersuchen, um zu ermitteln, welche Elemente zusammen mit ihren Datentypen und Formaten aufgenommen werden sollen.

Um eine Basisverbindungs-ID zu erstellen, senden Sie eine POST-Anfrage an den /connections-Endpunkt, einschließlich Ihrer Azure Synapse Analytics Authentifizierungsdaten in den Anfrageparametern.

API-Format

POST /connections

Auf Verbindungszeichenfolgen basierende Authentifizierung

Anfrage

Die folgende Anfrage erstellt eine Basisverbindung für Azure Synapse Analytics unter Verwendung der Authentifizierung über eine Verbindungszeichenfolge.

accordion

Beispielanfrage anzeigen

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
Parameter	Beschreibung
`auth.params.connectionString`	Die Verbindungszeichenfolge, die zum Herstellen einer Verbindung mit Azure Synapse Analytics verwendet wird. Das Azure Synapse Analytics-Verbindungszeichenfolgenmuster ist `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`	Die Spezifikations-ID der Azure Synapse Analytics-Verbindung lautet: `a49bcc7d-8038-43af-b1e4-5a7a089a7d79`.

Antwort

Eine erfolgreiche Antwort gibt Details zur neu erstellten Basisverbindung zurück, einschließlich ihrer eindeutigen Kennung (id).

accordion

Beispielantwort anzeigen

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

Schlüsselbasierte Authentifizierung für Service-Prinzipal

Die folgende Anfrage erstellt eine Basisverbindung für Azure Synapse Analytics mit einer Authentifizierung, die auf dem Service-Prinzipal-Schlüssel basiert.

Anfrage

accordion

Beispielanfrage anzeigen

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
Anmeldedaten	Beschreibung
`auth.params.server`	Der vollständig qualifizierte Domain-Name Ihres Azure Synapse Analytics SQL-Endpunkts.
`auth.params.database`	Der Name der spezifischen Datenbank in Ihrem Azure Synapse Analytics Workspace.
`auth.params.tenant`	Die mit Ihrem Azure-Abonnement verknüpfte Azure Active Directory-Mandanten-ID.
`auth.params.servicePrincipalId`	Die Client-ID einer Azure Active Directory.
`auth.params.servicePrincipalKey`	Das mit dem Service-Prinzipal verknüpfte Client-Geheimnis oder Kennwort.
`connectSpec.id`	Die Verbindungsspezifikations-ID von Azure Synapse Analytics.

Antwort

Eine erfolgreiche Antwort gibt Details zur neu erstellten Basisverbindung zurück, einschließlich ihrer eindeutigen Kennung (id).

accordion

Beispielantwort anzeigen

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

Nächste Schritte

In diesem Tutorial haben Sie eine Azure Synapse Analytics-Basisverbindung mithilfe der Flow Service-API erstellt. Sie können diese Basisverbindungs-ID in den folgenden Tutorials verwenden:

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089