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

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

Connecting

Você pode se conectar ao Azure Cosmos DB a partir do Power BI Desktop usando uma destas opções:

• Use o 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 rapidamente para o Fabric OneLake. Esse processo não reduz a velocidade do banco de dados principal nem usa recursos extras. 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 informações de negócios importantes.

• Use o Link do Azure Synapse para criar relatórios no Power BI sem impacto de desempenho ou custo sobre suas cargas de trabalho transacionais, e sem necessidade de pipelines de ETL (extração, transformação e carga). Você pode usar o modo do DirectQuery ou de importação. Com o DirectQuery, você pode criar painéis/relatórios usando dados ao vivo de suas contas do Azure Cosmos DB, sem precisar importar ou copiar os dados para o Power BI.

• Conecte a conta do Power BI Desktop à conta do Azure Cosmos DB com o conector do Azure Cosmos DB para Power BI. Essa opção está disponível apenas no modo de importação e consome RUs (unidades de solicitação) alocadas para suas cargas de trabalho transacionais.

Pré-requisitos

Antes de seguir as instruções deste tutorial do Power BI, verifique se você tem acesso a esses recursos:

• Baixar a última versão 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 Power BI Pro, consulte https://powerbi.microsoft.com/pricing.

Criar relatórios de BI usando espelhamento no Microsoft Fabric

Habilite o espelhamento nos contêineres existentes do Azure Cosmos DB e crie relatórios ou dashboards do BI nesses dados, quase em tempo real. Para obter instruções sobre como começar a usar o Fabric e o espelhamento, confira o tutorial de espelhamento do Azure Cosmos DB.

Compilando relatórios de BI usando o Link do Azure Synapse

Habilite o Link do Azure Synapse em seus contêineres existentes do Azure Cosmos DB e crie relatórios de BI com esses dados, em apenas algumas seleções 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 dinâmicos do Azure Cosmos DB sem afetar cargas de trabalho transacionais.

Para compilar um relatório/painel do Power BI:

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

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

   Observação

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

3. Na guia Habilitar Link do Azure Synapse, habilite o Link do Synapse do Azure em sua conta a partir da seção Habilitar o Link do Azure Synapse para essa conta. Se o Link do Azure Synapse já estiver habilitado em sua conta, essa guia não será exibida. Essa etapa é um pré-requisito para começar a habilitar o Link do Synapse em seus contêineres.

   Observação

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

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

   • Caso já tenha habilitado o Link do Azure Synapse em alguns contêineres, você verá que a caixa de seleção ao lado do nome do contêiner está selecionada. Você pode optar por desmarcá-la com base nos dados que você gostaria de visualizar no Power BI.

   • Se o Link do Azure Synapse não estiver habilitado, você poderá habilitá-lo em seus contêineres existentes. Se a habilitação do Link do Azure Synapse estiver em andamento em qualquer um dos contêineres, os dados desse contêiner não serão incluídos. Retorne posteriormente a essa guia mais tarde e importe dados quando os contêineres estiverem habilitados.

   

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

   Você pode verificar o progresso no portal, conforme mostrado na tela a seguir. Os contêineres estarão habilitados para o Link do Azure Synapse quando o progresso atingir 100%.

   

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

   Observação

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

7. Selecione um espaço de trabalho existente ou crie um novo. Para selecionar um espaço de trabalho existente, forneça os detalhes de 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 do Synapse e criar exibições T-SQL. Certifique-se de que você tem permissões de "administrador do Synapse" nesse espaço de trabalho.

   

8. Em seguida, selecione Download do .pbids para fazer o download do arquivo de fonte de dados do Power BI. Abra o arquivo baixado. Ele contém as informações de conexão necessárias e abre um desktop do Power BI.

   

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

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

   

10. Agora você pode começar a criar o relatório usando dados analíticos do Azure Cosmos DB. As alterações em seus dados não são refletidas no relatório até que os dados sejam replicados para o repositório analítico, o que normalmente ocorre em alguns minutos.

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

No momento, há suporte à conexão do Azure Cosmos DB com o conector do Power BI apenas em contas do Azure Cosmos DB for NoSQL e da API para Gremlin.

1. Execute o Power BI Desktop.

2. Você pode Obter Dados, ver Fontes Recentes ou Abrir Outros Relatórios diretamente da tela de boas-vindas. Feche a tela selecionando a opção "X". A exibição de Relatório do Power BI Desktop será exibida.

   

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

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

   

5. Na página Visualizar Conector, 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, em seguida, selecione OK. Para usar sua própria conta, você pode recuperar a URL na caixa de URI na seção Chaves do portal do Azure. Opcionalmente, é possível 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 são provenientes.

7. Se você estiver se conectando a esse ponto de extremidade pela primeira vez, será solicitado que informe as credenciais da conta.

8. Quando a conta for conectada com sucesso, o painel Navegador será exibido. O Navegador mostra uma lista de bancos de dados na conta.

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

   O Painel de Visualização mostra uma lista dos itens do Registro. Um Documento é representado como um tipo Registro no Power BI. Da mesma forma, um bloco JSON aninhado dentro de um documento é também um Registro. Para exibir os documentos de propriedades como colunas, selecione o botão cinza com duas setas em direções opostas que simbolizam a expansão do registro.

10. A exibição de Relatório do Power BI Desktop é aquela em que você 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 os dados: não planejada e agendada. Selecione Atualizar Agora para atualizar os dados. Verifique a documentação do Power BI para obter mais informações sobre a opção de atualização agendada.

Problemas e limitações conhecidos

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

• O conector não transmite uma função de agregação 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 agregada é 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 de agregação, o conector não transmitirá a função de agregação para o Azure Cosmos DB. DISTINCT em uma função de agregação não há suporte para o Azure Cosmos DB for NoSQL.

• Para a função de agregação SUM, o Azure Cosmos DB retornará indefinido se algum argumento em SUM for cadeia de caracteres, booliano ou nulo. Se houver valores nulos, o conector transmitirá a consulta para o Azure Cosmos DB para substituir valores nulos por zero durante o cálculo SUM.

• Para a função de agregação AVG, o Azure Cosmos DB retornará indefinido como conjunto de resultados se qualquer um dos argumentos em SUM for cadeia de caracteres, booliano ou nulo. O conector expõe uma propriedade de conexão para desabilitar a transmissão da função de agregação AVG para o Azure Cosmos DB, caso esse comportamento padrão do Cosmos DB precise ser substituído. Quando a transmissão do AVG estiver desabilitada, ela não será transmitida para o Azure Cosmos DB e o conector manipulará a execução da própria operação de agregação do AVG. Para obter mais informações, acesse Habilitar transmissão da função AVERAGE" em Opções avançadas.

• Não há suporte a contêineres do Azure Cosmos DB com chave de partição grande no conector.

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

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

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

• O conector V2 não oferece suporte a tipos de dados complexos, como matrizes, objetos e estruturas hierárquicas. Use o recurso de Espelhamento do Fabric para Azure Cosmos DB nesses cenários.

• O conector V2 usa a amostragem dos primeiros 1.000 documentos para criar o 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 o recurso de Espelhamento do Fabric para Azure Cosmos DB nesses cenários.

• O conector V2 não oferece suporte a valores que não sejam do tipo cadeia de caracteres em propriedades do objeto.

• A transmissão de filtro está desabilitada para a seguinte sintaxe devido às limitações do servidor:

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

Conteúdo relacionado

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