Skip to main content
Table.query(
    *columns: Column,
    filter: TableQueryFilterCondition | None = None,
    max_rows: PositiveInt = 2147483646,
    timeout: Duration = datetime.timedelta(seconds=30),
) → pd.DataFrame
Query the table to retrieve some of its rows. If the table has more than max_rows rows matching filter, the set of returned rows is unspecified and can change from one call to another. As opposed to head(), the returned DataFrame will not be indexed by the table’s keys since columns may lack some of them.

Parameters

*columns

The columns to query. If empty, all the columns of the table will be queried.

filter

The filtering condition. Only rows matching this condition will be returned.

max_rows

The maximum number of rows to return.

timeout

The duration the query execution can take before being aborted.