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

Набор строк DISCOVER_CSDL_METADATA

  • Статья

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

Контекст безопасности команды влияет на возвращаемый набор строк. Для получения определения CSDL с сервера необходимы разрешения на чтение в экземпляре служб Analysis Services.

Идентификатор языка клиента, который отправляет запрос набора строк, вводится в строку подключения для команды и влияет на язык, который отображается в нескольких свойствах, возвращаемых в составе набора строк. Сведения о свойствах и описании, которые могут зависеть от идентификатора языка, содержатся в разделе «Примечания».

Область применения: табличные модели

Столбцы наборов строк

Набор строк DISCOVER_CSDL_METADATA содержит следующие столбцы.

Имя столбца

Индикатор типа

Ограничение

Описание

CATALOG_NAME

DBTYPE_WSTR

Да

Задает имя базы данных, для которой запрошено описание CSDL. Если отсутствует, используется текущая база данных.

Набор строк DISCOVER_CSDL_METADATA необходимо ограничить с помощью этого столбца.

PERSPECTIVE_NAME

DBTYPE_WSTR

Да

Задает имя перспективы, определенной в модели, заданной с помощью CATALOG_NAME.

Набор строк DISCOVER_CSDL_METADATA при необходимости может быть ограничен по этому столбцу.

Такое ограничение может потребоваться в запросах языка CSDL к многомерным базам данных, которые содержат несколько кубов или перспектив. Эта возможность появилась в SQL Server 2012 с пакетом обновления 1 (SP1).

METADATA

DBTYPE_WSTR

Строка, содержащая XML-определение источника данных и его свойств в соответствии со CSDL-схемой.

Замечания

К DISCOVER_CSDL_METADATA предъявляются следующие требования.

  • Если база данных не указана с использованием ограничения CATALOG_NAME, запрос DISCOVER завершится неудачей.

  • Если перспектива представлена в качестве ограничения, то возвращается тот же набор строк CSDL, что и для модели. Однако все объекты, которые имеются в модели, но не включены в указанную перспективу, помечаются как Hidden = True.

  • Для таблиц и столбцов запрос DISCOVER всегда выдает значение из измерения куба. Если не задано свойство измерения куба, то запрос возвращает значение из этого измерения.

  • Запрос DISCOVER не может возвращать измерения или вычисляемые столбцы, содержащие семантические ошибки.

  • Запрос DISCOVER не возвратит никаких сведений для объектов, которые не имеют значений свойств. Запрос DISCOVER также не возвращает значения для атрибутов, которые используют значение по умолчанию.

Строка XML, которая возвращается в наборе строк, может включать следующие свойства для конкретного языка или значения. Например, если выполнен запрос набора строк от клиента, имеющего идентификатор LCID 0403 (каталонский испанский), свойство возвратит следующие значения, необходимые для языка «каталонский испанский». Если переводы недоступны на сервере, возвращается строка для языка сервера по умолчанию.

  • Заголовок

  • Квалификатор

  • SortDirection

  • IsRightToLeft

Пример

Следующий запрос XML для аналитики возвращает CSDL-представление базы данных Model для текущего соединения.

<Discover xmlns="urn:schemas-microsoft-com:xml-analysis">
<RequestType>DISCOVER_CSDL_METADATA</RequestType>
    <Restrictions>
<RestrictionList>
<CATALOG_NAME>Model</CATALOG_NAME>
</RestrictionList>
</Restrictions>
    <Properties>
<PropertyList>
                 <FORMAT>Tabular</FORMAT>
   </PropertyList>
</Properties>
</Discover>

Использование ADOMD.NET для возврата набора строк

Если для получения метаданных используется ADOMD.NET и набор строк схемы, то для ссылки на объект набора строк схемы в методе GetSchemaDataSet вы можете использовать идентификатор GUID или строку. Дополнительные сведения см. в разделе Работа с наборами строк схемы в ADOMD.NET.

В следующей таблице указываются значения строки и идентификатора GUID, определяющие этот набор строк.

Аргумент

Значение

GUID

87B86062-21C3-460F-B4F8-5BE98394F13B

ADOMDNAME

Csdl

См. также

Справочник

Наборы строк схемы служб Analysis Services

Основные понятия

Введение в расширения языка CSDL для табличных моделей