bigframes.geopandas.GeoSeries.peek

GeoSeries.peek(n: int = 5, *, force: bool = True, allow_large_results=None) → Series

Preview n arbitrary elements from the series without guarantees about row selection or ordering.

Series.peek(force=False) will always be very fast, but will not succeed if data requires full data scanning. Using force=True will always succeed, but may be perform queries. Query results will be cached so that future steps will benefit from these queries.

Parameters:

• n (int, default 5) – The number of rows to select from the series. Which N rows are returned is non-deterministic.

• force (bool, default True) – If the data cannot be peeked efficiently, the series will instead be fully materialized as part of the operation if force=True. If force=False, the operation will throw a ValueError.

• allow_large_results (bool, default None) – If not None, overrides the global setting to allow or disallow large query results over the default size limit of 10 GB.

Returns:

A pandas Series with n rows.

Return type:

pandas.Series

Raises:

ValueError – If force=False and data cannot be efficiently peeked.