polars_cloud.ExecuteRemote.execute#

ExecuteRemote.execute( *, blocking: bool = True, optimizations: QueryOptFlags = <polars.lazyframe.opt_flags.QueryOptFlags object>, silent: bool | None = None, ) → QueryResult | DirectQuery | ProxyQuery#

Start executing the query and store an intermediate result.

This result is not a DataFrame, but data written to temporary storage.

Parameters:

blocking: Block until a QueryResult is returned. if not blocking, this will return an InProgressQuery.
optimizations: The optimization passes done during query optimization.
silent: Don’t print to stdout during blocking execution.

Examples

>>> result = query.remote(ctx).execute()
>>> intermediate_lf = result.lazy()

>>> in_progress = query.remote(ctx).execute(blocking=False)
>>> # do other useful work
>>> ...
>>> # await the in-progress query
>>> in_progress.await_result()