Experience Platform API's gebruiken

Lees de gids op hoe te beginnen met Experience Platform APIsvoor informatie over hoe te om vraag aan Experience Platform APIs met succes te maken.

Voorwaarden configureren

Lees het Databricks overzichtom over de in de eerste plaats vereiste configuraties te leren die moeten worden voltooid alvorens u uw rekening met Experience Platform kunt verbinden.

Vereiste referenties verzamelen

Geef waarden op voor de volgende referenties om Databricks te verbinden met Experience Platform.

CredentialsBeschrijving
domainDe URL van de Databricks -werkruimte. Bijvoorbeeld https://adb-1234567890123456.7.azuredatabricks.net .
clusterIdDe id van uw cluster in Databricks . Deze cluster moet al een bestaande cluster zijn en moet een interactief cluster zijn.
accessTokenHet toegangstoken dat uw Databricks account verifieert. U kunt uw toegangstoken produceren gebruikend de Databricks werkruimte.
databaseDe naam van uw database in het delta-meer.
connectionSpec.IdDe verbindingsSPEC identiteitskaart keert de schakelaareigenschappen van een bron, met inbegrip van authentificatiespecificaties met betrekking tot het creëren van de basis en bronverbindingen terug. De verbindingsspecificatie-id voor Databricks is e9d7ec6b-0873-4e57-ad21-b3a7c65e310b .

Voor meer informatie raadpleegt u het Databricks overzicht.

Een basisverbinding maken

Een basisverbinding behoudt informatie tussen uw bron en Experience Platform, met inbegrip van de verificatiereferenties van uw bron, de huidige status van de verbinding, en uw unieke identiteitskaart van de basisverbinding. Met de ID van de basisverbinding kunt u bestanden verkennen en door bestanden navigeren vanuit uw bron en kunt u de specifieke items identificeren die u wilt opnemen, inclusief informatie over hun gegevenstypen en indelingen.

Als u een basis-verbindings-id wilt maken, vraagt u een POST-aanvraag naar het /connections -eindpunt en geeft u de juiste verificatiegegevens voor uw Databricks -account op.

API formaat

POST /connections

Verzoek

Met de volgende aanvraag wordt een basisverbinding voor een Databricks -bron gemaakt met behulp van toegangstoken-verificatie.

Voorbeeld van een aanvraag weergeven
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": "Databricks connection to Experience Platform",
    "description": "A Databricks base connection to Experience Platform",
    "auth": {
        "specName": "Access Token Authentication",
        "params": {
          "domain": "https://adb-1234567890123456.7.azuredatabricks.net",
          "clusterId": "xxxx",
          "accessToken": "xxxx",
          "database": "acme-db"
        }
    },
    "connectionSpec": {
        "id": "e9d7ec6b-0873-4e57-ad21-b3a7c65e310b",
        "version": "1.0"
    }
}'
EigenschapBeschrijving
auth.params.domainDe URL van de Databricks -werkruimte.
auth.params.clusterIdDe id van uw cluster in Databricks . Deze cluster moet al een bestaande cluster zijn en moet een interactief cluster zijn
auth.params.accessTokenHet toegangstoken dat uw Databricks account verifieert.
auth.params.databaseDe naam van uw database in het delta-meer.
connectionSpec.idDe Databricks connection spec ID.

Reactie

Een geslaagde reactie retourneert de zojuist gemaakte verbinding, inclusief de id van de basisverbinding.

Reactievoorbeeld weergeven
{
    "id": "f847950c-1c12-4568-a550-d5312b16fdb8",
    "etag": "\"0c0099f4-0000-0200-0000-67da91710000\""
}