TOM ADOMD.NET中“Retains dimensionality”含义及影响示例问询

核心含义 #

在ADOMD.NET对接多维分析数据源的场景里，“保留维度性”说白了就是让查询返回的数据完整保留原始多维模型里的维度层级、成员关联关系，不会把立体的多维结构硬拍成扁平的二维表格。比如你查询一个包含时间、产品、地区维度的立方体，开启这个特性后，返回的数据集里能直接拿到每个数据点对应的完整维度路径——比如某笔销售额对应的“2024年→Q3→9月”，而不是只给你孤零零的“9月”。

关键差异对比 #

举个直观的例子：关闭状态下，查询返回的产品维度值可能只有“山地自行车”，你没法直接知道它属于“自行车”类别；开启状态下，每个“山地自行车”成员都自带父节点“自行车”的信息，不用额外查维度表。

实际影响示例 #

1. 动态报表钻取场景 #

如果你做支持钻取的报表，开启“保留维度性”后，前端可以直接从返回的数据里拿到维度的层级关系——用户点击“2024年Q3”时，能直接展开对应的7、8、9月数据，不用再发新的查询去获取下层级数据；如果没开启，你得提前存储维度的层级映射表，或者每次钻取都重新发起查询，不仅麻烦，还会拖慢报表响应速度。

2. 数据分组计算场景 #

假设你要统计每个产品类别下的子类别销售额，开启该特性后，数据集里每个子类别成员都自带所属的类别信息，直接用成员的父节点属性就能分组计算；如果没开启，你得手动关联外部维度表去补全层级关系，不仅增加代码复杂度，还容易因为维度数据不一致导致计算错误。

3. ADOMD.NET代码示例 #

// 初始化查询命令
AdomdCommand cmd = new AdomdCommand(
    "SELECT [Measures].[Sales Amount] ON 0, [Product].[Category].Members ON 1 FROM [Adventure Works]", 
    conn
);
// 开启保留维度性
cmd.Properties["RetainDimensionality"] = true;
// 执行查询获取CellSet
CellSet cs = cmd.ExecuteCellSet();

// 遍历维度成员，直接获取层级关联
foreach (Position pos in cs.Axes[1].Positions)
{
    string categoryName = pos.Members[0].Caption;
    // 直接拿到父层级成员（开启特性才有效）
    string parentCategory = pos.Members[0].Parent?.Caption;
    Console.WriteLine($"类别：{categoryName}，上级类别：{parentCategory}");
}

如果把RetainDimensionality设为false，pos.Members[0].Parent会返回null，因为维度的层级关联信息已经被丢弃了。

内容的提问来源于stack exchange，提问作者Alberto Gentilcore