Conectar DbVisualizer a Query Service
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 Consultas na interface do usuário do Experience 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
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
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.
IMPORTANTverify-full.| Propriedade | Descrição |
|---|---|
PGHOST | O nome do host do servidor PostgreSQL. Este valor é a credencial do Host do Experience Platform. |
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 credencial Username do Experience Platform. |
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 do Experience Platform no campo de valor e selecione Apply para adicionar a propriedade de driver.
NOTEuser, 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
Para localizar as credenciais necessárias para conectar o BBVisualizer ao Serviço de Consulta, faça logon na interface do usuário do Experience Platform 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.
IMPORTANTcredential e technicalAccountId adquiridos compõem o valor do parâmetro DBVisualizer password.Autenticação
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-se ao Experience 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 objeto PostgreSQL e insira suas credenciais do 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| 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 sua credencial do 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 valor de credencial do Banco de Dados do Experience Platform: prod:all. |
| Id de Usuário do Banco de Dados | Esta é a ID da organização da Experience Platform. Use o valor da credencial Username do Experience Platform. A ID estará no formato de ORG_ID@AdobeOrg. |
| Senha do Banco de Dados | Esta sequência alfanumérica é a credencial Senha da Experience Platform. 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 a 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.