Функция Top() оценивает выражение в первой (верхней) строке сегмента столбца в таблице. Строка, для которой выполняется вычисление, зависит от значения элемента offset, если таковой имеет место, по умолчанию принимается верхняя строка. Для диаграмм, за исключением таблиц, функция Top() используется для оценки в первой строке текущего столбца в эквиваленте прямой таблицы диаграммы.
Синтаксис:
Top([TOTAL] expr [ , offset [,count
]])
Возвращаемые типы данных: двойное значение
Аргументы
Аргумент
Описание
expr
Выражение или поле, содержащее данные для измерения.
offset
Если задать значение offset из n, которое больше 1, оценка выражения будет перемещена вниз на n строк от верхней строки.
Если задать отрицательное число смещения, функция Top будет работать как функция Bottom с соответствующим положительным числом смещения.
count
Если задать для третьего параметра count значение больше 1, функция вернет ряд значений элемента count: по одному для каждой последней строки элемента count текущего сегмента столбца. В данной форме функция может использоваться в качестве аргумента для любой специальной функции интервала. Функции над выборкой
TOTAL
Если таблица имеет одно измерение, или если в качестве аргумента используется префикс TOTAL, текущий сегмент столбца всегда равен всему столбцу.
Примечание к информацииСегмент столбца определяется как последовательное подмножество ячеек с теми же значениями для измерений в текущем порядке сортировки. Межзаписные функции диаграмм выполняют вычисления в сегменте столбца за исключением крайнего правого измерения в эквивалентной прямой таблице. Если в диаграмме есть только одно измерение, или если указан квалификатор TOTAL, выражение оценивается по всей таблице.
Примечание к информацииЕсли таблица или эквивалент таблицы имеют несколько вертикальных измерений, текущий сегмент столбца будет включать только строки с теми же значениями, что и текущая строка во всех столбцах измерений, кроме столбца с последним измерением в межполевом порядке сортировки.
Ограничения:
Рекурсивные вызовы возвращают значение NULL.
Сортировка по значениям y на диаграммах или сортировка по столбцам выражений в таблицах не допускается, если в любом из выражений диаграммы используется эта функция диаграмм. Данные возможности сортировки автоматически отключаются. Когда используется эта функция диаграмм в визуализации или таблице, сортировка визуализации будет возвращена к сортировке на входе этой функции.
Пример: выражения диаграммы
Пример
Результат
Top( Sum(Sales) )
Возвращает значение Sales для первой (верхней) строки сегмента столбца в таблице.
Пример. Основы использования функции Top
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел.
Скрипт загрузки содержит следующее:
Набор данных, который загружается в таблицу данных под именем Example.
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте это поле как измерение:
Year
Создайте следующие меры:
=Sum(Sales), чтобы рассчитать годовой объем продаж.
=Top(Sum(Sales)), чтобы найти значение продаж за первый год, используется первая (верхняя) строка столбца в таблице.
=Sum(Sales) - Top(Sum(Sales)), чтобы рассчитать изменение между значением Sales в текущей и в первой (верхней) строке столбца.
=Sum(Sales)-Top(Sum(Sales), 3) рассчитывает изменение продаж между текущей и третьей сверху строкой.
=(Sales - Top(Sales)) / Top(Sales) позволяет получить изменение в Sales виде отношения / процента в сравнении с первой строкой. Чтобы показать это значение в процентах, в разделе Форматирование чисел выберите Число > Простое форматирование > 12,34%.
Сортировка таблицы по измерению Year в порядке возрастания.
Таблица результатов
Year
Sum(Sales)
Top(Sum(Sales))
Sum(Sales) - Top(Sum(Sales))
Sum(Sales)-Top(Sum(Sales), 3)
(Sales - Top(Sales)) / Top(Sales)
Totals
7200
1000
6200
6000
-
2019
1000
1000
0
-200
0.00%
2020
1500
1000
500
300
50.00%
2021
1200
1000
200
0
20.00%
2022
1800
1000
800
600
80.00%
2023
1700
1000
700
500
70.00%
По результатам можно сравнить значения Sales в текущем периоде с периодом, представленным в верхней (или первой) строке.
Мера Sum(Sales) - Top(Sum(Sales)) возвращает изменение в значениях Sales, сравнивая текущий период с первым.
Мера Sum(Sales)-Top(Sum(Sales), 3) возвращает сумму Sales для текущей строки минус третий период сверху.
Мера =(Sales - Top(Sales)) / Top(Sales) возвращает изменение в Sales относительно первого периода в процентах.
Примечание к подсказкеЭту функцию можно также использовать в диаграммах, кроме таблиц, например, в линейчатых диаграммах.
Выполните следующие действия.
Создайте линейчатую диаграмму и добавьте это поле как измерение:
Year
Создайте следующую меру:
=Sum(Sales)- Top(Sum(Sales)), чтобы вернуть разницу в продажах между текущим и верхним периодом.
Линейчатая диаграмма, демонстрирующая результаты для функции Top
Использование функции Top в линейчатой диаграмме позволяет наглядным образом сравнить изменение продаж за текущий период относительно первого (или верхнего) периода.
Пример. Сценарий использования Top
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел.
Скрипт загрузки содержит следующее:
Набор данных, который загружается в таблицу данных под именем Example.
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте это поле как измерение:
Customer
Создайте следующие меры:
=Sum(Sales), чтобы вычислить сумму продаж.
=Top(Sum(Sales)), чтобы показать сумму продаж для Customer в верхней строке.
=Sum(Sales)+Top(Sum(Sales)), чтобы добавить значение Sum(Sales) для текущего Customer к значению Customer в верхней строке.
=Sum(Sales)+Top(Sum(Sales), 3), чтобы добавить значение Sum(Sales) для текущего Customer к значению Customer в третьей сверху строке.
Таблица результатов
Customer
Sum(Sales)
Top(Sum(Sales))
Sum(Sales)+Top(Sum(Sales))
Sum(Sales)+Top(Sum(Sales), 3)
Totals
2566
587
3153
3249
Astrida
587
587
1174
1270
Betacab
539
587
1126
1222
Canutilty
683
587
1270
1366
Divadip
757
587
1344
1440
Мера Top(Sum(Sales)) возвращает 587 для всех строк, поскольку это значение верхней строки: Astrida.
Для меры Sum(Sales)+Top(Sum(Sales)) строка Betacab возвращает 1126, что является результатом сложения значений Sum(Sales) для Betacab и Astrida из Customer в верхней строке.
Мера Sum(Sales)+Top(Sum(Sales), 3) имеет аргумент offset, равный 3. Это выражение добавляет значение Sum(Sales) из текущей строки и третьей строки снизу, Canutility. Например, для клиента Divadip возвращается значение 1440. Это результат сложения значения Sum(Sales) для Divadip и SumSales для Canutility (757+683).
Если вы обнаружили какую-либо проблему на этой странице или с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом!