Ultimate
Verbinden von Azure Synapse Analytics mit Experience Platform mithilfe der Flow Service-API
Erstellt für:
- Entwickler
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
Anfrage
Die folgende Anfrage erstellt eine Basisverbindung für Azure Synapse Analytics unter Verwendung der Authentifizierung über eine Verbindungszeichenfolge.
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"
}
}'
auth.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
.Antwort
Eine erfolgreiche Antwort gibt Details zur neu erstellten Basisverbindung zurück, einschließlich ihrer eindeutigen Kennung (id
).
{
"id": "6bc13a3b-3546-455f-813a-3b3546a55fb1",
"etag": "\"3500866c-0000-0200-0000-5e83afa30000\""
}
Die folgende Anfrage erstellt eine Basisverbindung für Azure Synapse Analytics mit einer Authentifizierung, die auf dem Service-Prinzipal-Schlüssel basiert.
Anfrage
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"
}
}'
auth.params.server
auth.params.database
auth.params.tenant
auth.params.servicePrincipalId
auth.params.servicePrincipalKey
connectSpec.id
Antwort
Eine erfolgreiche Antwort gibt Details zur neu erstellten Basisverbindung zurück, einschließlich ihrer eindeutigen Kennung (id
).
{
"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: