Расширенные свойства поля для базы данных служб Analysis Services (службы SSRS)

Статья
03/23/2023

Модуль обработки данных СЛУЖБ SQL Server Analysis Services поддерживает расширенные свойства полей. Расширенные свойства полей — это дополнительные свойства, доступные для конкретного источника данных, помимо свойств Value и IsMissing , и поддерживаемые модулем обработки данных. Расширенные свойства не отображаются в области данных отчетах как часть коллекции полей для набора данных отчета. Значения расширенных свойств полей можно включить в отчет с помощью выражений, которые указывают их по именам во встроенной коллекции Fields .

Расширенные свойства включают стандартные свойства и пользовательские. Стандартные свойства — это свойства, общие для нескольких источников данных, сопоставленные с конкретными именами свойств полей и доступные по именам во встроенной коллекции Fields . Пользовательские свойства у каждого поставщика данных свои, и доступны они во встроенной коллекции Fields только при использовании синтаксиса, включающего имя расширенного свойства в виде строки.

При использовании конструктора запросов многомерных выражений Служб Analysis Services в графическом режиме для определения запроса в запрос многомерных выражений автоматически добавляется предопределенный набор свойств ячеек и свойств измерения. При этом могут быть использованы только те расширенные свойства, которые перечислены в запросе MDX данного отчета. В зависимости от отчета может потребоваться изменить текст по умолчанию команды запроса MDX, включив дополнительное измерение или пользовательские свойства, определенные в кубе. Дополнительные сведения о расширенных полях, доступных в источниках данных служб Службы Analysis Services, см. в разделе Создание и использование значений свойств (многомерные выражения).

Работа со свойствами полей в отчете

Расширенные свойства полей включают стандартные свойства и свойства, зависящие от конкретного поставщика данных. Свойства полей не отображаются со списком полей в области Данные отчета , даже если они определены в запросе, сформированном для набора данных; поэтому нельзя перетащить свойства полей в область конструктора отчета. Вместо этого следует перетащить в отчет поле, а затем заменить его свойство Value на то, которое необходимо использовать. Например, если данные ячейки куба уже отформатированы, можно использовать свойство поля FormattedValue с помощью следующего выражения: =Fields!FieldName.FormattedValue.

Для ссылки на расширенное свойство, не являющееся стандартным, используйте в выражении следующий синтаксис:

Fields!ИмяПоля("ИмяСвойства")

Стандартные свойства полей

В большинстве случаев стандартные свойства поля относятся к мерам, уровням или измерениям. Предопределенное свойство поля должно иметь соответствующее значение, хранящееся в источнике данных служб Analysis Services. Если такое значение не существует или, например, указывается свойство поля только для меры на уровне, это свойство возвращает значение NULL.

Для ссылки на предопределенное свойство из выражения можно использовать любой из следующих вариантов синтаксиса:

Fields!ИмяПоля.ИмяСвойства
Fields!ИмяПоля("ИмяСвойства")

В следующей таблице представлены стандартные свойства поля, которые можно использовать.

Свойство	Тип	Описание или ожидаемое значение
Value	Объект	Указывает значение данных поля.
IsMissing	Boolean	Указывает, найдено ли поле в результирующем наборе данных.
UniqueName	String	Возвращает полное имя уровня. Например, значение UniqueName для сотрудника может иметь вид [Сотрудник].[Отдел сотрудника].[Подразделение].&[Продажи].&[Менеджер продаж в Северной Америке].&[272].
BackgroundColor	String	Возвращает цвет фона, заданный в базе данных для этого поля.
Цвет	String	Возвращает цвет переднего плана, заданный в базе данных для этого элемента.
FontFamily	String	Возвращает название шрифта, определенного в базе данных для элемента.
FontSize	String	Возвращает размер шрифта, определенного в базе данных для элемента.
FontWeight	String	Возвращает тип шрифта, определенного в базе данных для элемента.
FontStyle	String	Возвращает стиль шрифта, определенного в базе данных для элемента.
TextDecoration	String	Возвращает специальное форматирование текста, определенное в базе данных для элемента.
FormattedValue	String	Возвращает форматированное значение для меры или ключевую цифру. Например, свойство FormattedValue для поля Sales Amount Quota возвращает значение в формате валюты, такое как 1 124 400,00 р.
Ключ	Объект	Возвращает ключ для уровня.
LevelNumber	Целое число	Для иерархий типа «родители-потомки» возвращает номер уровня или измерения.
ParentUniqueName	String	Для иерархий типа «родители-потомки» это свойство возвращает полное имя родительского уровня.

Примечание.

Значения существуют для этих расширенных свойств полей, только если источник данных (например, куб служб Analysis Services) предоставляет эти значения при запуске отчета и извлекает данные для своих наборов данных. Затем можно ссылаться на эти значения свойства поля из любого выражения с помощью синтаксиса, описанного в следующем разделе. Однако, поскольку эти поля уникальны для данного поставщика данных, изменения соответствующих значений не сохраняются вместе с определением отчета.

Примеры расширенных свойств

В качестве примера расширенных свойств следующий запрос MDX и результирующий набор содержат несколько свойств элементов, доступных из атрибута измерения, определенного в кубе. Это свойства MEMBER_CAPTION, UNIQUENAME, Properties("Day Name"), MEMBER_VALUE, PARENT_UNIQUE_NAME и MEMBER_KEY.

Этот запрос многомерных выражений выполняется в кубе AdventureWorks2022 в базе данных DW AdventureWorks2022, включенной в пример базы данных AdventureWorks2022.

WITH MEMBER [Measures].[DateCaption]   
      AS '[Date].[Date].CURRENTMEMBER.MEMBER_CAPTION'   
   MEMBER [Measures].[DateUniqueName]   
      AS '[Date].[Date].CURRENTMEMBER.UNIQUENAME'   
   MEMBER [Measures].[DateDayName]   
      AS '[Date].[Date].Properties("Day Name")'   
   MEMBER [Measures].[DateValueinOriginalDatatype]   
      AS '[Date].[Date].CURRENTMEMBER.MEMBER_VALUE'   
   MEMBER [Measures].[DateParentUniqueName]   
      AS '[Date].[Date].CURRENTMEMBER.PARENT_UNIQUE_NAME'   
   MEMBER [Measures].[DateMemberKeyinOriginalDatatype]   
      AS '[Date].[Date].CURRENTMEMBER.MEMBER_KEY'   
SELECT {  
   [Measures].[DateCaption],   
   [Measures].[DateUniqueName],   
   [Measures].[DateDayName],   
   [Measures].[DateValueinOriginalDatatype],  
   [Measures].[DateParentUniqueName],  
   [Measures].[DateMemberKeyinOriginalDatatype]  
   } ON COLUMNS , [Date].[Date].ALLMEMBERS ON ROWS   
FROM [Adventure Works]

При его запуске в панели запроса MDX получается результирующий набор из 1158 строк. Первые четыре строки приведены в следующей таблице.

DateCaption	DateUniqueName	DateDayName	DateValueinOriginalDatatype	DateParentUniqueName	DateMemberKeyinOriginalDatatype
All Periods	[Date].[Date].[All Periods]	(null)	(null)	(null)	0
1 июля 2001 г.	[Date].[Date].&[1]	Воскресенье	7/1/2001	[Date].[Date].[All Periods]	1
2 июля 2001 г.	[Date].[Date].&[2]	Понедельник	7/2/2001	[Date].[Date].[All Periods]	2
3 июля 2001 г.	[Date].[Date].&[3]	Вторник	7/3/2001	[Date].[Date].[All Periods]	3

Запросы MDX по умолчанию, созданные при помощи конструктора запросов многомерных выражений в графическом режиме, включают для измерения только свойства MEMBER_CAPTION и UNIQUENAME. По умолчанию эти значения всегда имеют тип String.

Если необходимо получить свойство элемента с его оригинальным типом данных, можно добавить дополнительное свойство MEMBER_VALUE, изменив инструкцию многомерных выражений по умолчанию в текстовом конструкторе запросов. В следующей простой инструкции MDX свойство MEMBER_VALUE добавлено в список получаемых свойств измерения.

SELECT NON EMPTY {[Measures].[Order Count]} ON COLUMNS,   
NON EMPTY { ([Date].[Month of Year].[Month of Year] ) }   
DIMENSION PROPERTIES   
   MEMBER_CAPTION, MEMBER_UNIQUE_NAME, MEMBER_VALUE ON ROWS   
FROM [Adventure Works]  
CELL PROPERTIES   
   VALUE, BACK_COLOR, FORE_COLOR,   
   FORMATTED_VALUE, FORMAT_STRING,   
   FONT_NAME, FONT_SIZE, FONT_FLAGS

Первые четыре строки результата в панели результатов многомерного выражения приведены в следующей таблице.

Месяц года	Число заказов
января	2,481
февраля	2,684
марта	2,749
апреля	2,739

Хотя свойства являются частью многомерного выражения инструкции выборки, они не отражаются в столбцах результирующего набора. Но данные все же доступны отчету при использовании расширенных свойств. В области результатов запроса многомерных выражений в SQL Server Management Studio можно дважды щелкнуть ячейку и просмотреть значения свойств ячейки, если они заданы в кубе. Если дважды щелкнуть ячейку «Число заказов», в которой содержится значение 1379, то откроется всплывающее окно, содержащее следующие свойства ячейки.

Свойство	Значение
CellOrdinal	0
ЗНАЧЕНИЕ	2481
BACK_COLOR	(null)
FORE_COLOR	(null)
FORMATTED_VALUE	2,481
FORMAT_STRING	#, #
FONT_NAME	(null)
FONT_SIZE	(null)
FONT_FLAGS	(null)

Если с помощью этого запроса создать набор данных для отчета и привязать его к таблице, то будет доступно свойство поля по умолчанию VALUE, например =Fields!Month_of_Year!Value. Если это выражение указано в качестве выражения сортировки таблицы, результат будет упорядочен по названиям месяцев в алфавитном порядке, поскольку по умолчанию поле Value имеет тип данных String . Для правильной сортировки таблицы по месяцам с января по декабрь воспользуйтесь следующим выражением.

=Fields!Month_of_Year("MEMBER_VALUE")

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

См. также

Выражения (построитель отчетов и службы SSRS)
Встроенные коллекции в выражениях (построитель отчетов и службы SSRS)
Коллекция полей набора данных (построитель отчетов и службы SSRS)