Dokumentation Experience Platform Anleitung zu Quell-Connectoren

Ultimate

Verbinden von AWS Redshift mit Experience Platform mithilfe der Flow Service-API

Letzte Aktualisierung: 4. April 2025

Themen:

Erstellt für:

Entwickler

WICHTIG

Die AWS Redshift ist im Quellkatalog für Benutzende verfügbar, die Real-Time Customer Data Platform Ultimate erworben haben.

Lesen Sie dieses Handbuch, um zu erfahren, wie Sie Ihr AWS Redshift-Quellkonto mithilfe der Flow Service API) mit Adobe Experience Platform.

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 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 entwickeln und weiterentwickeln können.

Verwenden von Experience Platform-APIs

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

Verbinden von AWS Redshift mit Experience Platform auf Azure

Lesen Sie die folgenden Schritte, um Informationen zum Verbinden Ihrer AWS Redshift mit Experience Platform auf Azure zu erhalten.

Sammeln erforderlicher Anmeldedaten

Damit Flow Service eine Verbindung mit AWS Redshift herstellen kann, müssen Sie die folgenden Verbindungseigenschaften angeben:

| Anmeldedaten | Beschreibung |
| server | Der Server-Name Ihrer AWS Redshift. |
| port | Der TCP-Port, den ein AWS Redshift-Server verwendet, um auf Client-Verbindungen zu warten. |
| username | Der Benutzername, der Ihrem AWS Redshift-Konto zugeordnet ist. |
| password | Das Kennwort, das dem Benutzerkonto entspricht. |
| database | Die AWS Redshift, aus der Daten abgerufen werden sollen. |
| 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 Verbindungsspezifikations-ID für AWS Redshift ist 3416976c-a9ca-4bba-901a-1f08f66978ff. |

Weitere Informationen zu den ersten Schritten finden Sie in diesem AWS Redshift Dokument.

Erstellen einer Basisverbindung für AWS Redshift auf Experience Platform auf Azure [#azure-base]

HINWEIS

Der Standardcodierungsstandard für Redshift ist Unicode. Dies kann nicht geändert werden.

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.

Um eine Basisverbindungs-ID zu erstellen, stellen Sie eine POST-Anfrage an den Endpunkt /connections und geben Sie dabei Ihre AWS Redshift-Authentifizierungs-Anmeldedaten als Teil der Anfrageparameter an.

API-Format

POST /connections

Anfrage

Beispiel auswählen, um es anzuzeigen

Die folgende Anfrage erstellt eine Basisverbindung für AWS Redshift:

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": "AWS-redshift base connection",
      "description": "base connection for AWS-redshift,
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "{SERVER}",
              "port": "{PORT},
              "username": "{USERNAME}",
              "password": "{PASSWORD}",
              "database": "{DATABASE}"
          }
      },
      "connectionSpec": {
          "id": "3416976c-a9ca-4bba-901a-1f08f66978ff",
          "version": "1.0"
      }
  }'

Eigenschaft

Beschreibung

auth.params.server

Der Server-Name Ihrer AWS Redshift.

auth.params.port

Der TCP-Port, den ein AWS Redshift-Server verwendet, um auf Client-Verbindungen zu warten.

auth.params.username

Der Benutzername, der Ihrem AWS Redshift-Konto zugeordnet ist.

auth.params.password

Das Kennwort, das dem Benutzerkonto entspricht.

auth.params.database

Die AWS Redshift, aus der Daten abgerufen werden sollen.

connectionSpec.id

Die AWS Redshift-Verbindungsspezifikations-ID: 3416976c-a9ca-4bba-901a-1f08f66978ff

Antwort

Beispiel auswählen, um es anzuzeigen

Eine erfolgreiche Antwort gibt die neu erstellte Basisverbindung zurück, einschließlich ihrer eindeutigen Kennung (id). Diese ID ist erforderlich, um Ihre Daten im nächsten Tutorial zu untersuchen.

{
    "id": "373e88fc-43da-4e3c-be88-fc43da3e3c0f",
    "etag": "\"1700ce7b-0000-0200-0000-5e3b405e0000\""
}

Verbinden von AWS Redshift mit Experience Platform über AWS Web Services (AWS)

AVAILABILITY

Dieser Abschnitt gilt für Implementierungen von Experience Platform, die auf AWS 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 Ihrer AWS Redshift mit Experience Platform auf AWS zu erhalten.

Erstellen einer Basisverbindung für AWS Redshift auf Experience Platform auf AWS

API-Format

POST /connections

Anfrage

Die folgende Anfrage erstellt eine Basisverbindung für AWS Redshift:

Beispiel auswählen, um es anzuzeigen

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": "AWS Redshift base connection for Experience Platform on AWS",
      "description": "AWS Redshift base connection for Experience Platform on AWS",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "{SERVER}",
              "port": "5439",
              "username": "{USERNAME}",
              "password": "{PASSWORD}",
              "database": "{DATABASE}",
              "schema": "{SCHEMA}"
          }
      },
      "connectionSpec": {
          "id": "3416976c-a9ca-4bba-901a-1f08f66978ff",
          "version": "1.0"
      }
  }'

Eigenschaft

Beschreibung

auth.params.server

Der Server-Name Ihrer AWS Redshift.

auth.params.port

Der TCP-Port, den ein AWS Redshift-Server verwendet, um auf Client-Verbindungen zu warten.

auth.params.username

Der Benutzername, der Ihrem AWS Redshift-Konto zugeordnet ist.

auth.params.password

Das Kennwort, das dem Benutzerkonto entspricht.

auth.params.database

Die AWS Redshift, aus der Daten abgerufen werden sollen.

auth.params.schema

Der Name des Schemas, das Ihrer AWS Redshift-Datenbank zugeordnet ist. Sie müssen sicherstellen, dass der Benutzer, dem Sie Datenbankzugriff gewähren möchten, auch Zugriff auf dieses Schema hat.

connectionSpec.id

Die AWS Redshift-Verbindungsspezifikations-ID: 3416976c-a9ca-4bba-901a-1f08f66978ff

Antwort

Eine erfolgreiche Antwort gibt Details der neu erstellten Verbindung zurück, einschließlich ihrer eindeutigen Kennung (id). Diese ID ist erforderlich, um Ihren -Speicher im nächsten Tutorial zu untersuchen.

Beispiel auswählen, um es anzuzeigen

{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700d77b-0000-0200-0000-5e3b41a10000\""
}

Nächste Schritte

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

recommendation-more-help