Оператор toptop operator

Возвращает первые N записей, отсортированных по указанным столбцам.Returns the first N records sorted by the specified columns.

T | top 5 by Name desc nulls last

СинтаксисSyntax

T | top NumberOfRows by выражение [ asc | desc ] [ nulls first | nulls last ]T | top NumberOfRows by Expression [asc | desc] [nulls first | nulls last]

АргументыArguments

  • NumberOfRows: число возвращаемых строк T .NumberOfRows: The number of rows of T to return. Можно указать любое числовое выражение.You can specify any numeric expression.
  • Выражение: скалярное выражение, по которому выполняется сортировка.Expression: A scalar expression by which to sort. Значения должны быть представлены числовыми или строковыми значениями, значениями времени или даты.The type of the values must be numeric, date, time or string.
  • asc или desc (по умолчанию) могут указывать направление выбора элементов в диапазоне: снизу вверх или сверху вниз.asc or desc (the default) may appear to control whether selection is actually from the "bottom" or "top" of the range.
  • nulls first (по умолчанию для asc Order) или nulls last (по умолчанию для desc Order) может использоваться для управления тем, будут ли значения NULL находиться в начале или конце диапазона.nulls first (the default for asc order) or nulls last (the default for desc order) may appear to control whether null values will be at the beginning or the end of the range.

Совет

top 5 by name эквивалентно выражению sort by name | take 5 как от семантических, так и с точки зрения производительности.top 5 by name is equivalent to the expression sort by name | take 5 both from semantic and performance perspectives.

См. также разделSee also

  • Используйте оператор Top-Nested для создания иерархических (вложенных) лучших результатов.Use top-nested operator to produce hierarchical (nested) top results.