Visualizar dados do Azure Cosmos DB para NoSQL usando o Power BI

Saiba como conectar dados do Azure Cosmos DB ao Power BI Desktop e criar relatórios perspicazes para insights de negócios acionáveis.

Connecting

Conecte-se ao Azure Cosmos DB a partir do Power BI Desktop usando uma destas opções:

• Utilize Espelhamento no Microsoft Fabric para replicar dados do Azure Cosmos DB no Fabric OneLake. Quando você faz alterações no banco de dados, as atualizações são enviadas para o Fabric OneLake rapidamente. Este processo não torna a sua base de dados principal mais lenta nem utiliza recursos adicionais. Os relatórios do Power BI acessam dados diretamente do OneLake usando o modo DirectLake. Com os recursos aprimorados do Copilot no Power BI no Fabric, aproveite a IA generativa para obter insights de negócios importantes.

• Use o Azure Synapse Link para criar relatórios do Power BI sem efeito de desempenho ou custo em suas cargas de trabalho transacionais e sem pipelines ETL (extract-transform-load). 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 consome unidades de solicitação (RUs) alocadas para suas cargas de trabalho transacionais.

Pré-requisitos

Antes de seguir as instruções neste tutorial do Power BI, certifique-se de que tem acesso a estes recursos:

• Transferir 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 compartilhar seus relatórios no PowerBI.com, você precisa de uma conta no PowerBI.com. Para saber mais sobre o Power BI e o Power BI Pro, consulte https://powerbi.microsoft.com/pricing.

Criando relatórios de BI usando o espelhamento no Microsoft Fabric

Habilite o espelhamento em seus contêineres existentes do Azure Cosmos DB para criar relatórios ou painéis de BI nesses dados quase em tempo real. Para obter instruções sobre como começar a usar o Fabric e o espelhamento, consulte o tutorial de espelhamento do Azure Cosmos DB.

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 nesses dados, em apenas alguns selecionados usando o portal do Azure Cosmos DB. O Power BI se conecta ao Azure Cosmos DB usando o modo de Consulta Direta, permitindo que você consulte dados ao vivo do Azure Cosmos DB sem afetar 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.

   Observação

   Atualmente, essa opção está disponível apenas para contas NoSQL da API for 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. Para obter mais informações, consulte Usar o Power BI e o pool SQL Synapse sem servidor para analisar dados do Azure Cosmos DB com Synapse.

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

   Observação

   Habilitar o Azure Synapse Link tem implicações de custo. Para obter mais informações, consulte Preços do Azure Synapse Link.

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

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

   • Se o Azure Synapse Link não estiver habilitado, você poderá habilitar esse recurso em seus contêineres existentes. Se a habilitação do Azure 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 habilitar o Azure Synapse Link. Para saber mais, consulte o artigo habilitar o Azure 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 Azure 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 cria 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 .

   Observação

   Suas propriedades de contêiner do Azure Cosmos DB são representadas como colunas em exibições T-SQL, incluindo dados JSON aninhados profundamente. Essa representação é um início rápido para seus painéis de BI. Essas visualizações estão disponíveis em seu espaço de trabalho/banco de dados Synapse; você também pode usar essas mesmas exibições no Synapse Workspace para exploração de dados, ciência de dados ou engenharia de dados. Cenários avançados podem exigir exibições mais complexas ou ajuste fino dessas exibições, para um melhor desempenho. Para mais informações. consulte o artigo Práticas recomendadas para o Azure Synapse Link ao usar pools SQL sem servidor Synapse .

7. Escolha um espaço de trabalho existente ou crie 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 usa 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 não são refletidas no relatório, assim que os dados são replicados para o armazenamento analítico, o que normalmente acontece em alguns minutos.

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

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

1. Inicie o Power BI Desktop.

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

   

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

4. Selecione no Azure, selecione Azure Cosmos DB (Beta) e, em seguida, selecione Conectar.

   

5. Na página Conector de visualização, selecione 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ê deseja recuperar os dados e selecione OK. Para usar sua própria conta, você pode recuperar a URL da caixa URI na seção 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ão solicitadas as credenciais da conta.

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

9. Selecione 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, selecione o botão cinzento com duas setas em direções opostas que simbolizam a expansão do registo.

10. A vista Relatório do Power BI Desktop é onde se pode começar a criar relatórios para visualizar dados. Crie relatórios arrastando e soltando campos na tela Relatório.

11. Há duas maneiras de atualizar dados: não planejada e agendada. Selecione 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.

Problemas conhecidos e limitações

• Para contêineres particionados do Azure Cosmos DB, uma consulta SQL com uma função agregada é passada para o Azure Cosmos DB se a consulta contiver um filtro (WHERE cláusula) na chave de partição. Se a consulta agregada não incluir um filtro na chave de partição, o conector executará a agregação.

• O conector não passa uma função agregada quando segue TOP ou LIMIT.

• O Azure Cosmos DB processa a operação TOP no final ao processar uma consulta. Por exemplo, na consulta a seguir, TOP é aplicado na subconsulta, enquanto a função de agregação é aplicada sobre esse conjunto de resultados:

  SELECT COUNT(1) FROM (SELECT TOP 4 - FROM EMP) E
  

• Se DISTINCT estiver incluído em uma função agregada, o conector não passará a função agregada para o Azure Cosmos DB. DISTINCT em uma função agregada não há suporte para o Azure Cosmos DB para NoSQL.

• Para a função de agregação, o SUM Azure Cosmos DB retorna undefined se quaisquer argumentos em SUM forem string, booleano ou null. Se houver valores nulos, o conector passará a consulta para o Azure Cosmos DB para substituir valores nulos por zero durante o cálculo de SOMA.

• Para a função de agregação, o AVG Azure Cosmos DB retorna undefined como conjunto de resultados se qualquer um dos argumentos em SUM for string, booleano ou null. O conector expõe uma propriedade de conexão para desabilitar a transmissão da função de agregação do AVG para o Azure Cosmos DB caso esse comportamento padrão do Azure Cosmos DB precise ser substituído. Quando AVG a transmissão é desabilitada, ela não é passada para o Azure Cosmos DB e o conector lida com a execução da própria operação de agregação do AVG. Para obter mais informações, vá para "Ativar AVERAGE passagem de função" em Opções avançadas.

• Os contêineres do Azure Cosmos DB com chaves de partição grandes não são suportados no conector.

• A passagem de agregação está desativada para a seguinte sintaxe devido a limitações do servidor:

  • A consulta não está filtrando em uma chave de partição ou quando o filtro de chave de partição usa o OR operador com outro predicado no nível superior da WHERE cláusula.

  • A consulta tem uma ou mais chaves de partição aparecem em uma IS NOT NULL cláusula na WHERE cláusula.

• O conector V2 não suporta tipos de dados complexos, como matrizes, objetos e estruturas hierárquicas. Use o recurso Espelhamento de malha para Azure Cosmos DB para esses cenários.

• O conector V2 usa a amostragem dos primeiros 1.000 documentos para chegar ao esquema inferido. Essa abordagem não é recomendada para cenários de evolução de esquema em que apenas alguns documentos são atualizados. Por exemplo, uma propriedade recém-adicionada a um documento em um contêiner com milhares de documentos pode não ser incluída no esquema inferido. Recomendamos a Funcionalidade de Espelhamento de Malha para Azure Cosmos DB para essas situações.

• O conector V2 não suporta valores sem cadeia de caracteres nas propriedades do objeto.

• A passagem de filtro está desabilitada para a seguinte sintaxe devido a limitações do servidor:

  • Quando a consulta que contém uma ou mais colunas agregadas é referenciada WHERE na cláusula

Conteúdo relacionado

• Saiba mais sobre o Power BI em Introdução ao Power BI.
• Saiba mais sobre o Azure Cosmos DB na página inicial da documentação do Azure Cosmos DB.