Connect DbVisualizer para Query Service

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

Introdução

Este guia requer que você já tenha acesso ao DbVisualizer aplicativos de desktop e estão familiarizados com como navegar em sua interface. Para baixar o DbVisualizer para aplicativos de desktop ou para obter mais informações, consulte o funcionário DbVisualizer documentação.

OBSERVAÇÃO

Existem Windows, macOSe Linux versões de DbVisualizer. As capturas de tela deste guia foram realizadas com o uso da variável macOS aplicativo de desktop. Pode haver pequenas discrepâncias na interface do usuário entre as versões do .

Para adquirir as credenciais necessárias para conexão ​ DbVisualizer para o Experience Platform, você deve ter acesso ao espaço de trabalho Consultas na interface do usuário da plataforma. Entre em contato com o administrador da Organização IMS caso não tenha acesso ao espaço de trabalho de Consultas.

Criar uma conexão de banco de dados

Depois de instalar o aplicativo de desktop no computador local, inicie o aplicativo e selecione Create a Database Connection da DbVisualizer menu. Em seguida, selecione Create a Connection no painel à direita.

O DbVisualizer menu principal com "Create a Database Connection" realçado.

Use a barra de pesquisa ou selecione PostgreSQL na lista suspensa nome do driver. O espaço de trabalho Conexão de Banco de Dados é exibido.

O menu suspenso do nome do driver com PostgreSQL destacado.

Definir propriedades para a ligação

No espaço de trabalho Conexão de Banco de Dados, selecione o Properties , seguido pela guia Driver Properties na barra lateral de navegação.

O espaço de trabalho Database Connection com Propriedades e Propriedades do Driver foi realçado.

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

IMPORTANTE

Para conectar o DBVisualizer ao Adobe Experience Platform, você deve habilitar o uso do SSL. Consulte a Documentação dos modos SSL para saber mais sobre o suporte SSL para conexões de terceiros com o Adobe Experience Platform Query Service e como se conectar usando verify-full Modo SSL.

Propriedade Descrição
PGHOST O nome do host para o PostgreSQL servidor. Esse é o seu Experience Platform Host credencial.
ssl Definir o valor SSL 1 para ativar o uso de SSL.
sslmode Isso controla o nível de proteção SSL. É recomendável usar o require Modo SSL ao conectar clientes de terceiros ao Adobe Experience Platform. O require O modo 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 de caracteres alfanumérica que termina em @Adobe.Org. Esse é o seu Experience Platform Nome do usuário credencial.

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

A guia DBVisulaizer Driver Properties com um valor inserido e Apply está realçada.

OBSERVAÇÃO

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

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

EntradaQuery Service credenciais

Para encontrar as credenciais necessárias para conectar o BBVisualizer com o Serviço de query, faça logon na interface do usuário da plataforma e selecione Queries no menu de navegação esquerdo, seguido por Credenciais. Para obter mais informações sobre como encontrar seu host, porta, banco de dados, username e senha credenciais, leia a guia de credenciais.

A página Credenciais do espaço de trabalho Consultas do Experience Platform com Credenciais e as Credenciais de Expiração destacadas.

IMPORTANTE

Query Service O também oferece credenciais que não estão expirando para permitir uma configuração única com clientes de terceiros. Consulte a documentação para instruções completas sobre como gerar e usar credenciais que não estão expirando. É necessário concluir esse processo se você quiser conectar o BDVisualizer como uma configuração única. O credential e technicalAccountId os valores adquiridos incluem o valor do DBVisualizer password parâmetro.

Autenticação

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

No painel Autenticação de conexão, verifique as Require Userid e Require Password caixas de seleção e, em seguida, selecione Apply.

O painel Autenticação para PostgreSQL Database Connection with the Require Userid and Password (Conexão do banco de dados com as caixas de seleção Require Userid e Password) realçada.

Conectar-se à plataforma

Você pode fazer uma conexão usando credenciais que estão expirando ou que não estão expirando. Para fazer uma conexão, selecione o Connection no espaço de trabalho Conexão do Banco de Dados e insira suas credenciais do Experience Platform para as seguintes configurações.

OBSERVAÇÃO

Todas as credenciais exigidas pelo BDVisualizer na tabela abaixo são iguais para credenciais que expiram e não expiram, a menos que declarado na descrição do parâmetro.

Parâmetro de conexão Descrição
Nome Crie um nome para a sua conexão. É recomendável fornecer um nome amigável para reconhecer a conexão.
Servidor de banco de dados Este é o seu Experience Platform Host credencial.
Porta do Banco de Dados A porta para Query Service. Você deve usar a porta 80º para conectar-se com Query Service.
Banco de dados Use seu Experience Platform Banco de dados valor da credencial: prod:all.
Userid do Banco de Dados Esta é a ID da organização da plataforma. Use seu Experience Platform Nome do usuário valor da credencial. A ID estará no formato de ORG_ID@AdobeOrg.
Senha do banco de dados Esta sequência alfanumérica é o seu Experience Platform Senha credential.Se você quiser usar credenciais que não expiram, esse valor será o argumento concatenado da variável technicalAccountID e credential baixado no arquivo JSON de configuração. O valor da senha assume o formulário: {technicalAccountId}:{credential}. O arquivo JSON de configuração para credenciais que não expiram é um download único durante a inicialização que o Adobe não mantém uma cópia.

Depois de ter inserido todas as credenciais relevantes, selecione Connect.

O PostgreSQL Espaço de trabalho Database Connection com a guia Connection e o botão connect realçado.

O Connect será exibida na primeira ocasião da sessão.

A Conexão: PostgreSQL com os campos de texto ID do usuário do banco de dados e Senha do banco de dados destacados.

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ê se conectou DbVisualizer com Query Service, você pode usar DbVisualizer para gravar queries. Para obter mais informações sobre como gravar e executar consultas, leia o guia sobre execução de query.

Nesta página