DocumentaciónExperience PlatformGuía de conectores de origen

Ultimate

Conectar AWS Redshift a Experience Platform mediante la API Flow Service

Última actualización: 4 de abril de 2025
  • Temas:

Creado para:

  • Desarrollador
IMPORTANTE
El origen AWS Redshift está disponible en el catálogo de orígenes para los usuarios que han adquirido Real-Time Customer Data Platform Ultimate.

Lea esta guía para saber cómo conectar su cuenta de origen de AWS Redshift a Adobe Experience Platform mediante la Flow Service API.

Introducción

Esta guía requiere una comprensión práctica de los siguientes componentes de Adobe Experience Platform:

  • Fuentes: Experience Platform permite la ingesta de datos de varias fuentes al tiempo que le ofrece la capacidad de estructurar, etiquetar y mejorar los datos entrantes mediante los servicios de Experience Platform.
  • Zonas protegidas: Experience Platform proporciona zonas protegidas virtuales que dividen una sola instancia de Experience Platform en entornos virtuales independientes para ayudar a desarrollar y evolucionar aplicaciones de experiencia digital.

Uso de API de Experience Platform

Para obtener información sobre cómo realizar llamadas correctamente a las API de Experience Platform, consulte la guía sobre introducción a las API de Experience Platform.

Conectar AWS Redshift a Experience Platform en Azure

Lea los pasos siguientes para obtener información sobre cómo conectar su origen de AWS Redshift a Experience Platform en Azure.

Recopilar credenciales necesarias

Para que Flow Service se conecte con AWS Redshift, debe proporcionar las siguientes propiedades de conexión:

| Credencial | Descripción |
| server | El nombre del servidor de su instancia AWS Redshift. |
| port | El puerto TCP que usa un servidor AWS Redshift para detectar conexiones de cliente. |
| username | El nombre de usuario asociado con su cuenta de AWS Redshift. |
| password | La contraseña que corresponde a la cuenta de usuario. |
| database | Base de datos AWS Redshift de la que se van a obtener datos. |
| connectionSpec.id | La especificación de conexión devuelve las propiedades del conector de origen, incluidas las especificaciones de autenticación relacionadas con la creación de las conexiones base y origen. El id. de especificación de conexión para AWS Redshift es 3416976c-a9ca-4bba-901a-1f08f66978ff. |

Para obtener más información sobre cómo empezar, consulte este AWS Redshift documento.

Crear una conexión base para AWS Redshift en Experience Platform en Azure [#azure-base]

NOTA
El estándar de codificación predeterminado para Redshift es Unicode. Esto no se puede cambiar.

Una conexión base retiene información entre el origen y Experience Platform, incluidas las credenciales de autenticación del origen, el estado actual de la conexión y el identificador único de la conexión base. El ID de conexión base le permite explorar y navegar por archivos desde el origen e identificar los elementos específicos que desea introducir, incluida la información sobre sus tipos de datos y formatos.

Para crear un identificador de conexión base, realice una petición POST al extremo /connections y proporcione sus credenciales de autenticación AWS Redshift como parte de los parámetros de solicitud.

Formato de API

POST /connections

Solicitud

Seleccione para ver el ejemplo

La siguiente solicitud crea una conexión base para 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"
      }
  }'
Propiedad
Descripción
auth.params.server
El nombre del servidor de su instancia AWS Redshift.
auth.params.port
El puerto TCP que usa un servidor AWS Redshift para detectar conexiones de cliente.
auth.params.username
El nombre de usuario asociado con su cuenta de AWS Redshift.
auth.params.password
La contraseña que corresponde a la cuenta de usuario.
auth.params.database
Base de datos AWS Redshift de la que se van a obtener datos.
connectionSpec.id
Id. de especificación de conexión AWS Redshift: 3416976c-a9ca-4bba-901a-1f08f66978ff

Respuesta

Seleccione para ver el ejemplo

Una respuesta correcta devuelve la conexión recién creada, incluido su identificador único (id). Este ID es necesario para explorar los datos en el siguiente tutorial.

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

Conectar AWS Redshift a Experience Platform en AWS Web Services (AWS)

AVAILABILITY
Esta sección se aplica a las implementaciones de Experience Platform que se ejecutan en AWS Web Services (AWS). Experience Platform que se ejecuta en AWS está disponible actualmente para un número limitado de clientes. Para obtener más información sobre la infraestructura de Experience Platform compatible, consulte la descripción general de la nube múltiple de Experience Platform.

Lea los pasos siguientes para obtener información sobre cómo conectar su origen de AWS Redshift a Experience Platform en AWS.

Crear una conexión base para AWS Redshift en Experience Platform en AWS

Formato de API

POST /connections

Solicitud

La siguiente solicitud crea una conexión base para AWS Redshift:

Seleccione para ver el ejemplo
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"
      }
  }'
Propiedad
Descripción
auth.params.server
El nombre del servidor de su instancia AWS Redshift.
auth.params.port
El puerto TCP que usa un servidor AWS Redshift para detectar conexiones de cliente.
auth.params.username
El nombre de usuario asociado con su cuenta de AWS Redshift.
auth.params.password
La contraseña que corresponde a la cuenta de usuario.
auth.params.database
Base de datos AWS Redshift de la que se van a obtener datos.
auth.params.schema
Nombre del esquema asociado con la base de datos AWS Redshift. Debe asegurarse de que el usuario al que desea otorgar acceso a la base de datos también tenga acceso a este esquema.
connectionSpec.id
Id. de especificación de conexión AWS Redshift: 3416976c-a9ca-4bba-901a-1f08f66978ff

Respuesta

Una respuesta correcta devuelve detalles de la conexión recién creada, incluido su identificador único (id). Este ID es necesario para explorar el almacenamiento en el siguiente tutorial.

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

Pasos siguientes

Siguiendo este tutorial, ha creado una conexión base AWS Redshift mediante la API Flow Service. Puede utilizar este ID de conexión base en los siguientes tutoriales:

  • Explore la estructura y el contenido de las tablas de datos mediante la API Flow Service B
  • Cree un flujo de datos para llevar los datos de la base de datos a Experience Platform mediante la API Flow Service
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089