Migrar aplicativos de vários clientes para o modelo de perfis de entidade de serviço

Este artigo descreve como você pode obter melhor escalabilidade migrando seus aplicativos de vários clientes de análise integrada do Power BI para o modelo de perfis de entidade de serviço.

Os perfis de entidade de serviço facilitam o gerenciamento de conteúdo organizacional no Power BI e o uso das suas capacidades com mais eficiência.

Pré-requisitos

É importante ler sobre perfis de entidade de serviço antes de iniciar a migração.

Também é necessário executar as seguintes etapas:

• Configure a entidade de serviço seguindo as três primeiras etapas de Inserir conteúdo do Power BI com entidade de serviço.
• Por meio de uma conta de administrador de locatário do Power BI, habilite a criação de perfis no locatário.

Migrar para os perfis de entidade de serviço

A migração para os perfis de entidade de serviço envolve as seguintes etapas:

1. Criar perfis, um por cliente.
2. Organizar seus workspaces.
3. Alterar o código do aplicativo para usar os perfis.
4. Testar seu aplicativo com o modelo de perfis.
5. Limpar as permissões redundantes.

Criar perfis (obrigatório)

Use a API REST de Perfis com a entidade de serviço que você criou para gerar um perfil para cada cliente.

É uma boa ideia salvar em seu banco de dados o mapeamento que liga cada ID do cliente de dados à ID de perfil correspondente. Você precisará desse mapeamento posteriormente para realizar chamadas à API com o perfil do locatário.

Organizar seus workspaces

A maneira mais fácil de gerenciar seus dados é mantendo um workspace por cliente. Se o aplicativo já usa esse modelo, não é necessário criar workspaces. No entanto, você ainda precisa fornecer a cada perfil acesso de Administrador ao workspace correspondente usando a API Adicionar Usuário de Grupo.

Se você não tiver um workspace por cliente, use o perfil correspondente para chamar a API Criar Usuário de Grupo a fim de criar um workspace para cada cliente.

Organizar os itens nos workspaces

Agora você deve ter um perfil e um workspace para cada cliente. Se você criou workspaces na etapa anterior, agora será necessário importar itens (como relatórios e modelos semânticos) a esses workspaces. Os modelos semânticos importados por você dependem da solução atual:

• Se seu aplicativo usar um modelo semântico separado para cada cliente, o design do modelo semântico poderá funcionar como está.

• Se seu aplicativo usar um modelo semântico com RLS (Segurança em Nível de Linha) para fornecer dados diferentes a cada cliente, você poderá obter melhor escalabilidade criando um modelo semântico separado para cada cliente e usando os perfis conforme descrito neste artigo.

• Após superar as limitações de escalabilidade usando perfis e fontes de dados separadas, você pode obter ainda mais separação de dados usando RLS com perfis.

  • Se você depender da RLS Dinâmica, o nome do perfil será retornado na função DAX UserName().
  • Se você usar RLS estática e substituir funções ao gerar o token inserido, poderá continuar fazendo isso.

Depois que os itens estiverem prontos, importe-os para os workspaces relevantes. Para automatizar o processo, considere usar a API de Importação.

Alterar os códigos do aplicativo para usar perfis

Uma vez que você tenha perfis com acesso de Administrador aos workspaces relevantes e um banco de dados com mapeamento que mostra qual perfil representa qual cliente, você pode fazer as alterações de código necessárias. Recomendamos que você mantenha dois fluxos de código lado a lado e exponha gradualmente o fluxo de código de perfis para seus clientes.

Faça as seguintes alterações no código:

• Alteração do código de autorização

  • Se você estiver usando um usuário mestre no aplicativo Microsoft Entra ID, altere o código do token de aquisição. Leia inserir com a entidade de serviço para saber mais sobre como criar um token do Microsoft Entra somente aplicativo.
  • Se você estiver usando uma entidade de serviço e tiver criado uma para perfis, ajuste o código para usar a ID e os segredos corretos da entidade de serviço.

• Alteração do código de gerenciamento

  Alguns aplicativos têm código de gerenciamento que automatiza a integração de novos clientes após o registro. Geralmente, o código de gerenciamento usa APIs REST do Power BI para criar workspaces e importar conteúdo. A maior parte desse código deve permanecer a mesma, mas talvez seja necessário adaptar os seguintes detalhes:

  • Sempre que você criar um locatário para o cliente, crie um perfil de serviço para ser o criador e administrador do workspace desse locatário.
  • Se você decidir reorganizar seu conteúdo do Power BI, edite o código para refletir as alterações realizadas.

• Inserir alteração do código de token

  Substitua o chamador da API. Verifique se um perfil chama a API GenerateToken porque, no modelo de perfis, apenas o perfil específico tem acesso ao conteúdo do cliente.

Validar

É uma melhor prática testar seu aplicativo por completo antes de movê-lo para o modelo de perfis. Os relatórios podem ser carregados mesmo se houver bugs no código do aplicativo SaaS porque você não excluiu as permissões mais antigas nos workspaces.

Limpar após a migração

Agora que você concluiu a migração e validou os resultados, remova o que não é mais necessário.

• Limpar o código: é recomendável desabilitar caminhos de código antigos para que você execute apenas novos códigos que dependem dos perfis.
• Limpar workspaces e permissões do Power BI: se você criou workspaces, exclua os workspaces antigos que não estão mais em uso. Se você reutilizou os mesmos workspaces, é recomendável excluir deles as permissões mais antigas (como as permissões de usuário mestre).

Conteúdo relacionado

Gerenciar perfis de entidade de serviço

Mais perguntas? Experimente perguntar à Comunidade do Power BI