Condividi tramite

Set di righe DISCOVER_CSDL_METADATA

  • Articolo

Vengono restituite informazioni su un modello di dati tabulari, inclusa la definizione del modello nel linguaggio CSDL (Conceptual Schema Definition Language). CSDL è un XML Schema utilizzato da Entity Data Framework utilizzato per la comunicazione tra un server Analysis Services e il client Power View. Per ulteriori informazioni sui modelli di dati tabulari, vedere Introduzione alle estensioni CSDL per i modelli tabulari.

Il contesto di sicurezza del comando influisce sul set di righe restituito. Le autorizzazioni di lettura nell'istanza di Analysis Services sono necessarie per ottenere la definizione CSDL dal server.

L'identificatore di lingua del client, tramite cui viene inviata la richiesta del set di righe, è incluso nella stringa di connessione per il comando e influisce sulla lingua visualizzata nelle varie proprietà restituite come parte del set di righe. Per informazioni sulle proprietà e sulla descrizione che l'identificatore di lingua può influenzare, vedere la sezione relativa alle osservazioni.

Si applica a: i modelli tabulari

Colonne del set di righe

Nel set di righe DISCOVER_CSDL_METADATA sono contenute le colonne seguenti.

Nome colonna

Indicatore del tipo

Restrizione

Descrizione

CATALOG_NAME

DBTYPE_WSTR

Sì

Viene specificato il nome del database per il quale viene richiesta la descrizione CSDL. Se omesso, viene utilizzato il database corrente.

Il set di righe DISCOVER_CSDL_METADATA deve essere limitato tramite questa colonna.

PERSPECTIVE_NAME

DBTYPE_WSTR

Sì

Viene specificato il nome di una prospettiva che è stata definita nel modello specificato da CATALOG_NAME.

Il set di righe DISCOVER_CSDL_METADATA può essere facoltativamente limitato tramite questa colonna.

Questa restrizione risulta necessaria per le query CSDL sui database multidimensionali che contengono più di un cubo o una prospettiva. Questa funzionalità è stata introdotta in SQL Server 2012 SP1.

METADATA

DBTYPE_WSTR

Stringa contenente la definizione XML di un'origine dati e delle relative proprietà, in base allo schema CSDL.

Osservazioni

DISCOVER_CSDL_METADATA dispone dei requisiti seguenti:

  • La richiesta DISCOVER non verrà completata se un database non viene specificato tramite la restrizione CATALOG_NAME.

  • Se una prospettiva viene fornita come restrizione, lo stesso set di righe CSDL viene restituito come per il modello. Tuttavia, tutti gli oggetti che sono nel modello ma non inclusi nella prospettiva specificata sono contrassegnati come Hidden = True.

  • Per tabelle e colonne, tramite la richiesta DISCOVER viene restituito sempre un valore dalla dimensione del cubo. Se la proprietà della dimensione del cubo non è impostata, tramite la richiesta viene restituito il valore dalla dimensione.

  • Tramite la richiesta DISCOVER non può essere restituita alcuna misura né colonne calcolate contenenti un errore semantico.

  • Tramite la richiesta DISCOVER non verrà restituita alcuna informazione per oggetti che non dispongono di valori di proprietà. Tramite la richiesta DISCOVER non verranno restituiti neanche i valori degli attributi in cui viene utilizzato il valore predefinito.

È possibile che nella stringa XML restituita nel set di righe siano incluse le proprietà o i valori specifici della lingua. Se si invia ad esempio la richiesta del set di righe da un client con LCID 0403 (spagnolo catalano), tramite la proprietà verranno restituiti i valori seguenti in modo appropriato per lo spagnolo catalano. Se nel server non sono disponibili traduzioni, viene restituita la stringa per la lingua predefinita del server.

  • Didascalia

  • Qualificatore

  • SortDirection

  • IsRightToLeft

Esempio

Nella query XMLA seguente viene restituita la rappresentazione CSDL del database, Model, nella connessione corrente.

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

Utilizzo di ADOMD.NET per restituire il set di righe

Quando si utilizzano ADOMD.NET e il set di righe dello schema per recuperare metadati, è possibile utilizzare il GUID o la stringa per fare riferimento a un oggetto set di righe dello schema nel metodo GetSchemaDataSet. Per ulteriori informazioni, vedere Utilizzo di set di righe dello schema in ADOMD.NET.

Nella tabella seguente vengono forniti il GUID e i valori stringa che identificano questo set di righe.

Argomento

Valore

GUID

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

ADOMDNAME

Csdl

Vedere anche

Riferimento

Set di righe dello schema di Analysis Services

Concetti

Introduzione alle estensioni CSDL per i modelli tabulari