mariadb-tzinfo-to-sql1

Usage

Overview

The mariadb-tzinfo-to-sql program loads the time zone tables in the mysql database. It is used on systems that have a zoneinfo database (the set of files describing time zones). Examples of such systems are Linux, FreeBSD, Solaris, and Mac OS X. One likely location for these files is the /usr/share/zoneinfo directory (/usr/share/lib/zoneinfo on Solaris).

mariadb-tzinfo-to-sql can be invoked several ways:

shell> mariadb-tzinfo-to-sql tz_dir
shell> mariadb-tzinfo-to-sql tz_file tz_name
shell> mariadb-tzinfo-to-sql --leap tz_file
shell> mariadb-tzinfo-to-sql --skip-write-binlog tz_dir

For the first invocation syntax, pass the zoneinfo directory path name to mariadb-tzinfo-to-sql and send the output into the mariadb program. For example:

shell> mariadb-tzinfo-to-sql /usr/share/zoneinfo | mariadb -u root mysql

mariadb-tzinfo-to-sql reads your system's time zone files and generates SQL statements from them. mariadb processes those statements to load the time zone tables.

The second syntax causes mariadb-tzinfo-to-sql to load a single time zone file tz_file that corresponds to a time zone name tz_name:

shell> mariadb-tzinfo-to-sql tz_file tz_name | mariadb -u root mysql

If your time zone needs to account for leap seconds, invoke mariadb-tzinfo-to-sql using the third syntax, which initializes the leap second information. tz_file is the name of your time zone file:

shell> mariadb-tzinfo-to-sql --leap tz_file | mariadb -u root mysql

Using the --skip-write-binlog option prevents writing of changes to the binary log or to other Galera cluster members. This can be used with any form of running mariadb-tzinfo-to-sql.

After running mariadb-tzinfo-to-sql, it is best to restart the server so that it does not continue to use any previously cached time zone data.