概念架构定义语言 (CSDLBI) 概述

适用于: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Analysis Services 支持在 1103 和更低兼容性级别上以称为概念架构定义语言的 XML 格式呈现多维模型和表格模型的定义,以及商业智能注释 (CSDLBI) 。 本文概述了 CSDLBI 以及如何将其与 Analysis Services 数据模型配合使用。

理解 CSDL 的角色

概念性架构定义语言 (CSDL) 是一种描述实体、关系和函数的基于 XML 的语言。 CSDL 定义为实体数据框架的一部分。 BI 注释是一个扩展,旨在支持使用 Analysis Services 进行数据建模。

尽管 CSDL 符合实体数据框架,但您无需理解实体关系模型或具有用于基于模型生成表格模型或报表的任何特殊工具。 可以使用客户端工具(如 Visual Studio 和 Analysis Services 项目扩展(也称为 SQL Server Data Tools (SSDT) )或 API(如 AMO)生成模型,并将模型部署到服务器。

CSDLBI 架构由 Analysis Services 服务器生成,以响应来自客户端的模型定义请求。 客户端应用程序将 XML 查询发送到承载模型数据的 Analysis Services 服务器。 在响应中,该服务器将发送一条 XML 消息,消息中使用 CSDLBI 注释包含该模型中实体的定义。 然后,报表客户端使用这些信息来展现可用于模型中的字段、聚合和度量值。 CSDLBI 注释还提供有关如何对数据进行分组、排序和格式设置的信息。

使用 CSDL

表示任何特定表格模型的 CSDLBI 注释集是一个 XML 文档,其中包含简单实体和复杂实体的集合。 实体定义表(或维度)、列(属性)、关联(关系)以及包含在计算列、度量值或 KPI 中的公式。

您不能直接使用 CSDL 修改这些对象,而必须使用为使用表格模型而提供的客户端工具和应用程序编程接口 (API)。

您可以通过将 DISCOVER 请求发送到承载某个模型的服务器,获取该模型的 CSDL。 必须通过指定服务器和模型(这两者是必需的)以及视图或透视(这两者是可选的)对该请求加以限定。 返回的消息是一个 XML 字符串。 某些元素是依赖于语言的,因此可能会根据当前连接的语言返回不同值。 有关详细信息,请参阅DISCOVER_CSDL_METADATA行集。

CSDLBI 参考

原始 CSDL 规范(来自实体数据框架)是为支持建模所需的大多数实体和属性提供的。 BI 注释支持表格模型的特殊要求、客户端所需的报告属性以及多维模型所需的其他元数据。

从 2012 年开始, 开放规范中介绍了 CSDLBI 规范的版本 1.0 和后续版本。 开放规范会定期更新,以配合功能更改。 在将 CSDLBI 发布到开放规范之前,CSDLBI 版本 1.0 和 1.1 作为参考记录在 MSDN\TechNet 上。 此早期版本的 CSDLBI 参考提供了比开放规范中提供的更深入的 CSDLBI 结构和语义定义,但是,应使用开放规范。

开放规范版本 1.0 及更高版本

[MS-CSDLBI]:使用商业智能注释的概念架构定义文件格式

CSDLBI 1.0、1.1 参考 (存档)

CSDLBI 1.0、1.1 参考

另请参阅

有关 CSDLBI 注释中各个元素的详细信息,请参阅 CSDL BI 注释的技术参考
有关核心 CSDL 规范的信息,请参阅 MSDN 上的 CSDL 规范