Compartilhar via


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

As áreas de trabalho do Power BI Premium, Premium por Usuário e Power BI Embedded usam um ponto de extremidade XMLA para dar suporte à conectividade de plataforma aberta para aplicativos e ferramentas da Microsoft e de terceiros.

Pontos de extremidade XMLA

Os workspaces usam o protocolo XML for Analysis (XMLA) para comunicações entre aplicativos cliente e o mecanismo que gerencia seus workspaces do Power BI, além dos modelos semânticos. Essas comunicações são por meio do que normalmente são chamados de pontos de extremidade XMLA. XMLA é o protocolo de comunicação usado pelo mecanismo do Microsoft Analysis Services, que executa a modelagem semântica, a governança, o ciclo de vida e o gerenciamento de dados do Power BI. Os dados enviados pelo protocolo XMLA são totalmente criptografados.

Por padrão, a conectividade somente leitura usando o endpoint está habilitada para a carga de trabalho dos modelos semânticos em uma capacidade. No modo somente leitura, aplicativos e ferramentas de visualização de dados podem consultar dados, metadados, eventos e estrutura de modelo semântico.

Leitura e escrita usando o endpoint podem ser habilitadas. A leitura/gravação fornece gerenciamento de modelo semântico, governança, modelagem semântica avançada, depuração e monitoramento. Quando habilitados, os modelos semânticos têm mais paridade com Azure Analysis Services e SQL Server Analysis Services processos e ferramentas de modelagem tabulares de nível empresarial.

Propriedades do servidor do Analysis Services

Power BI Premium dá suporte a muitas propriedades de servidor do Analysis Services. Para examinar essas propriedades, consulte as propriedades do servidor no Analysis Services.

Termos de uso

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

Single-user application - O aplicativo utiliza uma única conta de usuário ou identidade de aplicativo para acessar um modelo semântico do Power BI por meio do endpoint XMLA. Exemplos de aplicativos de usuário único incluem ferramentas de desenvolvedor, scripts de administrador 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 disparam 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 PPU (Premium por Usuário) válida, a menos que o modelo semântico resida em uma capacidade Premium.

multi-user application - O aplicativo fornece a vários usuários 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 comerciais.

  • Espaços de Trabalho PPU (Premium por Usuário) – O aplicativo deve exigir que cada usuário faça login 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 usuário deve ter sua própria conta Power BI para abrir relatórios, acessar modelos semânticos e executar consultas.
  • Para workspaces Premium, o aplicativo pode usar uma conta de serviço ou uma identidade de aplicativo em nome dos usuários finais sem exigir que cada usuário entre no Power BI.

Ferramentas e aplicativos cliente

Aplicativos e ferramentas comuns usados com Azure Analysis Services e SQL Server Analysis Services que agora têm suporte por modelos semânticos Premium do Power BI.

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

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

SQL Server Management Studio (SSMS) - dá suporte a consultas DAX, MDX e XMLA. Execute operações de atualização de grão fino e script de metadados de modelo semântico usando a TMSL ( Tabular Model Scripting Language ). Requer somente leitura para operações de consulta. Requer leitura-gravação para metadados de script. Requer o SSMS versão 18.9 ou superior. Baixe o SSMS.

SQL Server Profiler - SQL Server Profiler instala com o SSMS, permite o rastreamento e a depuração de eventos de modelo semântico. Embora oficialmente preterido para SQL Server, o Profiler ainda está incluído no SSMS e continua com suporte para o Analysis Services e Power BI. Requer SQL Server Profiler versão 18.9 ou superior. Os usuários devem especificar o modelo semântico (catálogo inicial) ao se conectar ao ponto de extremidade XMLA. Para saber mais, consulte ̄SQL Server Profiler for Analysis Services.

Analysis Services Deployment Wizard – Instalado com o SSMS, essa ferramenta fornece a implantação de projetos de modelo tabular criados no Visual Studio para o Analysis Services e workspace Premium. Ele pode ser executado interativamente ou na linha de comando para automação. A leitura e gravação XMLA são necessárias. Para saber mais, consulte o Assistente de Implantação do Analysis Services.

Cmdlets do PowerShell – Use os cmdlets do Analysis Services para automatizar tarefas de gerenciamento semântico de modelos, como operações de atualização. Requer leitura/gravação XMLA. Requer a versão 21.1.18256 ou superior do módulo do SqlServer PowerShell. Os cmdlets do Azure Analysis Services no módulo Az.AnalysisServices não têm suporte para modelos semânticos do Power BI. Para saber mais, consulte a 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. Você pode visualizar seu relatório no Report Builder e publicar seu relatório no Power BI service. Requer XMLA em modo somente leitura. Para saber mais, consulte Power BI Report Builder.

Editor tabular 2.x – uma ferramenta de software livre 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 de tabela. Organiza objetos por pastas de exibição com suporte para edição de propriedades de múltiplas seleções e destaque de sintaxe DAX. Requer somente leitura XMLA para operações de consulta. Requer leitura/gravação para operações de metadados. Para saber mais, consulte o Editor tabular 2.x.

DAX Studio – uma ferramenta de software livre para criação, diagnóstico, ajuste de desempenho e análise do DAX. Os recursos incluem navegação de objetos, rastreamento integrado, detalhamento da execução de consultas com estatísticas pormenorizadas, realce e formatação de sintaxe DAX. Requer somente leitura XMLA para operações de consulta. Para saber mais, consulte daxstudio.org.

ALM Toolkit - uma ferramenta de comparação de esquema de software livre para modelos semânticos Power BI, geralmente usados para cenários de ALM (gerenciamento do ciclo de vida do aplicativo). Execute a implantação entre ambientes e retenha dados históricos de atualização incremental. Diferir e mesclar arquivos de metadados, branches 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.

Aplicativos de terceiros – incluindo aplicativos de visualização de dados de clientes e ferramentas que podem se conectar, consultar e consumir modelos semânticos em workspaces Premium. A maioria das ferramentas exige as versões mais recentes das bibliotecas de clientes MSOLAP, mas algumas podem usar o ADOMD. O ponto de extremidade XMLA somente leitura ou leitura e escrita depende das operações.

Bibliotecas de cliente

As aplicações e ferramentas cliente não se comunicam diretamente com o endpoint XMLA. Em vez disso, eles usam bibliotecas de cliente como uma camada de abstração. Essas são as mesmas bibliotecas de cliente que os aplicativos usam para se conectar a Azure Analysis Services e SQL Server Analysis Services. Aplicativos da Microsoft, como Excel, SQL Server Management Studio (SSMS) e a extensão de projetos do Analysis Services para Visual Studio, instalam todas as três bibliotecas de cliente e as atualizam, além das atualizações regulares de aplicativos e extensões. Os desenvolvedores podem usar as bibliotecas de cliente para criar aplicativos personalizados. Em alguns casos, especialmente com aplicativos de terceiros, se não estiverem instalados com o aplicativo, talvez seja necessário instalar versões mais recentes das bibliotecas de clientes. As bibliotecas de cliente são atualizadas mensalmente. Para saber mais, confira Bibliotecas de clientes para se conectar com o Analysis Services.

Otimizar 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 de 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 a compactação), a diferença pode ser significativa. Para saber mais, consulte os modelos Large no Power BI Premium.

Habilitar leitura-gravação XMLA

Por padrão, a capacidade Premium ou cargas de trabalho de modelo semântico 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 endpoint XMLA deve estar habilitada para leitura-gravação.

Para habilitar a funcionalidade de leitura e gravação em uma capacidade Premium

  1. Selecione oportal de Administração de >.

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

  3. Expanda cargas de trabalho. Na configuração do endpoint XMLA, selecione Leitura e Gravação. A configuração do ponto de extremidade XMLA se aplica a todos os workspaces e modelos semânticos atribuídos à capacidade.

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

Para habilitar leitura e gravação para Premium por Usuário

  1. Selecione oportal de Administração de >.
  2. No portal do Administrador, selecione Premium por Usuário.
  3. Expanda as configurações de carga de trabalho do modelo semântico. Na configuração do endpoint XMLA, selecione Leitura e Gravação.

Conectando-se a um workspace Premium

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

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

Os aplicativos que se conectam ao workspace 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 de workspaces devem ser codificados em URI (ou escapados em URI), conforme definido no RFC 3986, que exige que quaisquer caracteres reservados sejam codificados como porcentagem. Por exemplo, Sales%20Workspace é a versão codificada por URI do nome Sales Workspacedo workspace.

Conectando a uma área de trabalho pessoal

Os usuários podem se conectar a modelos semânticos em um Meu Workspace utilizando o endpoint XMLA, caso o Meu Workspace seja atribuído a uma capacidade Premium Por Usuário (PPU), Premium ou Fabric. Os usuários devem ter Permissão de Build no modelo semântico dentro do espaço de trabalho de destino, especialmente ao se conectar a um modelo semântico no espaço de trabalho pessoal de outro usuário.

Os clientes baseados em XMLA podem se conectar a um workspace pessoal com os seguintes requisitos:

  • Bibliotecas de Clientes do Analysis Services versão MSOLAP 17.0.40.18 ou superior, ADOMD 19.104.2.0 ou superior.
  • Cadeia de conexão no formato v2, fazendo referência ao proprietário do espaço de trabalho pessoal de destino 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 SQL Server Management Studio (SSMS), use a versão de fevereiro de 2026 ou posterior ao se conectar a um workspace pessoal.

B2B e usuários convidados

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

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

Quando usuários B2B\convidados acessam workspaces em um locatário diferente, o nome do 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 primário e a ID de um locatário, entre no portal do Azure, selecione Microsoft Entra ID no menu principal e anote as informações na página visão geral do Microsoft Entra. Para obter mais informações, consulte Encontre o ID do locatário do Microsoft Entra e o nome do domínio principal.

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

No workspace Configurações>Premium>Conexão de Workspace, selecione Copiar.

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

Requisitos de conexão

Catálogo inicial

Com algumas ferramentas, como SQL Server Profiler, você deve especificar um Initial Catalog, que é o modelo semântico (banco de dados) ao qual se conectar em seu workspace. Na caixa de diálogo Conectar ao Servidor, selecioneOpções> Propriedades de>Conectar ao banco de dados, insira o nome do modelo semântico.

Screenshot mostrando a caixa de diálogo de conexão ao servidor do SQL Server Profiler. A seção de conexão ao banco de dados está destacada.

Nomes de espaços de trabalho duplicados

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

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

Para contornar o problema, além do nome do workspace, especifique o ObjectIDGuid. Você pode copiar o ObjectIDGuid do objectID do workspace na URL. Acrescente a 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 workspace, acrescente o guid de modelo semântico ao nome do modelo semântico. Você pode obter tanto o nome do modelo semântico quanto o guid quando estiver conectado ao workspace 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 serem exibidas.

Modelos semânticos sem suporte

Os modelos semânticos a seguir não estão acessíveis pelo endpoint XMLA. Esses modelos semânticos não aparecerão na área de trabalho no SSMS ou em outras ferramentas.

  • Modelos semânticos baseados em uma conexão dinâmica com um modelo de Azure Analysis Services ou SQL Server Analysis Services.
  • Modelos semânticos baseados em uma conexão dinâmica com um modelo semântico Power BI em outro workspace. Para saber mais, confira Introdução a modelos semânticos em workspaces.
  • Modelos semânticos com dados push usando a API REST.
  • Modelos semânticos de pasta de trabalho do Excel.

Alias de servidor/workspace

Não há suporte para aliases de nome de servidor em workspaces Premium, embora eles sejam suportados em Azure Analysis Services.

Segurança

Além de a propriedade XMLA Endpoint estar habilitada para leitura/gravação pelo administrador da capacidade, a configuração de nível de locatário Permitir endpoints XMLA e Analisar no Excel com modelos semânticos locais deve ser habilitada no portal de administração. Se você precisar gerar arquivos AIXL (Analisar no Excel) que se conectam ao ponto de extremidade XMLA, a configuração no nível do locatário os usuários poderão trabalhar com modelos semânticos no Excel usando uma conexão dinâmica também deverá ser habilitada. Essas configurações são habilitadas por padrão.

Permitir pontos de extremidade XMLA e analisar no Excel com modelos semânticos locais é uma configuração de integração.

A configuração de integração permite o uso de endpoints XMLA.

Os usuários podem trabalhar com modelos semânticos no Excel usando uma conexão dinâmica é uma configuração de Exportação e compartilhamento.

A configuração de exportação e compartilhamento permite conexões dinâmicas.

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

Configurações 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 = habilitados
Os usuários podem trabalhar com modelos semânticos no Excel usando uma conexão dinâmica = desabilitado 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 dinâmica = habilitada XMLA: não permitido
Analisar no Excel: permitido
XMLA: permitido
Analisar no Excel: permitido

O acesso por meio do endpoint XMLA respeitará a associação do grupo de segurança definida no nível do espaço de trabalho/aplicativo.

Contribuidores do workspace e níveis superiores possuem permissões para gravação no modelo semântico, que são efetivamente iguais às dos administradores de banco de dados do Analysis Services. Eles podem implantar novos modelos semânticos de Visual Studio e executar scripts TMSL no SSMS.

Os usuários com permissões de modelo semântico build 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 RLS (segurança em nível de linha) 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, confira Permissões de Modelo Semântico e Funções em Espaços de Trabalho

Representação

A representação do usuário usando a propriedade EffectiveUserName connection string tem suporte ao se conectar a modelos semânticos de workspace Premium. A conta especificada no EffectiveUserName deve estar no Microsoft Entra ID do locatário e deve ter permissões Read e Build para o modelo semântico ao qual está sendo conectado. Se a conta não tiver permissões de leitura e build, Power BI não poderá representar a conta de usuário. A conexão falhará e um erro será retornado.

Você também pode executar a representação especificando uma ou mais funções de workspace na propriedade Roles connection string. Com a propriedade Roles, você pode testar o rebaixamento de membros de função com permissões de gravação para permissões de leitura. As seguintes permissões de função se aplicam dependendo da conta do usuário conectado:

  • Se o usuário que executa a representação for um administrador de workspace, que é efetivamente o mesmo que um administrador de servidor no Analysis Services, ele não precisará ser membro de nenhuma das funções especificadas.

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

Funções de modelo

Com o terminal XMLA, as funções, a associação de função, a segurança em nível de linha (RLS) e a segurança em nível do objeto (OLS) podem ser definidas para usuários no Microsoft Entra ID do locatário. As funções de modelo em Power BI são usadas apenas para RLS e OLS. Use o modelo de segurança Power BI para controlar permissões além de RLS e OLS.

Para projetos de modelo de tabela criados em Visual Studio, as funções podem ser definidas usando o Role Manager no designer de modelo. Para modelos semânticos em Power BI, as funções podem ser definidas no Power BI Desktop antes da publicação no serviço. A associação de função é especificada no serviço do Power BI. O SSMS também pode ser usado para criar e gerenciar funções. Na maioria dos casos, as definições de objetos de função podem ser escritas usando TMSL para criar ou modificar o Roles object. 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 para uma função que pode ser definida para modelos semânticos é permissão de leitura. Outras permissões são concedidas usando o modelo de segurança Power BI.
  • Os Principais de Serviço não funcionam com RLS e OLS, e não podem ser adicionados como membros de função de modelo.
  • A permissão de build para um modelo semântico é necessária para acessar a leitura por meio do ponto de extremidade XMLA, independentemente da existência de funções de modelos semânticos.

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 configurações de modelo semântico no Serviço Power BI.

Entidades de serviço

Os princípios de serviço são um registro de aplicativo Microsoft Entra que você cria em seu locatário para realizar operações não supervisionadas de recurso e de nível de serviço. Eles são um tipo exclusivo de identidade de usuário com um nome de aplicativo, ID do aplicativo, ID do locatário e segredo do cliente ou certificado para uma senha. 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 workspaces, implantação de modelos e atualização semântica de modelo com:

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

Para saber mais, confira Automatizar tarefas de modelo semântico e workspace Premium com entidades de serviço.

Descoberta de modelo semântico

Quando a configuração de nível de locatário Bloquear republicação e desativar atualização de pacote estiver habilitada, um usuário descobrirá somente aqueles modelos semânticos usando o ponto de extremidade XMLA dos quais ele é 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 ele for administrador, membro ou colaborador no workspace.

Implantar projetos de modelo do SSDT (Visual Studio)

Implantar um projeto de modelo de tabela em Visual Studio em um workspace Premium é o mesmo que implantar em 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 na forma como as credenciais da fonte de dados são definidas, permitindo que as operações de processamento importem dados de fontes para o novo modelo semântico no espaço de trabalho.

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

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

Quando a propriedade Servidor de Implantação é especificada, o projeto pode ser implantado.

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

O processamento falha porque, ao contrário da implantação em uma instância do Analysis Services no Azure ou no SQL Server, onde você é solicitado a fornecer credenciais da fonte de dados como parte da operação de implantação, ao implantar em um workspace Premium, não é possível especificar as credenciais da fonte de dados como parte da operação de implantação. Em vez disso, depois que a implantação de metadados tiver sido bem-sucedida e o modelo semântico for criado, as credenciais da fonte de dados serão especificadas no Serviço de Power BI nas configurações de modelo semântico. No workspace, selecione Modelos semânticos>Configurações>Credenciais da fonte de dados>Editar credenciais.

Captura de tela mostrando a caixa de diálogo 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, você pode então atualizar o modelo semântico no serviço do Power BI, configurar a atualização de agenda ou processar (atualizar) a partir do SQL Server Management Studio para carregar dados no modelo semântico.

A propriedade Processing Option de implantação especificada no projeto em Visual Studio é observada. No entanto, se uma fonte de dados não tiver credenciais especificadas no Power BI service, mesmo que a implantação de metadados seja bem-sucedida, 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 como Padrão porque, depois 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 terá êxito.

Conectar-se ao SSMS

Usar o SSMS para se conectar a um workspace é como se conectar a um servidor Azure ou SQL Server Analysis Services. A única diferença é que você especifica a URL do workspace no nome do servidor e deve usar Active Directory - Universal com autenticação MFA.

Conectar-se a um workspace usando o SSMS

  1. Em SQL Server Management Studio, selecione Connect>Connect to Server.

  2. No Tipo de Servidor, selecione Analysis Services. No nome do servidor, insira a URL do workspace. Em Authentication, selecione Active Directory - Universal com MFA e, em User name, insira sua ID de usuário organizacional.

    Captura de tela da caixa de diálogo Conectar ao servidor. O tipo de servidor, o nome e a autenticação estão realçados. A conexão está selecionada.

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

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

Para saber mais sobre como usar o SSMS para criar script de metadados, confira:

Atualização do modelo semântico

O ponto de extremidade XMLA permite uma ampla variedade de cenários para capacidades de atualização de granularidade fina, usando o SSMS, automação com PowerShell, Azure Automation e Azure Functions, utilizando o 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 de atualização no serviço do Power BI, as operações de atualização por meio do ponto de extremidade XMLA não são limitadas a 48 atualizações por dia, e o tempo limite de atualização agendada não é imposto.

Data, hora e status para operações de atualização do modelo semântico que incluem uma transação de gravação por meio 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 os caches de tiles. Os caches de blocos só são atualizados quando um usuário acessa o relatório.

Captura de tela mostrando a tela de histórico de atualização. O item, por meio do endpoint XMLA, está destacado.

Visões de Gerenciamento Dinâmico (DMV)

As DMVs do Analysis Services fornecem visibilidade de metadados de modelo semântico, linhagem e uso de recursos. As DMVs disponíveis para consulta em Power BI por meio do ponto de extremidade XMLA são limitadas, no máximo, às que exigem permissões de administrador de banco de dados. Algumas DMVs, por exemplo, não são acessíveis porque exigem permissões de administrador de servidor do Analysis Services.

modelos semânticos criados na área de trabalho Power BI

Metadados aprimorados

As operações de gravação XMLA em modelos semânticos criados no Power BI Desktop e publicados em um workspace Premium exigem metadados aprimorados. Para saber mais, consulte metadados avançados do modelo semântico.

Cuidado

Neste momento, uma operação de gravação em um modelo semântico criado no Power BI Desktop impede que ele seja baixado novamente como um arquivo PBIX. Mantenha o arquivo PBIX original.

Declaração da fonte de dados

Ao se conectar a fontes de dados e consultar dados, o Power BI Desktop usa expressões Power Query M como declarações de fonte de dados embutidas. Embora tenha suporte em workspaces Premium, a declaração de fonte de dados inline do Power Query M não é compatível com os serviços do Azure Analysis Services ou do SQL Server Analysis Services. Em vez disso, ferramentas de modelagem de dados do Analysis Services, como Visual Studio, criam metadados usando declarações de fonte de dados estruturadas ou de provedor. Com o endpoint XMLA, o Premium também dá suporte a fontes de dados estruturadas e de provedor, mas não como parte de declarações internas de fonte de dados do Power Query M em modelos de área de trabalho do Power BI. Para saber mais, confira Noções básicas sobre provedores.

Power BI Desktop no modo de conexão ao vivo

Power BI Desktop pode se conectar a um modelo semântico Power BI Premium usando uma conexão dinâmica. Usando uma conexão dinâmica, os dados não precisam ser replicados localmente, tornando mais fácil para os usuários consumirem modelos semânticos. Há duas maneiras de os usuários se conectarem:

  • Selecione Power BI modelos semânticos e selecione um modelo semântico para criar um relatório. Essa é 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 localizar e acompanhar as URLs do workspace. 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.

    Screenshot do Power BI Desktop, os modelos semânticos do Power BI estão destacados na barra de opções. A caixa de diálogo de seleção de modelo semântico está no painel principal.

  • Usando Get Data>Analysis Services, especifique um nome de workspace Power BI Premium como uma URL, selecione Conectar em tempo real e, em seguida, no navegador, selecione um modelo semântico. Nesse caso, o Power BI Desktop utiliza o endpoint XMLA para se conectar em tempo real ao modelo semântico como se fosse um modelo de dados do Analysis Services.

    A captura de tela do Power BI Desktop Analysis Services está selecionada. A conexão ao vivo é destacada na caixa de diálogo do banco de dados do Analysis Services.

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

Logs de auditoria

Quando os aplicativos se conectam a um workspace, o acesso por meio de pontos de extremidade XMLA é registrado nos logs de auditoria Power BI com as seguintes operações:

Nome amigável da operação Nome da operação
Conectado ao modelo semântico do Power BI a partir de um aplicativo externo ConectarDeAplicativoExterno
Solicitação de atualização do modelo semântico do Power BI a partir de um aplicativo externo AtualizarConjuntoDeDadosDeAplicativoExterno
Modelo semântico do Power BI criado a partir de um aplicativo externo CriarConjuntoDeDadosDeAplicativoExterno
Modelo semântico Power BI editado de um aplicativo externo EditarConjuntoDeDadosDeAplicaçãoExterna
Modelo semântico do Power BI excluído de um aplicativo externo ExcluirConjuntoDeDadosDeAplicativoExterno

Para saber mais, consulte Auditing Power BI.

Considerações e limitações

Modelos semânticos padrão do Power BI não podem ser modificados usando o ponto de extremidade XMLA.

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