take operator

take operator

Return up to the specified number of rows.

There is no guarantee which records are returned, unless the source data is sorted. If the data is sorted, then the top values will be returned.

The take and limit operators are equivalent

Note: take is a simple, quick, and efficient way to view a small sample of records when browsing data interactively, but be aware that it doesn't guarantee any consistency in its results when executing multiple times, even if the data set hasn't changed. Even if the number of rows returned by the query isn't explicitly limited by the query (no take operator is used), Kusto limits that number by default. For more details, see Kusto query limits.

Syntax

take NumberOfRows

Parameters

NameTypeRequiredDescription
NumberOfRowsintThe number of rows to return.

Paging of query results

Methods for implementing paging include:

  • Export the result of a query to an external storage and paging through the generated data.
  • Write a middle-tier application that provides a stateful paging API by caching the results of a Kusto query.
  • Use pagination in Stored query results.

Example

[!div class="nextstepaction"] Run the query

StormEvents | take 5

See also