mysql_tzinfo_to_sqlとは？MySQLでタイムゾーンテーブルをロードする方法

mysql_tzinfo_to_sqlは、mysqlデータベース内のタイムゾーンテーブルをロードするために使用されるユーティリティプログラムです。このプログラムは、zoneinfoデータベース（タイムゾーン情報を記述したファイル群）を持つシステム上で利用できます。該当するOSとしては、Linux、FreeBSD、Solaris、macOSなどが挙げられます。

zoneinfoファイルの多くは/usr/share/zoneinfoディレクトリに格納されています（Solarisの場合は/usr/share/lib/zoneinfo）。もしシステムにzoneinfoデータベースが存在しない場合は、配布されているパッケージを別途インストールする必要があります。

mysql_tzinfo_to_sqlの呼び出し方

mysql_tzinfo_to_sqlには複数の実行構文があり、用途に応じて使い分けることができます。主な構文は以下のとおりです。

shell> mysql_tzinfo_to_sql tz_dir
(または)
shell> mysql_tzinfo_to_sql tz_file tz_name
(または)
shell> mysql_tzinfo_to_sql --leap tz_file

1. zoneinfoディレクトリ全体をロードする

最初の構文では、zoneinfoディレクトリのパス名をmysql_tzinfo_to_sqlに渡します。生成されたSQLはmysqlプログラムへ送信されます。

shell> mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root mysql

このコマンドを実行すると、mysql_tzinfo_to_sqlがシステム上のタイムゾーンファイルを読み込み、そこからSQL文を生成します。続いてmysqlがこれらのSQL文を処理し、タイムゾーンテーブルへデータをロードします。

2. 特定のタイムゾーンファイルだけをロードする

2番目の構文を使用すると、個別のタイムゾーンファイル（tz_file）を、対応するタイムゾーン名（tz_name）とともにロードできます。

shell> mysql_tzinfo_to_sql tz_file tz_name | mysql -u root mysql

3. うるう秒情報を初期化する

タイムゾーンの計算でうるう秒を考慮したい場合は、3番目の構文を使用します。この構文により、うるう秒に関する情報が初期化されます。tz_fileには対象となるタイムゾーンファイル名を指定してください。

shell> mysql_tzinfo_to_sql --leap tz_file | mysql -u root mysql

実行後の注意点

mysql_tzinfo_to_sqlの実行が完了したら、サーバーの再起動を行うことが推奨されています。再起動しない場合、サーバーが以前にキャッシュされた古いタイムゾーンデータを使い続けてしまう可能性があるためです。