Introducción al lenguaje de definición de esquemas conceptuales (CSDLBI)
Se aplica a:
SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium
Analysis Services admite la presentación de la definición de modelos multidimensionales y modelos tabulares en los niveles de compatibilidad 1103 y inferiores en un formato XML denominado Lenguaje de definición de esquema conceptual con anotaciones de Business Intelligence (CSDLBI). En este artículo se proporciona información general sobre CSDLBI y cómo se usa con los modelos de datos de Analysis Services.
Descripción del propósito de CSDL
El Lenguaje de definición de esquemas conceptuales (CSDL) es un lenguaje basado en XML que describe las entidades, las relaciones y las funciones. CSDL forma parte de Entity Data Framework. Las anotaciones de BI son una extensión diseñada para admitir el modelado de datos mediante Analysis Services.
Aunque CSDL es compatible con Entity Data Framework, no es necesario comprender el modelo entidad-relación ni tener ninguna herramienta especial para generar un modelo tabular o un informe basado en un modelo. Los modelos se compilan mediante herramientas de cliente como Visual Studio con extensiones de proyectos de Analysis Services, también conocidas como SQL Server Data Tools (SSDT) o una API como AMO e implementación del modelo en un servidor.
El servidor de Analysis Services genera el esquema CSDLBI en respuesta a una solicitud de una definición de modelo de un cliente. La aplicación cliente envía una consulta XML al servidor de Analysis Services que hospeda los datos del modelo. En respuesta, el servidor envía un mensaje XML que contiene una definición de las entidades del modelo, utilizando las anotaciones CSDLBI. El cliente de informes usa la información para mostrar los campos, las agregaciones y las medidas disponibles en el modelo. Las anotaciones CSDLBI también proporcionan información sobre cómo agrupar, ordenar y dar formato a los datos.
Trabajar con CSDL
El conjunto de anotaciones CSDLBI que representa cualquier modelo tabular determinado es un documento XML que contiene una colección de entidades, tanto simples como complejas. Las entidades definen las tablas (o dimensiones), las columnas (atributos), las asociaciones (relaciones) y las fórmulas incluidas en las columnas calculadas, medidas o KPI.
No puede modificar estos objetos directamente, sino que debe utilizar las herramientas del cliente y las interfaces de programación de aplicaciones (API) proporcionadas para trabajar con modelos tabulares.
Puede obtener el CSDL para un modelo enviando una solicitud DISCOVER al servidor que hospeda el modelo. La solicitud se debe calificar especificando el servidor y el modelo y, opcionalmente, una vista o una perspectiva. El mensaje devuelto es una cadena XML. Algunos elementos dependen del lenguaje y pueden devolver valores diferentes en función del lenguaje de la conexión actual. Para obtener más información, vea DISCOVER_CSDL_METADATA Conjunto de filas.
Referencia de CSDLBI
La especificación CSDL original (de Entity Data Framework) es suficiente para la mayor parte de las entidades y propiedades necesarias para el modelado. Las anotaciones de BI admiten requisitos especiales de modelos tabulares, propiedades de informes necesarias para los clientes y metadatos adicionales necesarios para los modelos multidimensionales.
A partir de 2012, la versión 1.0 y las versiones posteriores de la especificación CSDLBI se describen en Especificaciones abiertas. La especificación abierta se actualiza periódicamente para que coincida con los cambios en la funcionalidad. Antes de publicar CSDLBI en open Specification, las versiones 1.0 y 1.1 de CSDLBI se documentaban como referencia en MSDN\TechNet. Esta versión temprana de la referencia de CSDLBI proporciona definiciones más detalladas de estructuras y semánticas de CSDLBI que las proporcionadas en la especificación abierta; sin embargo, se debe usar la especificación abierta.
Abrir las versiones 1.0 y posteriores de especificaciones
Referencia de CSDLBI 1.0, 1.1 (archivado)
Consulte también
Para obtener información detallada sobre los elementos individuales en las anotaciones de CSDLBI, consulte Referencia técnica de anotaciones de BI en CSDL.
Para obtener información sobre la especificación de CSDL principal, consulte la especificación CSDL en MSDN.