Оператор top

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

Синтаксис

Выражение T | top NumberOfRows by [ascdesc | ] []nulls first | nulls last

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

Параметры

Имя (название)	Type	Обязательно	Описание
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

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

Пострадавшие	...
519	...
422	...
200	...

Связанный контент

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