Table of Contents

在 Power BI 模型中使用最新的兼容级别

  • 2026-01-09
  • Morten Lønskov

概述

此规则用于识别未使用最新可用兼容级别的 Power BI 模型。 使用最新兼容级别可确保获得最新功能、性能优化以及错误修复。

  • 类别：治理
  • 严重性：高（3）

适用范围

  • 模型（仅限 Power BI 语义模型）

为何重要

  • 功能缺失：无法使用新的 DAX 函数和模型能力
  • 面向未来的兼容性：使用较新的级别可让升级更轻松

何时触发此规则

对于 Power BI 模型，当兼容级别低于当前最大值时会触发：

Model.Database.CompatibilityMode=="PowerBI" 
and Model.Database.CompatibilityLevel<>[CurrentMaxLevel]

如何修复

自动修复

该最佳实践规则包含一个自动修复，会将兼容级别设置为当前安装的 Tabular Editor 3 所支持的最高可用级别。 如果您安装的是较旧版本的 Tabular Editor 3，请将其更新到最新版本。

Model.Database.CompatibilityLevel = [PowerBIMaxCompatibilityLevel]

手动修复

  1. 在 Tabular Editor 中，转到 Model 属性页
  2. 将兼容级别设置为最新版本
  3. 测试所有 DAX 表达式和功能
  4. 部署到 Power BI 服务

常见原因

原因 1：在 Power BI Desktop 中创建模型

在 Power BI Desktop 中创建的模型未必使用最新的兼容级别。

原因 2：模型以较低兼容级别创建

模型使用较旧版本的 Power BI Desktop 创建。

原因 3：保守做法

团队政策要求延后升级。

示例

修复前

模型兼容级别：1500
当前最高级别：1700

修复后

模型兼容级别：1700（最新）

可使用增强的计算组和字段参数等新功能。

兼容级别

此规则适用于所有兼容级别的 Power BI 模型。