通过

语义模型的 OneLake 集成

  • 项目

重要

语义模型的 OneLake 集成目前为预览版。

借助语义模型的 Microsoft OneLake 集成，导入到模型表中的数据也可以自动写入 OneLake 中的 Delta 表。 Delta 格式是 Microsoft Fabric 中所有计算引擎的统一表格式。 OneLake 集成在导出数据时会启用所有关键性能功能，以便提供更无缝的数据访问和更高的性能。

数据科学家、数据库分析师、应用开发人员、数据工程师和其他数据使用者随后可以在 Power BI 中访问相同的数据，借助它们驱动商业智能和财务报告。 T-SQL、Python、Scala、PySpark、Spark SQL、R 和无代码/低代码解决方案都可用于查询 Delta 表中的数据。

Diagram of OneLake integration for semantic models

在组织中实现 OneLake 集成解决方案之前，请务必阅读本文后面的注意事项和限制。

先决条件

语义模型的 OneLake 集成仅支持 Power BI Premium P 和 Microsoft Fabric F SKU。 Power BI Pro、Premium Per User 或 Power BI Embedded A/EM SKU 不支持它。

在启用 OneLake 集成之前，你必须具备：

权限

要访问模型文件夹的内容，创建链接到 Lakehouse 资源管理器中的文件夹的快捷方式，模型参与者（读取、写入、浏览）权限是必需的。

启用 OneLake 集成

在语义模型设置中，展开“OneLake 集成”，单击滑块至“开”，然后选择“应用”。

Enable OneLake integration in model settings.

管理门户

全局和租户管理员可以通过使用 Power BI 管理门户中的以下设置来控制 OneLake 集成：

Screenshot of tenant settings for admin portal.

  • 语义模型可以将数据导出到 OneLake - 在组织级别启用 OneLake 集成。 如果禁用，则用户无法为其语义模型启用 OneLake 集成，当前为 OneLake 集成配置的任何语义模型都会停止将导入表导出到 OneLake。 默认情况下，整个组织都会启用 OneLake 集成。

  • 用户可以在 OneLake 中存储语义模型表 - 使组织中的所有用户或选定用户能够为其语义模型配置 OneLake 集成。 如果对特定用户禁用，则该用户将无法再启用 OneLake 集成，但其为 OneLake 集成配置的任何语义模型都会继续将导入表导出到 OneLake。 该用户可以禁用已为 OneLake 集成配置的语义模型的 OneLake 集成，但无法重新启用 OneLake 集成。 该设置要求启用“语义模型可以将数据导出到 OneLake”租户设置。 默认情况下，组织中的所有用户都可以为其语义模型配置 OneLake 集成。

刷新模型

为了使模型导入数据写入 OneLake 中的 Delta 表，必须为模型至少运行一次手动刷新或计划刷新。 运行手动刷新或等待计划刷新。

导出 OneLake Delta 表

可以通过多种方式导出 Delta 表。 如果你的语义模型启用了 XMLA 读写模式，则可以使用表格对象模型 (TOM) 和表格模型脚本语言 (TMSL) 以编程方式导出。

例如，可以使用 SQL Server Management Studio (SSMS) 运行以下 TMSL 命令：

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

浏览导出文件

导出后，可以使用OneLake 文件资源管理器（它将 OneLake 与你的 Windows 文件资源管理器集成）来查找 Delta 表导出文件。

  1. 在 OneLake 文件资源管理器中，右键单击工作区文件夹，然后选择“从 OneLake 同步”。

  2. 使用 Windows 文件资源管理器查找数据文件。 在工作区文件夹中，查找名称与你的语义模型匹配且以 .SemanticModel 结尾的子文件夹。 语义模型文件夹包含子文件夹中的每个导入-模式表，其中包含 Delta 表的 parquet 文件和日志。

    TMSL export command in SSMS.

快捷方式

为你的语义模型 Lakehouse 表创建快捷方式后，可以从 Fabric 中的其他工作负载快速轻松地访问它们。

  1. 在 Lakehouse 资源管理器中，右键单击“表”，然后选择“新建快捷方式”。

  2. 在“新建快捷方式”中，选择“Microsoft OneLake”。

  3. 在“选择数据源类型”中，选择语义模型，然后选择要包括的表。

    OneLake shortcuts in Explorer

注意事项和限制

  • 在预览期间，值大于 18 个小数点的货币数据类型在导出到 Delta 文件时可能会有一些精度损失。

  • 在预览期间，不支持已启用 BYOK 的工作区中的语义模型。

  • 在预览期间，无法使用 SQL 终结点查询基于 Lakehouse 中导出的模型的快捷方式表。

  • 在预览期间，尚不支持多地理位置容量。

  • 在预览期间，不对将模型导出到 OneLake 的操作计费，但对 OneLake 上导出的模型的计算和存储使用情况计费。

  • 对于具有导出的模型表的参与者权限，但只有工作区的查看者权限的用户，模型文件夹会显示在 Lakehouse 资源管理器中，但在选中时会返回错误。

  • 度量值、DirectQuery 表、混合表、计算组表和系统托管的聚合表无法导出到 Delta 格式表。

  • 只会导出并在 OneLake 上存储一个版本的 Delta 表。 成功导出后，会删除旧版本的 Delta 表。 使用较旧但现已删除的数据版本的其他执行引擎可能会发生暂时性故障。

相关内容