语义模型的 OneLake 集成
重要
语义模型的 OneLake 集成目前为预览版。
借助语义模型的 Microsoft OneLake 集成，导入到模型表中的数据也可以自动写入 OneLake 中的 Delta 表。 Delta 格式是 Microsoft Fabric 中所有计算引擎的统一表格式。 OneLake 集成会导出启用了所有关键性能功能的数据，以便提供更无缝的数据访问，并提供更高的性能。
数据科学家、数据库分析师、应用开发人员、数据工程师和其他数据使用者随后可以访问在 Power BI 中驱动商业智能和财务报表的相同数据。 T-SQL、Python、Scala、PySpark、Spark SQL、R 和无代码/低代码解决方案都可用于查询 Delta 表中的数据。
在组织中实现 OneLake 集成解决方案之前，请务必阅读本文后面的 注意事项和限制。
先决条件
Power BI Premium P 和 Microsoft Fabric F SKU 上仅支持用于语义模型的 OneLake 集成。 Power BI Pro、Premium Per User 或 Power BI Embedded A/EM SKU 不支持它。
在启用 OneLake 集成之前，您需要：
- Power BI Premium 或 Fabric 容量上的工作区中的一个或多个导入语义模型。 导入语义模型是一种数据模型，其中数据完全导入到 Power BI 的内存中存储中，从而实现快速高效的查询。
- 为模型启用 大型语义模型存储格式。
权限
模型 的参与者 需要（读取、写入、浏览）权限，才能访问模型文件夹内容，并在 Lakehouse 资源管理器中创建链接指向该文件夹的快捷方式。
启用 OneLake 集成
在语义模型设置中，展开“OneLake 集成”，单击滑块至“开”，然后选择“应用”。
管理门户
全局管理员和租户管理员可以在 Power BI 管理门户中使用以下设置来控制 OneLake 集成：
语义模型可以将数据导出到 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 表导出文件。
在 OneLake 文件资源管理器中，右键单击工作区文件夹，然后从 OneLake中选择
同步。 使用 Windows 文件资源管理器查找数据文件。 在工作区文件夹中，查找名称与语义模型匹配的子文件夹，以 结尾。SemanticModel。 语义模型文件夹包含子文件夹中的每个导入-模式表，其中包含 Delta 表的 parquet 文件和日志。
快捷方式
通过为语义模型中的 Lakehouse 表创建 快捷方式，可以在 Fabric 的其他工作负荷中快速便捷地访问这些表。
在 Lakehouse 资源管理器中，右键单击“表”，然后选择“新建快捷方式”。
在 “新建”快捷方式中，选择 Microsoft OneLake。
在 选择数据源类型，选择语义模型，然后选择要包括的表。
中
注意事项和限制
在预览期间，值大于 18 个小数点的货币数据类型在导出到 Delta 文件时可能会有一些精度损失。
在预览期间，不支持已启用 BYOK 的工作区中的语义模型。
在预览期间，无法使用 SQL 终结点查询在 Lakehouse 中依据导出模型创建的快捷表格。
在预览期间，尚不支持多地理位置容量。
在预览期间，不对将模型导出到 OneLake 的操作计费，但对 OneLake 上导出的模型的计算和存储使用情况计费。
对于具有导出的模型表的参与者权限，但只有工作区的查看者权限的用户，模型文件夹会显示在 Lakehouse 资源管理器中，但在选中时会返回错误。
度量值、DirectQuery 表、混合表、计算组表和系统托管聚合表无法导出到 Delta 格式表。
只有单个版本的增量表导出并存储在 OneLake 上。 成功导出后，会删除旧版本的增量表。 使用较旧但现在删除的数据版本的其他执行引擎可能会发生暂时性故障。