Verbinden von MariaDB mit Experience Platform mithilfe der Flow Service-API

Lesen Sie dieses Handbuch, um zu erfahren, wie Sie Ihr MariaDB-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 MariaDB herstellen zu können.

Sammeln erforderlicher Anmeldedaten

Informationen zur Authentifizierung MariaDB Sie inÜbersicht“.

Verwenden von Experience Platform-APIs

Lesen Sie das Handbuch Erste Schritte mit Experience Platform-APIs um Informationen darüber zu erhalten, wie Sie Experience Platform-APIs erfolgreich aufrufen können.

Verbinden von MariaDB mit Experience Platform

Lesen Sie die folgenden Schritte, um Informationen zum Verbinden Ihres MariaDB-Kontos mit Experience Platform zu erhalten.

Erstellen einer Basisverbindung für MariaDB

Bei einer Basisverbindung werden Informationen zwischen Ihrer Quelle und Experience Platform gespeichert, einschließlich der Authentifizierungsdaten Ihrer Quelle, des aktuellen Verbindungsstatus und Ihrer eindeutigen ID der Basisverbindung. Mit der Kennung der Basisverbindung können Sie Dateien aus Ihrer Quelle heraus analysieren und darin navigieren und die spezifischen Elemente identifizieren, die Sie erfassen möchten, einschließlich Informationen zu ihren Datentypen und Formaten.

API-Format

POST /connections

Um eine Basisverbindungs-ID zu erstellen, stellen Sie eine POST-Anfrage an den /connections-Endpunkt und geben Sie die entsprechenden Authentifizierungsdaten für Ihr MariaDB-Konto an.

Auf Verbindungszeichenfolgen basierende Authentifizierung

Anfrage

Die folgende Anfrage erstellt eine Basisverbindung für eine MariaDB mithilfe der Authentifizierung über eine Verbindungszeichenfolge.

accordion
Beispiel für eine Anfrage anzeigen
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": "MariaDB connection",
    "description": "MariaDB connection",
    "auth": {
        "specName": "Connection String Based Authentication",
        "params": {
            "connectionString": "Server={HOST};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}"
        }
    },
    "connectionSpec": {
        "id": "3000eb99-cd47-43f3-827c-43caf170f015",
        "version": "1.0"
    }
}'
table 0-row-2 1-row-2 2-row-2
Eigenschaft Beschreibung
auth.params.connectionString Die mit Ihrer MariaDB verknüpfte Verbindungszeichenfolge. Das MariaDB-Verbindungszeichenfolgenmuster ist: Server={HOST};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}.
connectionSpec.id Die Spezifikations-ID der MariaDB-Verbindung lautet: 3000eb99-cd47-43f3-827c-43caf170f015.

Antwort

Eine erfolgreiche Antwort gibt Details zur neu erstellten Basisverbindung zurück, einschließlich ihrer eindeutigen Kennung (id).

accordion
Beispiel für eine Antwort anzeigen
code language-json
{
    "id": "be3a2d71-1fb6-4fea-ba2d-711fb61fea50",
    "etag": "\"02002624-0000-0200-0000-5e41f7040000\""
}
Einfache Authentifizierung

Anfrage

Die folgende Anfrage erstellt eine Basisverbindung für eine MariaDB mit einfacher Authentifizierung.

accordion
Beispiel für eine Anfrage anzeigen
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": "MariaDB on Experience Platform using basic auth",
      "description": "MariaDB on Experience Platform using basic auth",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "{SERVER}",
              "database": "{DATABASE}",
              "username": "{USERNAME}",
              "password": "{PASSWORD}",
              "sslMode": "{SSLMODE}"
          }
      },
      "connectionSpec": {
          "id": "3000eb99-cd47-43f3-827c-43caf170f015",
          "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
Eigenschaft Beschreibung
auth.params.server Der Name oder die IP der MariaDB.
auth.params.database Der Name Ihrer Datenbank.
auth.params.username Der Benutzername, der Ihrer Datenbank entspricht.
auth.params.password Das Passwort, das Ihrer Datenbank entspricht.
auth.params.sslMode Die Methode, mit der Daten während der Datenübertragung verschlüsselt werden.
connectionSpec.id Die Spezifikations-ID der MariaDB-Verbindung lautet: 3000eb99-cd47-43f3-827c-43caf170f015.

Antwort

Eine erfolgreiche Antwort gibt Details zur neu erstellten Basisverbindung zurück, einschließlich ihrer eindeutigen Kennung (id).

accordion
Beispiel für eine Antwort anzeigen
code language-json
{
    "id": "f847950c-1c12-4568-a550-d5312b16fdb8",
    "etag": "\"0c0099f4-0000-0200-0000-67da91710000\""
}

Nächste Schritte

In diesem Tutorial haben Sie eine MariaDB-Basisverbindung mithilfe der Flow Service-API erstellt. Sie können diese Basisverbindungs-ID in den folgenden Tutorials verwenden:

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089