Replace mysql client with mysql2

[paescuj]

Scope

Replace the database client library mysql with mysql2, which is a continuation of the former. The client is used to connect to MySQL/MariaDB databases.

Besides mysql2 being actively maintained, it also promises better performance along with additional features.
Switching to mysql2 enables using MySQL without the mysql_native_password authentication plugin, deprecated in MySQL 8.0.34 ¹. mysql2 is a drop in replacement for mysql, with two known incompatibilities ² (see below).

Potential Risks / Drawbacks

As mentioned in the breaking changes:

• mysql2 leads to cross-collection queries (filtering on relations) with stricter charset comparison, meaning the value of DB_CHARSET/DB_CHARSET_NUMBER needs to match the charset of the tables to work properly. This has already been recommended before and a corresponding warning in the server log has already been in place.
• Values of type "Decimal" are now returned as a string instead of a number, which ensures that the precision is preserved. This matches the behavior of PostgreSQL.

Review Notes / Questions

As you can see in https://github.com/directus/directus/actions/runs/9478259269, the blackbox tests are successful (only the checks fail, which are generally an issue at the moment)

---

Closes #19361, related to #20502

Footnotes

1. https://dev.mysql.com/doc/relnotes/mysql/8.0/en/news-8-0-34.html ↩

2. https://sidorares.github.io/node-mysql2/docs/documentation#known-incompatibilities-with-node-mysql ↩

[changeset-bot]

🦋 Changeset detected

Latest commit: 178ee40

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@directus/api	Major
directus	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR