Ensemble de lignes DISCOVER_CSDL_METADATA

Retourne des informations sur un modèle de données tabulaires, notamment la définition du modèle dans le langage de définition de schéma conceptuel (CSDL). Le CSDL est un schéma XML exploité par l'infrastructure Entity Data Framework utilisée pour la communication entre un serveur Analysis Services et le client Power View. Pour plus d'informations sur les modèles de données tabulaires, consultez Introduction aux extensions CSDL pour les modèles tabulaires.

Le contexte de sécurité de la commande affecte l'ensemble de lignes retourné. Les autorisations de lecture sur l'instance Analysis Services sont requises pour obtenir la définition CSDL à partir du serveur.

L'identificateur de langue du client qui émet la demande d'ensemble de lignes est inclus dans la chaîne de connexion pour la commande et affecte la langue affichée dans plusieurs propriétés retournées dans le cadre de l'ensemble de lignes. Pour plus d'informations sur les propriétés et la description affectées par l'identificateur de langue, consultez la section Remarques.

S'applique à : modèles tabulaires

Colonnes de l'ensemble de lignes

L'ensemble de lignes DISCOVER_CSDL_METADATA contient les colonnes suivantes.

Nom de la colonne

Indicateur de type

Restriction

Description

CATALOG_NAME

DBTYPE_WSTR

Oui

Spécifie le nom de la base de données pour laquelle la description CSDL est demandée. Si omis, le nom de la base de données active est utilisé.

L'ensemble de lignes DISCOVER_CSDL_METADATA doit être restreint à l'aide de cette colonne.

PERSPECTIVE_NAME

DBTYPE_WSTR

Oui

Spécifie le nom d'une perspective définie sur le modèle spécifié par CATALOG_NAME.

L'ensemble de lignes DISCOVER_CSDL_METADATA peut être éventuellement restreint à l'aide de cette colonne.

Cette restriction est requise pour les requêtes CSDL dans les bases de données multidimensionnelles qui contiennent plus d'un cube ou d'une perspective. Cette fonctionnalité a été introduite dans SQL Server 2012 SP1.

METADATA

DBTYPE_WSTR

Chaîne qui contient la définition XML d'une source de données et ses propriétés, d'après le schéma CSDL.

Notes

DISCOVER_CSDL_METADATA a les configurations requises suivantes :

  • La demande DISCOVER échouera si un base de données n'est pas spécifiée en utilisant la restriction CATALOG_NAME.

  • Si une perspective est fournie comme restriction, le même ensemble de lignes CSDL est retourné pour le modèle. Toutefois, tous les objets qui figurent dans le modèle mais sont inclus dans la perspective spécifiée sont marqués comme Hidden = True.

  • Pour les tables et les colonnes, la demande DISCOVER retourne toujours une valeur de la dimension du cube. Si la propriété de dimension du cube n'est pas définie, la demande retourne la valeur de la dimension.

  • La demande DISCOVER ne peut pas retourner toutes les mesure ou les colonnes calculées qui contiennent une erreur sémantique.

  • La demande DISCOVER ne retournera pas d'informations pour les objets qui n'ont pas de valeurs de propriété. De même, la demande DISCOVER ne retournera pas de valeurs pour les attributs qui utilisent la valeur par défaut.

La chaîne XML retournée dans l'ensemble de lignes peut inclure les propriétés ou valeurs spécifiques à une langue qui suivent. Par exemple, si vous émettez la demande d'ensemble de lignes à partir d'un client qui dont le LCID est 0403 (Catalan), la propriété retournera les valeurs approprié au catalan suivantes. Si les traductions ne sont pas disponibles sur le serveur, la chaîne de la langue par défaut du serveur est retournée.

  • Caption

  • Qualifier

  • SortDirection

  • IsRightToLeft

Exemple

La requête XMLA suivante retourne la représentation CSDL de la base de données, Model, sur la connexion actuelle.

<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>

Utilisation d'ADOMD.NET pour retourner l'ensemble de lignes

Lorsque vous utilisez ADOMD.NET et l'ensemble de lignes de schéma pour récupérer des métadonnées, vous pouvez utiliser un GUID ou une chaîne pour référencer un objet d'ensemble de lignes de schéma dans la méthode GetSchemaDataSet. Pour plus d'informations, consultez Utilisation d'ensembles de lignes de schéma dans ADOMD.NET.

Le tableau suivant fournit le GUID et les valeurs de chaîne qui identifient cet ensemble de lignes.

Argument

Valeur

GUID

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

ADOMDNAME

Csdl

Voir aussi

Référence

Ensembles de lignes de schéma Analysis Services

Concepts

Introduction aux extensions CSDL pour les modèles tabulaires