Skip to content

docs: reference the 0.22.0 train (core 0.22.0, drivers/sidecar 0.3.1, installer pin v0.22.0) #272

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fupelaqu merged 1 commit into from
Sep 3, 2026
Merged

docs: reference the 0.22.0 train (core 0.22.0, drivers/sidecar 0.3.1, installer pin v0.22.0) #272

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 11 additions & 11 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.0.jar` |
| ES 7.x | `softclient4es7-jdbc-driver-0.3.0.jar` |
| ES 8.x | `softclient4es8-jdbc-driver-0.3.0.jar` |
| ES 9.x | `softclient4es9-jdbc-driver-0.3.0.jar` |
| 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` |

> **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.

Expand All @@ -237,20 +237,20 @@ Driver class: app.softnetwork.elastic.jdbc.ElasticDriver
<dependency>
<groupId>app.softnetwork.elastic</groupId>
<artifactId>softclient4es8-jdbc-driver</artifactId>
<version>0.3.0</version>
<version>0.3.1</version>
</dependency>
```

**Gradle:**

```groovy
implementation 'app.softnetwork.elastic:softclient4es8-jdbc-driver:0.3.0'
implementation 'app.softnetwork.elastic:softclient4es8-jdbc-driver:0.3.1'
```

**sbt:**

```scala
libraryDependencies += "app.softnetwork.elastic" % "softclient4es8-jdbc-driver" % "0.3.0"
libraryDependencies += "app.softnetwork.elastic" % "softclient4es8-jdbc-driver" % "0.3.1"
```

The JDBC driver JARs are Scala-version-independent (no `_2.12` or `_2.13` suffix) and include all required dependencies.
Expand Down Expand Up @@ -339,13 +339,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.21.0"
libraryDependencies += "app.softnetwork.elastic" %% "softclient4es8-java-client" % "0.22.0"
// Add the community extensions for materialized views (optional)
libraryDependencies += "app.softnetwork.elastic" %% "softclient4es-community-extensions" % "0.3.0"
libraryDependencies += "app.softnetwork.elastic" %% "softclient4es-community-extensions" % "0.3.1"
// Add the arrow extensions for cross-index JOIN (required for JOINs; Java 11+)
libraryDependencies += "app.softnetwork.elastic" %% "softclient4es-arrow-extensions" % "0.3.0"
libraryDependencies += "app.softnetwork.elastic" %% "softclient4es-arrow-extensions" % "0.3.1"
// Add the JDBC driver if you want to use it from Scala (optional)
libraryDependencies += "app.softnetwork.elastic" %% "softclient4es-jdbc-driver" % "0.3.0"
libraryDependencies += "app.softnetwork.elastic" %% "softclient4es-jdbc-driver" % "0.3.1"
```

```scala
Expand Down
14 changes: 7 additions & 7 deletions documentation/client/adbc_driver.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,10 +23,10 @@ Download the self-contained fat JAR for your Elasticsearch version:

| Elasticsearch | Artifact |
|----------------|-----------------------------------------------------|
| ES 6.x | `softclient4es6-adbc-driver-0.3.0.jar` |
| ES 7.x | `softclient4es7-adbc-driver-0.3.0.jar` |
| ES 8.x | `softclient4es8-adbc-driver-0.3.0.jar` |
| ES 9.x | `softclient4es9-adbc-driver-0.3.0.jar` |
| ES 6.x | `softclient4es6-adbc-driver-0.3.1.jar` |
| ES 7.x | `softclient4es7-adbc-driver-0.3.1.jar` |
| ES 8.x | `softclient4es8-adbc-driver-0.3.1.jar` |
| ES 9.x | `softclient4es9-adbc-driver-0.3.1.jar` |

### Maven / Gradle / sbt

Expand All @@ -36,20 +36,20 @@ Download the self-contained fat JAR for your Elasticsearch version:
<dependency>
<groupId>app.softnetwork.elastic</groupId>
<artifactId>softclient4es8-adbc-driver</artifactId>
<version>0.3.0</version>
<version>0.3.1</version>
</dependency>
```

**Gradle:**

```groovy
implementation 'app.softnetwork.elastic:softclient4es8-adbc-driver:0.3.0'
implementation 'app.softnetwork.elastic:softclient4es8-adbc-driver:0.3.1'
```

**sbt:**

```scala
libraryDependencies += "app.softnetwork.elastic" % "softclient4es8-adbc-driver" % "0.3.0"
libraryDependencies += "app.softnetwork.elastic" % "softclient4es8-adbc-driver" % "0.3.1"
```

---
Expand Down
10 changes: 5 additions & 5 deletions documentation/client/arrow_flight_sql.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,15 +49,15 @@ Available images per ES version:
### Fat JAR

```bash
java -jar softclient4es8-arrow-flight-sql-0.3.0.jar
java -jar softclient4es8-arrow-flight-sql-0.3.1.jar
```

| Elasticsearch | Artifact |
|---------------|----------|
| ES 6.x | `softclient4es6-arrow-flight-sql-0.3.0.jar` |
| ES 7.x | `softclient4es7-arrow-flight-sql-0.3.0.jar` |
| ES 8.x | `softclient4es8-arrow-flight-sql-0.3.0.jar` |
| ES 9.x | `softclient4es9-arrow-flight-sql-0.3.0.jar` |
| ES 6.x | `softclient4es6-arrow-flight-sql-0.3.1.jar` |
| ES 7.x | `softclient4es7-arrow-flight-sql-0.3.1.jar` |
| ES 8.x | `softclient4es8-arrow-flight-sql-0.3.1.jar` |
| ES 9.x | `softclient4es9-arrow-flight-sql-0.3.1.jar` |

---

Expand Down
2 changes: 1 addition & 1 deletion documentation/client/download_analytics.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ beacon to a public endpoint with exactly these fields:
|---------------|----------|-----------------------------------------------|
| `source` | `portal` | Where the count came from (the docs button) |
| `driver` | `jdbc` | Which driver family (`jdbc` or `adbc`) |
| `version` | `0.3.0` | The published artifact version |
| `version` | `0.3.1` | The published artifact version |
| `count_delta` | `1` | One download |

A timestamp is added on the server. That is the **entire** record.
Expand Down
14 changes: 7 additions & 7 deletions documentation/client/jdbc.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.0.jar` |
| ES 7.x | `softclient4es7-jdbc-driver-0.3.0.jar` |
| ES 8.x | `softclient4es8-jdbc-driver-0.3.0.jar` |
| ES 9.x | `softclient4es9-jdbc-driver-0.3.0.jar` |
| 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` |

### Build Tool Integration

Expand All @@ -33,20 +33,20 @@ Download the self-contained fat JAR for your Elasticsearch version. The JARs are
<dependency>
<groupId>app.softnetwork.elastic</groupId>
<artifactId>softclient4es8-jdbc-driver</artifactId>
<version>0.3.0</version>
<version>0.3.1</version>
</dependency>
```

**Gradle:**

```groovy
implementation 'app.softnetwork.elastic:softclient4es8-jdbc-driver:0.3.0'
implementation 'app.softnetwork.elastic:softclient4es8-jdbc-driver:0.3.1'
```

**sbt:**

```scala
libraryDependencies += "app.softnetwork.elastic" % "softclient4es8-jdbc-driver" % "0.3.0"
libraryDependencies += "app.softnetwork.elastic" % "softclient4es8-jdbc-driver" % "0.3.1"
```

---
Expand Down
13 changes: 7 additions & 6 deletions documentation/client/repl.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.21.0
install.cmd -Target "C:\tools\softclient4es" -EsVersion 8 -Version 0.22.0
install.cmd -EsVersion 9 -NoExtensions
install.cmd -Help
```
Expand Down Expand Up @@ -216,8 +216,9 @@ install.cmd -ListVersions -EsVersion 8
• 0.20.3
• 0.20.4
• 0.21.0
• 0.22.0

Total: 5 version(s)
Total: 6 version(s)

To install a specific version:
./install.sh --es-version 8 --version <version>
Expand Down Expand Up @@ -245,7 +246,7 @@ install.cmd -ListVersions -EsVersion 8
./install.sh --list-versions --es-version 8

# Install specific version
./install.sh --es-version 8 --version 0.21.0
./install.sh --es-version 8 --version 0.22.0

# Install for Elasticsearch 9 (requires Java 17+)
./install.sh --es-version 9
Expand All @@ -254,7 +255,7 @@ install.cmd -ListVersions -EsVersion 8
./install.sh --target /opt/softclient4es

# Full custom installation
./install.sh --target ~/tools/softclient4es --es-version 7 --version 0.21.0
./install.sh --target ~/tools/softclient4es --es-version 7 --version 0.22.0
```

#### Windows
Expand All @@ -267,7 +268,7 @@ install.cmd -ListVersions -EsVersion 8
.\install.ps1 -ListVersions -EsVersion 8

# Install specific version
.\install.ps1 -EsVersion 8 -Version 0.21.0
.\install.ps1 -EsVersion 8 -Version 0.22.0

# Install for Elasticsearch 9 (requires Java 17+)
.\install.ps1 -EsVersion 9
Expand All @@ -276,7 +277,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.21.0
.\install.ps1 -Target "C:\tools\softclient4es" -EsVersion 7 -Version 0.22.0
```

---
Expand Down
6 changes: 3 additions & 3 deletions install.cmd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.21.0 -NoExtensions
rem install.cmd -EsVersion 7 -Version 0.22.0 -NoExtensions
rem install.cmd -Help
rem
rem Caveat worth knowing: -ExecutionPolicy Bypass is overridden when the policy
Expand Down Expand Up @@ -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.21.0"
set "PS1_SHA256=e1275bd269c8bb922d28827b6c74e965bbe7b5139b4e16138bacaac7c03912ae"
set "PS1_REF=v0.22.0"
set "PS1_SHA256=6a31198e68170eaca9fb05b6418713c6f7669d08f7bf46e9ed9cc622de0ae5c4"

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.
Expand Down
2 changes: 1 addition & 1 deletion install.ps1
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.21.0 -NoExtensions
.\install.ps1 -EsVersion 7 -Version 0.22.0 -NoExtensions

"@
exit 0
Expand Down
Loading