Документация, на которую вы ссылаетесь, напрямую ссылается на PEP 249, которая показывает различные стили.
О pyformat говорится:
'pyformat' Коды расширенного формата Python,например, '... WHERE name =% (name) s'
Так вот, что вам нужно использовать.
По Googling на "DBAPI pyformat" вторая ссылка - это ссылка документация psycopg2 .После упоминания о том, что он использует pyformat, есть ссылка «См. Также», ссылающаяся на страницу с множеством примеров .
Примеры использования этой ссылки приведены в исходной ссылке:
e.execute("select %s, %s;", ("param1", "test"), ("param2", "test2"))
Вы также можете использовать этот синтаксис:
e.execute("select %(param1)s, %(param2)s;", param1="test", param2="test2"))
Что лучше.