Partilhar via


Conectividade do modelo semântico com o ponto de extremidade XMLA

Power BI Premium, Premium Per User e espaços de trabalho Power BI Embedded utilizam um endpoint XMLA para suportar conectividade em plataforma aberta por parte da Microsoft e de aplicações e ferramentas clientes de terceiros.

Pontos de extremidade XMLA

Os espaços de trabalho utilizam o protocolo XML for Analysis (XMLA) para comunicações entre aplicações clientes e o motor que gere os seus espaços de trabalho Power BI e modelos semânticos. Essas comunicações são através do que são comumente chamados de pontos de extremidade XMLA. XMLA é o protocolo de comunicação utilizado pelo motor Microsoft Analysis Services, que executa a modelação semântica, governação, ciclo de vida e gestão de dados do Power BI. Os dados enviados através do protocolo XMLA são totalmente encriptados.

Por padrão, a conectividade somente leitura usando o ponto de extremidade é habilitada para a carga de trabalho de modelos semânticos em uma capacidade. Com somente leitura, os aplicativos e ferramentas de visualização de dados podem consultar dados de modelo semântico, metadados, eventos e esquema.

As operações de leitura/gravação usando o ponto de extremidade podem ser habilitadas. A leitura-gravação fornece mais gerenciamento de modelo semântico, governança, modelagem semântica avançada, depuração e monitoramento. Quando ativados, os modelos semânticos têm mais paridade com o Azure Analysis Services e o SQL Server Analysis Services, ferramentas e processos de modelação tabular de nível empresarial.

Propriedades do servidor do Analysis Services

O Power BI Premium suporta muitas propriedades de servidores dos Serviços de Análise. Para revisar essas propriedades, consulte Propriedades do servidor no Analysis Services.

Termos de utilização

O uso do ponto de extremidade (endpoint) XMLA está sujeito a:

Aplicação de utilizador único - A aplicação utiliza uma única conta de utilizador ou identidade de aplicação para aceder a um modelo semântico Power BI através do endpoint XMLA. Exemplos de aplicativos de usuário único incluem ferramentas de desenvolvedor, scripts de administração e processos automatizados. Esses aplicativos podem executar tarefas como modelagem de dados e tarefas administrativas que alteram os metadados de um modelo semântico, operação de backup ou restauração ou acionam uma atualização de dados. A conta de usuário ou identidade do aplicativo que o aplicativo cliente usa para acessar um modelo semântico deve ter uma licença Premium por usuário (PPU) válida, a menos que o modelo semântico resida em uma capacidade Premium.

Aplicação multiutilizador - A aplicação fornece a múltiplos utilizadores acesso a um modelo semântico Power BI. Por exemplo, um aplicativo de camada intermediária integrando um modelo semântico em uma solução de negócios e acessando o modelo semântico em nome de seus usuários corporativos.

  • Espaços de trabalho Premium por Utilizador (PPU) - A aplicação deve exigir que cada utilizador inicie sessão no Power BI. Para cada usuário, o aplicativo usa um token de acesso para acessar os modelos semânticos. O aplicativo não pode usar uma conta de serviço ou outra identidade de aplicativo para executar tarefas em nome de usuários individuais. Cada utilizador deve ter a sua própria conta Power BI para abrir relatórios, aceder a modelos semânticos e executar consultas.
  • Para espaços de trabalho Premium, a aplicação pode usar uma conta de serviço ou uma identidade de aplicação em nome dos utilizadores finais sem exigir que cada utilizador inicie sessão no Power BI.

Aplicações e ferramentas cliente

Aplicações e ferramentas comuns usadas com Azure Analysis Services e SQL Server Analysis Services que agora são suportadas por modelos semânticos Power BI Premium:

Microsoft Excel - As Tabelas Dinâmicas Excel são uma das ferramentas mais comuns usadas para resumir, analisar, explorar e apresentar dados de resumo de modelos semânticos Power BI. Somente leitura é necessário para operações de consulta. Requer a versão Clique para Executar do Office 16.0.13612.10000 ou superior.

Visual Studio com projetos de Serviços de Análise - Conhecido como SQL Server Data Tools(SSDT). O SSDT é uma ferramenta de criação de modelos de nível empresarial para modelos tabulares do Analysis Services. Todas as edições do Visual Studio 2017 e posteriores, incluindo a edição gratuita da Comunidade, suportam extensões de projetos Analysis Services. Requer a extensão versão 2.9.14 ou superior para implantar modelos tabulares em um espaço de trabalho Premium. O modelo deve estar no nível de compatibilidade 1500 ou superior para ser implantado. Requer leitura-gravação XMLA na carga de trabalho de modelos semânticos. Para saber mais, consulte Ferramentas para Analysis Services.

SQL Server Management Studio (SSMS) - Suporta consultas DAX, MDX e XMLA. Execute operações de atualização refinadas e scripts de metadados de modelo semântico usando a TMSL (Tabular Model Scripting Language ). Requer somente leitura para operações de consulta. Requer permissões de leitura e escrita para metadados de scripts. Requer SSMS versão 18.9 ou superior. Faça o download do SSMS.

SQL Server Profiler - SQL Server Profiler instala-se com o SSMS e permite rastrear e depurar eventos do modelo semântico. Embora oficialmente obsoleto para o SQL Server, o Profiler continua incluído no SSMS e continua suportado para Analysis Services e Power BI. Requer o SQL Server Profiler versão 18.9 ou superior. Os usuários devem especificar o modelo semântico (catálogo inicial) ao se conectar com o ponto de extremidade XMLA. Para saber mais, consulte o "Profiler de Serviços de Análise do SQL Server".

Assistente de Implementação de Serviços de Análise - Instalada com SSMS, esta ferramenta permite a implementação de projetos de modelos tabulares Visual Studio de autoria para Serviços de Análise e espaços de trabalho Premium. Ele pode ser executado interativamente ou a partir da linha de comando para automação. XMLA leitura-gravação é necessária. Para saber mais, consulte Assistente de Implantação do Analysis Services.

Cmdlets do PowerShell - Utilize os cmdlets do Análise de Serviços para automatizar tarefas de gestão de modelos semânticos, tais como operações de atualização. Requer permissões de leitura e gravação XMLA. Requer a versão 21.1.18256 ou superior do módulo SqlServer PowerShell. Os cmdlets do Azure Analysis Services no módulo Az.AnalysisServices não são suportados para modelos semânticos do Power BI. Para saber mais, consulte Referência do PowerShell do Analysis Services.

Power BI Report Builder - Uma ferramenta para criar relatórios paginados. Crie uma definição de relatório que especifique os dados a serem recuperados, onde obtê-los e como exibi-los. Pode pré-visualizar o seu relatório no Report Builder e depois publicá-lo no Power BI service. Requer XMLA somente leitura. Para saber mais, consulte Power BI Report Builder.

Tabular Editor 2.x - Uma ferramenta de código aberto para criar, manter e gerenciar modelos tabulares usando um editor intuitivo e leve. Uma exibição hierárquica mostra todos os objetos em seu modelo tabular. Organiza objetos por pastas de exibição com suporte para edição de propriedades de seleção múltipla e realce de sintaxe DAX. Requer XMLA somente leitura para operações de consulta. Requer leitura-gravação para operações de metadados. Para saber mais, consulte Editor de tabelas 2.x.

DAX Studio - Uma ferramenta de código aberto para criação, diagnóstico, ajuste de desempenho e análise de DAX. Os recursos incluem navegação de objetos, rastreamento integrado, análises detalhadas da execução de consultas com estatísticas detalhadas, destaque e formatação da sintaxe DAX. Requer XMLA somente leitura para operações de consulta. Para saber mais, consulte daxstudio.org.

ALM Toolkit - Uma ferramenta de comparação de esquemas open-source para modelos semânticos Power BI, mais frequentemente utilizada em cenários de gestão do ciclo de vida de aplicações (ALM). Realize a implementação em vários ambientes e retenha dados históricos de atualização incremental. Diferencie e mescle arquivos de metadados, ramificações e repositórios. Reutilize definições comuns entre modelos semânticos. Requer somente leitura para operações de consulta. Requer leitura-gravação para operações de metadados. Para saber mais, consulte alm-toolkit.com.

Terceiros - Inclui aplicativos e ferramentas de visualização de dados do cliente que podem se conectar, consultar e consumir modelos semânticos em espaços de trabalho Premium. A maioria das ferramentas requer as versões mais recentes das bibliotecas de cliente MSOLAP, mas algumas podem usar o ADOMD. O ponto de extremidade XMLA de apenas leitura ou leitura-gravação é dependente das operações.

Bibliotecas de cliente

As ferramentas e as aplicações cliente não se comunicam diretamente com o endpoint XMLA. Em vez disso, eles usam bibliotecas de cliente como uma camada de abstração. Estas são as mesmas bibliotecas clientes que as aplicações usam para se ligar ao Azure Analysis Services e ao SQL Server Analysis Services. Aplicações da Microsoft como o Excel, SQL Server Management Studio (SSMS) e a extensão de projetos Analysis Services para Visual Studio instalam as três bibliotecas clientes e atualizam-nas juntamente com atualizações regulares de aplicações e extensões. Os desenvolvedores podem usar as bibliotecas de cliente para criar aplicativos personalizados. Em alguns casos, particularmente com aplicativos de terceiros, se não forem instalados com o aplicativo, pode ser necessário instalar versões mais recentes das bibliotecas cliente. As bibliotecas de clientes são atualizadas mensalmente. Para saber mais, consulteBibliotecas de cliente para conexão com o Analysis Services.

Otimize modelos semânticos para operações de gravação habilitando modelos grandes

Ao usar o ponto de extremidade XMLA para gerenciamento de modelo semântico com operações de gravação, é recomendável habilitar o modelo semântico para modelos grandes. Isso reduz a sobrecarga das operações de gravação, o que pode torná-las consideravelmente mais rápidas. Para modelos semânticos com mais de 1 GB (após compressão), a diferença pode ser significativa. Para saber mais, consulte Modelos grandes no Power BI Premium.

Habilitar leitura-gravação XMLA

Por padrão, as cargas de trabalho de modelo semântico de capacidade Premium ou Premium Por Usuário têm a configuração da propriedade de ponto de extremidade XMLA habilitada para somente leitura. Isso significa que os aplicativos só podem consultar um modelo semântico. Para que os aplicativos executem operações de gravação, a propriedade XMLA Endpoint deve ser habilitada para leitura-gravação.

Para habilitar a leitura-gravação para uma capacidade Premium

  1. Selecione Configurações>Portal de administração.

  2. No portal de Administração, selecione Definições de capacidade>Power BI Premium> nome da capacidade.

  3. Expandir Cargas de Trabalho. Na configuração Ponto de extremidade XMLA, selecione Leitura e Escrita. A configuração XMLA Endpoint aplica-se a todos os espaços de trabalho e modelos semânticos atribuídos à capacidade.

    Captura de ecrã mostrando as configurações do endpoint XMLA. Leitura e gravação está selecionada.

Para ativar a leitura e gravação para a Premium Per User

  1. Selecione Configurações>Portal de administração.
  2. No Portal de administração, selecione Premium por usuário.
  3. Expanda Configurações de carga de trabalho do modelo semântico. Na configuração Ponto de extremidade XMLA, selecione Leitura e Escrita.

Conectando-se a um espaço de trabalho Premium

Os espaços de trabalho atribuídos a uma capacidade têm uma cadeia de conexão em formato URL. Por exemplo:

powerbi://api.powerbi.com/v1.0/[tenant name]/[workspace name].

Os aplicativos que se conectam ao espaço de trabalho usam a URL como se fosse um nome de servidor do Analysis Services. Por exemplo:

powerbi://api.powerbi.com/v1.0/contoso.com/Sales%20Workspace.

Observação

Os nomes dos espaços de trabalho devem ser codificados por URI (ou URI escapados) conforme definido no RFC 3986, que exige que quaisquer caracteres reservados sejam codificados por percentagem. Por exemplo, Sales%20Workspace é a versão codificada em URI do nome Sales Workspacedo espaço de trabalho .

Ligação a um espaço de trabalho pessoal

Os utilizadores podem ligar-se a modelos semânticos num espaço de trabalho pessoal (O Meu Espaço de Trabalho) usando o endpoint XMLA se o espaço de trabalho pessoal estiver atribuído a uma capacidade Premium Per User (PPU), Premium ou Fabric. Os utilizadores devem ter permissão de Build sobre o modelo semântico dentro do espaço de trabalho alvo, especialmente ao ligar-se a um modelo semântico no espaço de trabalho pessoal de outro utilizador.

Os clientes baseados em XMLA podem ligar-se a um espaço de trabalho pessoal com os seguintes requisitos:

  • Analysis Services Client Libraries versão MSOLAP 17.0.40.18 ou superior, ADOMD 19.104.2.0 ou superior.
  • String de ligação no formato v2, referenciando o proprietário do espaço de trabalho pessoal alvo por UPN ou ID de objeto:
    • powerbi://api.powerbi.com/v2.0/[tenantId]/home/myworkspace/[URI_encoded_UPN]
    • powerbi://api.powerbi.com/v2.0/[tenantId]/home/myworkspace/[UserObjectId]

Para o SQL Server Management Studio (SSMS), utilize a versão de fevereiro de 2026 ou posterior ao ligar-se a um espaço de trabalho pessoal.

Usuários B2B e convidados

Quando os usuários acessam um espaço de trabalho em seu locatário doméstico, a seção de nome do locatário na URL pode ser substituída por myorg. Por exemplo:

powerbi://api.powerbi.com/v1.0/myorg/Sales Workspace.

Quando usuários B2B\guest acessam espaços de trabalho em um locatário diferente, esse nome de locatário deve ser especificado na URL da fonte de dados. Por exemplo, quando um usuário contoso.com é convidado para o locatário fabrikam.com e recebe permissão para "Espaço de trabalho de vendas", ele deve usar a URL abaixo para se conectar:

powerbi://api.powerbi.com/v1.0/fabrikam.com/Sales Workspace.

Para determinar o nome de domínio principal e o ID de um inquilino, inicie sessão no portal Azure, selecione Microsoft Entra ID no menu principal e depois indique a informação na página de Visão Geral do Microsoft Entra. Para mais informações, consulte Encontre o ID do inquilino Microsoft Entra e o nome de domínio principal.

Para obter a URL de conexão do espaço de trabalho

Em Configurações do> espaço de trabalhoConexão de>, selecione Copiar.

Captura de tela mostrando a página de configurações. A seção de conexão do espaço de trabalho é realçada.

Requisitos de ligação

Catálogo inicial

Com algumas ferramentas, como SQL Server Profiler, deve especificar um Catálogo Inicial, que é o modelo semântico (base de dados) a que se deve ligar no seu espaço de trabalho. Na caixa de diálogo Conectar ao Servidor, selecione Opções> Propriedades >Conectar ao banco de dados, insira o nome do modelo semântico.

Captura de ecrã mostrando o diálogo de ligação ao servidor do SQL Server Profiler. A secção de ligação à base de dados está destacada.

Nomes de espaços de trabalho duplicados

Workspaces na validação de Power BI impede a criação ou renomeação de espaços de trabalho com nomes duplicados. Ao conectar-se a um espaço de trabalho com o mesmo nome de outro espaço de trabalho, você pode receber a seguinte mensagem:

Não é possível conectar-se ao powerbi://api.powerbi.com/v1.0/[tenant name]/[workspace name].

Para contornar o problema, além do nome do espaço de trabalho, especifique o ObjectIDGuid. Você pode copiar o ObjectIDGuid do objectID do espaço de trabalho na URL. Anexe o objectID à URL de conexão. Por exemplo:

powerbi://api.powerbi.com/v1.0/myorg/Contoso Sales - aaaabbbb-0000-cccc-1111-dddd2222eeee.

Nome do modelo semântico duplicado

Para se conectar a um modelo semântico com o mesmo nome de outro modelo semântico no mesmo espaço de trabalho, acrescente o guid do modelo semântico ao nome do modelo semântico. Você pode obter o nome do modelo semântico e o GUID quando conectado ao espaço de trabalho no SSMS.

Atraso nos modelos semânticos mostrados

Quando você se conecta a um espaço de trabalho, as alterações de modelos semânticos novos, excluídos e renomeados podem levar até alguns minutos para aparecer.

Modelos semânticos sem suporte

Os modelos semânticos a seguir não são acessíveis através do endpoint XMLA. Esses modelos semânticos não aparecerão no espaço de trabalho no SSMS ou em outras ferramentas:

  • Modelos semânticos baseados numa ligação ativa a um modelo Azure Analysis Services ou SQL Server Analysis Services.
  • Modelos semânticos baseiam-se numa ligação ativa a um modelo semântico do Power BI noutro espaço de trabalho. Para saber mais, consulte Introdução a modelos semânticos em espaços de trabalho.
  • Modelos semânticos com dados Push usando a API REST.
  • Modelos semânticos de pasta de trabalho do Excel.

Alias de servidor/espaço de trabalho

Os alias de nomes de servidor, suportados no Azure Analysis Services, não são suportados para espaços de trabalho Premium.

Segurança

Além de a propriedade Endpoint XMLA estar ativada para leitura e escrita pelo administrador de capacidade, a definição ao nível do locatário Permitir pontos de extremidade XMLA e Analisar no Excel com modelos semânticos locais deve ser habilitada no portal de administração. Se você precisar gerar arquivos Analisar no Excel (AIXL) que se conectam ao ponto de extremidade XMLA, a configuração de nível de locatário Os usuários podem trabalhar com modelos semânticos no Excel usando uma conexão em tempo real também deve ser habilitada. Essas configurações são ativadas por padrão.

Permitir endpoints XMLA e Analisar no Excel com modelos semânticos no local é uma configuração de integração.

A configuração de integração permite pontos de extremidade XMLA.

Os usuários podem trabalhar com modelos semânticos no Excel usando uma conexão em tempo real é uma configuração de exportação e compartilhamento.

A configuração de exportação e compartilhamento permite conexões ao vivo.

A tabela a seguir descreve as implicações de ambas as configurações:

Configuração Permitir pontos de extremidade XMLA e Analisar no Excel com modelos semânticos locais = desabilitado Permitir pontos de extremidade XMLA e Analisar no Excel com modelos semânticos locais = habilitado
Os usuários podem trabalhar com modelos semânticos no Excel usando uma conexão ao vivo = desabilitada XMLA: não permitido
Analisar no Excel: não permitido
XMLA: permitido
Analisar no Excel: não permitido
Os usuários podem trabalhar com modelos semânticos no Excel usando uma conexão ao vivo = habilitado XMLA: não permitido
Analisar no Excel: permitido
XMLA: permitido
Analisar no Excel: permitido

O acesso por meio do ponto de extremidade XMLA honrará o pertencimento ao grupo de segurança definido no nível do espaço de trabalho/aplicativo.

Os colaboradores do espaço de trabalho e acima têm permissões para escrita no modelo semântico, que são efetivamente as mesmas que os administradores de banco de dados do Analysis Services. Podem implementar novos modelos semânticos a partir do Visual Studio e executar scripts TMSL em SSMS.

Os usuários com permissões de modelo semântico de compilação são equivalentes aos leitores de banco de dados do Analysis Services. Eles podem se conectar e procurar modelos semânticos para consumo e visualização de dados. As regras de segurança em nível de linha (RLS) são respeitadas e não podem ver metadados internos do modelo semântico.

Não há suporte para operações que exigem permissões de administrador do servidor do Analysis Services (em vez de administrador de banco de dados) em geral.

Para saber mais, consulte Permissões de modelo semântico e Funções em espaços de trabalho

Imitação de identidade

A personificação de utilizador usando a propriedade EffectiveUserName da cadeia de ligação é suportada quando se liga a modelos semânticos no espaço de trabalho Premium. A conta especificada em EffectiveUserName deve estar na Microsoft Entra ID do inquilino e deve ter permissões Read e Build para o modelo semântico a que se está a ligar. Se a conta não tiver permissões de Leitura e Compilação, o Power BI não pode imitar a conta do utilizador. A conexão falhará e um erro será retornado.

Também pode realizar a impersonação especificando uma ou mais funções de espaço de trabalho na propriedade da cadeia de conexão Roles. Com a propriedade Roles, você pode testar o downgrade de membros da função com permissões de Gravação para Leitura. As seguintes permissões de função se aplicam dependendo da conta do usuário conectado:

  • Se o utilizador que executa a representação for um administrador de espaço de trabalho, que é efetivamente o mesmo que um administrador de servidor no Analysis Services, o mesmo não precisa ser membro de nenhuma das funções especificadas.

  • Se o utilizador que executa a representação não for um administrador de espaço de trabalho, ele deverá pertencer a uma ou mais das funções especificadas, caso contrário, será retornado um erro de utilizador não encontrado ou de falta de permissões.

Funções do modelo

Com o endpoint XMLA, funções, pertença a papéis, segurança ao nível de linha (RLS) e segurança ao nível de objeto (OLS) podem ser definidos para os utilizadores no Microsoft Entra ID do tenant. Os papéis de modelo no Power BI são usados apenas para RLS e OLS. Use o modelo de segurança do Power BI para controlar permissões para além do RLS e OLS.

Para projetos de modelos tabulares criados no Visual Studio, os papéis podem ser definidos usando o Role Manager no designer do modelo. Para modelos semânticos no Power BI, os papéis podem ser definidos no Power BI Desktop antes da publicação no serviço. A pertença a um papel é especificada no Power BI service. O SSMS também pode ser usado para criar e gerenciar funções. Na maioria das vezes, as definições de objetos de função podem ser escritas em script usando TMSL para criar ou modificar o Objeto Roles. Os scripts TMSL podem ser executados no SSMS ou com o cmdlet Invoke-ASCmd PowerShell.

As seguintes limitações se aplicam ao trabalhar com funções por meio do ponto de extremidade XMLA:

  • A única permissão que pode ser definida para uma função em modelos semânticos é a permissão de leitura. Outras permissões são concedidas utilizando o modelo de segurança do Power BI.
  • As Entidades de Serviço não funcionam com RLS e OLS e não podem ser adicionadas como membros de função de modelo.
  • A permissão de compilação para um modelo semântico é necessária para acesso de leitura por meio do ponto de extremidade XMLA, independentemente da existência de funções de modelo semântico.

Definindo credenciais de fonte de dados

Os metadados especificados por meio do ponto de extremidade XMLA podem criar conexões com fontes de dados, mas não podem definir credenciais de fonte de dados. Em vez disso, as credenciais podem ser definidas na página de definições semânticas do modelo no Power BI Service.

Entidades de Serviço

Os principais de serviço são um registo de aplicação Microsoft Entra que cria dentro do seu tenant para realizar operações de recursos e nível de serviço sem supervisão. Eles são um tipo exclusivo de identidade de usuário com um nome de aplicativo, ID de aplicativo, ID de locatário e segredo do cliente ou certificado para uma senha. O Power BI Premium utiliza a mesma funcionalidade de principal de serviço que o Power BI Embedded.

As entidades de serviço podem ser usadas com o ponto de extremidade XMLA para automatizar tarefas de gerenciamento de modelo semântico, como provisionamento de espaços de trabalho, implantação de modelos e atualização de modelo semântico com:

  • PowerShell
  • Azure Automation
  • Azure Logic Apps
  • Aplicativos cliente personalizados

Para saber mais, consulte Automatizar tarefas de espaço de trabalho Premium e modelo semântico com entidades de serviço.

Descoberta de modelo semântico

Quando a configuração de nível de locatário Bloquear republicação e desabilitar atualização de pacote está habilitada, um usuário pode descobrir apenas os modelos semânticos usando o Ponto de Extremidade XMLA do qual ele é o proprietário. Se um usuário não for o proprietário de um modelo semântico, ele será equivalente a um leitor de banco de dados do Analysis Services, mesmo quando for um Administrador, Membro ou Colaborador no espaço de trabalho.

Implementar projetos modelo a partir do Visual Studio (SSDT)

Implementar um projeto de modelo tabular no Visual Studio para um espaço de trabalho Premium é muito semelhante a implementar para um servidor Azure ou SQL Server Analysis Services. As únicas diferenças estão na propriedade Servidor de Implantação especificada para o projeto e como as credenciais da fonte de dados são especificadas para que as operações de processamento possam importar dados de fontes de dados para o novo modelo semântico no espaço de trabalho.

Para implementar um projeto de modelo tabular criado em Visual Studio, defina a URL de ligação do espaço de trabalho na propriedade do projeto Deployment Server. Em Visual Studio, em Solution Explorer, clique com o botão direito no projeto >Properties. Na propriedade Server , cole a URL de conexão do espaço de trabalho.

Captura de ecrã da janela de configuração. O servidor está realçado no painel principal. OK está selecionado.

Quando a propriedade Deployment Server é especificada, o projeto pode ser implantado.

Quando implantado pela primeira vez, um modelo semântico é criado no espaço de trabalho usando metadados do model.bim. Como parte da operação de implantação, depois que o modelo semântico for criado no espaço de trabalho a partir dos metadados do modelo, o processamento para carregar dados no modelo semântico a partir de fontes de dados falhará.

O processamento falha porque, ao contrário da implementação para uma instância do Azure ou SQL Server Analysis Server, onde lhe são solicitadas credenciais de fonte de dados como parte da operação de implementação, ao implementar para um espaço de trabalho Premium as credenciais da fonte de dados não podem ser especificadas como parte da operação de implementação. Em vez disso, após a implementação dos metadados ter sido bem-sucedida e o modelo semântico ser criado, as credenciais da fonte de dados são então especificadas no Power BI Service nas definições do modelo semântico. No espaço de trabalho, selecione Modelos semânticos>Configurações>Credenciais da fonte de dados>Editar credenciais.

Captura de tela mostrando a caixa de diálogo de credenciais da fonte de dados. Os campos que podem ser editados são realçados.

Quando as credenciais da fonte de dados são especificadas, pode então atualizar o modelo semântico no Power BI service, configurar a atualização do agendamento ou processar (atualizar) a partir do SQL Server Management Studio para carregar dados no modelo semântico.

A propriedade de desdobramento Processing Option especificada no projeto em Visual Studio é tomada em consideração. No entanto, se uma fonte de dados não tiver credenciais especificadas no Power BI service, mesmo que a implementação dos metadados tenha sucesso, o processamento falhará. Você pode definir a propriedade como Não processar, impedindo qualquer tentativa de processamento como parte da implantação. Talvez você queira definir a propriedade de volta como Padrão porque, assim que as credenciais da fonte de dados forem especificadas nas configurações da fonte de dados para o novo modelo semântico, o processamento como parte das operações de implantação subsequentes será bem-sucedido.

Conecte-se com o SSMS

Usar SSMS para se ligar a um espaço de trabalho é como ligar-se a um servidor Azure ou SQL Server Analysis Services. A única diferença é que especificas a URL do espaço de trabalho no nome do servidor, e tens de usar Active Directory - Universal com autenticação MFA.

Conectar-se a um espaço de trabalho usando o SSMS

  1. No SQL Server Management Studio, selecione Conectar>Ligar ao Servidor.

  2. Em Tipo de Servidor, selecione Analysis Services. Em Nome do servidor, insira a URL do espaço de trabalho. Em Autenticação, selecione Active Directory - Universal com MFA, e depois em Nome de utilizador, introduza o ID de utilizador da sua organização.

    Captura de ecrã da caixa de diálogo Ligar ao servidor. O tipo de servidor, o nome e a autenticação são realçados. Conectar está selecionado.

Quando conectado, o espaço de trabalho é mostrado como um servidor do Analysis Services e os modelos semânticos no espaço de trabalho são mostrados como bancos de dados.

Captura de ecrã da janela SQL Server Management Studio da Microsoft. Object Explorer está no painel principal.

Para saber mais sobre como usar o SSMS para criar scripts de metadados, consulte:

Atualização do modelo semântico

O endpoint XMLA permite uma vasta gama de cenários para capacidades de atualização de grão fino usando SSMS, automação com PowerShell, Azure Automation e Azure Functions usando TOM. Por exemplo, você pode atualizar determinadas partições históricas de atualização incremental sem precisar recarregar todos os dados históricos.

Ao contrário da configuração da atualização no Power BI service, as operações de atualização através do endpoint XMLA não estão limitadas a 48 atualizações por dia, e o tempo de espera agendado não é imposto.

Data, hora e status para operações de atualização de modelo semântico que incluem uma transação de gravação através do ponto de extremidade XMLA são registrados e mostrados no histórico de atualização do modelo semântico.

Observação

As operações de atualização executadas pelo ponto de extremidade XMLA não atualizam automaticamente a memória cache de mosaico. As caches de blocos só são atualizadas quando um utilizador acede ao relatório.

Captura de tela mostrando a tela do histórico de atualizações. O item, via ponto de extremidade XMLA, é realçado.

Visualizações de gerenciamento dinâmico (DMV)

Os DMVs do Analysis Services fornecem visibilidade de metadados de modelo semântico, linhagem e uso de recursos. Os DMVs disponíveis para consulta no Power BI através do endpoint XMLA estão limitados, no máximo, àqueles que requerem permissões de administrador de base de dados. Alguns DMVs, por exemplo, não são acessíveis porque exigem permissões de administrador de servidor do Analysis Services.

Modelos semânticos criados pelo Power BI Desktop

Metadados melhorados

As operações de escrita XMLA em modelos semânticos criados no Power BI Desktop e publicados num espaço de trabalho Premium requerem metadados melhorados. Para saber mais, consulte Metadados de modelo semântico avançados.

Atenção

Neste momento, uma operação de escrita num modelo semântico criado no Power BI Desktop impede que este seja descarregado novamente como ficheiro PBIK. Certifique-se de manter seu arquivo PBIX original.

Declaração da fonte de dados

Ao ligar-se a fontes de dados e consultar dados, o Power BI Desktop utiliza expressões Power Query M como declarações de fonte de dados inline. Embora suportado em espaços de trabalho Premium, a declaração de fonte de dados inline do Power Query M não é suportada pelo Azure Analysis Services ou pelo SQL Server Analysis Services. Em vez disso, ferramentas de modelação de dados da Analysis Services, como Visual Studio, criam metadados usando declarações de fontes de dados estruturadas ou provider. Com o endpoint XMLA, o Premium também suporta fontes de dados estruturadas e de fornecedores, mas não como parte das declarações de fontes de dados inline do Power Query M nos modelos Power BI Desktop. Para saber mais, consulte Noções básicas sobre provedores.

Power BI Desktop em modo de ligação ao vivo

O Power BI Desktop pode ligar-se a um modelo semântico Power BI Premium usando uma ligação em tempo real. Usando uma conexão ao vivo, os dados não precisam ser replicados localmente, facilitando o consumo de modelos semânticos pelos usuários. Há duas maneiras de os usuários se conectarem:

  • Selecione Power BI modelos semânticos, e depois selecione um modelo semântico para criar um relatório. Esta é a maneira recomendada para os usuários se conectarem ao vivo a modelos semânticos. Esse método fornece uma experiência de descoberta aprimorada mostrando o nível de endosso de modelos semânticos. Os usuários não precisam encontrar e acompanhar as URLs do espaço de trabalho. Para encontrar um modelo semântico, os usuários simplesmente digitam o nome do modelo semântico ou rolam para encontrar o modelo semântico que estão procurando.

    Captura de ecrã do Power BI Desktop: os modelos semânticos do Power BI estão destacados na barra de ferramentas. A caixa de seleção de modelo semântico está no painel principal.

  • Usando Get Data>Analysis Services, especifique um nome de espaço de trabalho Premium Power BI como URL, selecione Connect live, e depois, no Navigator, selecione um modelo semântico. Neste caso, o Power BI Desktop utiliza o endpoint XMLA para se ligar em tempo real ao modelo semântico como se fosse um modelo de dados dos Serviços de Análise.

    Captura de ecrã do Power BI Desktop está selecionada. Connect Live está destacado na caixa de diálogo da base de dados dos Serviços de Análise.

As organizações que têm relatórios existentes conectados diretamente a modelos de dados do Analysis Services e pretendem migrar para modelos semânticos Premium só precisam alterar a URL do nome do servidor em Transformar dados>Configurações da fonte de dados.

Registos de auditoria

Quando as aplicações se ligam a um espaço de trabalho, o acesso através dos endpoints XMLA é registado nos registos de auditoria do Power BI com as seguintes operações:

Nome amigável da operação Nome da operação
Ligado a um modelo semântico do Power BI a partir de uma aplicação externa ConectarDeAplicaçãoExterna
Solicitou a atualização do modelo semântico do Power BI de uma aplicação externa RefreshDatasetDeAplicacaoExterna
Criou um modelo semântico do Power BI a partir de uma aplicação externa CriarConjuntoDeDadosDeAplicaçãoExterna
Modelo semântico do Power BI editado a partir de uma aplicação externa EditarConjuntoDeDadosDeAplicaçãoExterna
Modelo semântico do Power BI apagado de uma aplicação externa EliminarConjuntoDeDadosDeAplicaçãoExterna

Para saber mais, consulte Auditing Power BI.

Considerações e limitações

Default Power BI Semantic Models não pode ser modificado usando o endpoint XMLA.

Para obter mais informações relacionadas a este artigo, consulte: