Agendando atualização automática do Power BI a partir do Fluid OAuth 2.0

Este artigo explica como manter um relatório publicado do Power BI automaticamente atualizado com dados do Fluid, usando atualização agendada no serviço do Power BI com OAuth 2.0 (Microsoft Entra ID).

A atualização agendada é executada sem nenhum usuário presente, mas não é um login de "aplicativo". O serviço do Power BI armazena as credenciais OAuth 2.0 de um usuário real – a pessoa que definiu as credenciais da fonte de dados – e as reproduz automaticamente (usando o cliente Power BI Data Refresh da Microsoft). Para o Fluid, cada atualização, portanto, parece ser esse usuário, então:

• a conta deve ser um usuário ativo do Fluid com permissão para os dados sendo atualizados, e

• a credencial armazenada deve ser reconsentida (conectada novamente) se expirar.

Como a atualização é executada como quem definiu as credenciais, use uma conta dedicada (por exemplo powerbi-refresh@yourcompany.com) em vez de uma pessoal. Se você usar sua própria conta e depois sair ou alterar sua senha, a atualização para. Consulte o Passo 1.

Esta é a única opção "não assistida" para o Power BI com o Fluid. Se você precisar de uma identidade verdadeira sem usuário / de aplicativo, esse é um mecanismo diferente – consulte Acesso programático à API do Fluid usando OAuth 2.0.

Quando você cria o relatório pela primeira vez no Power BI Desktop, você entra no Fluid com sua conta Organizacional, exatamente como uma conexão interativa. Quando você publica no serviço do Power BI e ativa a atualização agendada, o serviço precisa entrar no Fluid por conta própria, em um temporizador. Ele faz isso armazenando um token de atualização para a conta que você usou ao definir as credenciais da fonte de dados, e usando-o para obter um token de acesso atualizado para o Fluid cada vez que é atualizado.

You (once)       →  sign in with the refresh account  →  Power BI stores a refresh token
Power BI service →  (on schedule) uses the refresh token to get a Fluid access token
Power BI service →  calls Fluid as that user → loads the latest data

Como uma conexão interativa do Power BI, a atualização solicita um token para o host do seu site Fluid (por exemplo https://yourcompany.fluid.work) — ele não usa um recurso api:// personalizado. O login para atualização usa o aplicativo integrado da Microsoft Power BI Data Refresh (ID do cliente b52893c8-bc2e-47fc-918b-77022b299bbc), que o Fluid pré-autorizou no registro do aplicativo da API do Fluid.

Este guia pressupõe que a configuração única para Fluid + Entra já foi concluída. Em particular:

• O OAuth 2.0 está habilitado no seu site Fluid, e o host do seu site (por exemplo https://yourcompany.fluid.work) está registrado no aplicativo da API do Fluid para que a Microsoft emita tokens para ele. (Ambas são configurações do lado do Fluid — consulte seu Gerente de Conta Fluid.)

• Um administrador do Entra concedeu consentimento de administrador à API do Fluid no seu locatário.

• O cliente Power BI Data Refresh (b52893c8-bc2e-47fc-918b-77022b299bbc) está pré-autorizado no registro do aplicativo da API do Fluid (uma configuração do lado do Fluid), que é o que permite que a atualização agendada faça login.

Se algum desses itens estiver faltando, conclua primeiro Excel e Power BI usando OAuth 2.0 (Parte 1).

Você também precisará de:

• Solicite ao seu administrador do Microsoft 365 que forneça (ou crie) uma conta de usuário Entra dedicada para atualização, por exemplo powerbi-refresh@yourcompany.com, licenciada para o Power BI.

• Solicite ao seu administrador do Fluid que garanta que essa mesma conta exista como um usuário ativo do Fluid (seu nome de usuário no Fluid deve corresponder ao e-mail de trabalho / UPN da conta) com permissão para os dados que o relatório usa.

Não use uma conta pessoal para atualização em produção. A atualização é executada como essa conta, portanto, se a pessoa sair, alterar sua senha ou tiver a conta bloqueada, o agendamento é interrompido. Uma conta dedicada evita isso.

A conta de atualização entra interativamente uma vez quando você define as credenciais (Passo 3). Se sua organização impõe autenticação multifator (MFA) ou Acesso Condicional, pergunte ao seu administrador do Entra como a conta de atualização deve ser tratada para que seu token armazenado possa ser renovado sem um prompt interativo — caso contrário, a atualização eventualmente falhará. Consulte Mantendo a atualização em execução abaixo.

• No Power BI Desktop, na guia Início, selecione Obter Dados > Web (ou Feed OData) e insira sua URL de dados do Fluid, por exemplo https://yourcompany.fluid.work/api/....

• Quando solicitado, escolha Conta Organizacional > Entrar, e entre com a conta de atualização dedicada do Passo 1. Selecione Conectar.

• Modele os dados conforme necessário no Editor do Power Query, depois Fechar & Aplicar e crie seu relatório.

• Selecione Publicar (guia Início) e publique no workspace onde o relatório ficará.

Entrar como a conta de atualização durante a criação mantém a conexão consistente de ponta a ponta. Se você criou como você mesmo, tudo bem — você mudará para a conta de atualização quando definir as credenciais no Passo 3.

Este é o passo que armazena a credencial que o serviço reutilizará para atualização.

• No serviço do Power BI, abra o workspace que contém seu relatório.

• Encontre o modelo semântico (conjunto de dados), selecione ⋮ (Mais opções) > Configurações.

• Expanda Credenciais da fonte de dados e selecione Editar credenciais.

• Defina o Método de autenticação como OAuth2.

• Defina o nível de privacidade conforme exigido pela sua organização (por exemplo, Organizacional).

• Selecione Entrar, e entre com a conta de atualização dedicada.

Este passo concede ao serviço do Power BI permissão para chamar o Fluid em um agendamento como a conta de atualização. O login usa o cliente Power BI Data Refresh (b52893c8-…); se ele não foi pré-autorizado no aplicativo da API do Fluid, o login falha com AADSTS650057 (consulte Solução de problemas).

Se o seu ambiente Fluid só é acessível dentro da sua rede (não em um endereço público), o serviço do Power BI não consegue acessá-lo diretamente. Nesse caso, instale um Gateway de dados local e vincule a fonte de dados a ele em Conexões de gateway e nuvem, ainda usando credenciais OAuth2. Se o seu Fluid estiver hospedado na nuvem em um endereço público como https://yourcompany.fluid.work, nenhum gateway é necessário.

• Na mesma página de Configurações do conjunto de dados, expanda Atualização (ou Atualização agendada).

• Ative Mantenha seus dados atualizados como Ativado.

• Escolha a frequência de atualização e os horários que atendam às suas necessidades de relatório.

• (Recomendado) Insira um endereço de e-mail em enviar notificações de falha de atualização para ser alertado caso uma atualização falhe.

• Selecione Aplicar.

Para confirmar que funciona, selecione Atualizar agora (⋮ > Atualizar agora) e verifique o Histórico de atualização para uma entrada de sucesso.

As credenciais armazenadas não duram para sempre. A atualização continua funcionando apenas enquanto o token de atualização da conta de atualização permanecer válido. Ele pode ser invalidado por:

• a senha da conta sendo alterada ou redefinida,

• a conta sendo desativada ou sua licença removida,

• políticas de MFA / Acesso Condicional que exigem um novo login interativo,

• longos períodos de inatividade (os tokens de atualização expiram após um período sem uso).

Quando isso acontece, a atualização falha com um erro de credenciais/token expirado. Para corrigir, repita a Etapa 3 — selecione Editar credenciais e Entre novamente.

Para minimizar interrupções: use uma conta dedicada com uma senha gerenciada sem expiração ou de longa duração, mantenha-a licenciada e trabalhe com seu administrador do Entra em uma abordagem de Acesso Condicional que permita a renovação do token de atualização sem MFA interativo. Mantenha também o lado do Fluid saudável — a conta deve permanecer como um usuário ativo do Fluid com as permissões corretas.

• Para o lado do Fluid (a conta de atualização como usuário ativo do Fluid, permissões, a URL de dados), entre em contato com seu Administrador do Sistema Fluid ou Gerente de Conta Fluid.

• Para o lado da Microsoft (a conta dedicada, licenciamento, MFA/Acesso Condicional, o gateway de dados), entre em contato com seu administrador do Microsoft 365 / Azure.

• Excel e Power BI usando OAuth 2.0

• Conectando o Power Apps ao Fluid usando OAuth 2.0

• Acesso programático à API do Fluid usando OAuth 2.0

• Configurando o Power Automate para chamar a API do Fluid usando OAuth 2.0