diff --git a/py-polars/polars/lazyframe/frame.py b/py-polars/polars/lazyframe/frame.py index 698884360910..2b313e2500c6 100644 --- a/py-polars/polars/lazyframe/frame.py +++ b/py-polars/polars/lazyframe/frame.py @@ -1811,6 +1811,10 @@ def collect( Run the query in the background and get a handle to the query. This handle can be used to fetch the result or cancel the query. + .. warning:: + Background mode is considered **unstable**. It may be changed + at any point without it being considered a breaking change. + Returns ------- DataFrame @@ -1887,7 +1891,9 @@ def collect( _eager, new_streaming, ) + if background: + issue_unstable_warning("Background mode is considered unstable.") return InProcessQuery(ldf.collect_concurrently()) # Only for testing purposes atm.