Общие сведения о языке определения концептуальной схемы (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 см. в техническом справочнике по заметкам бизнес-аналитики в CSDL.
Сведения о базовой спецификации CSDL см. в спецификации CSDL на сайте MSDN.