sort.asciidoc 905 B

12345678910111213141516171819202122232425262728293031323334353637
  1. [discrete]
  2. [[esql-sort]]
  3. === `SORT`
  4. Use the `SORT` command to sort rows on one or more fields:
  5. [source,esql]
  6. ----
  7. include::{esql-specs}/docs.csv-spec[tag=sort]
  8. ----
  9. The default sort order is ascending. Set an explicit sort order using `ASC` or
  10. `DESC`:
  11. [source,esql]
  12. ----
  13. include::{esql-specs}/docs.csv-spec[tag=sortDesc]
  14. ----
  15. Two rows with the same sort key are considered equal. You can provide additional
  16. sort expressions to act as tie breakers:
  17. [source,esql]
  18. ----
  19. include::{esql-specs}/docs.csv-spec[tag=sortTie]
  20. ----
  21. [discrete]
  22. ==== `null` values
  23. By default, `null` values are treated as being larger than any other value. With
  24. an ascending sort order, `null` values are sorted last, and with a descending
  25. sort order, `null` values are sorted first. You can change that by providing
  26. `NULLS FIRST` or `NULLS LAST`:
  27. [source,esql]
  28. ----
  29. include::{esql-specs}/docs.csv-spec[tag=sortNullsFirst]
  30. ----