Percent escaping note

mymarilyn · Mar 26, 2021 · 368f949 · 368f949
1 parent 50dcc16
commit 368f949
Showing 1 changed file with 10 additions and 0 deletions.
diff --git a/docs/quickstart.rst b/docs/quickstart.rst
@@ -56,6 +56,16 @@ Of course queries can and should be parameterized to avoid SQL injections:
         ... )
         [('2018-10-21', 3)]
 
+Percent symbols in inlined constants should be doubled if you mix constants
+with ``%`` symbol and ``%(x)s`` parameters.
+
+    .. code-block:: python
+
+        >>> client.execute(
+        ...     "SELECT 'test' like '%%es%%', %(x)s",
+        ...     {'x': 1}
+        ... )
+
 Customisation ``SELECT`` output with ``FORMAT`` clause is not supported.
 
 .. _execute-with-progress: