DISCOVER_CSDL_METADATA-Rowset

  • Artikel

Gibt Informationen zu einem Tabellendatenmodell zurück, einschließlich der Definition des Modells in der konzeptionellen Schemadefinitionssprache (CSDL). CSDL ist ein vom Entity Data Framework verwendetes XML-Schema, das für die Kommunikation zwischen einem Analysis Services-Server und dem Power View-Client verwendet wird. Weitere Informationen zu Tabellendatenmodellen finden Sie unter Einführung in die CSDL-Erweiterungen für Tabellenmodelle.

Der Sicherheitskontext des Befehls wirkt sich auf das Rowset aus, das zurückgegeben wird. Leseberechtigungen auf der Analysis Services-Instanz sind erforderlich, um die CSDL-Definition vom Server abzurufen.

Der Sprachenbezeichner des Clients, der die Rowsetanforderung ausstellt, ist in der Verbindungszeichenfolge für den Befehl enthalten und wirkt sich auf die Sprache aus, die in mehreren Eigenschaften angezeigt wurde, die als Teil des Rowsets zurückgegeben werden. Informationen zu den Eigenschaften und der Beschreibung, auf die sich der Sprachenbezeichner möglicherweise auswirkt, finden Sie im Abschnitt mit den Hinweisen.

Gilt für: tabellarische Modelle

Rowsetspalten

Das DISCOVER_CSDL_METADATA-Rowset enthält die folgenden Spalten.

Spaltenname

Typindikator

Einschränkung

Beschreibung

CATALOG_NAME

DBTYPE_WSTR

Ja

Gibt den Namen der Datenbank an, für die die CSDL-Beschreibung angefordert wurde. Bei Auslassung wird die aktuelle Datenbank verwendet.

Das DISCOVER_CSDL_METADATA-Rowset muss mithilfe dieser Spalte eingeschränkt werden.

PERSPECTIVE_NAME

DBTYPE_WSTR

Ja

Gibt den Namen einer auf dem Modell definierten Perspektive an, die anhand von CATALOG_NAME angegeben wurde.

Das DISCOVER_CSDL_METADATA-Rowset kann mithilfe dieser Spalte optional eingeschränkt werden.

Diese Einschränkung ist für CSDL-Abfragen mehrdimensionaler Datenbanken erforderlich, die mehr als einen Cube bzw. mehr als eine Perspektive enthalten. Diese Funktion wurde in SQL Server 2012 SP1 eingeführt.

METADATA

DBTYPE_WSTR

Eine Zeichenfolge, die die XML-Definition einer Datenquelle und ihre Eigenschaften enthält, nach dem CSDL-Schema.

Hinweise

DISCOVER_CSDL_METADATA weist folgende Anforderungen auf:

  • Die DISCOVER-Anforderung schlägt fehl, wenn eine Datenbank nicht mithilfe der CATALOG_NAME-Einschränkung angegeben wird.

  • Wenn eine Perspektive als Einschränkung angegeben wird, wird das gleiche CSDL-Rowset wie für das Modell zurückgegeben. Allerdings sind alle Objekte, die im Modell, aber nicht in der angegebenen Perspektive enthalten sind, mit Hidden = True markiert.

  • Für Tabellen und Spalten gibt die DISCOVER-Anforderung immer einen Wert von der Cubedimension aus. Wenn die Cubedimensionseigenschaft nicht festgelegt ist, gibt die Anforderung den Wert über die Dimension zurück.

  • Die DISCOVER-Anforderung kann keine Measures oder berechnete Spalten zurückgeben, die einen Semantikfehler enthalten.

  • Die DISCOVER-Anforderung gibt keine Informationen für Objekte ohne Eigenschaftswerte zurück. Die DISCOVER-Anforderung gibt auch keine Werte für Attribute zurück, die den Standardwert verwenden.

Die XML-Zeichenfolge, die im Rowset zurückgegeben wird, enthält möglicherweise die folgenden sprachspezifischen Eigenschaften oder Werte. Wenn Sie z. B. die Rowsetanforderung von einem Client mit der LCID 0403 (katalanisches Spanisch) ausstellen, gibt die Eigenschaft die folgenden Werte für katalanisches Spanisch zurück. Wenn auf dem Server keine Übersetzungen verfügbar sind, wird die Zeichenfolge für die Standardsprache des Servers zurückgegeben.

  • Beschriftung

  • Qualifizierer

  • SortDirection

  • IsRightToLeft

Beispiel

Die folgende XMLA-Abfrage gibt für die aktuelle Verbindung die CSDL-Darstellung der Datenbank, Modell, zurück.

<Discover xmlns="urn:schemas-microsoft-com:xml-analysis">
<RequestType>DISCOVER_CSDL_METADATA</RequestType>
    <Restrictions>
<RestrictionList>
<CATALOG_NAME>Model</CATALOG_NAME>
</RestrictionList>
</Restrictions>
    <Properties>
<PropertyList>
                 <FORMAT>Tabular</FORMAT>
   </PropertyList>
</Properties>
</Discover>

Verwenden von ADOMD.NET zum Zurückgeben des Rowsets

Wenn Sie Metadaten mithilfe von ADOMD.NET und des Schemarowsets abrufen, können Sie entweder die GUID verwenden oder eine Referenz für ein Schemarowsetobjekt in der GetSchemaDataSet-Methode herstellen. Weitere Informationen finden Sie unter Arbeiten mit Schemarowsets in ADOMD.NET.

Die folgende Tabelle enthält die GUID und die Zeichenfolgenwerte, die dieses Rowset identifizieren.

Argument

Wert

GUID

87B86062-21C3-460F-B4F8-5BE98394F13B

ADOMDNAME

Csdl

Siehe auch

Verweis

Analysis Services-Schemarowsets

Konzepte

Einführung in die CSDL-Erweiterungen für Tabellenmodelle