Documentación Experience Platform Guía de conectores de origen

Conectar PostgreSQL a Experience Platform mediante la API Flow Service

Última actualización: 21 de mayo de 2025

Temas:

Creado para:

Desarrollador

Lea esta guía para aprender a conectar su base de datos de PostgreSQL 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 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.

Las secciones siguientes proporcionan información adicional que necesitará conocer para conectarse correctamente a PostgreSQL mediante la API Flow Service.

Uso de API de Experience Platform

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

Recopilar credenciales necesarias

Lea la PostgreSQL descripción general para obtener más información sobre la autenticación.

Habilitar el cifrado SSL para la cadena de conexión

Puede habilitar el cifrado SSL para la cadena de conexión PostgreSQL adjuntando la cadena de conexión con las siguientes propiedades:

Propiedad	Descripción	Ejemplo
`EncryptionMethod`	Permite habilitar el cifrado SSL en los datos de PostgreSQL.	`EncryptionMethod=0`(deshabilitado) `EncryptionMethod=1`(Habilitado) `EncryptionMethod=6`(RequestSSL)
`ValidateServerCertificate`	Valida el certificado enviado por la base de datos PostgreSQL cuando se aplica `EncryptionMethod`.	`ValidationServerCertificate=0`(deshabilitado) `ValidationServerCertificate=1`(Habilitado)

El siguiente es un ejemplo de una cadena de conexión PostgreSQL anexada con cifrado SSL: Server={SERVER};Database={DATABASE};Port={PORT};UID={USERNAME};Password={PASSWORD};EncryptionMethod=1;ValidateServerCertificate=1.

Conectar PostgreSQL a Experience Platform en Azure

Lea los pasos siguientes para aprender a conectar su cuenta de PostgreSQL a Experience Platform en Azure.

Crear una conexión base

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 PostgreSQL como parte de los parámetros de solicitud.

Formato de API

POST /connections

Solicitud

La siguiente solicitud crea una conexión base para PostgreSQL mediante la autenticación basada en clave de cuenta:

Ver ejemplo de solicitud

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": "PostgreSQL base connection",
      "description": "PostgreSQL base connection via connection string",
      "auth": {
          "specName": "Connection String Based Authentication",
          "params": {
              "connectionString": "Server={SERVER};Database={DATABASE};Port={PORT};UID={USERNAME};Password={PASSWORD}"
          }
      },
      "connectionSpec": {
          "id": "74a1c565-4e59-48d7-9d67-7c03b8a13137",
          "version": "1.0"
      }
  }'

Propiedad	Descripción
`auth.params.connectionString`	La cadena de conexión asociada a su cuenta de PostgreSQL. El patrón de cadena de conexión PostgreSQL es: `Server={SERVER};Database={DATABASE};Port={PORT};UID={USERNAME};Password={PASSWORD}`.
`connectionSpec.id`	Los identificadores de especificación de conexión PostgreSQL: `74a1c565-4e59-48d7-9d67-7c03b8a13137`.

Respuesta

Una respuesta correcta devuelve el identificador único (id) de la conexión base recién creada.

Ver ejemplo de respuesta

{
    "id": "056dd1b4-da33-42f9-add1-b4da3392f94e",
    "etag": "\"1700e582-0000-0200-0000-5e3c85180000\""
}

Solicitud

La siguiente solicitud crea una conexión base para PostgreSQL mediante autenticación básica:

Ver ejemplo de solicitud

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": "PostgreSQL base connection",
      "description": "PostgreSQL base connection via basic authentication",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "localhost",
              "port": "3306",
              "database": "postgresql-acme",
              "username": "acme",
              "password": "xxxx",
              "sslMode": "Allow"
          }
      },
      "connectionSpec": {
          "id": "74a1c565-4e59-48d7-9d67-7c03b8a13137",
          "version": "1.0"
      }
  }'

Propiedad	Descripción
`auth.params.server`	Nombre o dirección IP de la base de datos PostgreSQL.
`auth.params.port`	Número de puerto del servidor de la base de datos.
`auth.params.database`	Nombre de su base de datos PostgreSQL.
`auth.params.username`	El nombre de usuario asociado con la autenticación de la base de datos PostgreSQL.
`auth.params.password`	La contraseña asociada con la autenticación de la base de datos PostgreSQL.
`auth.params.sslMode`	Método por el que se cifran los datos durante la transferencia de datos. Los valores disponibles incluyen: `Disable`, `Allow`, `Prefer`, `Verify Ca` y `Verify Full`.
`connectionSpec.id`	Los identificadores de especificación de conexión PostgreSQL: `74a1c565-4e59-48d7-9d67-7c03b8a13137`.

Respuesta

Una respuesta correcta devuelve el identificador único (id) de la conexión base recién creada.

Ver ejemplo de respuesta

{
    "id": "2c15b1c5-73bf-47ab-9098-0467fcd854d9",
    "etag": "\"2600fc39-0000-0200-0000-67dd48f80000\""
}

Conectar PostgreSQL a Experience Platform en Amazon Web Service

AVAILABILITY

Esta sección se aplica a las implementaciones de Experience Platform que se ejecutan en Amazon Web Service (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 base de datos de PostgreSQL a Experience Platform en AWS.

Crear una conexión base

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

Formato de API

POST /connections

Solicitud

La siguiente solicitud crea una conexión base para que PostgreSQL se conecte a Experience Platform en AWS.

Ver ejemplo de solicitud

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": "PostgreSQL base connection",
      "description": "PostgreSQL base connection via basic authentication",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "localhost",
              "port": "3306",
              "database": "postgresql-acme",
              "username": "acme",
              "password": "xxxx",
              "sslMode": "false"
          }
      },
      "connectionSpec": {
          "id": "74a1c565-4e59-48d7-9d67-7c03b8a13137",
          "version": "1.0"
      }
  }'

Propiedad

Descripción

auth.params.server

Nombre o dirección IP de la base de datos PostgreSQL.

auth.params.port

Número de puerto del servidor de la base de datos.

auth.params.database

Nombre de su base de datos PostgreSQL.

auth.params.username

El nombre de usuario asociado con la autenticación de la base de datos PostgreSQL.

auth.params.password

La contraseña asociada con la autenticación de la base de datos PostgreSQL.

sslMode

Un valor booleano que controla si SSL se aplica o no, según la compatibilidad con el servidor. El valor predeterminado de esta configuración es false.

connectionSpec.id

Los identificadores de especificación de conexión PostgreSQL: 74a1c565-4e59-48d7-9d67-7c03b8a13137.

Respuesta

Una respuesta correcta devuelve el identificador único (id) de la conexión base recién creada.

Ver ejemplo de respuesta

{
    "id": "2c15b1c5-73bf-47ab-9098-0467fcd854d9",
    "etag": "\"2600fc39-0000-0200-0000-67dd48f80000\""
}

Pasos siguientes

Ahora que ha creado una conexión entre su base de datos PostgreSQL y Experience Platform, puede continuar con los siguientes pasos y llevar los datos de PostgreSQL a Experience Platform. Para obtener más información, lea la siguiente documentación:

recommendation-more-help