Partilhar via


Integração OneLake para modelos semânticos

Importante

A integração do OneLake para modelos semânticos está atualmente em visualização.

Com a integração do Microsoft OneLake para modelos semânticos, os dados importados para tabelas de modelo também podem ser gravados automaticamente em tabelas Delta no OneLake. O formato Delta é o formato de tabela unificado em todos os mecanismos de computação no Microsoft Fabric. A integração OneLake exporta os dados com todos os principais recursos de desempenho habilitados para fornecer acesso mais contínuo aos dados com maior desempenho.

Cientistas de dados, analistas de banco de dados, desenvolvedores de aplicativos, engenheiros de dados e outros consumidores de dados podem acessar os mesmos dados que impulsionam seus relatórios financeiros e de business intelligence no Power BI. T-SQL, Python, Scala, PySpark, Spark SQL, R e soluções no-code/low-code podem ser usadas para consultar dados de tabelas Delta.

Diagram of OneLake integration for semantic models

Antes de implementar uma solução de integração OneLake em sua organização, leia Considerações e limitações mais adiante neste artigo.

Pré-requisitos

A integração do OneLake para modelos semânticos é suportada apenas em SKUs do Power BI Premium P e do Microsoft Fabric F. Não é suportado no Power BI Pro, Premium Por Utilizador ou SKUs A/EM do Power BI Embedded.

Antes de habilitar a integração OneLake, você deve ter:

  • Um ou mais modelos semânticos de importação em um espaço de trabalho em uma capacidade do Power BI Premium ou Fabric.
  • Formato de armazenamento de modelo semântico grande habilitado para o modelo.

Permissões

As permissões de contribuidor de modelo (ler, gravar, explorar) são necessárias para acessar o conteúdo de uma pasta modelo e criar atalhos vinculando à pasta no Lakehouse Explorer.

Habilite a integração com o OneLake

Nas configurações do modelo semântico, expanda Integração OneLake, clique no controle deslizante para Ativado e selecione Aplicar.

Enable OneLake integration in model settings.

Portal de administração

Os administradores globais e locatários podem controlar a integração do OneLake usando as seguintes configurações no portal de administração do Power BI:

Screenshot of tenant settings for admin portal.

  • Os modelos semânticos podem exportar dados para o OneLake - permite a integração do OneLake no nível organizacional. Se desabilitado, os usuários não poderão ativar a integração do OneLake para seus modelos semânticos, e quaisquer modelos semânticos atualmente configurados para integração do OneLake pararão de exportar tabelas de importação para o OneLake. A integração OneLake é habilitada por padrão para toda a organização.

  • Os usuários podem armazenar tabelas de modelos semânticos no OneLake - permite que todos ou alguns usuários na organização configurem a integração do OneLake para seus modelos semânticos. Se desabilitado para um usuário específico, esse usuário não poderá mais ativar a integração do OneLake, mas todos os modelos semânticos que já tenham configurado para a integração do OneLake continuarão a exportar tabelas de importação para o OneLake. Esse usuário pode desabilitar a integração do OneLake para modelos semânticos já configurados para a integração do OneLake, mas não pode reativar a integração do OneLake. A configuração requer que a configuração Modelos semânticos podem exportar dados para o locatário OneLake seja habilitada. Por padrão, todos os usuários na organização podem configurar a integração do OneLake para seus modelos semânticos.

Atualizar modelo

Para que os dados de importação do modelo sejam gravados em uma tabela Delta no OneLake, pelo menos uma atualização manual ou agendada para o modelo deve ser executada. Execute uma atualização manual ou aguarde uma atualização agendada.

Exportar tabelas OneLake Delta

As tabelas delta podem ser exportadas de várias maneiras. Se o seu modelo semântico tiver o modo de leitura/gravação XMLA habilitado, você poderá exportar programaticamente usando o TOM (Tabular Object Model) e o TMSL (Tabular Model Scripting Language).

Por exemplo, você pode usar o SQL Server Management Studio (SSMS) para executar o seguinte comando TMSL:

{  
 "export": {  
   "layout": "delta",
   "type": "full",  
   "objects": [  
     {  
       "database": "<database name>"  
     }  
   ]  
 }  
}

Explore arquivos de exportação

Depois de exportar, você pode usar o explorador de arquivos OneLake, que integra o OneLake com o Explorador de Arquivos do Windows, para localizar arquivos de exportação de tabela Delta.

  1. No explorador de arquivos do OneLake, clique com o botão direito do mouse na pasta do espaço de trabalho e selecione Sincronizar do OneLake.

  2. Use o Explorador de Arquivos do Windows para localizar seus arquivos de dados. Na pasta de espaço de trabalho, procure uma subpasta com um nome que corresponda ao seu modelo semântico e termine com . Modelo Semântico. A pasta do modelo semântico inclui todas as tabelas de modo de importação em uma subpasta que contém os arquivos de parquet e o log da tabela Delta.

    TMSL export command in SSMS.

Atalhos

Ao criar atalhos para suas tabelas Lakehouse modelo semântico, você pode fornecer acesso rápido e fácil a elas a partir de outras cargas de trabalho no Fabric.

  1. No Lakehouse Explorer, clique com o botão direito do mouse em Tabelas e selecione Novo atalho.

  2. Em Novo atalho, selecione Microsoft OneLake.

  3. Em Selecione um tipo de fonte de dados, selecione seu modelo semântico e selecione as tabelas que deseja incluir.

    OneLake shortcuts in Explorer

Considerações e limitações

  • Durante a visualização, os tipos de dados de moeda com valores maiores que 18 pontos decimais podem ter alguma perda de precisão quando exportados para arquivos Delta.

  • Durante a visualização, não há suporte para modelos semânticos em espaços de trabalho habilitados para BYOK .

  • Durante a visualização, as tabelas de atalho criadas sobre o modelo exportado no Lakehouse não podem ser consultadas usando o ponto de extremidade SQL.

  • Durante a visualização, as capacidades Multi-Geo ainda não são suportadas.

  • Durante a visualização, a operação de exportação do modelo para o OneLake não é cobrada, mas o uso de computação e armazenamento do modelo exportado no OneLake é cobrado.

  • Para usuários com permissões de colaborador para tabelas de modelo exportadas, mas apenas permissões de visualizador para o espaço de trabalho, uma pasta modelo aparece no Lakehouse explorer, mas um erro é retornado quando selecionado.

  • Medidas, tabelas DirectQuery, tabelas híbridas, tabelas de grupo de cálculo e tabelas de agregação gerenciadas pelo sistema não podem ser exportadas para tabelas de formato Delta.

  • Apenas uma única versão das tabelas delta é exportada e armazenada no OneLake. As versões antigas das tabelas delta são excluídas após uma exportação bem-sucedida. Outros mecanismos de execução que usam a versão mais antiga, mas agora excluída, dos dados podem ter falhas transitórias.