Vue d’ensemble du langage CSDLBI (Conceptual Schema Definition Language)

S’applique à : SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Analysis Services prend en charge la présentation de la définition de modèles multidimensionnels et de modèles tabulaires aux niveaux de compatibilité 1103 et inférieurs dans un format XML appelé Conceptual Schema Definition Language avec annotations Business Intelligence (CSDLBI). Cet article fournit une vue d’ensemble de CSDLBI et de la façon dont il est utilisé avec les modèles de données Analysis Services.

Comprendre le rôle du langage CSDL

CSDL est un langage basé sur XML qui décrit des entités, des relations et des fonctions. Le langage CSDL est défini dans le cadre de l'Entity Data Framework. Les annotations BI sont une extension conçue pour prendre en charge la modélisation des données à l’aide d’Analysis Services.

Bien que le langage CSDL soit compatible avec l'Entity Data Framework, vous n'avez pas besoin de comprendre le modèle de relation d'entité et vous n'avez pas non plus besoin d'outils spéciaux pour générer un modèle tabulaire ou un rapport basé sur un modèle. Vous générez des modèles à l’aide d’outils clients tels que Visual Studio avec des extensions de projets Analysis Services, également appelées SQL Server Data Tools (SSDT), ou une API comme AMO et déployez le modèle sur un serveur.

Le schéma CSDLBI est généré par le serveur Analysis Services en réponse à une demande de définition de modèle à partir d’un client. L'application cliente envoie une requête XML au serveur Analysis Services qui héberge les données du modèle. En réponse, le serveur envoie un message XML contenant une définition des entités du modèle, en utilisant les annotations CSDLBI. Le client du rapport utilise ensuite des informations pour présenter les champs, les agrégations et les mesures qui sont disponibles dans le modèle. Les annotations CSDLBI fournissent également des informations sur le regroupement, le tri et la mise en forme des données.

Utilisation de CSDL

L'ensemble d'annotations CSDLBI qui représente n'importe quel modèle tabulaire est un document XML qui contient une collection d'entités, simples et complexes. Les entités définissent des tables (ou dimensions), des colonnes (attributs), des associations (relations) et des formules incluses dans des colonnes calculées, des mesures ou des indicateurs de performance clés.

Vous ne pouvez pas modifier directement ces objets, mais vous devez utiliser les outils clients et des API (interfaces de programmation d'applications) fournis pour utiliser des modèles tabulaires.

Vous pouvez obtenir le langage CSDL pour un modèle en envoyant une demande DISCOVER au serveur qui héberge le modèle. La demande doit être qualifiée en spécifiant le serveur et le modèle, et, éventuellement, une vue ou une perspective. Le message retourné est une chaîne XML. Certains éléments dépendent du langage et peuvent retourner des valeurs différentes selon le langage de la connexion actuelle. Pour plus d’informations, consultez DISCOVER_CSDL_METADATA Ensemble de lignes.

Référence CSDLBI

La spécification CSDL d'origine (Entity Data Framework) prévoit la plupart des entités et des propriétés exigées pour prendre en charge la modélisation. Les annotations BI prennent en charge les exigences particulières des modèles tabulaires, les propriétés de création de rapports requises pour les clients et les métadonnées supplémentaires requises pour les modèles multidimensionnels.

À compter de 2012, la version 1.0 et les versions ultérieures de la spécification CSDLBI sont décrites dans Open Specifications. La spécification Open Est régulièrement mise à jour pour coïncider avec les modifications apportées aux fonctionnalités. Avant de publier CSDLBI dans Open Specification, les versions 1.0 et 1.1 de CSDLBI étaient documentées en tant que référence sur MSDN\TechNet. Cette première version de la référence CSDLBI fournit des définitions plus détaillées des structures et de la sémantique CSDLBI que celles fournies dans la spécification ouverte. Toutefois, la spécification ouverte doit être utilisée.

Open Specification versions 1.0 et ultérieures

[MS-CSDLBI] : Format de fichier de définition de schéma conceptuel avec annotations Business Intelligence

Référence CSDLBI 1.0, 1.1 (archivé)

Référence CSDLBI 1.0, 1.1

Voir aussi

Pour plus d’informations sur des éléments individuels dans les annotations CSDLBI, consultez Référence technique pour les annotations BI dans CSDL.
Pour plus d’informations sur la spécification CSDL principale, consultez la spécification CSDL sur MSDN.