158 lines
8.1 KiB
Markdown
158 lines
8.1 KiB
Markdown
# awesome-mariadb
|
|
A curated list of awesome MariaDB resources, maintained by [Vettabase](https://vettabase.com) and sponsored by the [MariaDB Foundation](https://mariadb.org/).
|
|
|
|
[](https://github.com/sindresorhus/awesome) Inspired by the `awesome-*` trend on GitHub.
|
|
|
|
Topics are organised by audience, to save people from navigating through the noise.
|
|
|
|
**Awesome MariaDB sublists**
|
|
|
|
Lists for a specific audience:
|
|
|
|
- **[Awesome MariaDB for Database Administrators](list-dba.md)**
|
|
- **[Awesome MariaDB for Developers](list-dev.md)**
|
|
- **[Awesome MariaDB for Data Engineers](list-den.md)**
|
|
|
|
Specific topics:
|
|
|
|
- [Hilarious 🤣 MariaDB List](humour.md)
|
|
- [Awesome MariaDB Internals and Plugins Development](list-int.md)
|
|
|
|
## The Problem we Try to Solve
|
|
|
|
Why are we maintaining a list that is specifically for MariaDB, and not for MySQL and its forks?
|
|
|
|
It's easy to find software, cloud services or educative resources for MySQL. Finding MariaDB related resources is a bit
|
|
more difficult. The reason is simple: many authors of MySQL resources assume that, if something works with MySQL,
|
|
it will work with MariaDB as well. And it is certainly true that MariaDB and MySQL are very similar. MariaDB was initially
|
|
created by forking MySQL 5.1, and some effort to guarantee compatibility was made over the years.
|
|
|
|
However, MariaDB and MySQL are diverging more and more over time. So, before saying that a MySQL resource works well with
|
|
MariaDB, you should ask yourself some questions:
|
|
|
|
**Does the Resource Use Some MySQL Unique Features?**
|
|
|
|
In the worst case, a tool won't work at all, but this is not common. It is more common that some features of a tool can't
|
|
be used with MariaDB. For example, using certain features of the community.mysql Ansible module will generate queries that
|
|
fail with MariaDB.
|
|
|
|
**Does the Resource take Advantage of MariaDB Unique Features?**
|
|
|
|
Sometimes a resource works on MySQL, but it does things that could be done better by taking advantage of MariaDB features.
|
|
For example, a GUI might not allow you to create a `UUID` or `INET6` columns because these types are not supported by MySQL.
|
|
An ORM for MySQL might not allow you to produce a `DELETE ... RETURNING` for the same reason. A monitoring system for
|
|
MySQL normally won't show MariaDB-specific metrics.
|
|
|
|
**Is the Resource Adequately Tested with MariaDB?**
|
|
|
|
This might not matter much for a blog post. But software projects should be well tested with MariaDB. It's easy to overlook
|
|
this necessity, because one might think that if the code doesn't return strange errors it works. But when a query fails, the
|
|
application might not expose errors. After some time you might find out that some data are missing or inconsistent.
|
|
|
|
**Is the Resource Really "for MySQL and MariaDB"?**
|
|
|
|
As you can guess, sometimes resources "for MySQL and MariaDB" are mostly for MySQL, meaning that they are not thoroughly
|
|
tested and optimised for MariaDB. Any of the problems listed above might apply in such cases.
|
|
|
|
If you spot these problems in an open source application that officially supports MariaDB, please report a bug or contribute
|
|
a bugfix.
|
|
|
|
## Our Solution: Awesome MariaDB
|
|
|
|
When the MariaDB Foundation reached us proposing to sponsor the Awesome MariaDB list, we saw it as an opportunity to help
|
|
tackle the above problem. But how exactly?
|
|
|
|
**Provide a List of Real MariaDB Resources**
|
|
|
|
In this list, whenever possible, you will only find resources that properly support MariaDB. It doesn't matter to us if it
|
|
also supports MySQL or not, and whether the project's priority is MariaDB or not. We simply want to list "stuff that works
|
|
well".
|
|
|
|
Ideally, we aim to test all the listed resources with MariaDB. We temporarily list resources that we didn't test yet, but
|
|
in that case we at least checked the documentation and the website for MariaDB support. When unsure, we also take a look
|
|
at the source code.
|
|
|
|
Whenever relevant, we indicate if a project is FLOSS software (Free/Libre Open Source Software), proprietary downloadable
|
|
software, or a cloud service. When appropriate, we also indicate the supported platforms or programming language. These
|
|
aspects are often very important when you're looking for software that solves a problem.
|
|
|
|
**Provide a List of Open Source Resources That Have Problems with MariaDB**
|
|
|
|
If a listed resource has problems with MariaDB, we aim to indicate this. We try to list such resources only if they are
|
|
open source or free software. In this case, if you decide to use the resource, we warmly encourage you to contribute to
|
|
the project, with the aim of improving MariaDB support by applications.
|
|
|
|
There are various ways you can contribute improving MariaDB support:
|
|
|
|
* Report bugs describing them clearly, to help software maintainers to reproduce them.
|
|
* Contribute bugfixes.
|
|
* Report mistakes in documentation, technical articles, and even printed books.
|
|
* Write a guide on how to make an application work smoothly with MariaDB, for example in the form of a blog post.
|
|
|
|
**Knowledge Sharing**
|
|
|
|
Suppose you consult Awesome MariaDB, and you learn that a certain software doesn't work well with MariaDB because it
|
|
doesn't use a certain SQL syntax. If you're a developer, you'll find out that this syntax exists, and what it is for.
|
|
Hopefully, you will later use this information in your daily job to produce better code.
|
|
|
|
**Grow a Sense of Community**
|
|
|
|
All the activity listed in the previous point are normal and spontaneously happen in a community.
|
|
|
|
Let's grow the MariaDB community to see an increase in these kinds of activities, and let's show support towards resources
|
|
that aim to work well with MariaDB.
|
|
|
|
[Make it so!](https://memory-alpha.fandom.com/wiki/Make_It_So)
|
|
|
|
(yes, adding a nerd Star Trek link was one of our primary goals as well)
|
|
|
|
## Contributing
|
|
|
|
Contributions welcome!
|
|
|
|
If you want to suggest a new resource, remember that this is **Awesome MariaDB**, and ask yourself two simple questions:
|
|
|
|
- Does it work well with MariaDB?
|
|
- Is it actually awesome?
|
|
|
|
If both the answers are yes, you can add links through [pull requests](https://github.com/Vettabase/awesome-mariadb/pulls).
|
|
Once a PR is approved, we would appreciate if you take the time to notify the maintainer of the resource.
|
|
|
|
If you find inaccurate information, obsolete information, or resources that are not maintained anymore, please report the
|
|
problem by creating an [issue](https://github.com/Vettabase/awesome-mariadb/issues), or fix it by yourself by opening
|
|
a [pull request](https://github.com/Vettabase/awesome-mariadb/pulls).
|
|
|
|
If you contribute to Awesome MariaDB, we encourage you to add your name to the `CONTRIBUTORS.md` file.
|
|
|
|
## How to Thank Us
|
|
|
|
If you're the maintainer of a resource we linked, we encourage you to show in your resource an
|
|
[Awesome mentioned badge](https://github.com/sindresorhus/awesome/blob/main/awesome.md#awesome-mentioned-badge).
|
|
|
|
Simply paste this code in your `README.md` file:
|
|
|
|
```
|
|
[](https://github.com/Vettabase/awesome-mariadb)
|
|
```
|
|
|
|
The result will look like the following:
|
|
|
|
[](https://github.com/Vettabase/awesome-mariadb)
|
|
|
|
## Related Awesome Lists
|
|
|
|
- [Awesome MySQL](https://github.com/shlomi-noach/awesome-mysql) - Resources for MySQL and its variants. Only includes resources that are open source and available without registration. Their quality requirements are stricter than ours.
|
|
- [Awesome MySQL Performance](https://github.com/Releem/awesome-mysql-performance) - A curated list of awesome links related to MySQL / MariaDB / Percona Server configuration tuning for improved performance.
|
|
- [Awesome Database](https://github.com/agarcialeon/awesome-database) - A categorized community-driven collection of amazingly awesome database resources.
|
|
|
|
See also [Applications Supporting MariaDB](https://mariadb.com/docs/server/clients-and-utilities/server-client-software/applications-supporting-mariadb), in the MariaDB Documentation.
|
|
|
|
---
|
|
|
|
Copyright 2024 2025 Vettabase Ltd and contributors.
|
|
|
|
Awesome MariaDB list is licensed under [CC BY-SA 4.0 license](https://creativecommons.org/licenses/by-sa/4.0/).
|
|
|
|
[mariadb.md Github](https://github.com/Vettabase/awesome-mariadb
|
|
)
|