Annotations CSDL pour Business Intelligence (CSDLBI)CSDL Annotations for Business Intelligence (CSDLBI)

S’APPLIQUE À :ouiSQL Server Analysis ServicesnonAzure Analysis ServicesAPPLIES TO:yesSQL Server Analysis ServicesnoAzure Analysis Services Analysis ServicesAnalysis Services prend en charge la présentation de la définition d’un modèle tabulaire dans un format XML appelé Conceptual Schema Definition Language avec des annotations Business Intelligence (CSDLBI). Analysis ServicesAnalysis Services supports the presentation of the definition of a tabular model in an XML format called Conceptual Schema Definition Language with Business Intelligence annotations (CSDLBI). Cette rubrique fournit une vue d'ensemble de CSDLBI et de son utilisation avec des modèles de données Analysis ServicesAnalysis Services.This topic provides an overview of CSDLBI and how it is used with Analysis ServicesAnalysis Services data models.

Comprendre le rôle du langage CSDLUnderstanding the Role of CSDL

CSDL est un langage basé sur XML qui décrit des entités, des relations et des fonctions.The Conceptual Schema Data Language (CSDL) is an XML-based language that describes entities, relationships, and functions. Le langage CSDL est défini dans le cadre de l'Entity Data Framework.CSDL is defined as part of the 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 ServicesAnalysis Services.The BI annotations are an extension designed to support data modeling using Analysis ServicesAnalysis 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.Although CSDL is compliant with the Entity Data Framework, you do not need to understand the entity-relationship model or have any special tools to build a tabular model or a report based on a model. Pour générer des modèles, utilisez des outils clients tels que Outils de données SQL Server (SSDT)SQL Server Data Tools (SSDT) ou une API telle que AMO, puis déployez le modèle sur un serveur.You build models by using client tools such as Outils de données SQL Server (SSDT)SQL Server Data Tools (SSDT) or an API such as AMO, and deploy the model to a server. Pour se connectent au modèle les clients utilisent un fichier de définition de modèle, généralement publié dans une bibliothèque SharePoint où il pourra être utilisé par les concepteurs de rapports et les consommateurs de rapports.Clients connect to the model by using a model definition file, typically published to a SharePoint library where it can be used by report designers and report consumers. Pour plus d'informations, consultez ces liens :For more information, see these links:

  • Solutions de modèles tabulaires (SSAS Tabulaire)Tabular Model Solutions (SSAS Tabular)

  • Déploiement d’une solution de modèle tabulaire (SSAS Tabulaire)Tabular Model Solution Deployment (SSAS Tabular)

  • Connexion de modèle sémantique BI Power Pivot (.bism)Power Pivot BI Semantic Model Connection (.bism)

    Le schéma CSDLBI est généré par le serveur Analysis Services en réponse à une demande d'une définition de modèle d'un client de création de rapports, tel que Power ViewPower View.The CSDLBI schema is generated by the Analysis Services server in response to a request for a model definition from a client such as Power ViewPower View. L'application cliente envoie une requête XML au serveur Analysis Services qui héberge les données du modèle.The client application sends an XML query to the Analysis Services server that hosts the model data. En réponse, le serveur envoie un message XML contenant une définition des entités du modèle, en utilisant les annotations CSDLBI.In response, the server sends an XML message containing a definition of the entities in the model, using the CSDLBI annotations. 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.The reporting client then uses the information to present the fields, aggregations, and measures that are available in the model. Les annotations CSDLBI fournissent également des informations sur le regroupement, le tri et la mise en forme des données.The CSDLBI annotations also provide information about how to group, sort, and format the data.

    Pour obtenir des informations générales sur CSDLBI, consultez Concepts CSDLBI.For general information about CSDLBI, see CSDLBI Concepts.

Utilisation de CSDLWorking with 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.The set of CSDLBI annotations that represents any particular tabular model is an XML document containing a collection of entities, both simple and complex. 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.The entities define tables (or dimensions), columns (attributes), associations (relationships), and formulas included in calculated columns, measure, or KPIs.

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.You cannot modify these objects directly, but must use the client tools and application programming interfaces (APIs) provided for working with tabular models.

Vous pouvez obtenir le langage CSDL pour un modèle en envoyant une demande DISCOVER au serveur qui héberge le modèle.You can obtain the CSDL for a model by sending a DISCOVER request to the server that hosts the model. La demande doit être qualifiée en spécifiant le serveur et le modèle, et, éventuellement, une vue ou une perspective.The request must be qualified by specifying the server and the model, and, optionally, a view or perspective. Le message retourné est une chaîne XML.The returned message is an XML string. Certains éléments dépendent du langage et peuvent retourner des valeurs différentes selon le langage de la connexion actuelle.Certain elements are language-dependent and may return different values depending on the language of the current connection. Pour plus d’informations, consultez ensemble de lignes DISCOVER_CSDL_METADATA.For more information, see DISCOVER_CSDL_METADATA Rowset.

Versions de CSDLBICSDLBI Versions

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.The original CSDL specification (from the Entity Data Framework) provides for most of the entities and properties that are needed to support modeling. Les annotations BI prennent en charge les spécifications particulières des modèles tabulaires, les propriétés de création de rapports requises pour les clients, tels que Power ViewPower View, et les métadonnées supplémentaires requises pour les modèles multidimensionnels.The BI annotations support special requirements of tabular models, reporting properties required for clients such as Power ViewPower View, and additional metadata required for multidimensional models. Cette section décrit les mises à jour dans chaque version.This section describes the updates in each version.

CSDLBI VERSION 1.0CSDLBI 1.0

Le jeu initial d'ajouts au schéma CSDL pour prendre en charge les modèles tabulaires Analysis ServicesAnalysis Services contenait des annotations afin de prendre en charge la modélisation des données, les calculs personnalisés et la présentation avancée :The initial set of additions to the CSDL schema to support Analysis ServicesAnalysis Services tabular models contained annotations in support of data modeling, custom calculations, and enhanced presentation:

  • Nouveaux éléments et propriétés pour prendre en charge les modèles tabulaires.New elements and properties to support tabular models. Par exemple, une propriété a été ajoutée pour spécifier le type de requête de base de données utilisé pour remplir le modèle.For example, a property was added to specify the type of database query used to populate the model.

  • Nouvelles propriétés et extensions dans les entités existantes.New properties and extensions to existing entities. Par exemple, l'élément Association a été étendu pour prendre en charge les relations.For example, the Association element was extended to support relationships.

  • Propriétés de visualisation et de navigation.Visualization and navigation properties. Par exemple, des propriétés ont été ajoutées pour prendre en charge les champs de tri personnalisé, les images par défaut etFor example, properties were added to support custom sorting fields, default images, and

    1.1 DE CSDLBICSDLBI 1.1

    Cette version du schéma CSDLBI inclut des ajouts pour la prise en charge des bases de données multidimensionnelles (telles que les cubes OLAP).This version of the CSDLBI schema includes additions in support of multidimensional databases (such as OLAP cubes). Les nouveaux éléments et propriétés sont les suivants :The new elements and properties are as follows:

  • Prise en charge des dimensions sous la forme d'entités.Support for dimensions as entities.

  • Prise en charge des hiérarchies.Support for hierarchies.

  • Expose les partitions ROLAP.Exposes ROLAP partitions.

  • Prise en charge des traductions.Support for translations.

  • Prise en charge des perspectives.Support for perspectives.

    Pour plus d’informations sur les éléments individuels dans les annotations CSDLBI, consultez informations techniques de référence pour les Annotations BI au langage CSDL.For detailed information about individual elements in the CSDLBI annotations, see Technical Reference for BI Annotations to CSDL. Pour plus d’informations sur la spécification CSDL principale, consultez le spécification CSDL sur MSDN.For information about the core CSDL specification, see the CSDL specification on MSDN.

Voir aussiSee Also

Présentation du modèle d’objet tabulaire au niveau de compatibilité 1050 1103 via des niveaux Understanding the Tabular Object Model at Compatibility Levels 1050 through 1103
Concepts CSDLBI CSDLBI Concepts
Présentation du modèle d’objet tabulaire au niveau de compatibilité 1050 1103 via des niveauxUnderstanding the Tabular Object Model at Compatibility Levels 1050 through 1103