Skip to main content
Version: Python

head

The head method returns a table with a specific number of rows from the beginning of the source table.

Syntax

table.head(num_rows: int) -> Table

Parameters

ParameterTypeDescription
num_rowsint

The number of rows to return.

Returns

A new table with a specific number of rows from the beginning of the source table.

Examples

The following example filters the table to the first two rows.

from deephaven import new_table
from deephaven.column import string_col, int_col, double_col
from deephaven.constants import NULL_INT

source = new_table(
[
string_col("Letter", ["A", "C", "F", "B", "E", "D", "A"]),
int_col("Number", [NULL_INT, 2, 1, NULL_INT, 4, 5, 3]),
string_col(
"Color", ["red", "blue", "orange", "purple", "yellow", "pink", "blue"]
),
int_col("Code", [12, 14, 11, NULL_INT, 16, 14, NULL_INT]),
]
)


result = source.head(2)

The following example uses head on a blink table. Note that head treats the blink table like an append-only table, saving the first five rows that were added to the table, and ignoring all following updates.

from deephaven import time_table

source = time_table(period="PT0.10S", blink_table=True)

result = source.head(5)

img