Оператор top

Возвращает первые N записей, отсортированных по указанному столбцу.

Синтаксис

T| topNumberOfRowsbyВыражение [asc | desc] [nulls first | nulls last]

Дополнительные сведения о соглашениях о синтаксисе.

Параметры

Имя	Тип	Обязательно	Описание
T	string	✔️	Табличные входные данные для сортировки.
NumberOfRows	int	✔️	Число возвращаемых строк T .
Выражение	string	✔️	Скалярное выражение, по которому выполняется сортировка.
asc или desc	string		Определяет, находится ли выделенный фрагмент в нижней или верхней части диапазона. Значение по умолчанию: desc.
nulls first или nulls last	string		Определяет, отображаются ли значения NULL в нижней или верхней части диапазона. Значение по умолчанию для asc — nulls first. Значение по умолчанию для desc — nulls last.

Совет

top 5 by name эквивалентно выражению sort by name | take 5 как с точки зрения семантики, так и с точки зрения производительности.

Пример

Показать три лучших шторма с большинством прямых травм.

Выполнить запрос

StormEvents
| top 3 by InjuriesDirect

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

InjuriesDirect	...
519	...
422	...
200	...

См. также

• Используйте оператор top-nested для получения иерархических (вложенных) верхних результатов.