Erstellen Sie eine Azure Event Hubs Quellverbindung mithilfe der Flow Service API
In diesem Tutorial werden Schritte zum Erstellen eines Azure Event Hubs (nachstehend "genannt) Event Hubs") zu Experience Platform, unter Verwendung der Flow Service API.
Erste Schritte
Dieses Handbuch setzt ein Verständnis der folgenden Komponenten von Adobe 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 Platform-Services zu strukturieren, zu kennzeichnen und anzureichern.
- Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Platform-Instanz in separate virtuelle Umgebungen unterteilen, damit Sie Programme für digitale Erlebnisse entwickeln und weiterentwickeln können.
Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie benötigen, um Event Hubs mithilfe der Flow Service-API erfolgreich mit Platform verbinden zu können.
Sammeln erforderlicher Anmeldeinformationen
Zur Flow Service , um eine Verbindung mit Ihrer Event Hubs -Konto angeben, müssen Sie Werte für die folgenden Verbindungseigenschaften angeben:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
---|---|
Anmeldedaten | Beschreibung |
sasKeyName |
Der Name der Autorisierungsregel, der auch als SAS-Schlüsselname bezeichnet wird. |
sasKey |
Der Primärschlüssel der Event Hubs Namespace. Die sasPolicy dass sasKey muss manage -Berechtigungen, die für die Event Hubs Liste auszufüllen. |
namespace |
Der Namespace des Event Hubs auf die Sie zugreifen. Ein Event Hubs Der Namespace stellt einen eindeutigen Scoping-Container bereit, in dem Sie einen oder mehrere Event Hubs. |
connectionSpec.id |
Die Verbindungsspezifikation gibt die Connector-Eigenschaften einer Quelle zurück, einschließlich der Authentifizierungsspezifikationen für die Erstellung der Basis- und Quellverbindungen. Die Spezifikations-ID der Event Hubs-Verbindung lautet: bf9f5905-92b7-48bf-bf20-455bc6b60a4e . |
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
---|---|
Anmeldedaten | Beschreibung |
sasKeyName |
Der Name der Autorisierungsregel, der auch als SAS-Schlüsselname bezeichnet wird. |
sasKey |
Der Primärschlüssel der Event Hubs Namespace. Die sasPolicy dass sasKey muss manage -Berechtigungen, die für die Event Hubs Liste auszufüllen. |
namespace |
Der Namespace des Event Hubs auf die Sie zugreifen. Ein Event Hubs Der Namespace stellt einen eindeutigen Scoping-Container bereit, in dem Sie einen oder mehrere Event Hubs. |
eventHubName |
Der Name für Ihre Event Hubs -Quelle. |
connectionSpec.id |
Die Verbindungsspezifikation gibt die Connector-Eigenschaften einer Quelle zurück, einschließlich der Authentifizierungsspezifikationen für die Erstellung der Basis- und Quellverbindungen. Die Spezifikations-ID der Event Hubs-Verbindung lautet: bf9f5905-92b7-48bf-bf20-455bc6b60a4e . |
Weitere Informationen zu diesen Werten finden Sie unter Dieses Ereignis-Hubs-Dokument.
Verwenden von Platform-APIs
Informationen zum Aufrufen von Platform-APIs finden Sie im Handbuch unter Erste Schritte mit Platform-APIs.
Erstellen einer Basisverbindung
Der erste Schritt beim Erstellen einer Quellverbindung besteht darin, Ihre Event Hubs-Quelle zu authentifizieren und eine Basisverbindungs-ID zu generieren. Mittels einer Basisverbindungs-ID können Sie Dateien aus Ihrer Quelle durchsuchen, zwischen Dateien innerhalb der Quelle navigieren und bestimmte Elemente identifizieren, die Sie erfassen möchten, einschließlich Informationen zu Datentypen und Formaten.
Um eine Basisverbindungs-ID zu erstellen, stellen Sie eine POST-Anfrage an den /connections
-Endpunkt beim Bereitstellen der Event Hubs-Authentifizierungsberechtigungsdaten als Teil der Anfrageparameter.
API-Format
POST /connections
Um ein Konto mit Standardauthentifizierung zu erstellen, stellen Sie eine POST-Anfrage an die /connections
Endpunkt beim Bereitstellen von Werten für Ihre sasKeyName
, sasKey
, und namespace
.
accordion | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Anfrage | ||||||||||||||
|
accordion | ||
---|---|---|
Antwort | ||
Bei einer erfolgreichen Antwort werden Details zu der neu erstellten Basisverbindung zurückgegeben, einschließlich ihrer eindeutigen Kennung (
|
Um ein Konto mit SAS-Authentifizierung zu erstellen, stellen Sie eine POST-Anfrage an die /connections
Endpunkt beim Bereitstellen von Werten für Ihre sasKeyName
, sasKey
,namespace
, und eventHubName
.
accordion | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Anfrage | ||||||||||||||||
|
accordion | ||
---|---|---|
Antwort | ||
Bei einer erfolgreichen Antwort werden Details zu der neu erstellten Basisverbindung zurückgegeben, einschließlich ihrer eindeutigen Kennung (
|
Erstellen einer Quellverbindung
Eine Quellverbindung erstellt und verwaltet die Verbindung zu der externen Quelle, aus der Daten erfasst werden. Eine Quellverbindung besteht aus Informationen wie Datenquelle, Datenformat und einer Quell-Verbindungs-ID, die zum Erzeugen eines Datenflusses erforderlich sind. Eine Quellverbindungsinstanz ist für einen Mandanten und eine Organisation spezifisch.
Um eine Quellverbindung zu erstellen, stellen Sie eine POST-Anfrage an den /sourceConnections
-Endpunkt der Flow Service-API.
API-Format
POST /sourceConnections
Anfrage
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/sourceConnections' \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"name": "Azure Event Hubs source connection",
"description": "A source connection for Azure Event Hubs",
"baseConnectionId": "4cdbb15c-fb1e-46ee-8049-0f55b53378fe",
"connectionSpec": {
"id": "bf9f5905-92b7-48bf-bf20-455bc6b60a4e",
"version": "1.0"
},
"data": {
"format": "json"
},
"params": {
"eventHubName": "{EVENT_HUB_NAME}",
"dataType": "raw",
"reset": "latest",
"consumerGroup": "{CONSUMER_GROUP}"
}
}'
name
description
baseConnectionId
connectionSpec.id
bf9f5905-92b7-48bf-bf20-455bc6b60a4e
.data.format
json
unterstützt.params.eventHubName
params.dataType
raw
und xdm
.params.reset
latest
, um mit dem Lesen der neuesten Daten zu beginnen, und verwenden Sie earliest
, um mit dem Lesen der ersten verfügbaren Daten im Stream zu beginnen. Dieser Parameter ist optional und standardmäßig earliest
wenn nicht angegeben.params.consumerGroup
$Default
wenn nicht angegeben. Siehe hierzu Event Hubs Handbuch für Ereignisnutzer für weitere Informationen. Hinweis: ein Event Hubs Die Benutzergruppe kann nur für einen einzelnen Fluss gleichzeitig verwendet werden.Nächste Schritte
In diesem Tutorial haben Sie eine Event Hubs Quellverbindung mithilfe der Flow Service API. Sie können diese Quellverbindungs-ID im nächsten Tutorial verwenden, um einen Streaming-Datenfluss mit der Flow Service -API zu erstellen.