Verbinding maken met Experience Platform via de Flow Service APIAzure Synapse Analytics

Laatst bijgewerkt: 24 mei 2026

Onderwerpen:
Sources

Gemaakt voor:

Developer

IMPORTANT

De Azure Synapse Analytics -bron is in de broncatalogus beschikbaar voor gebruikers die Real-Time Customer Data Platform Ultimate hebben aangeschaft.

Lees deze gids om te leren hoe te om uw Azure Synapse Analytics rekening met Adobe Experience Platform te verbinden gebruikend Flow Service API .

Aan de slag

Deze handleiding vereist een goed begrip van de volgende onderdelen van Experience Platform:

Bronnen : Met Experience Platform kunt u gegevens uit verschillende bronnen innemen en binnenkomende gegevens structureren, labelen en verbeteren met behulp van Experience Platform-services.
Sandboxes : Experience Platform biedt virtuele sandboxen die één Experience Platform-instantie in afzonderlijke virtuele omgevingen verdelen om toepassingen voor digitale ervaringen te ontwikkelen en te ontwikkelen.

In de volgende secties vindt u aanvullende informatie die u moet weten voordat u verbinding kunt maken met Azure Synapse Analytics via de Flow Service API.

Vereiste referenties verzamelen

Lees het Azure Synapse Analytics overzicht voor informatie over authentificatie.

Experience Platform API’s gebruiken

Voor informatie over hoe te om vraag aan Experience Platform APIs met succes te maken, zie de gids op begonnen wordt met Experience Platform APIs .

Verbinden Azure Synapse Analytics met Experience Platform

Lees het volgende voor meer informatie over het maken van een basisverbinding en het verbinden van uw Azure Synapse Analytics -account met Experience Platform.

Een basisverbinding maken

A basisverbinding slaat zeer belangrijke informatie op die uw bronsysteem met Adobe Experience Platform verbindt. Dit omvat:

Verificatiegegevens van uw bron
De huidige status van de verbinding
Een unieke identiteitskaart van de basisverbinding

De identiteitskaart van de basisverbinding staat u toe om dossiers van uw bron te doorbladeren en te onderzoeken, die u helpen welke punten identificeren om in te voeren, samen met hun gegevenstypen en formaten.

Als u een basis-verbindings-id wilt maken, verzendt u een POST-aanvraag naar het /connections -eindpunt, inclusief de Azure Synapse Analytics -verificatiereferenties in de aanvraagparameters.

API formaat

POST /connections

Reeks Gebaseerde Authentificatie van de Verbinding

Verzoek

Met de volgende aanvraag wordt een basisverbinding voor Azure Synapse Analytics gemaakt met verificatie op basis van een verbindingstekenreeks.

accordion

Voorbeeldverzoek weergeven

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	Beschrijving
`auth.params.connectionString`	De verbindingstekenreeks waarmee verbinding wordt gemaakt met Azure Synapse Analytics . Het patroon van de Azure Synapse Analytics verbindingstekenreeks is `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`	De Azure Synapse Analytics connection specification ID is: `a49bcc7d-8038-43af-b1e4-5a7a089a7d79` .

Reactie

Een succesvolle reactie keert details van de pas gecreëerde basisverbinding, met inbegrip van zijn uniek herkenningsteken (id) terug.

accordion

Voorbeeldreactie weergeven

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

Belangrijkste Belangrijke Gebaseerde Authentificatie van de Dienst

Met de volgende aanvraag wordt een basisverbinding voor Azure Synapse Analytics gemaakt met behulp van op servicetoets gebaseerde verificatie.

Verzoek

accordion

Voorbeeldverzoek weergeven

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
Credentials	Beschrijving
`auth.params.server`	De volledig gekwalificeerde domeinnaam van het SQL-eindpunt van Azure Synapse Analytics .
`auth.params.database`	De naam van de specifieke database in de Azure Synapse Analytics -werkruimte.
`auth.params.tenant`	De Azure Active Directory huurder-id die aan uw Azure -abonnement is gekoppeld.
`auth.params.servicePrincipalId`	De client-id van een Azure Active Directory -toepassing.
`auth.params.servicePrincipalKey`	Het cliëntgeheim of wachtwoord verbonden aan het de diensthoofd.
`connectSpec.id`	De verbindingsspecificatie-id van Azure Synapse Analytics .

Reactie

Een succesvolle reactie keert details van de pas gecreëerde basisverbinding, met inbegrip van zijn uniek herkenningsteken (id) terug.

accordion

Voorbeeldreactie weergeven

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

Volgende stappen

Aan de hand van deze zelfstudie hebt u een Azure Synapse Analytics basisverbinding gemaakt met de Flow Service API. U kunt deze basis verbindings-id in de volgende zelfstudies gebruiken:

recommendation-more-help

experience-platform-help-sources