Panoramica del linguaggio CSDLBI (Conceptual Schema Definition Language)

Si applica a: SQL Server Analysis Services Azure Analysis Services Power BI Premium

Analysis Services supporta la presentazione della definizione di modelli multidimensionali e tabulari a livello di compatibilità 1103 e inferiore in un formato XML denominato Conceptual Schema Definition Language con annotazioni di Business Intelligence (CSDLBI). Questo articolo offre una panoramica di CSDLBI e del modo in cui viene usato con i Analysis Services dati.

Informazioni sul ruolo del linguaggio CSDL

Conceptual Schema Data Language (CSDL) è un linguaggio basato su XML tramite cui vengono descritte entità, relazioni e funzioni. CSDL è definito come parte di Entity Data Framework. Le annotazioni bi sono un'estensione progettata per supportare la modellazione dei dati Analysis Services.

Anche se CSDL è conforme a Entity Data Framework, non è necessario conoscere il modello entità-relazione o disporre di strumenti speciali per compilare un modello tabulare o un report basato su un modello. I modelli vengono compilati usando strumenti client come Visual Studio con estensioni di progetti Analysis Services, note anche come SQL Server Data Tools (SSDT), o un'API come AMO e la distribuzione del modello in un server.

Lo schema CSDLBI viene generato dal server Analysis Services in risposta a una richiesta di una definizione di modello da un client. L'applicazione client invia una query XML al server Analysis Services che ospita i dati del modello. In risposta, il server invia un messaggio XML che contiene una definizione delle entità nel modello,utilizzando le annotazioni CSDLBI. Il client di creazione report quindi utilizza le informazioni per presentare i campi, le aggregazioni e le misure disponibili nel modello. Le annotazioni CSDLBI forniscono inoltre informazioni sul raggruppamento, l'ordinamento e la formattazione dei dati.

Utilizzo di CSDL

Il set di annotazioni CSDLBI che rappresenta un qualsiasi modello tabulare particolare è un documento XML contenente una raccolta di entità semplici e complesse. Le entità definiscono tabelle (o dimensioni), colonne (attributi), associazioni (relazioni) e formule incluse in colonne calcolate, misure o indicatori KPI.

Non è possibile modificare questi oggetti direttamente, ma è necessario utilizzare gli strumenti client e le API disponibili per l'utilizzo dei modelli tabulari.

È possibile ottenere il linguaggio CSDL per un modello inviando una richiesta DISCOVER al server in cui è ospitato il modello. La richiesta deve essere qualificata specificando il server e il modello e, facoltativamente, una vista o una prospettiva. Il messaggio restituito è una stringa XML. Determinati elementi dipendono dal linguaggio e possono restituire valori diversi a seconda del linguaggio della connessione corrente. Per altre informazioni, vedere Set DISCOVER_CSDL_METADATA set di righe.

Informazioni di riferimento su CSDLBI

La specifica CSDL originale di Entity Data Framework fornisce la maggior parte delle entità e proprietà necessarie per supportare la modellazione. Le annotazioni bi supportano requisiti speciali dei modelli tabulari, proprietà di report necessarie per i client e metadati aggiuntivi necessari per i modelli multidimensionali.

A partire dalla versione 2012, la versione 1.0 e le versioni successive della specifica CSDLBI sono descritte in Open Specifications. La specifica Open viene aggiornata periodicamente in modo da coincidere con le modifiche delle funzionalità. Prima di pubblicare CSDLBI in Open Specification, le versioni 1.0 e 1.1 di CSDLBI erano documentate come riferimento in MSDN\TechNet. Questa versione iniziale del riferimento CSDLBI fornisce definizioni più approfondite delle strutture e della semantica CSDLBI rispetto a quelle fornite nella specifica open, tuttavia è consigliabile usare la specifica open.

Open Specification 1.0 e versioni successive

[MS-CSDLBI]: Formato del file di definizione dello schema concettuale con annotazioni di Business Intelligence

Informazioni di riferimento su CSDLBI 1.0, 1.1 (archiviato)

Informazioni di riferimento su CSDLBI 1.0, 1.1

Vedi anche

Per informazioni dettagliate sui singoli elementi nelle annotazioni CSDLBI, vedere Technical Reference for BI Annotations to CSDL.
Per informazioni sulla specifica CSDL di base, vedere la specifica CSDL in MSDN.