Справочник по функциям многомерных выражений (многомерные выражения)

Служба MicrosoftSQL ServerAnalysis Services позволяет пользоваться функциями в синтаксисе многомерных выражений. Функции могут включаться во все допустимые инструкции многомерных выражений. Они часто применяются в запросах, пользовательских свертках и других вычислениях. В данном разделе содержатся сведения о функциях многомерных выражений в службах Analysis Services.

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

Функции массивов

Функция	Описание
SetToArray (многомерные выражения)	Преобразует один или несколько наборов в массив для использования в пользовательской функции.

Функции иерархий

Функция	Описание
Hierarchy (многомерные выражения)	Возвращает иерархию, содержащую заданный элемент или уровень.
Dimension (многомерные выражения)	Возвращает измерение, содержащее указанный элемент, уровень или иерархию.
Dimensions (многомерные выражения)	Возвращает иерархию, указанную числовым или строковым выражением.

Функции уровней

Функция	Описание
Level (многомерные выражения)	Возвращает уровень элемента.
Levels (многомерные выражения)	Возвращает уровень, положение которого в измерении или иерархии указано числовым выражением или имя которого указано строковым выражением.

Логические функции

Функция	Описание
IsAncestor (многомерные выражения)	Возвращает значение, сообщающее, является ли заданный элемент предком другого заданного элемента.
IsEmpty (многомерные выражения)	Возвращает значение, сообщающее, является ли вычисленное выражение значением пустой ячейки.
IsGeneration (многомерные выражения)	Возвращает значение, сообщающее, принадлежит ли заданный элемент указанному поколению.
IsLeaf (многомерные выражения)	Возвращает значение, сообщающее, является ли элемент конечным.
IsSibling (многомерные выражения)	Возвращает значение, сообщающее, имеет ли указанный элемент общего родителя с другим указанным элементом.

Функции элементов

Функция	Описание
Ancestor (многомерные выражения)	Возвращает предка элемента на указанном уровне или расстоянии.
ClosingPeriod (многомерные выражения)	Возвращает последний родственный элемент среди потомков элемента на указанном уровне.
Cousin (многомерные выражения)	Возвращает дочерний элемент, позиция которого относительно родительского элемента совпадает с позицией заданного дочернего элемента.
CurrentMember (многомерные выражения)	Возвращает текущий элемент заданного измерения или иерархии во время выполнения цикла.
DataMember (многомерные выражения)	Возвращает элемент данных, сформированный системой и связанный с неконечным элементом измерения.
DefaultMember (многомерные выражения)	Возвращает элемент по умолчанию для измерения или иерархии.
FirstChild (многомерные выражения)	Возвращает первого потомка элемента.
FirstSibling (многомерные выражения)	Возвращает первого потомка предка заданного элемента.
Item (элемент) (многомерные выражения)	Возвращает элемент указанного кортежа.
Lag (многомерные выражения)	Возвращает элемент, который находится на указанное количество позиций перед заданным элементом в измерении этого элемента.
LastChild (многомерные выражения)	Возвращает последний дочерний элемент указанного элемента.
LastSibling (многомерные выражения)	Возвращает последний дочерний элемент родителя указанного элемента.
Lead (многомерные выражения)	Возвращает элемент, который следует за заданным элементом через указанное число позиций в измерении элемента.
LinkMember (многомерные выражения)	Возвращает элемент, эквивалентный заданному элементу в указанной иерархии.
Members (строка) (многомерные выражения)	Возвращает элемент, заданный строковым выражением.
NextMember (многомерные выражения)	Возвращает следующий элемент уровня, содержащего заданный элемент.
OpeningPeriod (многомерные выражения)	Возвращает первый родственный элемент среди потомков указанного уровня; по желанию можно указать элемент, потомок которого будет возвращаться.
ParallelPeriod (многомерные выражения)	Возвращает элемент предыдущего периода, расположенный в той же относительной позиции, что и заданный элемент.
Parent (многомерные выражения)	Возвращает родительский элемент заданного элемента.
PrevMember (многомерные выражения)	Возвращает предыдущий элемент уровня, содержащего указанный элемент.
StrToMember (многомерные выражения)	Возвращает элемент, заданный строкой в формате многомерных выражений.
UnknownMember (многомерные выражения)	Возвращает неизвестный элемент, связанный с уровнем или элементом.
ValidMeasure (многомерные выражения)	Возвращает допустимую меру в виртуальном кубе, принудительно вставляя неприменимые измерения на верхний уровень измерений.

Числовые функции

Функция	Описание
Aggregate (многомерные выражения)	Возвращает скалярное значение путем статистического вычисления по мерам или (дополнительно) по заданному числовому выражению для кортежей указанного набора.
Avg (многомерные выражения)	Возвращает среднее значение мер или среднее значение числового выражения (необязательный аргумент), вычисленного по заданному набору.
CalculationCurrentPass (многомерные выражения)	Возвращает текущий этап вычисления куба для указанного контекста запроса.
CalculationPassValue (многомерные выражения)	Возвращает значение многомерного выражения, вычисленное на указанном этапе вычисления куба.
CoalesceEmpty (многомерные выражения)	Объединяет значение пустой ячейки с числом или строкой и возвращает объединенное значение.
Correlation (многомерные выражения)	Возвращает коэффициент корреляции двух последовательностей, рассчитанных по набору.
Count (измерение) (многомерные выражения)	Возвращает количество измерений в кубе.
Count (уровни иерархии) (многомерные выражения)	Возвращает количество уровней в измерении или иерархии.
Count (набор) (многомерные выражения)	Возвращает количество ячеек в наборе.
Count (кортеж) (многомерные выражения)	Возвращает количество измерений в кортеже.
Covariance (многомерные выражения)	Возвращает ковариацию совокупности двух последовательностей на наборе с использованием формулы смещенной совокупности.
CovarianceN (многомерные выражения)	Возвращает выборочную ковариацию двух последовательностей на наборе с использованием формулы несмещенной совокупности.
DistinctCount (многомерные выражения)	Возвращает количество неодинаковых, непустых кортежей в наборе.
IIf (многомерные выражения)	Возвращает одно из двух значений, исходя из логического условия.
LinRegIntercept (многомерные выражения)	Вычисляет линейную регрессию для набора и возвращает значение отрезка, отсекаемого линией регрессии y = ax + b.
LinRegPoint (многомерные выражения)	Вычисляет линейную регрессию для набора и возвращает значение y в линии регрессии y = ax + b.
LinRegR2 (многомерные выражения)	Вычисляет линейную регрессию набора и возвращает коэффициент смешанной корреляции R2.
LinRegSlope (многомерные выражения)	Вычисляет линейную регрессию набора и возвращает значение наклона линии регрессии y = ax + b.
LinRegVariance (многомерные выражения)	Вычисляет линейную регрессию набора и возвращает дисперсию, связанную с линией регрессии y = ax + b.
LookupCube (многомерные выражения)	Возвращает значение многомерного выражения, рассчитанного для другого указанного куба в той же базе данных.
Max (многомерные выражения)	Возвращает максимальное значение числового выражения, вычисляемого на наборе.
Median (многомерные выражения)	Возвращает медиант числового выражения, вычисляемого на наборе.
Min (многомерные выражения)	Возвращает минимальное значение числового выражения, вычисляемого на наборе.
Ordinal (многомерные выражения)	Возвращает начинающееся с нуля порядковое значение, связанное с уровнем.
Predict (многомерные выражения)	Возвращает значение числового выражения, вычисленного по модели интеллектуального анализа данных.
Rank (многомерные выражения)	Возвращает ранг (начиная с единицы) указанного кортежа в указанном наборе.
RollupChildren (многомерные выражения)	Возвращает значение, сформированное сверткой значений дочерних элементов указанного элемента с помощью указанного унарного оператора.
Stddev (многомерные выражения)	Псевдоним для функции Stdev (многомерные выражения).
StddevP (многомерные выражения)	Псевдоним для функции StdevP (многомерные выражения).
Stdev (многомерные выражения)	Возвращает среднеквадратичное отклонение выборки для числового выражения, вычисляемого на наборе по формуле несмещенной совокупности.
StdevP (многомерные выражения)	Возвращает среднеквадратичное отклонение совокупности для числового выражения, вычисляемого на наборе по формуле смещенной совокупности.
StrToValue (многомерные выражения)	Возвращает значение, заданное строкой в формате многомерных выражений.
Sum (многомерные выражения)	Возвращает сумму значений числового выражения, вычисленного по набору.
Value (многомерные выражения)	Возвращает значение меры.
Var (многомерные выражения)	Возвращает выборочную дисперсию числового выражения, вычисленную на наборе по формуле несмещенной совокупности.
Variance (многомерные выражения)	Псевдоним для функции Var (многомерные выражения).
VarianceP (многомерные выражения)	Псевдоним для функции VarP (многомерные выражения).
VarP (многомерные выражения)	Возвращает дисперсию генеральной совокупности для числового выражения, вычисленного по набору исходя из формулы смещенной совокупности.

Функции наборов

Функция	Описание
AddCalculatedMembers (многомерные выражения)	Возвращает набор, созданный путем добавления вычисляемых элементов в указанный набор.
AllMembers (многомерные выражения)	Возвращает набор, содержащий все элементы (включая вычисляемые) заданного измерения, иерархии или уровня.
Ancestors (многомерные выражения)	Возвращает набор всех предков элемента на указанном уровне или расстоянии.
Ascendants (многомерные выражения)	Возвращает набор родителей указанного элемента, включая его самого.
Axis (многомерные выражения)	Возвращает набор, определенный на оси.
BottomCount (многомерные выражения)	Сортирует набор в порядке возрастания и возвращает указанное число кортежей с минимальными значениями.
BottomPercent (многомерные выражения)	Сортирует набор по возрастанию и возвращает набор кортежей с наименьшими значениями, совокупное значение которых меньше или равно заданному проценту.
BottomSum (многомерные выражения)	Сортирует набор по возрастанию и возвращает набор кортежей с наименьшими значениями, совокупное значение которых меньше или равно заданному значению.
Children (многомерные выражения)	Возвращает дочерние элементы заданного элемента.
Crossjoin (многомерные выражения)	Возвращает перекрестное произведение двух или нескольких наборов.
CurrentOrdinal (многомерные выражения)	Возвращает номер текущей итерации в наборе во время итерации.
Descendants (многомерные выражения)	Возвращает набор потомков элемента на указанном уровне или расстоянии, по желанию включая или исключая потомков на других уровнях.
Distinct (многомерные выражения)	Возвращает набор, удаляя повторяющиеся кортежи из указанного набора.
DrilldownLevel (многомерные выражения)	Детализирует углублением элементы набора на один уровень ниже самого нижнего уровня, представленного в наборе, или на один уровень ниже заданного по желанию уровня элемента, представленного в наборе.
DrilldownLevelBottom (многомерные выражения)	Детализирует углублением самые нижние элементы набора на указанном уровне и одним уровнем ниже.
DrilldownLevelTop (многомерные выражения)	Детализирует углублением самые верхние элементы набора на указанном уровне и одним уровнем ниже.
DrilldownMember (многомерные выражения)	Детализирует углублением элементы указанного набора, присутствующие во втором указанном наборе. В качестве альтернативы функция детализирует углублением кортежи из набора кортежей.
DrilldownMemberBottom (многомерные выражения)	Детализирует углублением элементы указанного набора, присутствующие во втором указанном наборе, ограничивая результирующий набор заданным количеством элементов. В качестве альтернативы функция детализирует углублением кортежи из набора кортежей.
DrilldownMemberTop (многомерные выражения)	Детализирует углублением элементы указанного набора, присутствующие во втором указанном наборе, ограничивая результирующий набор заданным количеством элементов. В качестве альтернативы функция детализирует углублением кортежи из набора кортежей.
DrillupLevel (многомерные выражения)	Детализирует обобщением элементы набора, находящиеся ниже указанного уровня.
DrillupMember (многомерные выражения)	Детализирует обобщением элементы указанного набора, присутствующие во втором указанном наборе.
Except (многомерные выражения)	Находит разницу между двумя наборами, при необходимости сохраняя повторяющиеся элементы.
Exists (многомерные выражения)	Возвращает набор элементов одного набора, существующих в одном или нескольких кортежах одного или нескольких других наборов.
Extract (многомерные выражения)	Возвращает набор кортежей из извлеченных элементов измерения.
Filter (многомерные выражения)	Возвращает набор, получающийся в результате фильтрации заданного набора на основе условия поиска.
Generate (многомерные выражения)	Применяет набор к каждому элементу другого набора и соединяет результирующие наборы. В качестве альтернативы эта функция также возвращает сцепленную строку, созданную путем вычисления строкового выражения по набору.
Head (многомерные выражения)	Возвращает указанное количество первых элементов набора, сохраняя повторяющиеся элементы.
Hierarchize (многомерные выражения)	Упорядочивает элементы набора в иерархии.
Intersect (многомерные выражения)	Возвращает пересечение двух входных наборов, при необходимости сохраняя повторяющиеся элементы.
LastPeriods (многомерные выражения)	Возвращает набор элементов до указанного элемента включительно.
Members (набор) (многомерные выражения)	Возвращает набор элементов в измерении, уровне или иерархии.
Mtd (многомерные выражения)	Возвращает набор элементов с общим родителем, находящихся на том же уровне, что и данный элемент, начиная с первого такого элемента и заканчивая данным элементом, в соответствии с ограничениями уровня Year в измерении Time.
NameToSet (многомерные выражения)	Возвращает набор, содержащий элемент, заданный строкой в формате многомерных выражений.
NonEmptyCrossjoin (многомерные выражения)	Возвращает набор, содержащий перекрестное произведение двух или нескольких наборов, исключая пустые кортежи и кортежи, не связанные с данными таблиц фактов.
Order (многомерные выражения)	Упорядочивает элементы указанного набора, по выбору сохраняя или нарушая иерархию.
PeriodsToDate (многомерные выражения)	Возвращает набор элементов с общим родителем, находящихся на том же уровне, что и данный элемент, начиная с первого такого элемента и заканчивая данным элементом, в соответствии с ограничениями заданного уровня в измерении Time.
Qtd (многомерные выражения)	Возвращает набор элементов с общим родителем, находящихся на том же уровне, что и данный элемент, начиная с первого такого элемента и заканчивая данным элементом, в соответствии с ограничениями уровня Quarter в измерении Time.
Siblings (многомерные выражения)	Возвращает элементы, имеющие общего родителя с указанным элементом, включая сам элемент.
StripCalculatedMembers (многомерные выражения)	Возвращает набор, созданный путем удаления вычисляемых элементов из указанного набора.
StrToSet (многомерные выражения)	Возвращает набор, заданный строкой в формате многомерных выражений.
Subset (многомерные выражения)	Возвращает подмножество кортежей указанного набора.
Tail (многомерные выражения)	Возвращает подмножество из конца набора.
ToggleDrillState (многомерные выражения)	Переключает состояние детализации элементов.
TopCount (многомерные выражения)	Сортирует набор по убыванию и возвращает заданное число элементов с самыми высокими значениями.
TopPercent (многомерные выражения)	Сортирует набор по убыванию и возвращает набор кортежей с самыми высокими значениями, совокупное значение которых равно или меньше заданного процента от суммы по набору.
TopSum (многомерные выражения)	Сортирует набор и возвращает самые верхние элементы, совокупное значение которых не меньше указанного значения.
Union (многомерные выражения)	Возвращает объединение двух наборов, сохраняя повторяющиеся элементы (по выбору).
Unorder (многомерные выражения)	Удаляет принудительное упорядочивание заданного набора.
VisualTotals (многомерные выражения)	Возвращает набор, сформированный динамическим суммированием дочерних элементов указанного набора, (дополнительно) используя шаблон для имени родительского элемента в результирующем наборе ячеек.
Wtd (многомерные выражения)	Возвращает набор элементов с общим родителем, находящихся на том же уровне, что и данный элемент, начиная с первого такого элемента и заканчивая данным элементом, в соответствии с ограничениями уровня Week в измерении Time.
Ytd (многомерные выражения)	Возвращает набор элементов с общим родителем, находящихся на том же уровне, что и данный элемент, начиная с первого такого элемента и заканчивая данным элементом, в соответствии с ограничениями уровня Year в измерении Time.

Строковые функции

Функция	Описание
CalculationPassValue (многомерные выражения)	Возвращает значение многомерного выражения, вычисленное на указанном этапе вычисления куба.
CoalesceEmpty (многомерные выражения)	Объединяет значение пустой ячейки с числом или строкой и возвращает объединенное значение.
Generate (многомерные выражения)	Применяет набор к каждому элементу другого набора и соединяет результирующие наборы. В качестве альтернативы эта функция также возвращает сцепленную строку, созданную путем вычисления строкового выражения по набору.
IIf (многомерные выражения)	Возвращает одно из двух значений, исходя из логического условия.
LookupCube (многомерные выражения)	Возвращает значение многомерного выражения, рассчитанного для другого указанного куба в той же базе данных.
MemberToStr (многомерные выражения)	Возвращает строку в формате многомерных выражений, соответствующую заданному элементу.
Name (многомерные выражения)	Возвращает имя измерения, иерархии, уровня или элемента.
Properties (многомерные выражения)	Возвращает строку или строго типизированное значение, содержащее значение свойства элемента.
SetToStr (многомерные выражения)	Возвращает строку в формате многомерных выражений, соответствующую указанному набору.
TupleToStr (многомерные выражения)	Возвращает строку в формате многомерных выражений, соответствующую указанному кортежу.
UniqueName (многомерные выражения)	Возвращает уникальное имя указанного измерения, иерархии, уровня или элемента.
UserName (многомерные выражения)	Возвращает имя домена и пользователя для текущего соединения.

Функции вложенных кубов

Функция	Описание
This (многомерные выражения)	Возвращает текущий вложенный куб.
Leaves (многомерные выражения)	Возвращает набор конечных элементов в указанном измерении, элементе или кортеже.

Функции кортежей

Функция	Описание
Current (многомерные выражения)	Возвращает текущий кортеж из набора во время выполнения цикла.
Item (кортеж) (многомерные выражения)	Возвращает кортеж из набора.
Root (многомерные выражения)	Возвращает кортеж, состоящий из элементов All каждой иерархии атрибутов в кубе, измерении или кортеже.
StrToTuple (многомерные выражения)	Возвращает кортеж, заданный строкой в формате многомерных выражений.

Прочие функции

Функция	Описание
Error (многомерные выражения)	Вызывает ошибку, при необходимости выводя заданное сообщение об ошибке.

См. также

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

Справка по языку многомерных выражений (многомерные выражения)