Conectar Power BI 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 a Área de Trabalho do Power BI ao Serviço de Consulta da Adobe Experience Platform.

Introdução

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

IMPORTANT
O aplicativo de área de trabalho Power BI está somente disponível em dispositivos Windows.

Para adquirir as credenciais necessárias para conectar Power BI 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 de consultas.

Conectar Power BI ao Serviço de consulta

Para conectar Power BI ao Serviço de Consulta, abra Power BI e selecione Get Data na faixa de opções do menu superior. Em seguida, digite "PostgreSQL" na barra de pesquisa para restringir a lista de fontes de dados. A partir dos resultados que aparecem, selecione PostgreSQL database, seguido por Connect.

A caixa de diálogo do banco de dados PostgreSQL é exibida, solicitando valores para o servidor e o banco de dados. Instruções adicionais sobre como conectar-se a um banco de dados PostgreSQL a partir do Power Query Desktop podem ser encontradas na documentação oficial PowerBI.

Esses valores obrigatórios foram obtidos de suas credenciais do Adobe Experience Platform. 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 mais informações sobre como localizar o nome do banco de dados, o host, a porta e as credenciais de logon, leia o guia de credenciais.

IMPORTANT
Como usuário do Power BI ou Tableau, você pode conectar o Customer Journey Analytics às suas ferramentas de BI na guia de credenciais do Serviço de consulta. Consulte a documentação de credenciais para obter instruções sobre como conectar suas ferramentas de BI ao Customer Journey Analytics.

O espaço de trabalho Consultas do Experience Platform com a guia Credenciais e as credenciais Expirando foram realçadas.

No campo Server da caixa de diálogo PostgreSQL database, insira o valor do host encontrado na seção Credenciais do Serviço de Consulta. Para produção, adicione a porta :80 ao final da cadeia de caracteres do host. Por exemplo, made-up.platform-query.adobe.io:80.

O campo Database pode ser "all" ou um nome de tabela de conjunto de dados. Por exemplo, prod:all.

IMPORTANT
As estruturas de dados aninhadas em ferramentas de BI de terceiros podem ser niveladas para melhorar sua usabilidade e reduzir a carga de trabalho necessária para recuperar, analisar, transformar e relatar dados. Consulte a documentação sobre o recurso FLATTEN para obter instruções sobre como ativar essa configuração ao conectar-se a um banco de dados.

Modo de Conectividade de Dados

Em seguida, você pode selecionar seu Data Connectivity mode. Na caixa de diálogo PostgreSQL database, selecione Import seguido de OK para exibir uma lista de todas as tabelas disponíveis, ou selecione DirectQuery para consultar a fonte de dados diretamente sem importar ou copiar dados diretamente para Power BI.

Para saber mais sobre o modo Import, leia a seção sobre importação de uma tabela. Para saber mais sobre o modo DirectQuery, leia a seção sobre consulta a um conjunto de dados sem importar os dados.

Selecione OK depois de confirmar os detalhes do banco de dados.

Autenticação

Após confirmar o modo de conectividade de dados, é exibido um prompt solicitando seu nome de usuário, senha e configurações do aplicativo. Nesse caso, o nome de usuário é a ID da organização e a senha é o token de autenticação. Ambos podem ser encontrados na página de credenciais do Serviço de consulta.

Preencha estes detalhes e selecione Connect para prosseguir para a próxima etapa.

Importar uma tabela

Selecionando o Import Data Connectivity mode, o conjunto de dados completo é importado, o que permite usar as tabelas e colunas selecionadas no aplicativo de desktop Power BI como está.

IMPORTANT
Para ver as alterações de dados ocorridas desde a importação inicial, atualize os dados em Power BI importando o conjunto de dados completo novamente.

Para importar uma tabela, insira os detalhes do servidor e do banco de dados conforme descrito acima e selecione o Import Data Connectivity mode, seguido de OK. A caixa de diálogo Navigator é exibida, exibindo uma lista de todas as tabelas disponíveis. Selecione a tabela que deseja visualizar, seguida de Load para trazer o conjunto de dados para a Power BI. A tabela foi importada para Power BI.

Informações gerais sobre como se conectar aos dados no aplicativodo PowerBi desktop podem ser encontradas na documentação oficial.

Importar tabelas usando SQL personalizado

Atualmente, o Power BI e outras ferramentas de terceiros, como o Tableau, não permitem que os usuários importem objetos aninhados, como objetos XDM no Experience Platform. Para levar em conta isso, Power BI permite que você use SQL personalizado para acessar esses campos aninhados e criar uma exibição nivelada dos dados. Power BI carrega essa exibição nivelada dos dados aninhados anteriormente como uma tabela normal.

Na caixa de diálogo PostgreSQL database, selecione Advanced options para inserir uma consulta SQL personalizada na seção SQL statement. Essa consulta personalizada deve ser usada para nivelar seus pares de nome-valor JSON em um formato de tabela. A documentação oficial também fornece informações sobre como conectar o PowerBI usando uma instrução SQL nas opções avançadas.

Após inserir sua consulta personalizada, selecione OK para continuar conectando seu banco de dados. Consulte a seção autenticação acima para obter orientação sobre como conectar um banco de dados a partir desta parte do fluxo de trabalho.

Uma vez concluída a autenticação, uma pré-visualização dos dados nivelados será exibida no painel da Área de Trabalho Power BI como uma tabela. O nome do servidor e do banco de dados são listados na parte superior da caixa de diálogo. Selecione Load para concluir o processo de importação.

As visualizações agora estão disponíveis para edição e exportação no aplicativo de desktop Power BI.