From d08e4545c11f8e13c192e2cbdb46b58be29775ce Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phane=20Manciot?= Date: Mon, 14 Sep 2026 20:46:15 +0200 Subject: [PATCH] docs: sweep versions to the 0.23.0 train MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit core/repl 0.23.0 · extensions 0.3.2 · arrow 0.3.3 · jdbc 0.3.3. Per-occurrence triage, not a blanket replace. Every version WRITTEN here was confirmed to return 200 on JFrog first (jdbc + adbc drivers es6/7/8/9 0.3.3, java-client 0.23.0, arrow-extensions 0.3.3, community-extensions 0.3.2) — the check that previously caught a doc installing a version that never shipped. Deliberately NOT bumped: - `joins.md` "since arrow-extensions 0.2.5 (REPL bundle 0.20.4, driver 0.2.5)" — a SINCE line: it records when the behaviour appeared; - `joins.md` "Since engine 0.23.0 with arrow-extensions 0.3.3" — already the correct pair for this train; - the subquery/CTE limitation statements — still TRUE (see below). Found while sweeping — README was stale by TWO releases: its JDBC driver table and all three coordinate blocks still said 0.3.1 while `documentation/client/ jdbc.md` said 0.3.2, so the 0.3.2 sweep had missed README. Also `community-extensions` was deliberately held at 0.3.1 last train because the extensions repo had not moved; it has now, so it bumps to 0.3.2 here. `install.cmd` carries the RELEASE RITUAL, which is functional and not documentation: PS1_REF v0.22.0 -> v0.23.0 AND PS1_SHA256 recomputed from the real tag (9a7c772c…), because a bumped ref with a stale hash is a hard failure for every install.cmd-only user. Method controlled first: the hash pinned before this change matches v0.22.0's install.ps1 byte for byte. Patched as BYTES — `.gitattributes` marks `*.cmd -text`, so a text-mode rewrite silently converts CRLF and turns a 3-line edit into 330. `repl.md`'s installer listing is a quoted product output, so it was RE-CAPTURED by running `./install.sh --list-versions --es-version 8` rather than retyped: it now shows 7 versions ending at 0.23.0. That run also proves the `softclient4es8-cli-all_2.13` bundle published at 0.23.0 — a missing `-all` bundle falls back to the plain artifact, which carries no arrow extensions and therefore no cross-index JOIN. ⚠️ No wording claims derived tables or subqueries EXECUTE. Story 22.1 makes `FROM (SELECT ...) AS d` PARSE and be refused with HTTP 400 where the relational engine is absent; execution is story 22.4. The existing "no arbitrary subqueries" statements stay correct and untouched. Co-Authored-By: Claude Opus 5 (1M context) --- README.md | 22 +++++++++++----------- documentation/client/adbc_driver.md | 14 +++++++------- documentation/client/arrow_flight_sql.md | 4 ++-- documentation/client/jdbc.md | 14 +++++++------- documentation/client/repl.md | 13 +++++++------ install.cmd | 6 +++--- install.ps1 | 2 +- 7 files changed, 38 insertions(+), 37 deletions(-) diff --git a/README.md b/README.md index 97c16c466..e9e465f0b 100644 --- a/README.md +++ b/README.md @@ -217,10 +217,10 @@ Download the self-contained fat JAR for your Elasticsearch version: | Elasticsearch Version | Artifact | |-----------------------|----------------------------------------| -| ES 6.x | `softclient4es6-jdbc-driver-0.3.1.jar` | -| ES 7.x | `softclient4es7-jdbc-driver-0.3.1.jar` | -| ES 8.x | `softclient4es8-jdbc-driver-0.3.1.jar` | -| ES 9.x | `softclient4es9-jdbc-driver-0.3.1.jar` | +| ES 6.x | `softclient4es6-jdbc-driver-0.3.3.jar` | +| ES 7.x | `softclient4es7-jdbc-driver-0.3.3.jar` | +| ES 8.x | `softclient4es8-jdbc-driver-0.3.3.jar` | +| ES 9.x | `softclient4es9-jdbc-driver-0.3.3.jar` | > **Java 11+ recommended** (17+ for ES 9.x): **cross-index JOINs require Java 11+** — the embedded JOIN engine is built on Apache Arrow 18.x, which ships Java-11 bytecode. @@ -237,20 +237,20 @@ Driver class: app.softnetwork.elastic.jdbc.ElasticDriver app.softnetwork.elastic softclient4es8-jdbc-driver - 0.3.1 + 0.3.3 ``` **Gradle:** ```groovy -implementation 'app.softnetwork.elastic:softclient4es8-jdbc-driver:0.3.1' +implementation 'app.softnetwork.elastic:softclient4es8-jdbc-driver:0.3.3' ``` **sbt:** ```scala -libraryDependencies += "app.softnetwork.elastic" % "softclient4es8-jdbc-driver" % "0.3.1" +libraryDependencies += "app.softnetwork.elastic" % "softclient4es8-jdbc-driver" % "0.3.3" ``` The JDBC driver JARs are Scala-version-independent (no `_2.12` or `_2.13` suffix) and include all required dependencies. @@ -346,13 +346,13 @@ For programmatic access, add SoftClient4ES to your project. resolvers += "Softnetwork" at "https://softnetwork.jfrog.io/artifactory/releases/" // Choose your Elasticsearch version -libraryDependencies += "app.softnetwork.elastic" %% "softclient4es8-java-client" % "0.22.0" +libraryDependencies += "app.softnetwork.elastic" %% "softclient4es8-java-client" % "0.23.0" // Add the community extensions for materialized views (optional) -libraryDependencies += "app.softnetwork.elastic" %% "softclient4es-community-extensions" % "0.3.1" +libraryDependencies += "app.softnetwork.elastic" %% "softclient4es-community-extensions" % "0.3.2" // Add the arrow extensions for cross-index JOIN (required for JOINs; Java 11+) -libraryDependencies += "app.softnetwork.elastic" %% "softclient4es-arrow-extensions" % "0.3.1" +libraryDependencies += "app.softnetwork.elastic" %% "softclient4es-arrow-extensions" % "0.3.3" // Add the JDBC driver if you want to use it from Scala (optional) -libraryDependencies += "app.softnetwork.elastic" %% "softclient4es-jdbc-driver" % "0.3.1" +libraryDependencies += "app.softnetwork.elastic" %% "softclient4es-jdbc-driver" % "0.3.3" ``` ```scala diff --git a/documentation/client/adbc_driver.md b/documentation/client/adbc_driver.md index c6a30bd3d..b715649eb 100644 --- a/documentation/client/adbc_driver.md +++ b/documentation/client/adbc_driver.md @@ -23,10 +23,10 @@ Download the self-contained fat JAR for your Elasticsearch version: | Elasticsearch | Artifact | |----------------|-----------------------------------------------------| -| ES 6.x | `softclient4es6-adbc-driver-0.3.2.jar` | -| ES 7.x | `softclient4es7-adbc-driver-0.3.2.jar` | -| ES 8.x | `softclient4es8-adbc-driver-0.3.2.jar` | -| ES 9.x | `softclient4es9-adbc-driver-0.3.2.jar` | +| ES 6.x | `softclient4es6-adbc-driver-0.3.3.jar` | +| ES 7.x | `softclient4es7-adbc-driver-0.3.3.jar` | +| ES 8.x | `softclient4es8-adbc-driver-0.3.3.jar` | +| ES 9.x | `softclient4es9-adbc-driver-0.3.3.jar` | ### Maven / Gradle / sbt @@ -36,20 +36,20 @@ Download the self-contained fat JAR for your Elasticsearch version: app.softnetwork.elastic softclient4es8-adbc-driver - 0.3.2 + 0.3.3 ``` **Gradle:** ```groovy -implementation 'app.softnetwork.elastic:softclient4es8-adbc-driver:0.3.2' +implementation 'app.softnetwork.elastic:softclient4es8-adbc-driver:0.3.3' ``` **sbt:** ```scala -libraryDependencies += "app.softnetwork.elastic" % "softclient4es8-adbc-driver" % "0.3.2" +libraryDependencies += "app.softnetwork.elastic" % "softclient4es8-adbc-driver" % "0.3.3" ``` --- diff --git a/documentation/client/arrow_flight_sql.md b/documentation/client/arrow_flight_sql.md index 7876505e9..a4d65e24b 100644 --- a/documentation/client/arrow_flight_sql.md +++ b/documentation/client/arrow_flight_sql.md @@ -49,12 +49,12 @@ Available images per ES version: ### Pinning a release, and why there is no JAR The images above track `latest`. Pin the tag for anything you need to reproduce — the current -release is **`0.3.2`**: +release is **`0.3.3`**: ```bash docker run -p 32010:32010 \ -e ELASTIC_HOST=elasticsearch \ - softnetwork/softclient4es8-arrow-flight-sql:0.3.2 + softnetwork/softclient4es8-arrow-flight-sql:0.3.3 ``` The sidecar ships **as a Docker image only**. The `softclient4es{6,7,8,9}-arrow-flight-sql` diff --git a/documentation/client/jdbc.md b/documentation/client/jdbc.md index cad35fb65..d9ce5a76d 100644 --- a/documentation/client/jdbc.md +++ b/documentation/client/jdbc.md @@ -20,10 +20,10 @@ Download the self-contained fat JAR for your Elasticsearch version. The JARs are | Elasticsearch | Artifact | |---------------|----------| -| ES 6.x | `softclient4es6-jdbc-driver-0.3.2.jar` | -| ES 7.x | `softclient4es7-jdbc-driver-0.3.2.jar` | -| ES 8.x | `softclient4es8-jdbc-driver-0.3.2.jar` | -| ES 9.x | `softclient4es9-jdbc-driver-0.3.2.jar` | +| ES 6.x | `softclient4es6-jdbc-driver-0.3.3.jar` | +| ES 7.x | `softclient4es7-jdbc-driver-0.3.3.jar` | +| ES 8.x | `softclient4es8-jdbc-driver-0.3.3.jar` | +| ES 9.x | `softclient4es9-jdbc-driver-0.3.3.jar` | ### Build Tool Integration @@ -33,20 +33,20 @@ Download the self-contained fat JAR for your Elasticsearch version. The JARs are app.softnetwork.elastic softclient4es8-jdbc-driver - 0.3.2 + 0.3.3 ``` **Gradle:** ```groovy -implementation 'app.softnetwork.elastic:softclient4es8-jdbc-driver:0.3.2' +implementation 'app.softnetwork.elastic:softclient4es8-jdbc-driver:0.3.3' ``` **sbt:** ```scala -libraryDependencies += "app.softnetwork.elastic" % "softclient4es8-jdbc-driver" % "0.3.2" +libraryDependencies += "app.softnetwork.elastic" % "softclient4es8-jdbc-driver" % "0.3.3" ``` --- diff --git a/documentation/client/repl.md b/documentation/client/repl.md index 5d1196ca8..d3640d434 100644 --- a/documentation/client/repl.md +++ b/documentation/client/repl.md @@ -162,7 +162,7 @@ unchanged — there is no second implementation to drift: ```bat install.cmd -ListVersions -EsVersion 8 -install.cmd -Target "C:\tools\softclient4es" -EsVersion 8 -Version 0.22.0 +install.cmd -Target "C:\tools\softclient4es" -EsVersion 8 -Version 0.23.0 install.cmd -EsVersion 9 -NoExtensions install.cmd -Help ``` @@ -217,8 +217,9 @@ install.cmd -ListVersions -EsVersion 8 • 0.20.4 • 0.21.0 • 0.22.0 + • 0.23.0 - Total: 6 version(s) + Total: 7 version(s) To install a specific version: ./install.sh --es-version 8 --version @@ -246,7 +247,7 @@ install.cmd -ListVersions -EsVersion 8 ./install.sh --list-versions --es-version 8 # Install specific version -./install.sh --es-version 8 --version 0.22.0 +./install.sh --es-version 8 --version 0.23.0 # Install for Elasticsearch 9 (requires Java 17+) ./install.sh --es-version 9 @@ -255,7 +256,7 @@ install.cmd -ListVersions -EsVersion 8 ./install.sh --target /opt/softclient4es # Full custom installation -./install.sh --target ~/tools/softclient4es --es-version 7 --version 0.22.0 +./install.sh --target ~/tools/softclient4es --es-version 7 --version 0.23.0 ``` #### Windows @@ -268,7 +269,7 @@ install.cmd -ListVersions -EsVersion 8 .\install.ps1 -ListVersions -EsVersion 8 # Install specific version -.\install.ps1 -EsVersion 8 -Version 0.22.0 +.\install.ps1 -EsVersion 8 -Version 0.23.0 # Install for Elasticsearch 9 (requires Java 17+) .\install.ps1 -EsVersion 9 @@ -277,7 +278,7 @@ install.cmd -ListVersions -EsVersion 8 .\install.ps1 -Target "C:\tools\softclient4es" # Full custom installation -.\install.ps1 -Target "C:\tools\softclient4es" -EsVersion 7 -Version 0.22.0 +.\install.ps1 -Target "C:\tools\softclient4es" -EsVersion 7 -Version 0.23.0 ``` --- diff --git a/install.cmd b/install.cmd index 05be14d57..4e5be6729 100644 --- a/install.cmd +++ b/install.cmd @@ -19,7 +19,7 @@ rem rem install.cmd rem install.cmd -ListVersions -EsVersion 8 rem install.cmd -Target "C:\tools\softclient4es" -EsVersion 8 -Version 1.0.0 -rem install.cmd -EsVersion 7 -Version 0.22.0 -NoExtensions +rem install.cmd -EsVersion 7 -Version 0.23.0 -NoExtensions rem install.cmd -Help rem rem Caveat worth knowing: -ExecutionPolicy Bypass is overridden when the policy @@ -53,8 +53,8 @@ rem The pinned hash belongs to the pinned tag, so overriding the ref drops the rem integrity check unless SOFTCLIENT4ES_INSTALL_SHA256 supplies another one - rem and says so when it does not. rem --------------------------------------------------------------------------- -set "PS1_REF=v0.22.0" -set "PS1_SHA256=6a31198e68170eaca9fb05b6418713c6f7669d08f7bf46e9ed9cc622de0ae5c4" +set "PS1_REF=v0.23.0" +set "PS1_SHA256=9a7c772ce2d6934eca9cc63145753fbed60f8adfd039113bc0b1063e0a7d7966" rem One `if` per line, never a parenthesised block: cmd expands every %VAR% in a rem block in ONE parse pass, before running any line in it. diff --git a/install.ps1 b/install.ps1 index 4fcb786b7..5d27b501d 100644 --- a/install.ps1 +++ b/install.ps1 @@ -63,7 +63,7 @@ Examples: .\install.ps1 .\install.ps1 -ListVersions -EsVersion 8 .\install.ps1 -Target "C:\tools\softclient4es" -EsVersion 8 -Version 1.0.0 - .\install.ps1 -EsVersion 7 -Version 0.22.0 -NoExtensions + .\install.ps1 -EsVersion 7 -Version 0.23.0 -NoExtensions "@ exit 0