Eventos
Junte-se a nós na FabCon Vegas
31 de mar., 23 - 2 de abr., 23
O melhor evento liderado pela comunidade Microsoft Fabric, Power BI, SQL e AI. 31 de março a 2 de abril de 2025.
Registre-se hoje mesmoNão há mais suporte para esse navegador.
Atualize o Microsoft Edge para aproveitar os recursos, o suporte técnico e as atualizações de segurança mais recentes.
Este artigo explica como usar o SDK com perfis de entidade de serviço. Há duas maneiras de conectar um cliente do Power BI a um perfil de entidade de serviço. Você pode:
Depois que o cliente estiver associado a um perfil, você poderá obter o perfil da entidade de serviço atual do cliente do Power BI.
var profileObjectId = new Guid("81f24a6d-7ebb-4478-99c7-2c36f7870a26");
var powerBIclient = new PowerBIClient(credentials, profileObjectId: profileObjectId);
Quando você cria um cliente do Power BI com a ID do objeto de perfil, cada chamada à API que usa o cliente tem X-PowerBI-profile-id
no cabeçalho da solicitação.
Por exemplo:
GET https://powerbiapi.analysis-df.windows.net/v1.0/myorg/groups
Authorization: Bearer eyJ0eXAiO.....5U_g
X-PowerBI-profile-id: 81f24a6d-7ebb-4478-99c7-2c36f7870a26
Como alternativa, você pode especificar a ID do perfil na solicitação à API usando a propriedade customHeaders
no método WithHttpMessagesAsync
do PowerBIClient sobrecarregado da API.
var powerBIclient = new PowerBIClient(credentials);
var profileHeader = new Dictionary<string, List<string>>();
profileHeader.Add("X-PowerBI-profile-id", new List<string> { "81f24a6d-7ebb-4478-99c7-2c36f7870a26" });
var groups = await powerBIclient.Groups.GetGroupsWithHttpMessagesAsync(customHeaders: profileHeader);
Por exemplo,
GET https://powerbiapi.analysis-df.windows.net/v1.0/myorg/groups
Authorization: Bearer eyJ0eXAiO.....5U_g
X-PowerBI-profile-id: 81f24a6d-7ebb-4478-99c7-2c36f7870a26
No exemplo de código anterior, o cabeçalho do perfil não faz parte dos cabeçalhos padrão do cliente, pois o código não adiciona o cabeçalho do perfil. Você precisa especificar o cabeçalho do perfil com cada solicitação à API.
Evite duplicações. Por exemplo, criar um cliente com uma ID de objeto de perfil e especificar o cabeçalho com a solicitação à API resultará em erros por falta de autorização.
Para recuperar o perfil da entidade de serviço atual do cliente do SDK, chame GetServicePrincipalProfileObjectId
.
var profileObjectId = new Guid("81f24a6d-7ebb-4478-99c7-2c36f7870a26");
var powerBIclient = new PowerBIClient(credentials, profileObjectId: profileObjectId);
var currentProfileObjectId = powerBIclient.GetServicePrincipalProfileObjectId();
Não há suporte para perfis de entidade de serviço com AAS (Azure Analysis Services) no modo de conexão dinâmica.
Eventos
Junte-se a nós na FabCon Vegas
31 de mar., 23 - 2 de abr., 23
O melhor evento liderado pela comunidade Microsoft Fabric, Power BI, SQL e AI. 31 de março a 2 de abril de 2025.
Registre-se hoje mesmoTreinamento
Módulo
Usar a autenticação entidade de serviço em conectores personalizados - Training
Saiba como usar a autenticação entidade de serviço com conectores personalizados.
Certificação
Microsoft Certified: Power BI Data Analyst Associate - Certifications
Demonstre métodos e boas práticas que se alinhem aos requisitos técnicos e comerciais para modelagem, visualização e análise de dados com o Microsoft Power BI.
Documentação
Mover aplicativos de vários clientes para o modelo de perfil da entidade de serviço - Power BI
Obter melhor escalabilidade migrando aplicativos multilocatário de análise integrada do Power BI para o modelo de perfis de entidade de serviço
Crie, importe, atualize e atribua workspaces multilocatário na análise integrada usando perfis de entidade de serviço.
APIs REST do Power BI para análise e automação integradas - Power BI REST API
Este artigo fornece uma visão geral das APIs REST do Power BI que podem ser usadas para análise e automação integradas do Power BI