Conectar Aqua Data Studio ao Serviço de consulta

Última atualização: 4 de abril de 2025
  • Tópicos:

Criado para:

  • Usuário
  • Desenvolvedor

Este documento aborda as etapas para conectar o Aqua Data Studio ao Adobe Experience Platform Query Service.

Introdução

Este guia requer que você já tenha acesso ao Aqua Data Studio e esteja familiarizado com como navegar em sua interface. Mais informações sobre Aqua Data Studio podem ser encontradas na documentação Aqua Data Studio oficial.

NOTE
Há Windows e macOS versões de Aqua Data Studio. As capturas de tela neste guia foram feitas usando o aplicativo de desktop macOS. Pode haver pequenas discrepâncias na interface do usuário entre as versões.

Para adquirir as credenciais necessárias para conectar Aqua Data Studio ao Experience Platform, você deve ter acesso ao espaço de trabalho Consultas na interface do usuário do Experience Platform. Entre em contato com o administrador da organização se você não tiver acesso ao espaço de trabalho Consultas.

Registrar o servidor

Depois de instalar o Aqua Data Studio, primeiro você deve registrar o servidor. Consulte a documentação oficial do Aqua Data Studio para obter instruções sobre como iniciar a Register Server caixa de diálogo e registrar o servidor.

Quando a caixa de diálogo Register Server for exibida para um servidor PostgresSQL, forneça os detalhes a seguir para as configurações do servidor.

  • Name: O nome da sua conexão. É recomendável fornecer um nome amigável para reconhecer a conexão.
  • Login Name: O nome de logon é sua ID da organização da Experience Platform. Ele assume a forma de ORG_ID@AdobeOrg.
  • Password: esta é uma cadeia de caracteres alfanumérica encontrada no painel de credenciais Query Service.
  • Host and Port: O ponto de extremidade do host e sua porta para Query Service. Você deve usar a porta 80 para se conectar com Query Service.
  • Database: O banco de dados que será usado. Use o valor para a credencial de interface do usuário do Experience Platform dbname: prod:all.

Query Service credenciais

Para encontrar suas credenciais, faça logon na interface do usuário do Experience Platform e selecione Consultas na navegação à esquerda, seguido de Credenciais. Para obter instruções completas para localizar suas credenciais de logon, host, porta e nome do banco de dados, leia o guia de credenciais.

Query Service também oferece credenciais sem expiração para permitir uma configuração única com clientes de terceiros. Consulte a documentação de instruções completas sobre como gerar e usar credenciais sem expiração.

Definição do modo SSL

Em seguida, defina o valor do modo SSL como ?sslmode=require. Isso é feito na guia Driver da caixa de diálogo Edit Server Properties. Consulte a documentação oficial do Aqua Data Studio para obter instruções sobre como editar propriedades do driver e configurar o SSL para PostgreSQL. Use a barra de pesquisa para localizar a propriedade sslmode.

IMPORTANT
Consulte a Query Service documentação SSL para saber mais sobre o suporte SSL para conexões de terceiros ao Serviço de Consulta da Adobe Experience Platform e como se conectar usando o modo SSL verify-full.

Depois de inserir os detalhes da conexão, na mesma guia, selecione Test Connection para garantir que suas credenciais funcionem corretamente. Se o teste de conexão for bem-sucedido, selecione Save para registrar o servidor. Uma caixa de diálogo de confirmação é exibida confirmando a conexão, e o ícone de conexão é exibido no painel. Agora você pode se conectar ao servidor e visualizar seus objetos de esquema.