Saída de Power BI do Azure Stream Analytics

Você pode usar Power BI como saída para um trabalho do Stream Analytics para fornecer uma experiência de visualização avançada dos resultados da análise. Use essa funcionalidade para painéis operacionais, geração de relatórios e relatórios controlados por métricas.

Observação

Power BI saída do Stream Analytics não está disponível no momento no Microsoft Azure operado pela 21Vianet e Azure Alemanha (T-Systems International).

Importante

O streaming em tempo real no Power BI foi preterido. Para obter mais informações sobre a desativação do streaming em tempo real no Power BI, consulte o blog. A partir de 31 de outubro de 2027, você não poderá criar jobs do Stream Analytics com o conector de saída do Power BI, e os jobs existentes em execução com o conector do Power BI serão interrompidos. Microsoft recomenda que você explore Real-Time Intelligence no Microsoft Fabric. Se você estiver interessado em migrar para o Fabric Real-Time Intelligence, poderá usar as diretrizes fornecidas nesta postagem blog. Se você precisar de mais diretrizes de migração de Microsoft, como revisão de arquitetura ou esclarecimento sobre recursos específicos, preencha sua solicitação a.

Configuração de saída

A tabela a seguir lista nomes de propriedade e suas descrições para configurar a saída do Power BI.

Nome da propriedade Descrição
Alias de saída Forneça um nome amigável que é usado em consultas para direcionar a saída da consulta para esta saída do Power BI.
Espaço de trabalho em grupo Para habilitar o compartilhamento de dados com outros usuários Power BI, selecione grupos dentro de sua conta Power BI ou escolha My Workspace se você não quiser gravar em um grupo. Atualizar um grupo existente requer a renovação da autenticação do Power BI.
Nome do conjunto de dados Forneça um nome para o conjunto de dados que você deseja que a saída do Power BI utilize.
Nome da tabela Forneça um nome de tabela no conjunto de dados da saída do Power BI. Atualmente, a saída do Power BI de trabalhos do Stream Analytics só pode ter uma tabela em um conjunto de dados (dataset).
Autorizar conexão Autorize no Power BI para definir suas configurações de saída. Depois de conceder esse acesso de saída ao painel de Power BI, você poderá revogar o acesso alterando a senha da conta de usuário, excluindo a saída do trabalho ou excluindo o trabalho do Stream Analytics.

Para obter um passo a passo sobre como configurar uma saída e um dashboard do Power BI, consulte o Tutorial: Analisar os dados de uma chamada fraudulenta com o Stream Analytics e visualizar os resultados em um dashboard do Power BI.

Observação

Não crie explicitamente o conjunto de dados e a tabela no painel do Power BI. O conjunto de dados e a tabela são preenchidos automaticamente quando a tarefa é iniciada e começa a enviar os dados para o Power BI. Se a consulta do trabalho não gerar resultados, o conjunto de dados e a tabela não serão criados. Se o Power BI já tiver um conjunto de dados e uma tabela com o mesmo nome fornecido no trabalho do Stream Analytics, os dados existentes serão substituídos.

Criar um esquema

Azure Stream Analytics criará um conjunto de dados Power BI e um esquema de tabela para você se eles ainda não existirem. Em todos os outros casos, a tabela é atualizada com novos valores. Atualmente, só pode existir uma tabela em um conjunto de dados.

O Power BI usa a política de retenção de PEPS (primeiro a entrar, primeiro a sair). Os dados são coletados em uma tabela até atingirem 200.000 linhas.

Observação

Não use várias saídas para gravar no mesmo conjunto de dados porque isso pode causar vários problemas. Cada saída tenta criar o conjunto de dados Power BI independentemente, o que pode resultar em vários conjuntos de dados com o mesmo nome. Além disso, se as saídas não tiverem esquemas consistentes, o conjunto de dados alterará o esquema em cada gravação, o que leva a muitas solicitações de alteração de esquema. Mesmo que você evite esses problemas, várias saídas têm menos desempenho do que uma única saída mesclada.

Converter um tipo de dados do Stream Analytics para o Power BI

O Azure Stream Analytics atualiza o modelo de dados dinamicamente no runtime se o esquema de saída mudar. Ele rastreia alterações de nome de coluna, alterações de tipo de coluna e a adição ou remoção de colunas.

Esta tabela abrange as conversões de tipo de dados dos Tipos de dados do Stream Analytics para Tipos de EDM (Modelo de Dados de Entidade) do Power BI caso não existam um conjunto de dados e uma tabela do Power BI.

De Stream Analytics Para o Power BI
bigint Int64
nvarchar(max) String
datetime Data e hora
derivar Duplo
Matriz de registro Tipo de cadeia de caracteres, valor constante IRecord ou IArray

Atualizar o esquema

o Stream Analytics infere o esquema do modelo de dados com base no primeiro conjunto de eventos na saída. Posteriormente, se necessário, ele atualiza o esquema do modelo de dados para acomodar eventos de entrada que podem não se encaixar no esquema original.

Evite usar a SELECT * consulta para evitar atualizações dinâmicas de esquema entre linhas. Além de possíveis implicações de desempenho, isso pode resultar em incertezas sobre o tempo necessário para os resultados. Selecione os campos exatos que você deseja mostrar no painel Power BI. Além disso, verifique se os valores de dados estão em conformidade com o tipo de dados escolhido.

Anterior/atual Int64 String Data e Hora Double
Int64 Int64 String String Duplo
Duplo Duplo String String Duplo
String String String String String
Data e hora String String Data e Hora String

Limitações e práticas recomendadas

Atualmente, você pode chamar Power BI aproximadamente uma vez por segundo. A transmissão de elementos visuais oferece suporte a pacotes de 15 KB. Além desse tamanho, os visuais de streaming falham (mas o push continua funcionando). Devido a essas limitações, Power BI funciona melhor quando Azure Stream Analytics reduz significativamente a carga de dados. Use uma janela de deslizamento ou uma janela de salto para garantir que você envie dados no máximo uma vez por segundo e que sua consulta atenda aos requisitos de taxa de transferência. Para saber mais sobre o tamanho do lote de saída, confira Limites da API REST do Power BI.

Use a seguinte equação para calcular o valor da janela em segundos:

Captura de tela da equação para calcular o valor da janela em segundos.

Por exemplo:

  • Você tem 1.000 dispositivos que enviam dados em intervalos de um segundo.
  • Você está usando a SKU (unidade de manutenção de estoque) do Power BI Pro que dá suporte a 1.000.000 linhas por hora.
  • Você deseja publicar a quantidade de dados médios por dispositivo no Power BI.

Como resultado, a equação torna-se:

Captura de tela da equação com base em critérios de exemplo.

Dada essa configuração, você pode alterar a consulta original para o seguinte:

    SELECT
        MAX(hmdt) AS hmdt,
        MAX(temp) AS temp,
        System.TimeStamp AS time,
        dspl
    INTO "CallStream-PowerBI"
    FROM
        Input TIMESTAMP BY time
    GROUP BY
        TUMBLINGWINDOW(ss,4),
        dspl

Renovar autorização

Se a senha foi alterada desde que você criou seu trabalho ou autenticado pela última vez, reautentica sua conta Power BI. Se a autenticação multifator do Microsoft Entra estiver configurada no locatário do Microsoft Entra, também será necessário renovar a autorização do Power BI a cada duas semanas. Se você não renovar, poderá ver sintomas como a ausência de resultado do trabalho ou um Authenticate user error nos registros de operação.

Da mesma forma, se um trabalho for iniciado após a expiração do token, ocorrerá um erro e o trabalho falhará. Para resolver esse problema, interrompa o trabalho em execução e vá para o resultado do Power BI. Para evitar a perda de dados, selecione Renovar autorização e reinicie o trabalho a partir da Hora da Última Interrupção.

Depois de atualizar a autorização com Power BI, um alerta verde será exibido na área de autorização para mostrar que o problema foi resolvido. Para superar essa limitação, use a identidade gerenciada para autenticar seu trabalho Azure Stream Analytics para Power BI.