Skip to content

Commit 02b5b55

Browse files
committed
Added documentation around prepared statement id-caching.
1 parent 53a9a1d commit 02b5b55

File tree

1 file changed

+9
-4
lines changed

1 file changed

+9
-4
lines changed

features/basics/prepared_statements.feature

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,12 @@ Feature: Prepared statements
44
it multiple times with different values. A bind variable marker `?` is used
55
to represent a dynamic value in a statement.
66

7-
Scenario: an INSERT statement is prepared
7+
The driver caches prepared statement id's in such a way that
8+
when a query is to be prepared for a node, the "preparation" is bypassed if the statement has previously
9+
been prepared on any other node. This reduces a round-trip to the node while also optimizing query execution
10+
performance.
11+
12+
Scenario: An INSERT statement is prepared
813
Given a running cassandra cluster with schema:
914
"""cql
1015
CREATE KEYSPACE simplex WITH replication = {'class': 'SimpleStrategy', 'replication_factor': 3};
@@ -72,7 +77,7 @@ Feature: Prepared statements
7277
"""
7378

7479
@cassandra-version-specific @cassandra-version-2.1
75-
Scenario: an INSERT statement is prepared with named parameters
80+
Scenario: An INSERT statement is prepared with named parameters
7681
Given a running cassandra cluster with schema:
7782
"""cql
7883
CREATE KEYSPACE simplex WITH replication = {'class': 'SimpleStrategy', 'replication_factor': 3};
@@ -140,7 +145,7 @@ Feature: Prepared statements
140145
"""
141146

142147
@cassandra-version-specific @cassandra-version-2.0
143-
Scenario: a SELECT statement with parameterized LIMIT is prepared
148+
Scenario: A SELECT statement with parameterized LIMIT is prepared
144149
Given a running cassandra cluster with schema:
145150
"""cql
146151
CREATE KEYSPACE simplex WITH replication = {'class': 'SimpleStrategy', 'replication_factor': 3};
@@ -284,4 +289,4 @@ Feature: Prepared statements
284289
Then its output should contain:
285290
"""
286291
Joséphine Baker: La Petite Tonkinoise / Bye Bye Blackbird
287-
"""
292+
"""

0 commit comments

Comments
 (0)