Property-Element (CSDLBI)

Artikel
10/31/2023

Wichtig: Dieses Dokument wurde archiviert. Die neuesten Informationen finden Sie unter Open Specification zu [MS-CSDLBI]: Dateiformat für die konzeptuelle Schemadefinition mit Anmerkungen zu Business Intelligence.

Das Eigenschaftselement in CSDLBI ist ein komplexer Typ, der Ergänzungen zum CSDL-Eigenschaftselement bereitstellt, um Business Intelligence-Datenmodelle zu unterstützen.

Elemente und Attribute

In der folgenden Tabelle sind die Elemente und Attribute aufgeführt, die das CSDLBI-Eigenschaftselement definieren.

Name	Ist erforderlich	BESCHREIBUNG
Inhalte	No	Eine Zeichenfolge, die die LCID der Anforderung enthält.
DefaultAggregationFunction	Ja	Eine Zeichenfolge, die die Aggregationsfunktion angibt, die verwendet werden soll, wenn Berechnungen mit dem Attribut ausgeführt werden und keine anderen Funktion angegeben wurde. Falls nicht angegeben, wird die Standardaggregation für das Modell verwendet; dies ist i. d. R. SUM.
GroupingBehavior	No	Ein Wert, der angibt, wie Abfrageergebnisse gruppiert werden. Die Inhalte des Attributs werden vom einfachen Typ TGroupingBehavior definiert (siehe Tabelle unten).
OrderBy	No	Ein Verweis auf eine andere Eigenschaft im Modell, mit der die Sortierreihenfolge für die Werte der Eigenschaft definiert wird. Die Werte für die beiden Eigenschaften SOLLTEN eine 1:1-Zuordnung haben. Andernfalls ist das Sortierverhalten nicht definiert. Wenn dieses Element nicht angegeben wird, werden die Eigenschaften nach ihren Werten sortiert.
Stability	No	Ein Attribut, das die Stabilität der Eigenschaftswerte zwischen Aktualisierungsvorgängen angibt. Dieses Attribut wird nicht vom Benutzer festgelegt, sondern von der Entwurfszeitumgebung nur für instabile Werte ausgegeben. Es wird immer auf Spalten angewendet, die eine Zeilennummer enthalten, sowie auf Spalten mit Formeln, die unbestimmte Ergebnisse generieren, beispielsweise NOW() oder RAND(). Die Werte für dieses Attribut werden in der Tabelle unten aufgeführt, die den Stabilitysimple-Typ beschreibt.

GroupingBehavior

In der folgenden Tabelle sind die Werte des einfachen Typs GroupingBehavior aufgeführt.

Wert	BESCHREIBUNG
GroupOnValue	Gruppieren nach dem Wert des xthe-Attributs.
GroupOnEntityKey	Gruppieren nach dem Entitätsschlüssel.

Das folgende Beispiel veranschaulicht die Verwendung dieser beiden Werte. Angenommen, die Abfrage wurde entwickelt, um die Gehaltsabzüge für einen bestimmten Benutzer zurückzugeben, der mit Namen angegeben wurde. Wenn die Datenbank zwei Benutzer mit dem gleichen Namen, aber unterschiedlichen Datenbankbezeichnern enthält, würde sich das Abfrageergebniss je nach dem auf die Spalte angewendeten Attributwert unterscheiden:

GroupOnValue: Die Abfrageergebnisse enthalten die Summe der Gehaltsabzüge beider Benutzer.
GroupOnEntityKey: Die Abfrageergebnisse enthalten die Gehaltsabzüge für jeden Benutzer separat.

Stability

In der folgenden Tabelle sind die Werte des einfachen Typs Stability aufgeführt.

Wert	BESCHREIBUNG
Stable	Die Eigenschaft bleibt zwischen Aktualisierungsvorgängen konstant.
RowNumber	Die Eigenschaft enthält eine Zeilennummer.
Volatil	Die Eigenschaft bleibt zwischen Aktualisierungsvorgängen möglicherweise nicht konstant.

Tabellarisches Beispiel

Das folgende XML zeigt die Darstellung einiger Eigenschaften in CSDLBI, Version 1.1, im tabellarischen AdventureWorks-Modellbeispiel.

  
<EntityType   
   Name="DimEmployee">  
   <Key>  
      <PropertyRef   
      Name="RowNumber" />  
   </Key>  
  
   <Property   
      Name="RowNumber"   
      Type="Int64"   
      Nullable="false">  
   <bi:Property   
      Hidden="true"   
      Contents="RowNumber"   
      Stability="RowNumber" />  
   </Property>  
  
   <Property   
      Name="EmployeeKey"   
      Type="Int64">  
   <bi:Property />  
   </Property>  
….  
</bi:EntityType>  
</EntityType>

Beispiel für mehrdimensionale

Im folgenden Beispiel werden einige Eigenschaften für Spalten des Datenmodells in CSDLBI, Version 1.1, angezeigt, das den Contoso-Vorgangscube darstellt. Beachten Sie, dass BI-Anmerkungen nicht erforderlich sind bzw. auf die meisten Spalten nicht angewendet werden; die Anmerkungen werden nur für die Spalten verwendet, die eine besondere Behandlung in der Darstellungsschicht erfordern.

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

Freigeben über