From 8b4ba785fdf1cb5bd92be905131f204b772e57a2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stanis=C5=82aw=20Czech?= Date: Wed, 17 Jun 2026 10:06:28 +0200 Subject: [PATCH 1/2] Prepare readme for GA --- README.md | 19 ++++++++++--------- docs/source/index.rst | 19 +++++++++---------- 2 files changed, 19 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 612b6f807..da82902ec 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ This driver is an overlay over the [ScyllaDB Rust Driver](https://github.com/scy with the interface based on the [Node.js Driver for Apache Cassandra](https://github.com/apache/cassandra-nodejs-driver) (formerly known as DataStax Node.js Driver). Although optimized for ScyllaDB, the driver is also compatible with [Apache Cassandra®](https://cassandra.apache.org/). -This driver is currently in the experimental state. We are working on features necessary for the driver to be considered production ready. +This driver is considered production-ready. Support for some optional driver features is planned for upcoming releases ## Getting started @@ -20,7 +20,9 @@ Currently only linux x86_64 architecture is supported with planned support for o ### Documentation -The API ([documentation](https://nodejs-rs-driver.docs.scylladb.com/stable/api/)) of the driver is based on the Cassandra driver. +See the [online documentation](https://nodejs-rs-driver.docs.scylladb.com/) for ScyllaDB Node.js RS Driver. +It includes the [Getting Started](https://nodejs-rs-driver.docs.scylladb.com/stable/getting-started/getting-started.html) guide, the [Migration Guide](https://nodejs-rs-driver.docs.scylladb.com/stable/migration-guide/migration-guide.html), the [API documentation](https://nodejs-rs-driver.docs.scylladb.com/stable/api/), and more. + Some of the endpoints are already implemented, others are planned, and some parts of the API (including features that were deprecated and are specific to DataStax databases) are removed. The status of each API endpoint is listed in [this document](https://docs.google.com/spreadsheets/d/e/2PACX-1vRR8BUXy5u_DLNMet4L2MEmjSE0eeOX2SQIq8Sxy5BI8OoLeOopWlD2I_6-IWcas-rKw06o19la5-q6/pubhtml?gid=2021765806) and unimplemented features are tracked in the repository [issues](https://github.com/scylladb/nodejs-rs-driver/issues). @@ -45,17 +47,16 @@ The driver supports the following: - Row streaming and pipes - Built-in TypeScript support - Password authentication -- Configurable load balancing policies +- Configurable load balancing, retry policies +- Simple address translation policy - Error handling, based on the Rust driver - SSL support +- Driver logging +- Faster performance, compared to DataStax Node.js driver(*) -Features that are planned for the driver to become production ready: - -- Configurable retry policies -- Faster performance, compared to DataStax Node.js driver -- Migration guide from the DataStax driver +(*) In most of the internally conducted benchmarks -For other planned features see our [Milestones](https://github.com/scylladb/nodejs-rs-driver/milestones) +For planned features see our [Milestones](https://github.com/scylladb/nodejs-rs-driver/milestones) ## Reference Documentation diff --git a/docs/source/index.rst b/docs/source/index.rst index e99f4cf89..b958e65d8 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -7,10 +7,8 @@ This driver is an overlay over the `ScyllaDB Rust Driver `_. Although optimized for ScyllaDB, the driver is also compatible with `Apache Cassandra® `_. -.. caution:: - - This driver is currently in the experimental state. - We are working on features necessary for the driver to be considered production ready. +This driver is considered production-ready. +Support for some optional driver features is planned for upcoming releases. .. toctree:: :maxdepth: 2 @@ -59,17 +57,18 @@ The driver supports the following: - Built-in TypeScript support - Password authentication - SSL support +- Configurable load balancing, retry policies +- Simple address translation policy - Error handling, based on the Rust driver +- Driver logging +- Faster performance, compared to DataStax Node.js driver(*) + +(*) In most of the internally conducted benchmarks Roadmap ------- -Features planned for the driver to become production ready: - -- Configurable load balancing and retry policies -- Faster performance, compared to Apache cassandra-driver - -For other planned features, see the `Milestones `_. +For planned features, see the `Milestones `_. Other resources =============== From 958f860785b84bd215ba8961b6be0b2583febc6f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stanis=C5=82aw=20Czech?= Date: Mon, 27 Apr 2026 12:50:22 +0200 Subject: [PATCH 2/2] Add documentation about Parameterized queries --- docs/source/statements/index.md | 1 + .../statements/parameterized-queries.md | 33 +++++++++++++++++++ 2 files changed, 34 insertions(+) create mode 100644 docs/source/statements/parameterized-queries.md diff --git a/docs/source/statements/index.md b/docs/source/statements/index.md index 8f78ef5c9..e511237d0 100644 --- a/docs/source/statements/index.md +++ b/docs/source/statements/index.md @@ -6,4 +6,5 @@ prepared.md unprepared.md batch.md +parameterized-queries.md ``` diff --git a/docs/source/statements/parameterized-queries.md b/docs/source/statements/parameterized-queries.md new file mode 100644 index 000000000..9eed4b124 --- /dev/null +++ b/docs/source/statements/parameterized-queries.md @@ -0,0 +1,33 @@ + + +# Parameterized queries + +You can bind the values of parameters in a statement either by _position_ or by using _named_ markers. + +## Positional parameterized statements + +When using positional parameters, the query parameters must be provided as an Array. + +```javascript +const statement = 'INSERT INTO artists (id, name) VALUES (?, ?)'; +// Parameters by marker position +const params = ['krichards', 'Keith Richards']; +await client.execute(statement, params, { prepare: true }); +``` + +## Named parameterized statements + +You declare the named markers in your queries and use JavaScript object properties to define the parameters, with +the `Object` property names matching the parameter names. + +```javascript +const statement = 'INSERT INTO artists (id, name) VALUES (:id, :name)'; +// Parameters by marker name +const params = { id: 'krichards', name: 'Keith Richards' }; +await client.execute(statement, params, { prepare: true }); +``` + +Named parameters are case-insensitive. + +Currently named parameters are supported only in prepared statements.