Back to Databend

compat_docs

src/meta/ver/compat_docs/README.md

1.2.888-patch-52.0 KB
Original Source

compat_docs

Compatible version ranges between databend-query and databend-meta-service.

For Users

Pre-calculated compatible version ranges:

To look up a specific version:

bash
python3 scripts/find_compat.py -q 1.2.600   # compatible metasrv for query 1.2.600
python3 scripts/find_compat.py -m 1.2.400   # compatible query for metasrv 1.2.400

For Developers

Regenerate: update the known versions in src/, then:

bash
make

Scripts

FilePurpose
scripts/extract_from_git.pyOne-time. Extracts version constraints from git tags into src/min_compatible_versions.txt.
scripts/resolve_versions.pyResolves CalVer (e.g. 260205.0.0) to repo tag versions. Writes generated/resolved_min_compatibles.txt.
scripts/find_compat.pyPrints compatible version range for a given query or metasrv version.
MakefileRuns resolve then generates both output files.

Source Data (src/)

FilePurpose
src/min_compatible_versions.txtRaw version data from git tags.
src/external-meta-min-compatibles.txtMin server/client versions for each external databend-meta crate release.

Generated Output

FilePurpose
generated/resolved_min_compatibles.txtResolved version table. Input for scripts/find_compat.py.
query_to_meta.txtCompatible metasrv range for every query version.
meta_to_query.txtCompatible query range for every metasrv version.