Skip to content

Commit 49854e4

Browse files
docs: clarify bulk_insert only supports fb_numeric parameter style
- Remove QMARK parameter style example from bulk_insert documentation - Update note to explicitly state bulk_insert requires fb_numeric - Clarify that using other parameter styles will raise an error Addresses PR feedback from ptiurin on #463 Co-Authored-By: petro.tiurin@firebolt.io <petro.tiurin@firebolt.io>
1 parent d13d20e commit 49854e4

File tree

1 file changed

+3
-20
lines changed

1 file changed

+3
-20
lines changed

docsrc/Connecting_and_queries.rst

Lines changed: 3 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -444,26 +444,9 @@ For inserting large amounts of data more efficiently, you can use the ``bulk_ins
444444
with ``executemany()``. This concatenates multiple INSERT statements into a single batch request,
445445
which can significantly improve performance when inserting many rows.
446446

447-
**Note:** The ``bulk_insert`` parameter only works with INSERT statements. Using it with other
448-
statement types (SELECT, UPDATE, DELETE, etc.) will raise an error.
449-
450-
Example with QMARK parameter style::
451-
452-
import firebolt.db
453-
# Explicitly set paramstyle to "qmark" for QMARK style
454-
firebolt.db.paramstyle = "qmark"
455-
456-
cursor.executemany(
457-
"INSERT INTO test_table VALUES (?, ?, ?)",
458-
(
459-
(1, "apple", "2019-01-01"),
460-
(2, "banana", "2020-01-01"),
461-
(3, "carrot", "2021-01-01"),
462-
(4, "donut", "2022-01-01"),
463-
(5, "eggplant", "2023-01-01")
464-
),
465-
bulk_insert=True # Enable bulk insert for better performance (important-comment)
466-
)
447+
**Note:** The ``bulk_insert`` parameter only works with INSERT statements and requires the
448+
``fb_numeric`` parameter style. Using it with other statement types or parameter styles will
449+
raise an error.
467450

468451
Example with FB_NUMERIC parameter style::
469452

0 commit comments

Comments
 (0)