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.
Credentials | Beschrijving |
---|---|
domain | De URL van de Databricks -werkruimte. Bijvoorbeeld https://adb-1234567890123456.7.azuredatabricks.net . |
clusterId | De id van uw cluster in Databricks . Deze cluster moet al een bestaande cluster zijn en moet een interactief cluster zijn. |
accessToken | Het toegangstoken dat uw Databricks account verifieert. U kunt uw toegangstoken produceren gebruikend de Databricks werkruimte. |
database | De naam van uw database in het delta-meer. |
connectionSpec.Id | De 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"
}
}'
Eigenschap | Beschrijving |
---|---|
auth.params.domain | De URL van de Databricks -werkruimte. |
auth.params.clusterId | De id van uw cluster in Databricks . Deze cluster moet al een bestaande cluster zijn en moet een interactief cluster zijn |
auth.params.accessToken | Het toegangstoken dat uw Databricks account verifieert. |
auth.params.database | De naam van uw database in het delta-meer. |
connectionSpec.id | De 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\""
}