Поделиться через


Общие сведения о языке определения концептуальной схемы (CSDLBI)

Применимо к: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Службы Analysis Services поддерживают представление определения многомерных моделей и табличных моделей на 1103 и более низких уровнях совместимости в формате XML, называемом языком определения концептуальной схемы с заметками бизнес-аналитики (CSDLBI). В этой статье приводятся общие сведения о CSDLBI и его использовании с моделями данных служб Analysis Services.

Основные сведения о роли языка CSDL

Язык концептуальной схемы данных (CSDL) — это язык на основе XML, описывающий сущности, связи и функции. Язык CSDL определен как часть платформы Entity Data Framework. Заметки бизнес-аналитики — это расширение, предназначенное для поддержки моделирования данных с помощью служб Analysis Services.

Несмотря на то что язык CSDL совместим с платформой Entity Data Framework, для построения с его помощью табличной модели или основанного на модели отчета не требуются ни знания модели «сущность-связь», ни какие-либо специальные средства. Модели создаются с помощью клиентских инструментов, таких как Visual Studio с расширениями проектов служб Analysis Services, также известными как SQL Server Data Tools (SSDT), или API, например AMO, и развертывать модель на сервере.

Схема CSDLBI создается сервером служб Analysis Services в ответ на запрос определения модели от клиента. Клиентское приложение отправляет XML-запрос серверу служб Analysis Services, на котором размещены данные модели. В ответ сервер отправляет XML-сообщение, содержащее определение сущностей в модели с использованием заметок CSDLBI. С помощью этих сведений клиентское средство создания отчетов представляет поля, статистические выражения и меры, доступные в модели. Заметки CSDLBI также содержат сведения о том, как группировать, сортировать и форматировать данные.

Работа с языком CSDL

Набор заметок CSDLBI, представляющий любую конкретную табличную модель, — это XML-документ, содержащий коллекцию сущностей, как простых, так и сложных. Сущности определяют таблицы (или измерения), столбцы (атрибуты), ассоциации (связи) и формулы, включенные в вычисляемые столбцы, меры и ключевые показатели эффективности.

Эти объекты нельзя изменять непосредственно, для их изменения следует использовать клиентские средства и API-интерфейсы для работы с табличными моделями.

CSDL-код для модели можно получить, отправив запрос DISCOVER на сервер, на котором размещается модель. Запрос следует уточнить, указав сервер и модель, а также при необходимости представление или перспективу. Возвращаемое сообщение является XML-строкой. Некоторые элементы зависят от языка и могут возвращать разные значения в зависимости от языка текущего соединения. Дополнительные сведения см. в разделе DISCOVER_CSDL_METADATA наборе строк.

Справочник по CSDLBI

Изначальная спецификация языка CSDL (для платформы Entity Data Framework) предоставляет большинство сущностей и свойств, необходимых для моделирования. Заметки бизнес-аналитики поддерживают особые требования к табличным моделям, свойствам отчетов, необходимым для клиентов, и дополнительным метаданным, необходимым для многомерных моделей.

Начиная с 2012 года, версия 1.0 и последующие версии спецификации CSDLBI описаны в разделе Открытые спецификации. Открытая спецификация периодически обновляется в соответствии с изменениями в функциональных возможностях. Перед публикацией CSDLBI в открытой спецификации csdlbi версии 1.0 и 1.1 были задокументированы в виде ссылки на MSDN\TechNet. В этой ранней версии справочника по CSDLBI содержатся более подробные определения структур и семантики CSDLBI, чем в открытой спецификации, однако следует использовать открытую спецификацию.

Open Specification версии 1.0 и выше

[MS-CSDLBI]: формат файла определения концептуальной схемы с заметками бизнес-аналитики

Справочник по CSDLBI 1.0, 1.1 (архив)

Справочник по CSDLBI 1.0, 1.1

См. также раздел

Подробные сведения об отдельных элементах в заметках CSDLBI см. в техническом справочнике по заметкам бизнес-аналитики в CSDL.
Сведения о базовой спецификации CSDL см. в спецификации CSDL на сайте MSDN.