タイムゾーンの設定

このトピックでは、タイムゾーンの設定方法とその影響について説明します。

セッションレベルまたはグローバルタイムゾーンの設定

StarRocks クラスターのセッションレベルまたはグローバルタイムゾーンを time_zone パラメータを使用して設定できます。

• セッションレベルのタイムゾーンを設定するには、コマンド SET time_zone = 'xxx'; を実行します。異なるセッションに対して異なるタイムゾーンを設定できます。FEs から切断すると、タイムゾーン設定は無効になります。
• グローバルタイムゾーンを設定するには、コマンド SET global time_zone = 'xxx'; を実行します。タイムゾーン設定は FEs に保存され、FEs から切断しても有効です。

注意

StarRocks にデータをロードする前に、StarRocks クラスターのグローバルタイムゾーンを system_time_zone パラメータと同じ値に変更してください。そうしないと、データロード後に DATE 型のデータが正しくなくなります。system_time_zone パラメータは、FEs をホストするマシンのタイムゾーンを指します。マシンが起動されると、マシンのタイムゾーンがこのパラメータの値として記録されます。このパラメータを手動で設定することはできません。

タイムゾーン形式

time_zone パラメータの値は大文字と小文字を区別しません。このパラメータの値は次の形式のいずれかで指定できます。

形式	例
UTC オフセット	SET time_zone = '+10:00'; SET global time_zone = '-6:00';
タイムゾーン名	SET time_zone = 'Asia/Shanghai'; SET global time_zone = 'America/Los_Angeles';

タイムゾーン形式の詳細については、List of tz database time zones を参照してください。

注意

CST を除いて、タイムゾーンの略語はサポートされていません。time_zone の値を CST に設定すると、StarRocks は CST を Asia/Shanghai に変換します。

デフォルトタイムゾーン

time_zone パラメータのデフォルト値は Asia/Shanghai です。

タイムゾーン設定の表示

タイムゾーン設定を表示するには、次のコマンドを実行します。

 SHOW VARIABLES LIKE '%time_zone%';

タイムゾーン設定の影響

• タイムゾーン設定は、SHOW LOAD および SHOW BACKENDS ステートメントによって返される時間値に影響を与えます。ただし、CREATE TABLE ステートメントで指定されたパーティション列が DATE または DATETIME 型の場合、LESS THAN 句で指定された値には影響しません。また、DATE および DATETIME 型のデータにも影響しません。
• タイムゾーン設定は、次の関数の表示と保存に影響を与えます。
  • from_unixtime: 指定した UTC タイムスタンプに基づいて、指定したタイムゾーンの日付と時刻を返します。たとえば、StarRocks クラスターのグローバルタイムゾーンが Asia/Shanghai の場合、select FROM_UNIXTIME(0); は 1970-01-01 08:00:00 を返します。
  • unix_timestamp: 指定したタイムゾーンの日付と時刻に基づいて UTC タイムスタンプを返します。たとえば、StarRocks クラスターのグローバルタイムゾーンが Asia/Shanghai の場合、select UNIX_TIMESTAMP('1970-01-01 08:00:00'); は 0 を返します。
  • curtime: 指定したタイムゾーンの現在の時刻を返します。たとえば、指定したタイムゾーンの現在の時刻が 16:34:05 の場合、select CURTIME(); は 16:34:05 を返します。
  • now: 指定したタイムゾーンの現在の日付と時刻を返します。たとえば、指定したタイムゾーンの現在の日付と時刻が 2021-02-11 16:34:13 の場合、select NOW(); は 2021-02-11 16:34:13 を返します。
  • convert_tz: 日付と時刻をあるタイムゾーンから別のタイムゾーンに変換します。たとえば、select CONVERT_TZ('2021-08-01 11:11:11', 'Asia/Shanghai', 'America/Los_Angeles'); は 2021-07-31 20:11:11 を返します。