Share via


Integração OneLake para modelos semânticos

Importante

A integração do OneLake para modelos semânticos está atualmente em versão prévia.

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 do OneLake exporta os dados com todos os principais recursos de desempenho habilitados para fornecer acesso a dados mais contínuo 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 modelo semânticos tem suporte apenas em SKUs Power BI Premium P e Microsoft Fabric F. Não há suporte para ele em SKUs Power BI Pro, Premium por Usuário ou Power BI Embedded A/EM.

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

Permissões

As permissões de colaborador de modelo (leitura, gravação, exploração) são necessárias para acessar o conteúdo de uma pasta de modelo e criar atalhos vinculando à pasta no explorador do Lakehouse.

Habilitar a integração do OneLake

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

Enable OneLake integration in model settings.

Portal de administração

Os administradores globais e de locatário 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 em nível organizacional. Se estiver desabilitado, os usuários não poderão ativar a integração do OneLake para seus modelos semânticos e os modelos semânticos atualmente configurados para a integração do OneLake param de exportar tabelas de importação para o OneLake. A integração do 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 os usuários selecionados na organização configurem a integração do OneLake para seus modelos semânticos. Se estiver 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á configuraram 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 integração do OneLake, mas não pode reabilitar a integração do OneLake. A configuração requer que os Modelos semânticos possam exportar dados para o OneLake para que a configuração do locatário seja habilitada. Por padrão, todos os usuários da organização podem configurar a integração do OneLake para seus modelos semânticos.

Atualizar modelo

Para que os dados de importação de 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 do OneLake Delta

As tabelas Delta podem ser exportadas de várias maneiras. Se o modelo semântico tiver o modo de leitura-gravação de 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 SSMS (SQL Server Management Studio) para executar o seguinte comando TMSL:

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

Explorar arquivos de exportação

Depois de exportar, você pode usar o explorador de arquivos OneLake, que integra o OneLake ao 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 do espaço de trabalho, procure uma subpasta com um nome que corresponda ao seu modelo semântico e termine com .SemanticModel. A pasta do modelo semântico inclui cada tabela de modo de importação em uma subpasta que contém os arquivos parquet e o log da tabela Delta.

    TMSL export command in SSMS.

Atalhos

Ao criar atalhos para suas tabelas Lakehouse de 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 Selecionar 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 versão prévia, 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 versão prévia, modelos semânticos em BYOK habilitados para espaço de trabalho não têm suporte.

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

  • Durante a versão prévia, as capacidades Multi-Geo ainda não tem suporte.

  • Durante a versão prévia, 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 colaboradorpara tabelas de modelo exportadas, mas apenas permissões de visualizador para o espaço de trabalho, uma pasta de modelo aparece no Lakehouse Explorer, mas um erro retorna 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.