DokumentationExperience PlatformAnleitung zu Quell-Connectoren

Ultimate

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

Letzte Aktualisierung: 18. Juni 2025
  • Themen:

Erstellt für:

  • Entwickler
WICHTIG
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.

Beispielanfrage anzeigen
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"
      }
  }'
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).

Beispielantwort anzeigen
{
    "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

Beispielanfrage anzeigen
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"
    }
  }'
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).

Beispielantwort anzeigen
{
    "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:

  • Erkunden von Struktur und Inhalten Ihrer Datentabellen mithilfe der Flow Service -API
  • Erstellen eines Datenflusses, um Datenbankdaten mithilfe der API Flow Service Experience Platform zu übertragen
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089