导入指标视图并查看诊断信息
这篇操作指南演示如何使用 C# Script 将已加载的指标视图导入到表格模型中，以及如何查看导入产生的诊断信息。
Note
这些操作指南面向 Tabular Editor 3.26.2 及更高版本。 早期版本不支持此处展示的 v1.1 指标视图功能。
为这些代码示例加载示例 Metric View
开始前，请确保你已打开 Tabular Editor 3，并已打开一个表格模型；如果没有，也可以新建一个模型。
本操作指南使用一个示例电商 Metric View 来展示销售数据：三张维度表（产品、客户、日期）与一张事实表（订单）进行联接。 使用下面任一方法来加载它（“下载并加载”或“复制并反序列化”），然后继续阅读本操作指南的其余内容。 你可以在与本示例其余部分相同的 C# Script 中运行任一命令；也可以先在单独的 C# Script 中运行该命令，再在另一个 C# Script 中运行本示例的其余部分。
下载 sample-metricview.yaml
然后按路径加载：
SemanticBridge.MetricView.Load("C:/path/to/sample-metricview.yaml");
Note
下面的每个示例都会导入到当前打开的表格模型中。 如果要运行多个示例，建议在每个示例之后撤销导入（菜单中选择 Edit>Undo，或在 TOM Explorer 中按 CTRL-z）。 如果依次执行每次导入，就会生成多个已转换的指标视图副本。
导入已加载的指标视图
ImportToTabular 会将当前加载的指标视图转换为当前打开的表格模型。
构建 M 分区表达式时会用到 Databricks 主机名和 HTTP 路径；
如需快速测试，可以先传入占位值，再在刷新数据前修正。
var success = SemanticBridge.MetricView.ImportToTabular(
Model,
"your-workspace.azuredatabricks.net",
"/sql/1.0/warehouses/abc123def456",
out var diagnostics
);
var sb = new System.Text.StringBuilder();
sb.AppendLine($"已导入 {Model.AllColumns.Count()} 个字段和 {Model.AllMeasures.Count()} 个度量值。");
sb.AppendLine(success ? "导入成功。" : "导入失败。");
sb.AppendLine($"诊断信息: {diagnostics.Count}");
foreach (var diag in diagnostics)
{
sb.AppendLine($" [{diag.Severity}] {diag.Code}: {diag.Message}");
}
Output(sb.ToString());
输出：
已导入 15 个字段和 6 个度量值。
导入成功。
诊断信息: 0
注意，导入的字段数包括联接键和指标视图定义中的隐式列引用，
因此会大于指标视图定义中显式 Fields 的数量。
查看最近一次导入的诊断信息
最近一次导入产生的诊断信息可随时通过 ImportDiagnostics 获取，即使该次导入是通过 GUI 执行的也一样。
foreach (var d in SemanticBridge.MetricView.ImportDiagnostics)
Output($"[{d.Severity}] {d.Code}: {d.Message}");
查看翻译诊断信息
某些指标视图中的结构无法转换为 Tabular。 例如，窗口度量值不会转换为 DAX： 导入时会创建一个占位 TOM 度量值，并在注释中保留原始指标视图定义， 同时向你 Report 一条诊断警告。
向某个度量值添加窗口规范，然后导入以查看诊断信息：
using MetricView = TabularEditor.SemanticBridge.Platforms.Databricks.MetricView;
var view = SemanticBridge.MetricView.Model;
// 添加窗口规范
view.Measures["total_revenue"].Window =
[
new MetricView.Window
{
Order = "order_date",
Range = "trailing 3 month",
Semiadditive = MetricView.Window.SemiadditiveType.Last
}
];
var success = SemanticBridge.MetricView.ImportToTabular(
Model,
"your-workspace.azuredatabricks.net",
"/sql/1.0/warehouses/abc123def456",
out var diagnostics
);
var sb = new System.Text.StringBuilder();
sb.AppendLine(success ? "导入成功，但存在问题。" : "导入失败。");
foreach (var diag in diagnostics)
{
sb.AppendLine($" [{diag.Severity}] {diag.Code}: {diag.Message}");
}
// 注意，我们按 DisplayName 搜索，因为转换为 TOM 时会用这个名称
sb.AppendLine($"TOM 度量值表达式: {Model.AllMeasures.First(m => m.Name == "Total Revenue").Expression}");
Output(sb.ToString());
输出：
导入成功，但存在问题。
[Warning] MEASURE_WINDOW_UNSUPPORTED: 度量值 'Total Revenue' 使用了当前不支持的窗口规范；因此它被保留为不生效状态，原始定义则作为注释保留下来。
TOM 度量值表达式：// 这个度量值使用了窗口规范（windowed / cumulative / semiadditive），
// 当前导入 Databricks 指标视图时还不支持这种规范。
// 这个度量值会保持为空——查看下面的详细信息，然后手动编写 DAX。
// 翻译后的 DAX 并未考虑窗口规范；你很可能
// 需要把它包装在 CALCULATE（或类似函数）中来应用窗口逻辑。
//
// 原始源表达式（Databricks SQL）：
/*
SUM(revenue)
*/
//
// 建议的 DAX 翻译结果（未应用窗口规范）：
/*
SUM('Fact'[revenue])
*/
//
// 窗口规范：
/*
- order: order_date
range: trailing 3 month
semiadditive: last
*/