概念スキーマ定義言語 (CSDLBI) の概要

[アーティクル]
12/23/2023

適用対象: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Analysis Services では、ビジネスインテリジェンス注釈付き概念スキーマ定義言語 (CSDLBI) と呼ばれる XML 形式の 1103 以下の互換性レベルでの多次元モデルと表形式モデルの定義の表示がサポートされています。この記事では、CSDLBI の概要と、それが Analysis Services データモデルでどのように使用されるかについて説明します。

CSDL の役割について

概念スキーマ定義言語 (CSDL) は、エンティティ、リレーションシップ、および関数を記述する XML ベースの言語です。 CSDL は Entity Data Framework の一部として定義されます。 BI 注釈は、Analysis Services を使用したデータモデリングをサポートするように設計された拡張機能です。

CSDL は Entity Data Framework に準拠していますが、エンティティとリレーションシップのモデルについての理解や、テーブルモデルまたはモデルに基づくレポートを構築するための専用ツールは必要ありません。モデルを構築するには、Visual Studio などのクライアントツールと Analysis Services プロジェクト拡張機能 (SQL Server Data Tools (SSDT) とも呼ばれます)、または AMO などの API を使用してモデルをサーバーにデプロイします。

CSDLBI スキーマは、クライアントからのモデル定義の要求に応じて Analysis Services サーバーによって生成されます。クライアントアプリケーションは、モデルデータをホストする Analysis Services サーバーに XML クエリを送信します。その応答として、サーバーはモデル内のエンティティの定義を含む XML メッセージを CSDLBI 注釈を使用して送信します。その後、レポートクライアントは情報を使用して、モデルで使用できるフィールド、集計、メジャーを表示します。 CSDLBI 注釈は、データのグループ化、並べ替え、および書式設定の方法に関する情報も提供します。

CSDL の操作

特定のテーブルモデルを表す CSDLBI 注釈のセットは、単純型と複合型の両方のエンティティのコレクションを含む XML ドキュメントです。エンティティは、計算列、メジャーまたは KPI に含まれるテーブル (またはディメンション)、列 (属性)、関連付け (リレーションシップ) および式を定義します。

これらのオブジェクトを直接変更することはできません。テーブルモデルを操作するには、クライアントツールおよびアプリケーションプログラミングインターフェイス (API) を使用してください。

モデルの CSDL を取得するには、モデルをホストするサーバーに DISCOVER 要求を送信します。この要求は、サーバーとモデルのほか、必要に応じてビューまたはパースペクティブを指定して修飾する必要があります。返されるメッセージは、XML 文字列です。一部の要素は言語に依存しているため、現在の接続の言語に応じて異なる値が返される可能性があります。詳細については、「DISCOVER_CSDL_METADATA行セット」を参照してください。

CSDLBI リファレンス

元の CSDL 仕様 (Entity Data Framework に基づく) では、モデリングのサポートに必要なエンティティとプロパティの大半が規定されています。 BI 注釈では、テーブルモデルの特別な要件、クライアントに必要なレポートプロパティ、および多次元モデルに必要な追加のメタデータがサポートされています。

2012 年以降、バージョン 1.0 以降の CSDLBI 仕様については、オープン仕様に関するページを参照してください。 Open Specification は、機能の変更に合わせて定期的に更新されます。 CSDLBI を Open Specification に公開する前は、CSDLBI バージョン 1.0 と 1.1 が MSDN\TechNet のリファレンスとして文書化されていました。この初期バージョンの CSDLBI リファレンスでは、オープン仕様で提供されるよりも、CSDLBI 構造体とセマンティクスの詳細な定義が提供されますが、オープン仕様を使用する必要があります。

仕様バージョン 1.0 以降を開く

[MS-CSDLBI]: ビジネスインテリジェンス注釈を使用した概念スキーマ定義ファイル形式

CSDLBI 1.0、1.1 リファレンス (アーカイブ済み)

CSDLBI 1.0、1.1 リファレンス

こちらもご覧ください

CSDLBI 注釈内の個々の要素の詳細については、「CSDL への BI 注釈のテクニカルリファレンス」を参照してください。
CSDL のコア仕様については、MSDN の CSDL 仕様を参照してください。

次の方法で共有