大网数据广告活动
数据库与应用安全

CSDLBI 概念

· 52CE 我爱测

!INCLUDE[ssas-appliesto-sqlas] 带 BI 注释的概念性架构定义语言 (CSDLBI) 基于实体数据框架。实体数据框架是一个抽象概念,用于以某种方式表示不同类型的数据,以便能够以编程方式访问、查询或导出不同的数据集。 CSDLBI 用于表示使用 !INCLUDE[ssASnoversion] 创建的数据模型,因为它支持丰富的数据驱动的报告和应用程序。

适用于: 是SQL Server Analysis Services没有Azure Analysis Services 带 BI 注释的概念性架构定义语言 (CSDLBI) 基于实体数据框架。实体数据框架是一个抽象概念,用于以某种方式表示不同类型的数据,以便能够以编程方式访问、查询或导出不同的数据集。 CSDLBI 用于表示使用 Analysis Services 创建的数据模型,因为它支持丰富的数据驱动的报告和应用程序。

这部分说明 CSDLBI 表示形式如何映射到 Analysis Services 数据模型(表格和多维)以及每种模型类型的示例。

用于说明这些概念的示例取自 Codeplex 上提供的 AdventureWorks 示例数据库。 有关示例的详细信息,请参阅SQL Server 的 Adventure Works 示例。

CSDLBI 中表格模型的结构

描述报表模型及其数据的 CSDLBI 文档以 xsd 语句开头,后跟模型的定义。

模型是一个命名空间,其中包含以下主要实体、关联和属性:

  • EntityContainer列出了在模型中的表。

  • 每个表列出与EntityContainer作为EntitySet。

  • 两个表之间的每个关系被称为AssociationSet ,用于定义关系端点和关系角色。

  • EntityType元素扩展的 BISM 以提供其他详细信息的表和列中,其中包括用于排序的属性和显示目的。

  • 度量值元素在模型中定义可以使用的计算结果。 度量值可以通过添加一组特殊显示属性,使用新转换为 KPI KPI元素。

  • 没有针对透视的单独表示形式。 不包括在透视的列和表都位于但标志,则为 CSDL Hidden属性。

实体、EntitySet 和 EntityType

已对实体数据框架中的实体概念进行扩展,以便表示数据模型中的列和表。 以下摘录显示了一系列EntitySet中一个简单的元素的模型包含只有三个表。

<EntityContainer Name="SimpleModel">  
<EntitySet Name="DimCustomer"EntityType="SimpleModel.DimCustomer">  
     <bi:EntitySet />  
   </EntitySet>  
<EntitySet Name="DimDate" EntityType="SimpleModel.DimDate">  
     <bi:EntitySet />  
   </EntitySet>  
<EntitySet Name="DimGeography" EntityType="SimpleModel.DimGeography">  
     <bi:EntitySet />  
   </EntitySet> />  
  

EntitySet不包含列或表中的数据的相关信息。 EntityType 元素中提供了列及其属性的详细说明。

EntitySet元素为每个实体 (表) 包含定义的键列、 数据类型和长度的列,为 null 性、 排序行为等的属性的集合。 例如,以下 CSDL 摘录描述了 Customer 表中的三列。 第一列是模型在内部使用的特殊隐藏列。

<EntityType Name="Customer">  
  <Key>  
     <PropertyRef Name="RowNumber" />  
  </Key>  
    <Property Name="RowNumber" Type="Int64" Nullable="false">  
     <bi:Property Hidden="true" Contents="RowNumber"  
       Stability="RowNumber" />  
    </Property>  
    <Property Name="CustomerKey" Type="Int64" Nullable="false">  
      <bi:Property />  
    </Property>  
     <Property Name="FirstName" Type="String" MaxLength="Max" FixedLength="false">  
       <bi:Property />  
      </Property>  
  

为了限制生成的 CSDLBI 文档的大小,出现不止一次实体中的属性指定由对某个现有属性的引用,以便为需要一次列出的属性EntityType。 客户端应用程序可以通过查找获取属性的值EntityType相匹配OriginEntityType。

关系

在实体数据框架中,关系被定义为关联实体之间。

关联始终有两个端点,每个端点指向表中的一个字段或一个列。 因此,两个表之间可以存在多个关系,前提是这些关系具有不同的端点。 将为关联的端点分配角色名称,并指示如何在数据模型的上下文中使用关联。 角色名称的一个示例可能ShipTo,当应用于与 Orders 表中的客户 ID 相关的客户 ID。

该模型的 CSDLBI 表示形式还包含对关联来确定如何将实体映射到彼此的特性多重性的关联。 多重性指示位于表之间的关系的端点上的属性或列是位于关系的一方还是多方。 没有针对一对一关系的单独的值。 CSDLBI 注释支持多重性为 0(表示实体未与任何对象关联)或为 0..1(表示一对一关系或一对多关系)。

以下示例表示 Date 表和 ProductInventory 表之间的关系的 CSDLBI 输出,其中这两个表通过 DateAlternateKey 列联接。 请注意,默认情况下的名称AssociationSet是关系中涉及的列的完全限定的名称。 但是,可以在设计模型时将此行为更改为使用其他命名格式。

<AssociationSet Name="ProductInventory_Date_DateKey" Association="Model.ProductInventory_Date_DateKey">  
              <End EntitySet="ProductInventory" />  
              <End EntitySet="Date" />  
              <bi:AssociationSet />  
            </AssociationSet>  
  

可视化和导航属性

用于定义报告层中的表示形式和导航实体之间的关系的属性是 CSDLBI 注释的一个重要部分。 通常,基于客户端应用程序将指定排序和表示形式的其他详细信息这种假设,在创建数据模型时,您会认为控制数据的排序和分组方式或可能的默认值并不重要。 但是,Analysis Services 表格模型设计为可以与 Power View 报表客户端集成,并在报表设计图面中包含支持数据模型中的实体的表示形式的属性和特性。

针对可视化的扩展包括用于以下用途的属性:指定要用于数值数据的默认聚合、指示指向图像的 URL 的文本字段或指定用于为当前字段进行排序的字段。

名称属性和命名约定

CSDLBI 架构规定每个实体具有一个唯一名称和一个可用作密钥的标识符。 此外,某些实体可具有用于显示的标题和随实体的使用位置的不同而不同的上下文名称。

文档元素提供了报表设计人员能够提供实体的说明的机会帮助业务用户了解数据的含义。 某些实体还允许一个或多个批注属性,以便提供额外的元数据由应用程序或客户端。

使用 Analysis Services 工具生成模型时,为对象创建的名称应遵循对象命名的 Analysis Services 约定和名称唯一性。 但是,由于 CSDLBI 基于实体数据框架 (EDF),而实体数据框架要求名称遵循 C# 标识符的约定,因此,服务器在为模型创建 CSDLBI 输出时将采用 Analysis Services 架构中使用的名称,并将自动创建符合 EDF 要求的新对象名称。 下表描述了用于生成新名称的操作。

规则 操作
无禁止字符 禁止字符将由下划线替换。
名称必须是唯一的 如果两个字符串相同,则通过为一个字符串追加下划线和数字使其具有唯一性

Warning:
标题和限定符都有对应的译文,而对于某种给定语言,可能只存在二者之一。 这意味着,当限定符与名称或限定符与标题串联时,字符串可用两种不同的语言表示。

所增加的用于支持多维模型的内容

CSDLBI 注释 1.0 版仅支持表格模型。 在版本 1.1 中,添加了对使用传统 BI 开发工具创建的多维模型(OLAP 多维数据集)的支持。 因此,您现在可以向多维模型发出 XML 请求并接收模型的 CSDLBI 定义,以用于报告。

多维数据集: SQL ServerAnalysis Services表格数据库只能包含只有一种模式。 相比较而言,每个多维数据库可以包含多个多维数据集,每个数据库与一个默认的多维数据集关联。 因此,当针对多维服务器发出 XML 请求时,需要指定多维数据集;否则,将返回默认多维数据集的 XML。

多维数据集的表示形式与表格模型数据库的表示形式非常相似。 多维数据集名称和多维数据集分别对应于表格数据库名称和数据库标识符。

维度: 维度在 CSDLBI 中表示为具有列和属性的实体 (表)。 请注意,即使未包括在透视中,将会在模型中包括的维度表示为 CSDL 输出,标记为Hidden。

透视: 客户端可以请求 CSDL 以获得单独的透视。 有关详细信息,请参阅DISCOVER_CSDL_METADATA 行集。

层次结构: 支持和 CSDLBI 中表示为一组级别的层次结构。

成员: 对已添加的默认成员和默认值会自动添加到 CSDLBI 输出的支持。

计算成员: 多维模型支持计算的成员的子级所有具有单个真实成员。

维度属性: 在 CSDLBI 输出中,维度属性均受支持,自动将标记为不可聚合。

Kpi: CSDLBI 版本 1.1 中支持 Kpi,但表示形式已发生变化。 以前,KPI 是度量值的属性。 在版本 1.1 中,可以将 KPI 元素添加到度量值

新属性: 添加了其他属性以支持 DirectQuery 模型。

限制: 不支持单元安全性。

另请参阅

用于商业智能的 CSDL 批注 (CSDLBI)

历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 minewiskan)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / SQL Server 中文文档历史快照
适用范围
历史中文快照 2018-11-30;详见原文产品版本;文档日期 05/07/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。