FormatDax 弃用说明

Applies to:

随着 Tabular Editor 2.13.0 的发布，FormatDax 方法（Tabular Editor 中可用的辅助方法之一）已被弃用。

弃用的原因是 https://www.daxformatter.com/ 的 Web 服务开始在短时间内收到大量连续请求，导致对方服务端出现问题。这是因为 FormatDax 方法在脚本中每次被调用时都会发起一次 Web 请求，而很多人一直在使用如下这类脚本：

不要这样做！

foreach(var m in Model.AllMeasures)
{
    // DON'T DO THIS
    m.Expression = FormatDax(m.Expression);
}

对于只有几十个度量值的小模型来说这没问题，但 www.daxformatter.com 的流量表明，上述脚本正被用于包含数千个度量值的多个模型上，甚至每天执行好几次！

为解决该问题，当使用上述语法连续调用 FormatDax 超过三次时，Tabular Editor 2.13.0 会显示一条警告。此外，后续调用将会被限流，每次调用之间会强制延迟 5 秒。

替代写法

Tabular Editor 2.13.0 引入了两种不同的方式来调用 FormatDax。上面的脚本可以改写为以下任意一种：

foreach(var m in Model.AllMeasures)
{
    m.FormatDax();
}

……或者更简单地写成……：

Model.AllMeasures.FormatDax();

这两种方式都会将对 www.daxformatter.com 的所有调用合并为一次请求。如果你愿意，也可以使用全局方法的写法：

foreach(var m in Model.AllMeasures)
{
    FormatDax(m);
}

……或者更简单地写成……：

FormatDax(Model.AllMeasures);