Conectar Power BI ao Serviço de consulta
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.
Para adquirir as credenciais necessárias para conectar Power BI 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 você não tiver acesso ao espaço de trabalho de consultas.
Após instalar o Power BI, será necessário instalar o Npgsql, um pacote de driver .NET para PostgreSQL. Mais informações sobre Npgsql podem ser encontradas na Documentação de Npgsql.
Em "Npgsql GAC Installation", na tela de instalação personalizada, selecione Will be installed on local hard drive.
Para garantir que o Npgsql foi instalado corretamente, reinicie o computador antes de prosseguir para as próximas etapas.
Conectar Power BI ao Serviço de consulta connect-power-bi
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 da 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.
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.
FLATTEN para obter instruções sobre como ativar essa configuração ao conectar-se a um banco de dados.Modo de Conectividade de Dados data-connectivity-mode
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 authentication
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 import
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á.
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 o 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 na 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.
Consultar o conjunto de dados sem importar dados direct-query
O DirectQuery Data Connectivity mode consulta a fonte de dados diretamente sem importar ou copiar dados para a Área de Trabalho Power BI. Usando esse modo de conexão, você pode atualizar todas as visualizações com dados atuais por meio da interface do. No entanto, o tempo necessário para produzir ou atualizar a visualização varia de acordo com o desempenho da fonte de dados subjacente.
Mais informações sobre o uso de DirectQuery, bem como uma discussão abrangente sobre suas opções de conectividade, casos de uso e limitações, podem ser encontradas na documentação oficial PowerBI.
Para usar este Data Connectivity mode, selecione o alternador DirectQuery e depois Advanced options para inserir uma consulta SQL personalizada na seção SQL statement. Verifique se Include relationship columns está selecionado. Depois de concluir a consulta, selecione OK para continuar.
Uma pré-visualização do query é exibida. Selecione Load para ver os resultados da consulta.
Próximas etapas
Após a leitura deste documento, você deve entender como se conectar ao aplicativo de desktop Power BI e aos diferentes modos de conexão de dados disponíveis. Para obter mais informações sobre como gravar e executar consultas, consulte a orientação para a execução da consulta.