Skip to content

Commit 152cb25

Browse files
Merge pull request #209 from datajoint/docs/db-version-support-policy
docs(backends): state DB version support policy — LTS-targeted, scope out MySQL 9.x
2 parents 1179818 + 0aae045 commit 152cb25

1 file changed

Lines changed: 18 additions & 4 deletions

File tree

src/reference/specs/database-backends.md

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,24 @@ DataJoint supports multiple database backends through a unified adapter architec
77

88
## Supported Backends
99

10-
| Backend | Minimum Version | Default Port | Status |
11-
|---------|-----------------|--------------|--------|
12-
| MySQL | 8.0.13 | 3306 | Production |
13-
| PostgreSQL | 15 | 5432 | Production |
10+
| Backend | Minimum Version | Tested in CI | Default Port | Status |
11+
|---------|-----------------|--------------|--------------|--------|
12+
| MySQL | 8.0.13 | 8.0, 8.4 (LTS) | 3306 | Production |
13+
| PostgreSQL | 15 | 15 | 5432 | Production |
14+
| MariaDB |||| **Not supported** |
15+
16+
### Version support policy
17+
18+
DataJoint targets **long-term-support (LTS) database releases** — the versions offered by managed
19+
services such as AWS RDS:
20+
21+
- **MySQL** — the **8.0** and **8.4** LTS lines; CI exercises both (see
22+
[datajoint-python#1498](https://github.com/datajoint/datajoint-python/pull/1498)).
23+
- **PostgreSQL****15** and later.
24+
- **MySQL 9.x is not a supported target.** The 9.x series is a sequence of short-lived *Innovation*
25+
releases — there is no 9.x LTS, and it is not offered as a standard managed-service engine. DataJoint
26+
may run on it, but it is untested and support is best-effort only.
27+
- **MariaDB is not officially supported** in DataJoint 2.x; the client emits a warning on connection.
1428

1529
## Configuration
1630

0 commit comments

Comments
 (0)