Documentação Experience Platform Guia do Serviço de consulta

Guia de credenciais

Última atualização: 4 de abril de 2025

Tópicos:

Criado para:

Usuário
Desenvolvedor

O Adobe Experience Platform Query Service permite conectar-se com clientes externos. Você pode se conectar a esses clientes externos usando credenciais com ou sem expiração.

NOTE

O painel de credenciais não está disponível automaticamente para todos os(as) usuários(as). Entre em contato com a equipe de conta da Adobe para solicitar que a guia Credenciais seja incluída no espaço de trabalho do Serviço de consulta, se necessário. Se solicitado, essa alteração abrange toda a organização e é realizada pela equipe de engenharia da Adobe. Não é uma configuração controlada por usuários.

Credenciais expiradas

Você pode usar credenciais com expiração para configurar rapidamente uma conexão com um cliente externo.

A guia Credenciais do painel Consultas com a seção Credenciais em Expiração realçada.

A seção Credenciais que estão expirando fornece as seguintes informações:

Host: o nome do host ao qual conectar seu cliente. Ele incorpora o nome da sua organização, como visto na faixa superior da interface do usuário do Experience Platform.
Porta: o número da porta do host ao qual se conectar.
Banco de dados: o nome do banco de dados ao qual conectar um cliente.
Nome de usuário: o nome de usuário usado para se conectar ao Serviço de Consulta.
Senha: a senha usada para se conectar ao Serviço de Consulta. As senhas na interface do usuário receberam hash por questões de segurança. Selecione o ícone de cópia ( ) para copiar suas credenciais completas com hash para a área de transferência.
Comando PSQL: um comando que inseriu automaticamente todas as informações relevantes para você se conectar ao Serviço de Consulta usando PSQL na linha de comando.
Expira: a data e a hora de expiração das credenciais. A duração padrão da validade do token é de 24 horas, mas pode ser alterada nas configurações avançadas do Admin Console.

TIP

Para alterar a vida útil da sessão da sua conexão de credenciais com o Serviço de Consulta expirando, navegue até a Admin Console e selecione as seguintes opções na tela: Configurações > Privacidade e Segurança > Configurações de Autenticação > Configurações avançadas > Vida útil máxima da sessão.

A guia Configurações do Admin Console com Privacidade e Segurança, Configurações de autenticação e Vida máxima da sessão foi realçada.

Consulte a documentação de Ajuda do Adobe para obter mais informações sobre as Configurações avançadas oferecidas pelo Admin Console.

Conectar-se aos dados do Customer Journey Analytics nas sessões de consulta

Use a extensão Customer Journey Analytics BI com Power BI ou Tableau para acessar suas visualizações de dados do Customer Journey Analytics com SQL. Ao integrar o Serviço de consulta à extensão BI, você pode acessar suas visualizações de dados diretamente nas sessões do Serviço de consulta. Essa integração simplifica a funcionalidade das ferramentas de BI que usam o Serviço de consulta como interface PostgreSQL. Essa funcionalidade elimina a necessidade de duplicar visualizações de dados em ferramentas de BI, garante a geração de relatórios consistentes entre plataformas e simplifica a integração dos dados do Customer Journey Analytics com outras fontes em plataformas de BI.

Consulte a documentação para saber como conectar o Serviço de consulta a uma variedade de aplicativos de cliente de desktop, como Power BI ou Tableau

IMPORTANT

Um projeto do espaço de trabalho do Customer Journey Analytics e uma visualização de dados são necessários para usar essa funcionalidade.

Para acessar os dados do Customer Journey Analytics no Power BI ou Tableau, selecione o menu suspenso Banco de Dados e prod:cja nas opções disponíveis. Em seguida, copie os parâmetros de credenciais do Postgres (Host, Porta, Banco de Dados, Nome de Usuário e outros) para uso na sua configuração do Power BI ou Tableau.

A guia de credenciais do Serviço de Consulta com a lista suspensa de banco de dados foi realçada.

NOTE

Quando você conecta o Power BI ou o Tableau ao Customer Journey Analytics, o direito de "sessões simultâneas" do Serviço de consulta é consumido. Se sessões e consultas adicionais forem necessárias, um complemento de pacote de usuários de consulta ad hoc adicional poderá ser adquirido para obter cinco sessões simultâneas adicionais e uma consulta simultânea adicional.

Você também pode acessar os dados do Customer Journey Analytics diretamente do Editor de consultas ou da CLI do Postgres. Para fazer isso, faça referência ao banco de dados cja ao gravar sua consulta. Consulte o guia de criação de consultas do Editor de consultas para obter mais informações sobre como gravar, executar e salvar consultas.

Consulte o guia de extensão de BI para obter instruções completas sobre como acessar suas visualizações de dados do Customer Journey Analytics com SQL.

Credenciais sem expiração

Você pode usar credenciais sem expiração para configurar uma conexão mais permanente com um cliente externo.

NOTE

As credenciais sem expiração têm as seguintes limitações:

Os usuários devem fazer logon com seu nome de usuário e senha no formato de {technicalAccountId}:{credential}. Encontre mais informações na seção Gerar credenciais.
Por padrão, as credenciais sem expiração recebem permissões para executar somente consultas SELECT. Para executar consultas CTAS ou ITAS, adicione manualmente as permissões "Gerenciar conjunto de dados" e "Gerenciar esquemas" à função associada à credencial sem expiração. A permissão "Gerenciar Esquemas" pode ser encontrada na seção "Modelagem de Dados", e a permissão "Gerenciar Conjuntos de Dados" está localizada na seção "Gerenciamento de Dados" da Adobe Developer Console.
Os clientes de terceiros podem ter um desempenho diferente do esperado ao listar objetos de consulta. Por exemplo, alguns clientes de terceiros, como DB Visualizer, não exibirão o nome da exibição no painel esquerdo. No entanto, o nome da exibição pode ser acessado se for chamado em uma consulta SELECT. Da mesma forma, PowerUI pode não listar as exibições temporárias criadas por meio do SQL para seleção na criação do painel.

Pré-requisitos

Antes de gerar credenciais sem expiração, você deve concluir as seguintes etapas no Adobe Admin Console:

Faça logon no Adobe Admin Console e selecione a Organização relevante na barra de navegação superior.
Selecione um perfil de produto.
Configure as permissões Sandboxes e Gerenciar Integração do Serviço de Consulta para o perfil do produto.
Adicione um novo usuário a um perfil de produto para que ele tenha suas permissões configuradas.
Adicione o usuário como um administrador de perfil de produto para permitir a criação de uma conta para qualquer perfil de produto ativo.
Adicione o usuário como desenvolvedor de perfil de produto para criar uma integração.

Para saber mais sobre como atribuir permissões, leia a documentação em controle de acesso.

Todas as permissões necessárias agora estão configuradas no Adobe Developer Console para que o usuário use o recurso de credenciais com vencimento.

Gerar credenciais

Para criar um conjunto de credenciais sem expiração, retorne à interface do usuário do Experience Platform e selecione Consultas na navegação à esquerda para acessar o espaço de trabalho Consultas. Em seguida, selecione a guia Credenciais seguida por Gerar credenciais.

O painel Consultas com a guia Credenciais e as credenciais Gerar realçadas.

Uma caixa de diálogo é exibida com a permissão para gerar credenciais. Para criar credenciais sem expiração, você deve fornecer os seguintes detalhes:

Nome: o nome das credenciais sendo geradas.
Descrição: (opcional) uma descrição para as credenciais que você está gerando.
Atribuído a: o usuário ao qual as credenciais serão atribuídas. Esse valor deve ser o endereço de email do usuário que está criando as credenciais.
Senha (Opcional) Uma senha opcional para suas credenciais. Se a senha não for definida, o Adobe gerará automaticamente uma senha para você.

Depois de fornecer todos os detalhes necessários, selecione Gerar credenciais para gerar suas credenciais.

A caixa de diálogo Gerar credenciais está realçada.

IMPORTANT

Quando Gerar credenciais é selecionado, um arquivo JSON de configuração é baixado para o computador local. Como o Adobe não registra as credenciais geradas, você deve armazenar com segurança o arquivo baixado e manter um registro da credencial.

Além disso, se as credenciais não forem usadas por 90 dias, elas serão eliminadas.

O arquivo JSON de configuração contém informações como nome da conta técnica, ID da conta técnica e credencial. Ela é fornecida no formato a seguir.

{"technicalAccountName":"9F0A21EE-B8F3-4165-9871-846D3C8BC49E@TECHACCT.ADOBE.COM","credential":"3d184fa9e0b94f33a7781905c05203ee","technicalAccountId":"4F2611B8613AA3670A495E55"}

Depois de salvar as credenciais geradas, selecione Fechar. Agora você pode ver uma lista de todas as suas credenciais sem expiração.

A guia Credenciais do painel Consultas com a seção Credenciais sem expiração realçada.

Você pode editar ou excluir suas credenciais sem expiração. Para editar uma credencial sem expiração, selecione o ícone de lápis ( ). Para excluir uma credencial sem expiração, selecione o ícone Excluir ( ).

Ao editar uma credencial sem expiração, um modal é exibido. Você pode fornecer os seguintes detalhes para atualizar:

Nome: o nome das credenciais sendo geradas.
Descrição: (opcional) uma descrição para as credenciais que você está gerando.
Atribuído a: o usuário ao qual as credenciais serão atribuídas. Esse valor deve ser o endereço de email do usuário que está criando as credenciais.

A caixa de diálogo Atualizar conta.

Depois de fornecer todos os detalhes necessários, selecione Atualizar conta para concluir a atualização de suas credenciais.

Usar credenciais para se conectar a clientes externos

Você pode usar as credenciais com ou sem expiração para se conectar com clientes externos, como Aqua Data Studio, Looker ou Power BI. O método de entrada dessas credenciais varia de acordo com o cliente externo. Consulte a documentação do cliente externo para obter instruções específicas sobre o uso dessas credenciais.

A imagem indica o local de cada parâmetro encontrado na interface, exceto a senha das credenciais sem expiração. Embora as credenciais sem expiração sejam fornecidas pelos arquivos de configuração JSON, você pode exibir suas credenciais que estão expirando na guia Credenciais da interface.

A guia Credenciais do espaço de trabalho Consultas com a seção Credenciais que estão Expirando está realçada.

A tabela abaixo descreve os parâmetros normalmente necessários para se conectar a clientes externos.

NOTE

Ao conectar-se a um host usando credenciais sem expiração, ainda é necessário usar todos os parâmetros listados na seção CREDENCIAIS EM EXPIRAÇÃO, exceto a senha e o nome de usuário.
O formato para inserir seu nome de usuário e senha usa valores separados por dois pontos, como neste exemplo username:{your_username} e password:{password_string}.

Parâmetro

Descrição

Exemplo

Servidor/Host

O nome do servidor/host ao qual você está se conectando.

Este valor é usado para credenciais com e sem expiração e assume a forma de server.adobe.io. O valor está em Host na seção CREDENCIAIS QUE EXPIRAM.

acme.platform.adobe.io

Port

A porta do servidor/host ao qual você está se conectando.

Este valor é usado para credenciais com e sem expiração e é encontrado na Porta da seção CREDENCIAIS DE EXPIRAÇÃO.

80

Banco de dados

O banco de dados ao qual você está se conectando.

Este valor é usado para credenciais que estão ou não expirando e foi encontrado no Banco de Dados na seção CREDENCIAIS QUE ESTÃO EXPIRANDO.

prod:all

Nome de usuário

O nome de usuário do usuário que está se conectando ao cliente externo.

Esse valor é usado para credenciais com e sem expiração. Assume a forma de uma sequência alfanumérica antes de @AdobeOrg. Este valor está em Username.

ECBB80245ECFC73E8A095EC9@AdobeOrg

Password

A senha do usuário que está se conectando ao cliente externo.

Se você estiver usando credenciais com vencimento, elas poderão ser encontradas em Senha na seção CREDENCIAIS QUE EXPIRAM.
Se você estiver usando credenciais sem expiração, esse valor serão os argumentos concatenados de technicalAccountID e a credencial retirada do arquivo JSON de configuração. O valor da senha tem o formato: {technicalAccountId}:{credential}.

Uma senha de credencial que expira tem mais de mil caracteres alfanuméricos. Nenhum exemplo será dado.
Uma senha de credencial sem expiração é a seguinte:
4F2611B8613DK3670V495N55:3d182fa9e0b54f33a7881305c06203ee

Próximas etapas

Agora que você entende como as credenciais com e sem expiração funcionam, é possível usá-las para se conectar a clientes externos. Para obter mais informações detalhadas sobre clientes externos, leia o guia Conectar clientes ao Serviço de Consulta.

recommendation-more-help