Deploying to master from @ psycopg/psycopg-website@d152452 🚀

Author: dvarrazzo

psycopg3/docs/_sources/advanced/pipeline.rst.txt

@@ -200,8 +200,10 @@ synchronization point.
 
     - 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!)
+      opposite of batching!).
     - `ServerCursor` are currently not implemented in pipeline mode.
+    - You cannot execute :ref:`multiple statements in the same query
+      <multi-statements>`.
 
 .. note::
 

psycopg3/docs/_sources/basic/from_pg2.rst.txt

@@ -154,6 +154,14 @@ or a :ref:`client-side binding cursor <client-side-binding-cursors>`::
     ...     "INSERT INTO foo VALUES (%s); INSERT INTO foo VALUES (%s)",
     ...     (10, 20))
 
+.. warning::
+
+    You cannot executeA multiple statements in the same query:
+
+    - when retrieving a :ref:`binary result <binary-data>` (such as using
+      ``.execute(..., binary=True)``;
+    - when using the :ref:`pipeline mode <pipeline-mode>`.
+
 .. warning::
 
     If a statement must be executed outside a transaction (such as

psycopg3/docs/_sources/basic/params.rst.txt

@@ -240,3 +240,8 @@ in the database, such as images::
     cur.execute(
         "SELECT image_data FROM images WHERE id = %s", [image_id], binary=True)
     data = cur.fetchone()[0]
+
+.. warning::
+
+    You cannot execute :ref:`multiple statements in the same query
+    <multi-statements>` when requesting a binary result.

psycopg3/docs/advanced/pipeline.html

@@ -467,8 +467,9 @@ <h2>Client-server messages flow<a class="headerlink" href="#client-server-messag
 <ul class="simple">
 <li><p>COPY is not supported in pipeline mode by PostgreSQL.</p></li>
 <li><p><a class="reference internal" href="../api/cursors.html#psycopg.Cursor.stream" title="psycopg.Cursor.stream"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Cursor.stream()</span></code></a> doesn’t make sense in pipeline mode (its job is the
-opposite of batching!)</p></li>
+opposite of batching!).</p></li>
 <li><p><a class="reference internal" href="../api/cursors.html#psycopg.ServerCursor" title="psycopg.ServerCursor"><code class="xref py py-obj docutils literal notranslate"><span class="pre">ServerCursor</span></code></a> are currently not implemented in pipeline mode.</p></li>
+<li><p>You cannot execute <a class="reference internal" href="../basic/from_pg2.html#multi-statements"><span class="std std-ref">multiple statements in the same query</span></a>.</p></li>
 </ul>
 </div>
 <div class="admonition note">

psycopg3/docs/basic/from_pg2.html

@@ -370,6 +370,15 @@
 </div>
 <div class="admonition warning">
 <p class="admonition-title">Warning</p>
+<p>You cannot executeA multiple statements in the same query:</p>
+<ul class="simple">
+<li><p>when retrieving a <a class="reference internal" href="params.html#binary-data"><span class="std std-ref">binary result</span></a> (such as using
+<code class="docutils literal notranslate"><span class="pre">.execute(...,</span> <span class="pre">binary=True)</span></code>;</p></li>
+<li><p>when using the <a class="reference internal" href="../advanced/pipeline.html#pipeline-mode"><span class="std std-ref">pipeline mode</span></a>.</p></li>
+</ul>
+</div>
+<div class="admonition warning">
+<p class="admonition-title">Warning</p>
 <p>If a statement must be executed outside a transaction (such as
 <code class="sql docutils literal notranslate"><span class="pre">CREATE</span> <span class="pre">DATABASE</span></code>), it cannot be executed in batch with other
 statements, even if the connection is in autocommit mode:</p>

psycopg3/docs/basic/params.html

@@ -449,6 +449,10 @@ <h2><code class="xref py py-obj docutils literal notranslate"><span class="pre">
 <span class="n">data</span> <span class="o">=</span> <span class="n">cur</span><span class="o">.</span><span class="n">fetchone</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span>
 </pre></div>
 </div>
+<div class="admonition warning">
+<p class="admonition-title">Warning</p>
+<p>You cannot execute <a class="reference internal" href="from_pg2.html#multi-statements"><span class="std std-ref">multiple statements in the same query</span></a> when requesting a binary result.</p>
+</div>
 </section>
 </section>