Condividi tramite


Panoramica di Conceptual Schema Definition Language (CSDLBI)

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

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

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 tramite 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. È possibile compilare modelli usando strumenti client come Visual Studio con estensioni di progetti di Analysis Services, note anche come SQL Server Data Tools (SSDT) o un'API come AMO e distribuire il modello in un server.

Lo schema CSDLBI viene generato dal server Analysis Services in risposta a una richiesta di 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 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 per i modelli tabulari, le proprietà di creazione di report necessarie per i client e i metadati aggiuntivi necessari per i modelli multidimensionali.

A partire dal 2012, la versione 1.0 e le versioni successive della specifica CSDLBI sono descritte in Specifiche aperte. La specifica aperta viene aggiornata periodicamente per coincidere con le modifiche apportate alle funzionalità. Prima di pubblicare CSDLBI in Open Specification, le versioni CSDLBI 1.0 e 1.1 sono state documentate come riferimento su MSDN\TechNet. Questa versione iniziale del riferimento CSDLBI fornisce definizioni più approfondite delle strutture e della semantica CSDLBI rispetto a quelle fornite nella specifica aperta, tuttavia, è consigliabile usare la specifica aperta.

Open Specification versioni 1.0 e successive

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

Riferimento CSDLBI 1.0, 1.1 (archiviato)

Riferimenti a CSDLBI 1.0, 1.1

Vedi anche

Per informazioni dettagliate sui singoli elementi nelle annotazioni CSDLBI, vedere Riferimento tecnico per le annotazioni BI in CSDL.
Per informazioni sulla specifica CSDL di base, vedere la specifica CSDL su MSDN.