Skip to content

Commit 728717f

Browse files
authored
docs(FAQ): add answer about supported db versions
1 parent 7809ff4 commit 728717f

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

FAQ.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,23 @@
11
SQLx Frequently Asked Questions
22
===============================
33

4+
### What database versions does SQLx support?
5+
6+
This is a difficult question to answer because it depends on which features of the databases are used and when those features were introduced. SQL databases tend to be very strongly backwards-compatible so it's likely that SQLx will work with some very old versions.
7+
8+
TLS support is one of the features that ages most quickly with databases, since old SSL/TLS versions are deprecated over time as they become insecure due to weaknesses being discovered; this is especially important to consider when using RusTLS, as it only supports the latest TLS version for security reasons (see the question below mentioning RusTLS for details).
9+
10+
As a rule, however, we only officially support the range of versions for each database that are still actively maintained, and will drop support for versions as they reach their end-of-life.
11+
12+
* Postgres has a page to track these versions and give their end-of-life dates: https://www.postgresql.org/support/versioning/
13+
* MariaDB has a similar list here (though it doesn't show the dates at which old versions were EOL'd): https://mariadb.com/kb/en/mariadb-server-release-dates/
14+
* MySQL's equivalent page is more concerned with what platforms are supported by the newest and oldest maintained versions: https://www.mysql.com/support/supportedplatforms/database.html
15+
* However, its Wikipedia page helpfully tracks its versions and their announced EOL dates: https://en.wikipedia.org/wiki/MySQL#Release_history
16+
* SQLite is easy as only SQLite 3 is supported and the current version depends on the version of the `libsqlite3-sys` crate being used.
17+
18+
For each database and where applicable, we test against the latest and oldest versions that we intend to support. You can see the current versions being tested against by looking at our CI config: https://github.com/launchbadge/sqlx/blob/main/.github/workflows/sqlx.yml#L168
19+
20+
-------------------------------------------------------------------
421
### What versions of Rust does SQLx support? What is SQLx's MSRV\*?
522

623
Officially, we will only ever support the latest stable version of Rust.

0 commit comments

Comments
 (0)