MariaDBのソースを表示

MariaDBは、MariaDB Foundationのもとに組織されたオリジナルのMySQL開発者によって開発および保守されているMySQLのフォークです。よりオープンであると考えられており、最近のLinuxディストリビューションの大多数で、MySQL互換のデフォルトデータベースとして配布されています。また、MariaDBの新しいバージョンは、MySQLより低いレイテンシと高いスループットを備え、パフォーマンスにも優れています。実際にMariaDB自身がMySQLとのベンチマークを実施しており、その結果はこちらで見ることができます：[https://mariadb.com/resources/blog/benchmark-mariadb-vs-mysql-on-commodity-cloud-hardware/ Benchmark: MariaDB vs MySQL on Commodity Cloud Hardware]。

MariaDBはOracle MySQLのドロップイン置き換えであり、PHPにデフォルトで同梱されている標準のmysqliドライバを使用して、サポートされている安定版のMoodleのどのバージョンでも使用できます。
==MoodleのMariaDBドライバ==



MoodleにはMariaDB専用のドライバがあります。config.phpで、Moodleのmariadbドライバを明示的に指定することをお勧めします：

<syntaxhighlight lang="php">
$CFG->dbtype = 'mariadb';
$CFG->dblibrary = 'native';
</syntaxhighlight>

現時点では、このドライバはMySQLのものと似ていますが、将来的には実装が大きく異なる可能性があります。

詳細については[[MySQL]]をご覧ください。セットアップ手順はほぼ同じです。

== インストール ==
MariaDBのインストールは比較的簡単で、LinuxやWindowsでの一般的なパッケージのインストールと同様です。サイトにアクセスして必要なものを直接ダウンロードすることもできますし（主にWindowsの場合）、Linuxであれば、筆者ならほとんどのパッケージと同様にAPTで入手します。 

MariaDBのインストールおよびインストール後のセットアップについては、DigitalOceanが優れたガイドを書いています：[https://www.digitalocean.com/community/tutorials/how-to-install-mariadb-on-ubuntu-22-04 How To Install MariaDB on Ubuntu 22.04]。ただし、いずれにせよLOMPスタックをインストールするのであれば、こちらのガイドの方が適しているかもしれません：[https://www.digitalocean.com/community/tutorials/how-to-install-linux-openlitespeed-mariadb-php-lomp-stack-on-ubuntu-22-04 How To Install Linux, OpenLiteSpeed, MariaDB, PHP (LOMP stack) on Ubuntu 22.04]。最初のガイドは、必要に応じてユーザをパスワード認証に変更する方法（現在、Linuxでのデフォルトはunixソケット認証です）も扱っているため、より適しているかもしれません。とはいえ、両方にざっと目を通しておく価値はあるでしょう。それ以外の点ではよく似ています（しかも、ざっと読みやすい内容です）。

データベースのセットアップは[[MySQL]]の場合とほぼまったく同じです（ただし、MariaDBではutf8mb4とInnoDBがデフォルトであるため、サーバの文字セットをutf8mb4に設定したり、InnoDBを有効にしたりする必要はありません。データベースを作成する際に指定することだけは忘れないでください）。そのため、[[Moodleのインストール]]または[[Ubuntu向けステップバイステップインストールガイド|Ubuntu向けステップバイステップインストールガイド]]の手順に従ってセットアップできます。

== インストール後のMariaDBの最適化およびチューニング ==
MariaDBは、そのままの状態でもかなりよくチューニングされており、開発者によれば、不要なチューニングはかえってパフォーマンスを低下させる可能性があるため、ここでは慎重に進めてください。MariaDBのドキュメントには最適化とチューニングに関するセクションがまるごと用意されています：[https://mariadb.com/kb/en/optimization-and-tuning/ Optimization and Tuning]。ただし、その大部分はデータベースクエリの設計などについて述べたもので、ここでの利用者にとってはおおむね範囲外です。そのため、ひとまずそれは飛ばして、パフォーマンスの最適化についてインターネット上で意見が一致しているように思われるいくつかの点に進みます。まずはメモリ使用量です。

=== メモリ割り当て ===
MariaDBのドキュメントには[https://mariadb.com/kb/en/mariadb-memory-allocation/ Memory Allocation]（メモリ割り当て）に関する専用のページがあり、筆者が見たそのドキュメントの中では、おそらくこれが最も役に立つページだと思います。要するに、MySQLと同様に、パフォーマンス向上の大部分は、利用可能なメモリに応じて[https://mariadb.com/kb/en/innodb-system-variables/#innodb_buffer_pool_size innoDB_buffer_pool_size]を正しく設定することで得られます。残念ながら、これは状況によって大きく異なるため、ここではほとんど指針を示すことができません。すべては環境、RAMの容量、サーバ上でほかに何が実行されているかによります。ただし最低限として、軽量なものを構築する場合でも、最近のホスティングではRAMがかなり安価になっていることを考えると、筆者ならMariaDB全体に1GB未満を割り当てることはまずありません。何よりも安心のためです。ただし、これは比較的小規模なMoodleサーバを前提にしたものなので、当然、規模の拡大に応じて変わります。このGitHubのページ（[https://gist.github.com/DroneZzZko/4a38a1652187dbd0a89c17ed5b249bb2 dronezzzko/mysql-mariadb-tuning-and-optimization-for-best-performance.md]）には、メモリに応じたMariaDBの最適化についていくつかの提案があります。ただし、それらが自分に適しているかどうかを判断する前に、各オプションが実際に何をするのかを確認することを改めてお勧めします（決してやみくもに設定しないでください）。その点では、MariaDBのドキュメントはかなり充実しています。その場合に探すことになるページはこちらです：[https://mariadb.com/kb/en/server-system-variables/ Server System Variables]。

元のメモリ割り当てのページに戻ると、このページを読んで内容を確認することをお勧めします。見た目ほど長くはまったくなく、ほかにも役に立つ提案があります： 

* 構成に応じたパラメータの調整：[https://mariadb.com/kb/en/mariadb-memory-allocation/#64-bit-os-and-mariadb 64-bit OS and MariaDB¶]（最近では一般的に64ビットのはずです）。
* [https://mariadb.com/kb/en/mariadb-memory-allocation/#table_open_cache table_open_cache]（以前の名称はtable_cache）の調整：[[パフォーマンスの推奨事項]]のMySQLの項では、ほとんどのMoodleインストールでこれを512にすることが推奨されていますが、筆者はMariaDBのデフォルト設定の2000のままにしました。
* [https://mariadb.com/kb/en/mariadb-memory-allocation/#query-cache query_cache]の調整：これはMySQLとは異なり、MariaDBではデフォルトで無効になっています。ドキュメントによれば、必要ない場合に有効にすると、かえってパフォーマンスが低下することさえあります。残念ながら筆者は、Moodleがデータベースをどのように使用しているかについて、最近ではこれをオンにした方がよいのかオフにした方がよいのかを判断できるほど詳しくないため、MySQLでの推奨どおり'''オン'''にしましたが、[https://mariadb.com/kb/en/server-system-variables/#query_cache_size query_cache_size]は64Mにしました（最近はメモリが豊富なため、ほかの多くのサイトでもこれが推奨されているようです）。ただし、[https://mariadb.com/kb/en/server-system-variables/#query_cache_min_res_unit query_cache_min_res_unit]はデフォルトの4096（4KB）のままにしました。
* [https://mariadb.com/kb/en/mariadb-memory-allocation/#thread_cache_size thread_cache_size]の調整：ページにも書かれているとおり、通常これはそれほど大きな影響はないため、デフォルト（256）のままにしておいても大きな害はないようです。ただし、ほかのサイトでは16程度の値に設定することが推奨されています。推奨されているとおり、自分の環境でテストして何が最適かを確認するのが一番よいでしょう。筆者も小規模なMoodleサイトで16を試してみましたが、目立った違いは特にありませんでした。
* [https://mariadb.com/kb/en/mariadb-memory-allocation/#Swappiness Swappiness]の調整：Swappinessとは、OSがどれだけ積極的にRAMとディスクの間でスワップするかを表すものです。使用中のアプリケーションをすばやく切り替える場合には便利ですが、データベース用途ではそれほど有用ではありません。buffer_poolがディスクにスワップアウトされてしまい、buffer_poolの意味がなくなる可能性があるためです。筆者はこれを推奨値の5に設定しました。


インターネット上で見つけたその他の調整：

* [https://mariadb.com/kb/en/server-system-variables/#tmp_table_size tmp_table_size]を64MBに調整しました。インターネット上でよく推奨されているようですし、利用できるRAMの量を考えれば害はないだろうと考えました（この設定のデフォルトは16MBです）。
* [https://mariadb.com/kb/en/server-system-variables/#max_heap_table_size max_heap_table_size]も、インターネット上の推奨に従って同じく64MBに調整しました。何をするものなのかについての情報を見て、害はないだろうと考えました。こちらもデフォルトは16MBです。
* 上記でリンクしたGitHubの提案に従って、[https://mariadb.com/kb/en/innodb-system-variables/#innodb_flush_log_at_trx_commit innodb_flush_log_at_trx_commit]も0に設定しました。これにより、データベースはトランザクションが実行されるたびにディスクへのフラッシュを行わなくなります。つまりACID原則には準拠しなくなりますが、その代わりに目に見えてパフォーマンスが向上します。これは、電源が失われた場合に直近1秒間のトランザクションが失われることを意味しますが、筆者なら自動シャットダウンを設定したUPSを導入するか、データセンターであれば何らかのフェイルオーバーと冗長化の仕組みを用意する方を選びます。ただし、これをオフにする場合は、それらのトランザクションをディスクに書き込むための何らかの代替手段を必ず用意しておいてください。Moodleインストールの破損だけは避けたいものです！（もちろん、そのために[[サイトのバックアップ]]があるのです）。
* [https://mariadb.com/kb/en/server-system-variables/#log_slow_query_time log_slow_query_time]も1に変更しました。これは、処理に1秒より長くかかるものはすべてスロークエリとみなされることを意味します。肉眼では速く思えますが、通常、MariaDB/MySQLの接続は数ミリ秒しか続かないことを覚えておいてください。
* 最後に、[https://mariadb.com/kb/en/server-system-variables/#skip_name_resolve skip_name_resolve]を1に設定して有効にしました。これにより、接続にはIPアドレスのみが使用され、ホスト名は解決されなくなります。ウェブサーバで逆引きDNSが正しく設定されていない場合（DNSルックアップが失敗し続けてデータベースが遅くなる場合）には検討すべき点ですが、筆者の環境ではデータベースとウェブサーバが同じマシン上にあり、解決する必要のあるアドレスはいずれにせよlocalhost/自分自身だけなので、これで特に問題が生じることはありません（と思います）。


以上で大部分の作業は済み、データベースサーバがそれなりにうまく動作するようになるはずです。ほとんどの場合、これらの設定では対応しきれず、より多くの接続/トランザクション/メモリ使用量に合わせて（再）設定が必要になる段階に達するころには、自分のニーズ、つまり何をどのように設定する必要があるかもよくわかっているはずです。そのため、ドキュメントの面ではほぼ自然に解決する問題と言えます。いずれにせよ、話は振り出しに戻ります。残念ながらインストールはそれぞれ異なるため、どのインストールでも、利用できるリソースとニーズを確認したうえで、適切に設定する必要があります。

ともあれ、ここまでたどり着いたなら、おめでとうございます！MariaDBサーバ（ひいてはMoodleインスタンス）が動作しているはずです。ひと休みしてお祝いしましょう。自分へのごほうびに何かよいもの（コーヒーなど？）でも買ってください :)

==エラー「バージョン xxx.xx.xx 以上が必須です。あなたは現在 yy.yy.y を使用しています。」==
データベースのエラー「バージョン xx.xx.xx 以上が必須です。あなたは現在 yy.yy.yy を使用しています。」は、開発中のブランチの[https://download.moodle.org/windows/ Windows用Moodleインストーラパッケージ]をインストールしようとしたときによく見られます。詳細と対処方法については、[[admin/environment/database/mariadb (10.4.28-MariaDB)]]をご覧ください。

==FAQ==
binlog_formatの設定が原因でインストール中に失敗する：
my.cnfファイルの[mysqld]の下にbinlog_format = ROWを設定し、mysqlサービスを再起動してください。
==関連項目==
* [[パフォーマンスの推奨事項]]
* [https://mariadb.org MariaDB.org]
* [https://mariadb.com/kb/en/configuring-mariadb-for-optimal-performance/ Configuring MariaDB for Optimal Performance]
* [https://gist.github.com/DroneZzZko/4a38a1652187dbd0a89c17ed5b249bb2 dronezzzko/mysql-mariadb-tuning-and-optimization-for-best-performance.md]
* [https://vitux.com/tune-and-optimize-mysql-mariadb/ 13 Tips for Tuning and Optimizing MySQL and MariaDB]
* [https://www.appservgrid.com/paw92/index.php/2019/03/14/15-useful-mysql-mariadb-performance-tuning-and-optimization-tips/ 15 Useful MySQL/MariaDB Performance Tuning and Optimization Tips]

[[Category:Environment]]
[[en:MariaDB]]