elasticsearch/docs/reference/sql/endpoints/version-compat.asciidoc
Bogdan Pintea 925f1645cf
SQL: Enforce and document dedicated client version compatibility (#70451)
* Implement dedicated client version compatibility

Add further dedicated client (xDBC, CLI) compatibility rules and
document these. A client is version-compatible with the server if:
- it supports version compatibility (past or on 7.7.0); and
- it's not on a version newer than server's; and
- it's major version is at most one unit behind server's.

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2021-03-22 11:17:51 +01:00

49 lines
1.4 KiB
Text
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Your driver must be compatible with your {es} server version.
IMPORTANT: The driver version cannot be newer than the {es} server version.
For example, A 7.10.0 server is not compatible with {version} drivers.
[options="header",cols="1,3a,1"]
|====
| {es} server version
| Compatible driver versions
| Example
ifeval::[ "{major-version}" != "7.x" ]
ifeval::[ "{minor-version}" != "8.0" ]
| 8.0.0{version}
| * The same version
* Any earlier 8.x version
* Any 7.x version after 7.7.0.
| An {version} server is compatible with {version} and earlier 8.x drivers. An
{version} server is also compatible with 7.7.0 and later 7.x drivers.
endif::[]
ifeval::[ "{minor-version}" == "8.0" ]
| 8.0.0
| * The same version
* Any 7.x version after 7.7.0.
| An 8.0.0 server is compatible with 8.0.0 drivers. An 8.0.0 server is also
compatible with 7.7.0 and later 7.x drivers.
endif::[]
// After 8.0 release, replace 7.x with last 7.x version
| 7.7.1-7.x
| * The same version
* An earlier 7.x version, back to 7.7.0.
| A 7.10.0 server is compatible with 7.7.0-7.10.0 drivers.
endif::[]
ifeval::[ "{major-version}" == "7.x" ]
| 7.7.1-{version}
| * The same version
* An earlier 7.x version, back to 7.7.0.
| A 7.10.0 server is compatible with 7.7.0-7.10.0 drivers.
endif::[]
| 7.7.0 and earlier versions
| * The same version.
| A 7.6.1 server is only compatible with 7.6.1 drivers.
|====