Verbinden von Oracle DB mit Experience Platform mithilfe der Flow Service-API

Lesen Sie dieses Handbuch, um zu erfahren, wie Sie Ihr Oracle DB-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 Oracle-API eine Verbindung zu Flow Service herstellen zu können.

Verwenden von Experience Platform-APIs

Informationen zum erfolgreichen Aufrufen von Experience Platform-APIs finden Sie im Handbuch unter mit Experience Platform-APIs.

Sammeln erforderlicher Anmeldedaten

Informationen zur Authentifizierung Oracle DB Sie inÜbersicht“.

Verbinden von Oracle DB mit Experience Platform auf Azure azure

Lesen Sie die folgenden Schritte, um Informationen zum Verbinden Ihres Oracle DB-Kontos mit Experience Platform auf Azure zu erhalten.

Erstellen einer Basisverbindung für Oracle DB auf Experience Platform auf Azure azure-base

Eine Basisverbindung verknüpft Ihre Quelle mit Experience Platform und speichert Authentifizierungsdetails, Verbindungsstatus und eine eindeutige ID. Verwenden Sie diese ID, um Quelldateien zu durchsuchen und bestimmte aufzunehmende Elemente zu identifizieren, einschließlich ihrer Datentypen und Formate.

API-Format

POST /connections

Um eine Basisverbindungs-ID zu erstellen, stellen Sie eine POST-Anfrage an den /connections-Endpunkt und geben Sie Ihre Oracle DB Authentifizierungsdaten als Teil der Anfrageparameter an.

Anfrage

Die folgende Anfrage erstellt eine Basisverbindung für Oracle DB unter Verwendung der Authentifizierung über eine Verbindungszeichenfolge.

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": "Oracle DB base connection",
    "description": "A base connection to connect Oracle DB to Experience Platform on Azure",
    "auth": {
      "specName": "ConnectionString",
      "params": {
        "connectionString": "Host={HOST};Port={PORT};Sid={SID};UserId={USERNAME};Password={PASSWORD}"
      }
    },
    "connectionSpec": {
      "id": "d6b52d86-f0f8-475f-89d4-ce54c8527328",
      "version": "1.0"
    }
  }'
table 0-row-2 1-row-2 2-row-2
Parameter Beschreibung
auth.params.connectionString Die Verbindungszeichenfolge, die zum Herstellen einer Verbindung mit Oracle DB verwendet wird. Das Oracle DB-Verbindungszeichenfolgenmuster ist: Host={HOST};Port={PORT};Sid={SID};User Id={USERNAME};Password={PASSWORD}.
connectionSpec.id Die Spezifikations-ID der Oracle-Verbindung: d6b52d86-f0f8-475f-89d4-ce54c8527328.

Antwort

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

Antwort anzeigen
code language-json
{
    "id": "f088e4f2-2464-480c-88e4-f22464b80c90",
    "etag": "\"43011faa-0000-0200-0000-5ea740cd0000\""
}

Verbinden von Oracle DB mit Experience Platform auf Amazon Web Services aws

AVAILABILITY
Dieser Abschnitt gilt für Implementierungen von Experience Platform, die auf Amazon Web Services (AWS) ausgeführt werden. Experience Platform, das auf AWS ausgeführt wird, steht derzeit einer begrenzten Anzahl von Kunden zur Verfügung. Weitere Informationen zur unterstützten Experience Platform-Infrastruktur finden Sie in der Übersicht zur Experience Platform Multi-Cloud.

Lesen Sie die folgenden Schritte, um Informationen zum Verbinden Ihres Oracle DB-Kontos mit Experience Platform auf AWS zu erhalten.

Erstellen einer Basisverbindung für Oracle DB auf Experience Platform auf AWS aws-base

API-Format

POST /connections

Anfrage

Die folgende Anfrage erstellt eine Basisverbindung für Oracle DB, um eine Verbindung zu Experience Platform auf AWS herzustellen.

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": "Oracle DB on Experience Platform AWS",
      "description": "Oracle DB on Experience Platform AWS",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "diy.us-dawkins-1.oraclecloud.com",
              "port": "1521",
              "database": "mcmg_profits_diy.oraclecloud.com",
              "username": "Admin",
              "password": "xxxx",
              "schema": "ADMIN",
              "sslMode": "true"
          }
      },
      "connectionSpec": {
          "id": "26d738e0-8963-47ea-aadf-c60de735468a",
          "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 7-row-2 8-row-2
Eigenschaft Beschreibung
auth.params.server Die IP-Adresse oder der Hostname Ihres Oracle DB.
auth.params.port Die Port-Nummer Ihres Oracle DB.
auth.params.database Der Name der Oracle DB-Instanz, mit der Sie eine Verbindung herstellen.
auth.params.username Das mit Ihrer Oracle DB verknüpfte Benutzerkonto.
auth.prams.password Das Passwort, das Ihrem Oracle DB-Benutzerkonto entspricht.
auth.params.schema Das Schema, das Ihre Datenbankobjekte enthält.
auth.params.sslMode Ein boolescher Wert, der angibt, ob SSL-Maßnahmen erzwungen werden oder nicht.
connectionSpec.id Die Verbindungsspezifikations-ID, die der Oracle DB entspricht. Dieser ID-Wert ist wie folgt festgelegt: d6b52d86-f0f8-475f-89d4-ce54c8527328.

Antwort

Eine erfolgreiche Antwort gibt Details zur neu erstellten Basisverbindung zurück, einschließlich ihrer eindeutigen Kennung (id) und der entsprechenden. Sie können die ID verwenden, um Quellverbindung zu erstellen und den etag, um Ihr Konto zu aktualisieren.

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

Erstellen eines Datenflusses für Oracle DB Daten

Nachdem Sie Ihr Oracle DB-Konto erfolgreich verbunden haben, können Sie jetzt einen Datenfluss erstellen und Daten aus Ihrer Datenbank in Experience Platform aufnehmen.

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