Внутренние свойства элементов (многомерные выражения)
Как поставщик, выполняющий требования раздела OLAP спецификации OLE DB, принятой в марте 1999 года (версия 2.6), службы Microsoft SQL Server Службы Analysis Services поддерживают внутренние свойства элементов, указанные в этом разделе.
.gif "Примечание") Примечание |
|---|
Другие поставщики (не службы SQL Server Службы Analysis Services) могут поддерживать дополнительные внутренние свойства элементов. Дополнительные сведения о внутренних свойствах элементов, поддерживаемых другими поставщиками, см. в документации по этим поставщикам. |
Типы свойств элементов
Службы SQL Server Службы Analysis Services поддерживают два типа внутренних свойств элементов.
Свойства элементов, зависящие от контекста
Эти свойства элементов должны использоваться в контексте конкретного измерения или уровня и передавать значения для каждого элемента заданного измерения или уровня.Свойства элементов, не зависящие от контекста
Эти свойства элементов нельзя использовать в контексте конкретного измерения или уровня; они передают значения для всех элементов оси.
Независимо от зависимости внутреннего свойства элемента от контекста, действуют следующие правила их использования:
Можно указывать только те внутренние свойства элементов, которые связаны с элементами измерения, проецируемым на оси.
В одном запросе можно одновременно обращаться к свойствам элементов как зависящим, так и не зависящим от контекста.
Для обращения к свойству используется ключевое слово PROPERTIES.
В следующих разделах описаны внутренние свойства элементов, доступные в службах SQL Server Службы Analysis Services (зависящие и не зависящие от контекста), а также использование ключевого слова PROPERTIES со свойствами каждого типа.
Свойства элементов, зависящие от контекста
Все элементы измерения и уровня поддерживают группу внутренних свойств, зависящих от контекста. Эти свойства перечислены в следующей таблице.
Свойство |
Описание |
|---|---|
ID |
Внутренний идентификатор элемента. |
Key |
Значение, хранящееся в столбце MEMBER_KEY набора строк схемы MEMBERS для данного элемента. |
Name |
Имя элемента. |
Синтаксис ключевого слова PROPERTIES для свойств, зависящих от контекста
Данные свойства элементов используются в контексте конкретного измерения или уровня и передают значения для каждого элемента заданного измерения или уровня.
Для свойств элемента измерения перед именем свойства указывается имя измерения, к которому относится свойство. Правильный синтаксис показан в следующем примере.
DIMENSION PROPERTIES Dimension.Property_name
Имя свойства элемента уровня может быть предварено только именем уровня или (для дополнительного уточнения) как именем измерения, так и и именем уровня. Правильный синтаксис показан в следующем примере.
DIMENSION PROPERTIES [Dimension.]Level.Property_name
Необходимо вернуть список имен всех указанных элементов в измерении [Sales]. Чтобы получить список этих имен, в запрос многомерных выражений включена следующая инструкция:
DIMENSION PROPERTIES [Sales].Name
Свойства элементов, не зависящие от контекста
Все элементы поддерживают группу внутренних свойств элементов, одинаковых вне зависимости от контекста. Эти свойства несут дополнительные сведения, используемые приложениями для создания более удобной пользовательской среды.
В следующей таблице перечислены внутренние свойства, которые поддерживаются службами SQL Server Службы Analysis Services и не зависят от контекста.
| Примечание |
|---|
Столбцы в наборе строк схемы MEMBERS поддерживают внутренние свойства элементов, перечисленные в следующей таблице. Дополнительные сведения о наборе строк схемы MEMBERS см. в разделе Набор строк MDSCHEMA_MEMBERS. |
Свойство |
Описание |
|---|---|
ACTION_TYPE |
Битовая маска, определяющая типы действий над элементом. Это свойство может принимать одно из следующих значений:
|
CAPTION |
Эквивалентно MEMBER_CAPTION. |
CHILDREN_CARDINALITY |
Количество потомков элемента. Значение этого свойства может быть приблизительным, поэтому не стоит рассчитывать на него для определения точного числа. Поставщики должны возвращать возможное наивернейшее приблизительное значение. |
CUBE_NAME |
Имя куба, которому принадлежит элемент. |
CUSTOM_ROLLUP |
Пользовательское выражение элемента. |
CUSTOM_ROLLUP_PROPERTIES |
Пользовательские свойства элемента. |
DESCRIPTION |
Понятное описание элемента. |
DIMENSION_UNIQUE_NAME |
Уникальное имя измерения, которому принадлежит элемент. Для поставщиков, формирующих уникальные имена путем использования квалификаторов, компоненты имени разделяются между собой. |
HIERARCHY_UNIQUE_NAME |
Уникальное имя иерархии. Если элемент принадлежит нескольким иерархиям, свойство содержит строку для каждой из этих иерархий. Для поставщиков, формирующих уникальные имена путем использования квалификаторов, компоненты имени разделяются между собой. |
IS_DATAMEMBER |
Логическое значение, указывающее, является ли элемент элементом данных. |
KEYx |
Ключ для элемента, где x — это начинающийся с нуля порядковый номер ключа. Значение KEY0 доступно для составных и несоставных ключей, а значения KEY1, KEY2 и т. д.— только для составных ключей. Key0, Key1, Key2 и т. д. вместе образуют составной ключ. |
LCIDx |
Перевод заголовка элемента в шестнадцатеричное значение языкового стандарта, где x — шестнадцатеричное значение языкового стандарта (например LCID1009 для канадского английского). Доступно, только если перевод имеет столбец заголовков, привязанный к источнику данных. |
LEVEL_NUMBER |
Расстояние от элемента до корня иерархии. Корневой уровень является нулевым. |
LEVEL_UNIQUE_NAME |
Уникальное имя уровня, которому принадлежит элемент. Для поставщиков, формирующих уникальные имена путем использования квалификаторов, компоненты имени разделяются между собой. |
MEMBER_CAPTION |
Метка или заголовок, связанный с элементом. Заголовок используется главным образом при отображении элемента. Если заголовок отсутствует, запрос возвращает MEMBER_NAME. |
MEMBER_KEY |
Значение ключа элемента в исходном типе данных. Параметр MEMBER_KEY сохранен в целях обратной совместимости. Параметр MEMBER_KEY имеет то же самое значение, что и KEY0 для несоставного ключа, и имеет значение NULL для составных ключей. |
MEMBER_NAME |
Имя элемента. |
MEMBER_TYPE |
Тип элемента. Это свойство может принимать одно из следующих значений:
Значение MDMEMBER_TYPE_FORMULA имеет больший приоритет, чем MDMEMBER_TYPE_MEASURE. Поэтому, если в измерении мер есть формула (вычисляемый элемент), то свойством MEMBER_TYPE для вычисляемого элемента будет MDMEMBER_TYPE_FORMULA. |
MEMBER_UNIQUE_NAME |
Уникальное имя элемента. Для поставщиков, формирующих уникальные имена путем использования квалификаторов, компоненты имени разделяются между собой. |
MEMBER_VALUE |
Значение элемента в исходном типе данных. |
PARENT_COUNT |
Количество родительских элементов данного элемента. |
PARENT_LEVEL |
Расстояние от родительского элемента данного элемента до корневого уровня иерархии. Корневой уровень является нулевым. |
PARENT_UNIQUE_NAME |
Уникальное имя родительского элемента данного элемента. Для элементов на корневом уровне свойство возвращает значение NULL. Для поставщиков, формирующих уникальные имена путем использования квалификаторов, компоненты имени разделяются между собой. |
SKIPPED_LEVELS |
Количество пропущенных уровней элемента. |
UNARY_OPERATOR |
Унарный оператор элемента. |
Синтаксис ключевого слова PROPERTIES для свойств, не зависящих от контекста
Для обращения к внутреннему свойству элемента, не зависящему от контекста, используется следующий синтаксис ключевого слова PROPERTIES.
DIMENSION PROPERTIES Property
Обратите внимание, что такой синтаксис не позволяет указывать для этого свойства измерение или уровень, поскольку внутреннее контекстно-независимое свойство элемента применяется ко всем элементам оси.
Например, инструкция многомерных выражений, обращающаяся к внутреннему свойству элемента DESCRIPTION, будет иметь следующий синтаксис:
DIMENSION PROPERTIES DESCRIPTION
Инструкция возвращает описание каждого элемента в оси измерения. Если добавить в качестве квалификатора свойства измерение или уровень, например Dimension.DESCRIPTION или Level.DESCRIPTION, то инструкция будет недопустимой.
Пример
В следующем примере возвращается количество посредников, продажи которых снизились по сравнению с предыдущим периодом, на основании выбранных пользователем значений элемента State-Province, вычисленных с помощью функции Aggregate. Функции Hierarchize (многомерные выражения) и DrilldownLevel (многомерные выражения) используются для возвращения показателей падения продаж для категорий продуктов в измерении Product. Функция Properties (многомерные выражения) возвращает уникальные имена родительских элементов для оси столбцов.
WITH MEMBER Measures.[Declining Reseller Sales] AS
Count
(Filter
(Existing
(Reseller.Reseller.Reseller)
, [Measures].[Reseller Sales Amount] <
(
[Measures].[Reseller Sales Amount]
,[Date].Calendar.PrevMember
)
)
)
MEMBER [Geography].[State-Province].x AS
Aggregate
(
{[Geography].[State-Province].&[WA]&[US]
, [Geography].[State-Province].&[OR]&[US]
}
)
SELECT NON EMPTY HIERARCHIZE
(AddCalculatedMembers
(
{DrillDownLevel
({[Product].[All Products]})
}
)
) DIMENSION PROPERTIES PARENT_UNIQUE_NAME ON COLUMNS
FROM [Adventure Works]
WHERE
(
[Geography].[State-Province].x
, [Date].[Calendar].[Calendar Quarter].&[2003]&[4]
,[Measures].[Declining Reseller Sales]
)
Следующий пример возвращает переведенный заголовок элемента категории продукта в измерении Product куба Adventure Works для указанных языковых стандартов.
WITH
MEMBER Measures.CategoryCaption AS Product.Category.CurrentMember.MEMBER_CAPTION
MEMBER Measures.SpanishCategoryCaption AS Product.Category.CurrentMember.Properties("LCID3082")
MEMBER Measures.FrenchCategoryCaption AS Product.Category.CurrentMember.Properties("LCID1036")
SELECT
{ Measures.CategoryCaption, Measures.SpanishCategoryCaption, Measures.FrenchCategoryCaption } ON 0
,[Product].[Category].MEMBERS ON 1
FROM [Adventure Works]
См. также