4.10.8 MySQL サーバのタイムゾーンサポート|無料CGI PHPサイト(新着情報、営業日カレンダーなど)

4.10.8. MySQL サーバのタイムゾーンサポート

MySQL サーバにはいくつかのタイムゾーンがあります。

システムのタイムゾーン。サーバ起動時に、ホストマシンのタイムゾーンを使用して、system_time_zone システム変数で設定する。それ以降にこの値が変更することはない。

起動時の MySQL Server のシステムタイムゾーンは、mysqld_safe で、--timezone=timezone_name を使用する。または、mysqld を起動する前に、TZ 環境変数で設定する。--timezone と TZ の許容値は、システムに依存するため、OS のドキュメントを参照のこと。
サーバのカレントタイムゾーン。time_zone のグローバルシステム変数はサーバ稼動中のタイムゾーンを示す。time_zone の初期値は、'SYSTEM' で、サーバとシステムのタイムゾーンが同じであることを示す。

サーバのタイムゾーンの初期グローバル値は、コマンドラインで --default-time-zone=timezone オプションで起動するときに明示的に指定する。または、オプションファイルに次のラインを使用する。
```
default-time-zone='timezone'
```
SUPER 権限がある場合は、ラインタイムで次のステートメントを使用して、サーバのタイムゾーンにグローバル値を設定する。
```
mysql> SET GLOBAL time_zone = timezone;
```
接続毎のタイムゾーン。接続するそれぞれのクライアントには、time_zone 変数で与えられた、それぞれのタイムゾーンセッティングがある。最初は、セッション変数の値が time_zone 変数の値になるが、クライアントは次のステートメントを使用して、それぞれのタイムゾーンを指定できる。
```
mysql> SET time_zone = timezone;
```

カレントセッションのタイムゾーンセッティングは、時間との関わりが深いディスプレイやストレージのタイム値に影響します。これには、NOW() または CURTIME() などの関数で表示する値や、TIMESTAMP カラムに保存し、そこから読み出す値も含まれます。TIMESTAMP カラムの値は、ストレージでは現在のタイムゾーンから UTC へ、読み出しでは UTC からカレントのタイムゾーンに変換します。カレントのタイムゾーンセッティングは、DATE, TIME, or DATETIME などのカラム値、または UTC_TIMESTAMP() 関数などによって表示する値には影響しません。

グローバルおよびクライアント指定のタイムゾーンのカレント値は、次のように読み出します。

mysql> SELECT @@global.time_zone, @@session.time_zone;

timezone 値には、いくつかの形式があります。次に示す形式では文字区別はありません。

'SYSTEM' 値は、システムタイムゾーンと同じ値を示す。
UTC オフセットを示す文字列の値。たとえば、'+10:00' または '-6:00' など。
指定したタイムゾーンの値。たとえば、'Europe/Helsinki'、 'US/Eastern'、'MET' など。指定したタイムゾーンは、タイムゾーンの情報テーブルが mysql データベースにあるときにだけ使用できる。

MySQL のインストール手順でタイムゾーンテーブルを mysql データベースに作成しますが、そのときは、ロードまではしません。その前に、テーブルを作成する必要があります。MySQL 4.1.3 以降にアップグレードする場合は、mysql データベースを更新すると、そのテーブルを作成できます。アップグレードに関する手順は、項4.5.4. 「mysql_upgrade ? MySQL アップグレードのテーブルチェック」を参照してください。次に、テーブル作成してから、タイムゾーンテーブルをロードするまでの手順 (手動) を示します。

注意

タイムゾーンの情報をロードは、情報が変更する場合に応じて、変更します。たとえば、夏時間を導入している米国、メキシコ、カナダでは 2007年に導入ルールが変更しました。そのような変更がある場合、古いルールを使用しているアプリケーションとの誤差がでるため、MySQL サーバの時間で使用している情報を維持するために、タイムゾーンテーブルをリロードする必要があります。このセクションで後述のノートを参照してください。

システムに独自の zoneinfo データベース (タイムゾーンの関するファイルセット) がある場合、mysql_tzinfo_to_sql プログラムを使用して、タイムゾーンテーブルの充てんを行います。Linux、FreeBSD、Sun Solaris、Mac OS X などのシステムでは、通常、タイムゾーンに関するファイルは、/usr/share/zoneinfo ディレクトリにあります。システムに zoneinfo データベースがない場合、このセクションで後述しているパッケージをダウンロードします。

mysql_tzinfo_to_sql プログラムをタイムゾーンテーブルのリロードに使用します。コマンドラインで、zoneinfo ディレクトリへのパスを mysql_tzinfo_to_sql へ渡し、mysql プログラムに出力します。たとえば次のようにします。

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

mysql_tzinfo_to_sql はシステム内のタイムゾーンファイルを読み、そこから SQL ステートメントを生成します。mysql でそのステートメントを処理して、タイムゾーンテーブルにロードします。

mysql_tzinfo_to_sql コマンドを使用して、単一のタイムゾーンファイルをロードしたり、うるう秒 (リープセカンド) の情報を生成することも可能です。

tz_name というタイムゾーンに対応する単一のタイムゾーンファイル、tz_file をロードするには、次のように mysql_tzinfo_to_sql を呼び出す。
```
shell> mysql_tzinfo_to_sql tz_file tz_name | mysql -u root mysql
```
注意：この方法で、サーバが必要とする、それぞれの指定ゾーンのファイルを別々のコマンドでロードしてください。
うるう秒のカウントが必要な場合は、次のように、うるう秒の情報を初期化します。ここで tz_file をタイムゾーンファイルの名前とします。
```
shell> mysql_tzinfo_to_sql --leap tz_file | mysql -u root mysql
```

Windows または HP-UX など、zoneinfo データベースを使用しないシステムの場合は、パッケージのタイムゾーンテーブルを使用します。これは、MySQL Developer Zone からダウンロードできます。

http://dev.mysql.com/downloads/timezones.html

このタイムゾーンパッケージには、 MyISAM のタイムゾーンテーブル用に、.frm、.MYD、.MYI などのファイルが入っています。このテーブルを mysql データベースの一部にする必要があるため、そのファイルをMySQL サーバのデータディレクトリの mysql サブディレクトリに入れてください。そのときは、サーバを停止してから作業を行い、再起動してください。

警告：システムに zoneinfo データベースがある場合は、ダウンロードパッケージを使用してはいけません。MySQL とシステムアプリケーション間での時間に関わる処理に誤差が生じる原因になります。代わりに、mysql_tzinfo_to_sql ユーティリティを使用してください。

レプリケーションを行うときのタイムゾーンセッティングに関する情報は、項5.4.1. 「レプリケーション機能と既知問題」を参照してください。

タイムゾーン変更に対応

タイムゾーンのルールに変更があるときは、古いルールを使用しているアプリケーションでも調節が必要になります。タイムゾーンのずれを回避するために、システムのタイムゾーン情報がカレント(最新の時間)であることを確認してください。MySQL では、タイムゾーンをカレントにする必要がある要素が 2 つあります。

MySQL サーバでタイムゾーンを SYSTEM で設定している場合は、オペレーティングシステムの時間が、MySQL で使用する時間の値に影響するため、オペレーティングシステムが最新 (アップデート) のタイムゾーンを使用していることを確認する必要がある。大抵のオペレーティングシステムでは、アップデートやサービスパックで時間変更に対応している。時間変更に関するアップデートなどオペレーティングシステムのベンダーウェブサイトを確認する。インターネットのパブリックタイムでサーバを稼動させている場合、システムが自動的に調整を行う。
MySQL で特定のタイムゾーンを使用する場合、mysql データベースのタイムゾーンテーブルのアップデートを行う。システムに独自の zeroinfo データベースがある場合は、 zeroinfo データベースをアップデートする度に、このセクションで前述した手順に従って、MySQL のタイムゾーンテーブルをリロードする。 zeroinfo データベースがない場合は、MySQL Developer Zone のアップデート情報に従う。アップデートがある場合は、ダウンロードして、カレントのタイムゾーンテーブルと置き換える。

無料PHPプログラム

4.10.8. MySQL サーバのタイム ゾーン サポート

注意

4.10.8. MySQL サーバのタイムゾーンサポート