Visualizar dados do Azure Cosmos DB usando o Power BI

APLICA-SE A: NoSQL

Este artigo descreve as etapas necessárias para conectar dados do Azure Cosmos DB ao Power BI Desktop.

Você pode se conectar ao Azure Cosmos DB a partir da área de trabalho do Power BI usando uma destas opções:

• Use o Azure Synapse Link para criar relatórios do Power BI sem impacto no desempenho ou no custo de suas cargas de trabalho transacionais e sem pipelines de ETL.

  Você pode usar o DirectQuery ou o modo de importação . Com o DirectQuery, você pode criar painéis/relatórios usando dados em tempo real de suas contas do Azure Cosmos DB, sem importar ou copiar os dados para o Power BI.

• Conecte o Power BI Desktop à conta do Azure Cosmos DB com o conector do Azure Cosmos DB para Power BI. Essa opção só está disponível no modo de importação e consumirá RUs alocados para suas cargas de trabalho transacionais.

Nota

Os relatórios criados no Power BI Desktop podem ser publicados no PowerBI.com. A extração direta de dados do Azure Cosmos DB não pode ser executada a partir do PowerBI.com.

Pré-requisitos

Antes de seguir as instruções neste tutorial do Power BI, verifique se você tem acesso aos seguintes recursos:

• Baixe a versão mais recente do Power BI Desktop.

• Crie uma conta de banco de dados do Azure Cosmos DB e adicione dados aos contêineres do Azure Cosmos DB.

Para partilhar os seus relatórios no PowerBI.com, tem de ter uma conta no PowerBI.com. Para saber mais sobre o Power BI e o Power BI Pro, consulte https://powerbi.microsoft.com/pricing.

Vamos começar

Criando relatórios de BI usando o Azure Synapse Link

Você pode habilitar o Azure Synapse Link em seus contêineres existentes do Azure Cosmos DB e criar relatórios de BI sobre esses dados, em apenas alguns cliques usando o portal do Azure Cosmos DB. O Power BI se conectará ao Azure Cosmos DB usando o modo de Consulta Direta, permitindo que você consulte seus dados do Azure Cosmos DB ao vivo, sem afetar suas cargas de trabalho transacionais.

Para criar um relatório/dashboard do Power BI:

1. Entre no portal do Azure e navegue até sua conta do Azure Cosmos DB.

2. Na seção Integrações , abra o painel Power BI e selecione Introdução.

   Nota

   Atualmente, essa opção só está disponível para API para contas NoSQL. Você pode criar exibições T-SQL diretamente em pools SQL sem servidor Synapse e criar painéis de BI para o Azure Cosmos DB para MongoDB. Consulte "Usar o Power BI e o pool SQL Synapse sem servidor para analisar dados do Azure Cosmos DB com Synapse" para obter mais informações.

3. Na guia Habilitar Link de Sinapse do Azure, você pode habilitar o Link de Sinapse em sua conta em Habilitar o link de Sinapse do Azure para esta seção de conta. Se o Synapse Link já estiver ativado para sua conta, você não verá essa guia. Esta etapa é um pré-requisito para começar a habilitar o Synapse Link em seus contêineres.

   Nota

   Habilitar o Azure Synapse Link tem implicações de custo. Consulte a seção de preços do Azure Synapse Link para obter mais detalhes.

4. Em seguida, na seção Habilitar o Azure Synapse Link para seus contêineres , escolha os contêineres necessários para habilitar o Synapse Link.

   • Se você já ativou o Synapse Link em alguns contêineres, você verá a caixa de seleção ao lado do nome do contêiner está selecionado. Opcionalmente, você pode desmarcá-los, com base nos dados que deseja visualizar no Power BI.

   • Se o Synapse Link não estiver habilitado, você poderá ativá-lo em seus contêineres existentes.

     Se a ativação do Synapse Link estiver em andamento em qualquer um dos contêineres, os dados desses contêineres não serão incluídos. Você deve voltar a essa guia mais tarde e importar dados quando os contêineres estiverem habilitados.

   

5. Dependendo da quantidade de dados em seus contêineres, pode demorar um pouco para ativar o Synapse Link. Para saber mais, consulte o artigo habilitar o Synapse Link em contêineres existentes.

   Você pode verificar o progresso no portal como mostrado na tela a seguir. Os contêineres são habilitados com o Synapse Link quando o progresso atinge 100%.

   

6. Na guia Selecionar espaço de trabalho, escolha o espaço de trabalho do Azure Synapse Analytics e selecione Avançar. Esta etapa criará automaticamente exibições T-SQL no Synapse Analytics para os contêineres selecionados anteriormente. Para obter mais informações sobre modos de exibição T-SQL necessários para conectar seu Azure Cosmos DB ao Power BI, consulte o artigo Preparar modos de exibição .

   Nota

   Suas propriedades de contêiner do Azure Cosmos DB serão representadas como colunas em exibições T-SQL, incluindo dados JSON aninhados profundamente. Este é um início rápido para seus painéis de BI. Estas vistas estarão disponíveis na sua área de trabalho/base de dados Synapse; você também pode usar essas mesmas visualizações no Synapse Workspace para exploração de dados, ciência de dados, engenharia de dados, etc. Observe que cenários avançados podem exigir exibições mais complexas ou ajustes finos dessas exibições, para um melhor desempenho. Para obter mais informações. consulte as práticas recomendadas para o artigo Synapse Link ao usar pools SQL sem servidor Synapse.

7. Você pode escolher um espaço de trabalho existente ou criar um novo. Para selecionar um espaço de trabalho existente, forneça os detalhes Assinatura, Espaço de trabalho e Banco de dados. O portal do Azure usará suas credenciais do Microsoft Entra para se conectar automaticamente ao seu espaço de trabalho Synapse e criar exibições T-SQL. Certifique-se de que tem permissões de "administrador Sinapse" para esta área de trabalho.

   

8. Em seguida, selecione Baixar .pbids para baixar o arquivo de fonte de dados do Power BI. Abra o ficheiro transferido. Ele contém as informações de conexão necessárias e abre a área de trabalho do Power BI.

   

9. Agora você pode se conectar aos dados do Azure Cosmos DB a partir do Power BI desktop. Uma lista de exibições T-SQL correspondentes aos dados em cada contêiner é exibida.

   Por exemplo, a tela a seguir mostra os dados da frota de veículos. Você pode carregar esses dados para análise adicional ou transformá-los antes de carregá-los.

   

10. Agora você pode começar a criar o relatório usando os dados analíticos do Azure Cosmos DB. Quaisquer alterações nos dados serão refletidas no relatório, assim que os dados forem replicados para o armazenamento analítico, o que normalmente acontece em alguns minutos.

Criando relatórios de BI usando o conector do Power BI

Nota

A conexão ao Azure Cosmos DB com o conector do Power BI é atualmente suportada apenas para contas do Azure Cosmos DB para NoSQL e API para Gremlin.

1. Execute o Power BI Desktop.

2. Você pode Obter dados, ver Fontes recentes ou Abrir outros relatórios diretamente na tela de boas-vindas. Selecione o "X" no canto superior direito para fechar a tela. O modo de exibição Relatório do Power BI Desktop é exibido.

   

3. Selecione a faixa de opções Página Inicial e clique em Obter Dados. A janela Obter dados deve aparecer.

4. Clique em Azure, selecione Azure Cosmos DB (Beta) e clique em Conectar.

   

5. Na página Conector de Pré-visualização, clique em Continuar. A janela do Azure Cosmos DB é exibida.

6. Especifique a URL do ponto de extremidade da conta do Azure Cosmos DB da qual você gostaria de recuperar os dados, conforme mostrado abaixo, e clique em OK. Para usar sua própria conta, você pode recuperar a URL da caixa URI na folha Chaves do portal do Azure. Opcionalmente, você pode fornecer o nome do banco de dados, o nome da coleção ou usar o navegador para selecionar o banco de dados e a coleção para identificar de onde os dados vêm.

7. Se você estiver se conectando a esse ponto de extremidade pela primeira vez, será solicitada a chave da conta. Para sua própria conta, recupere a chave da caixa Chave Primária na folha Chaves Somente Leitura do portal do Azure. Insira a chave apropriada e clique em Conectar.

   Recomendamos que você use a chave somente leitura ao criar relatórios. Isso evita a exposição desnecessária da chave primária a potenciais riscos de segurança. A chave somente leitura está disponível na folha Chaves do portal do Azure.

8. Quando a conta é conectada com êxito, o painel Navegador é exibido. O Navigator mostra uma lista de bases de dados sob a conta.

9. Clique e expanda o banco de dados de onde vêm os dados para o relatório. Agora, selecione uma coleção que contenha os dados a serem recuperados.

   O painel Visualizar mostra uma lista de itens de Registro . Um documento é representado como um tipo de registro no Power BI. Da mesma forma, um bloco JSON aninhado dentro de um documento também é um Registro. Para visualizar os documentos de propriedades como colunas, clique no botão cinza com 2 setas em direções opostas que simbolizam a expansão do registro. Ele está localizado à direita do nome do contêiner, no mesmo painel de visualização.

10. O modo de exibição Relatório do Power BI Desktop é onde você pode começar a criar relatórios para visualizar dados. Você pode criar relatórios arrastando e soltando campos na tela Relatório .

11. Há duas maneiras de atualizar dados: ad hoc e agendada. Basta clicar em Atualizar agora para atualizar os dados. Consulte a documentação do Power BI para obter mais informações sobre a opção de atualização agendada.

Próximos passos

• Para saber mais sobre o Power BI, consulte Introdução ao Power BI.
• Para saber mais sobre o Azure Cosmos DB, consulte a página inicial da documentação do Azure Cosmos DB.