タイムゾーンの設定

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

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

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

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

注意

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

タイムゾーンの形式

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 を返します。