Conectar Aqua Data Studio al servicio de consultas

5 de mayo de 2025

Creado para:

  • Usuario
  • Desarrollador

Este documento describe los pasos para conectar Aqua Data Studio con Adobe Experience Platform Query Service.

Introducción

Esta guía requiere que ya tenga acceso a Aqua Data Studio y que esté familiarizado con cómo navegar por su interfaz. Encontrará más información sobre Aqua Data Studio en la documentación oficial Aqua Data Studio 3}.

NOTE
Hay Windows y macOS versiones de Aqua Data Studio. Las capturas de pantalla de esta guía se tomaron mediante la aplicación de escritorio macOS. Puede haber discrepancias menores en la interfaz de usuario entre las versiones.

Para adquirir las credenciales necesarias para conectar Aqua Data Studio a Experience Platform, debe tener acceso al área de trabajo Consultas en la interfaz de usuario de Experience Platform. Póngase en contacto con el administrador de su organización si actualmente no tiene acceso al área de trabajo Consultas.

Registrar el servidor

Después de instalar Aqua Data Studio, primero debe registrar el servidor. Consulte la documentación oficial de Aqua Data Studio para obtener instrucciones sobre cómo iniciar el Register Server diálogo y registrar el servidor.

Una vez que aparezca el cuadro de diálogo Register Server para un servidor PostgresSQL, proporcione los siguientes detalles para la configuración del servidor.

  • Name: nombre de su conexión. Se recomienda proporcionar un nombre descriptivo para reconocer la conexión.
  • Login Name: el nombre de inicio de sesión es su ID de organización de Experience Platform. Adopta la forma de ORG_ID@AdobeOrg.
  • Password: se trata de una cadena alfanumérica que se encuentra en el panel de credenciales de Query Service.
  • Host and Port: el extremo de host y su puerto para Query Service. Debe usar el puerto 80 para conectarse con Query Service.
  • Database: La base de datos que se utilizará. Use el valor de la credencial dbname de la interfaz de usuario de Experience Platform: prod:all.

Credenciales de Query Service

Para encontrar sus credenciales, inicie sesión en la interfaz de usuario de Experience Platform y seleccione Consultas en el panel de navegación izquierdo, seguido de Credenciales. Para obtener instrucciones completas para encontrar sus credenciales de inicio de sesión, host, puerto y nombre de base de datos, lea la guía de credenciales.

Query Service también ofrece credenciales que no caducan para permitir una configuración única con clientes de terceros. Consulte la documentación para obtener instrucciones completas sobre cómo generar y utilizar credenciales que no caducan.

Estableciendo modo SSL

A continuación, debe establecer el valor del modo SSL como ?sslmode=require. Esto se hace desde la ficha Driver del cuadro de diálogo Edit Server Properties. Consulte la documentación oficial de Aqua Data Studio para obtener instrucciones sobre cómo editar las propiedades del controlador y configurar SSL para PostgreSQL. Utilice la barra de búsqueda para encontrar la propiedad sslmode.

IMPORTANT
Consulte la Query Service documentación SSL para obtener más información sobre la compatibilidad de SSL para conexiones de terceros con el servicio Adobe Experience Platform Query y cómo conectarse mediante el modo SSL verify-full.

Después de escribir los detalles de conexión, en la misma ficha, seleccione Test Connection para asegurarse de que las credenciales funcionan correctamente. Si la prueba de conexión se realizó correctamente, seleccione Save para registrar el servidor. Aparecerá un cuadro de diálogo de confirmación que confirma la conexión y el icono de conexión aparecerá en el panel. Ahora puede conectarse al servidor y ver sus objetos de esquema.