DISCOVER_CSDL_METADATA, conjunto de filas

Devuelve información sobre un modelo de datos tabular, lo cual incluye la definición del modelo en el Lenguaje de definición de esquemas conceptuales (CSDL). CSDL es un esquema XML utilizado por Entity Data Framework para la comunicación entre un servidor de Analysis Services y el cliente de Power View. Para obtener más información acerca de los modelos de datos, vea Introducción a las extensiones de CSDL para los modelos tabulares.

El contexto de seguridad del comando afecta al conjunto de filas que se devuelve. Se requiere que los permisos Read en la instancia de Analysis Services obtengan la definición de CSDL desde servidor.

El identificador de idioma del cliente que emite la solicitud del conjunto de filas se incluye en la cadena de conexión para el comando, y afecta al idioma que se muestra en varias propiedades que se devuelven como parte del conjunto de filas. Para obtener información acerca de las propiedades y la descripción que pueden verse afectadas por el identificador de idioma, vea la sección Comentarios.

Se aplica a: modelos tabulares

Columnas del conjunto de filas

El conjunto de filas DISCOVER_CSDL_METADATA contiene las siguientes columnas.

Nombre de columna	Indicador de tipo	Restricción	Descripción
CATALOG_NAME	DBTYPE_WSTR	Sí	Especifica el nombre de la base de datos cuya descripción CSDL se solicita. Si se omite, se utiliza la base de datos actual. El conjunto de filas DISCOVER_CSDL_METADATA debe restringirse mediante esta columna.
PERSPECTIVE_NAME	DBTYPE_WSTR	Sí	Especifica el nombre de una perspectiva que se ha definido en el modelo especificado por CATALOG_NAME. Si se desea, el conjunto de filas DISCOVER_CSDL_METADATA puede restringirse mediante esta columna. Esta restricción es necesaria para las consultas CSDL en bases de datos multidimensionales que contienen más de un cubo o perspectiva. Esta funcionalidad se presentó por primera vez SQL Server 2012 SP1.
METADATA	DBTYPE_WSTR		Cadena que contiene la definición XML de un origen de datos y sus propiedades, de acuerdo con el esquema CSDL.

Comentarios

DISCOVER_CSDL_METADATA tiene los requisitos siguientes:

• La solicitud DISCOVER producirá un error si no se especifica una base de datos mediante la restricción CATALOG_NAME.

• Si una perspectiva se proporciona como una restricción, se devuelve el mismo conjunto de filas de CSDL que se devolvió para el modelo. Sin embargo, todos los objetos que estén en el modelo pero que no se incluyan en la perspectiva especificada se marcan como Hidden = TRUE.

• Para las tablas y columnas, la solicitud DISCOVER siempre devuelve un valor del cubo. Si no está establecida la propiedad de dimensión del cubo, la solicitud devuelve el valor de la dimensión.

• La solicitud DISCOVER no puede devolver ninguna medida ni columna calculada que contenga un error semántico.

• La solicitud DISCOVER no devolverá ninguna información para los objetos que no tienen valores de propiedad. La solicitud DISCOVER tampoco devolverá los valores para los atributos que utilizan el valor predeterminado.

La cadena XML que se devuelve en el conjunto de filas puede incluir las propiedades o los valores específicos del idioma siguientes. Por ejemplo, si se emite la solicitud de conjunto de filas desde un cliente con el LCID 0403 (catalán de España), la propiedad devolverá los valores siguientes correspondientes para dicho idioma. Si las traducciones no están disponibles en el servidor, se devuelve la cadena para el idioma predeterminado del servidor.

• Caption

• Qualifier

• SortDirection

• IsRightToLeft

Ejemplo

La siguiente consulta XMLA devuelve la representación CSDL de la base de datos Model en la conexión actual.

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

Usar ADOMD.NET para devolver el conjunto de filas

Cuando se utilizan ADOMD.NET y el conjunto de filas de esquema para recuperar metadatos, puede utilizar el GUID o una cadena para hacer referencia a un objeto de conjunto de filas de esquema del método GetSchemaDataSet. Para obtener más información, vea Trabajar con conjuntos de filas de esquema en ADOMD.NET.

La tabla siguiente proporciona el GUID y los valores de cadena que identifican este conjunto de filas.

Argumento	Valor
GUID	87B86062-21C3-460F-B4F8-5BE98394F13B
ADOMDNAME	Csdl

Vea también

Referencia

Conjuntos de filas de esquema de Analysis Services

Conceptos

Introducción a las extensiones de CSDL para los modelos tabulares