Conectar DbVisualizer a Query Service connect-dbvisualizer

Este documento aborda as etapas para conectar a ferramenta de banco de dados DbVisualizer ao Adobe Experience Platform Query Service.

Introdução

Este guia requer que você já tenha acesso ao aplicativo de desktop DbVisualizer e esteja familiarizado com como navegar em sua interface. Para baixar o aplicativo de desktop DbVisualizer ou obter mais informações, consulte a documentação DbVisualizer oficial.

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

Criar uma conexão de banco de dados connect-database

Depois de instalar o aplicativo de desktop em seu computador local, siga as instruções oficiais do BDVisualizer para criar uma nova conexão de banco de dados.

Depois de selecionar PostgreSQL na lista Connections, uma guia Object View para a nova conexão PostgreSQL será exibida.

Definir propriedades do driver para sua conexão properties

Na guia de exibição de objeto PostgreSQL, selecione a guia Properties, seguida pela Driver Properties na barra lateral de navegação. Mais informações sobre propriedades do driver podem ser encontradas na documentação oficial.

Em seguida, insira as propriedades de driver descritas na tabela abaixo.

IMPORTANT
Para conectar o DBVisualizer ao Adobe Experience Platform, é necessário habilitar o uso de SSL. Consulte a documentação sobre modos 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.
Propriedade
Descrição
PGHOST
O nome do host do servidor PostgreSQL. Este valor é a sua credencial de Experience Platform Host.
ssl
Defina o valor SSL 1 para habilitar o uso de SSL.
sslmode
Isso controla o nível de proteção SSL. É recomendável usar o modo SSL require ao conectar clientes de terceiros ao Adobe Experience Platform. O modo require garante que a criptografia seja necessária em todas as comunicações e que a rede seja confiável para se conectar ao servidor correto. A validação do certificado SSL do servidor não é necessária.
user
O nome de usuário conectado ao banco de dados é a ID da organização. É uma sequência alfanumérica terminando em @Adobe.Org. Este valor é a sua credencial de Experience Platform Nome de usuário.

Use a barra de pesquisa para encontrar cada propriedade e, em seguida, selecione a célula correspondente para o valor do parâmetro. A célula será destacada em azul. Insira sua credencial da Platform no campo de valor e selecione Apply para adicionar a propriedade de driver.

NOTE
Para adicionar um segundo perfil user, selecione user na coluna de parâmetro e, em seguida, selecione o ícone azul + (mais) para adicionar credenciais para cada usuário. Selecione Apply para adicionar a propriedade de driver.

A coluna Edited mostra uma marca de seleção para indicar que o valor do parâmetro foi atualizado.

Credenciais do Serviço de consulta de entrada query-service-credentials

Para localizar as credenciais necessárias para conectar o BBVisualizer ao Serviço de Consulta, faça logon na Interface do Usuário da Plataforma e selecione Consultas na navegação à esquerda, seguido de Credenciais. Para obter mais informações sobre como localizar suas credenciais de host, porta, banco de dados, nome de usuário e senha, leia o guia de credenciais.

A página Credenciais do espaço de trabalho Consultas do Experience Platform com as Credenciais e as Credenciais que Estão Expirando realçadas.

IMPORTANT
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. É necessário concluir esse processo se você deseja conectar o BDVisualizer como uma configuração única. Os valores credential e technicalAccountId adquiridos compõem o valor do parâmetro DBVisualizer password.

Autenticação authentication

Para exigir uma ID de usuário e autenticação baseada em senha sempre que uma conexão for estabelecida, navegue até a guia Properties e selecione Authentication na barra lateral de navegação em PostgreSQL.

No painel Autenticação de Conexão, marque as caixas de seleção Require Userid e Require Password e selecione Apply. Mais informações sobre definição de opções de autenticação podem ser encontradas na documentação oficial.

Conectar à Platform

Você pode fazer uma conexão usando credenciais com ou sem expiração. Para fazer uma conexão, selecione a guia Connection na guia de exibição de objetos PostgreSQL e insira suas credenciais de Experience Platform para as seguintes configurações. Instruções complementares para configurar uma conexão manual estão disponíveis no site oficial do DBVisualizer.

NOTE
Todas as credenciais exigidas pelo BDVisualizer na tabela abaixo são as mesmas para credenciais com e sem expiração, a menos que seja declarado na descrição do parâmetro.
Parâmetro de conexão
Descrição
Nome
Crie um nome para a conexão. É recomendável fornecer um nome amigável para reconhecer a conexão.
Servidor de Banco de Dados
Esta é a credencial do seu Experience Platform Host.
Porta de Banco de Dados
A porta para Query Service. Você deve usar a porta 80 ou 5432 para se conectar com Query Service.
Banco de dados
Use seu Experience Platform Valor de credencial do banco de dados: prod:all.
Id de Usuário do Banco de Dados
Esta é a ID da sua organização da Platform. Use o valor da credencial do Experience Platform Nome de usuário. A ID estará no formato de ORG_ID@AdobeOrg.
Senha do Banco de Dados
Esta sequência alfanumérica é a credencial Experience Platform Password. Se você quiser usar credenciais sem expiração, esse valor serão os argumentos concatenados de technicalAccountID e credential baixados no arquivo JSON de configuração. O valor da senha tem o formato: {technicalAccountId}:{credential}. O arquivo JSON de configuração para credenciais sem expiração é um download único durante a inicialização do qual o Adobe não mantém uma cópia.

Depois de inserir todas as credenciais relevantes, selecione Connect.

A caixa de diálogo Connect aparece na primeira ocasião da sessão. Digite sua ID de usuário e senha e selecione Connect. Uma mensagem é exibida no log para confirmar uma conexão bem-sucedida.

Próximas etapas

Agora que você conectou o DbVisualizer com o Query Service, é possível usar o DbVisualizer para gravar consultas. Para obter mais informações sobre como gravar e executar consultas, leia o manual sobre execução de consultas.

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb