From dec1ad7ae1197a3a19c66842dbd552c2fea80fa6 Mon Sep 17 00:00:00 2001 From: Daniele Varrazzo Date: Sun, 3 Apr 2022 02:25:55 +0200 Subject: [PATCH] docs: add note about features not supported in pipeline mode --- docs/advanced/pipeline.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/advanced/pipeline.rst b/docs/advanced/pipeline.rst index 6a50f4cd5..dc4c18451 100644 --- a/docs/advanced/pipeline.rst +++ b/docs/advanced/pipeline.rst @@ -68,6 +68,14 @@ which executed them. If a cursor had run more than one query, it will receive more than one result; results after the first will be available, in their execution order, using `~Cursor.nextset()`. +.. warning:: + Certanin features are not available in pipeline mode, including: + + - COPY is not supported in pipeline mode by PostgreSQL. + - `Cursor.stream()` doesn't make sense in pipeline mode (its job is the + opposite of batching!) + - `ServerCursor` are currently not implemented in pipeline mode. + .. note:: Starting from Psycopg 3.1, `Cursor.executemany()` is optimised to make use of pipeline mode. -- 2.47.2