ApsaraDB for SelectDB:変数の管理

セッション変数の設定

セッション変数は直ちに有効になり、現在の接続にのみ適用されます：

SET exec_mem_limit = 137438953472;
SET forward_to_master = true;
SET time_zone = "Asia/Shanghai";

変数には定数式も指定できます：

SET exec_mem_limit = 10 * 1024 * 1024 * 1024;
SET forward_to_master = concat('tr', 'u', 'e');

グローバル変数の設定

グローバル変数は、現在のセッションおよび以降のすべてのセッションで有効になります：

SET GLOBAL exec_mem_limit = 137438953472;

次の変数は、セッションスコープとグローバルスコープの両方をサポートしています：

• time_zone

• wait_timeout

• sql_mode

• enable_profile

• query_timeout

• insert_timeout

• exec_mem_limit

• batch_size

• allow_partition_column_nullable

• insert_visible_timeout_ms

• enable_fold_constant_by_be

次の変数はグローバルスコープのみをサポートしています：

• default_rowset_type

• default_password_lifetime

• password_history

• validate_password_policy

単一クエリでの変数のオーバーライド

SET_VAR ヒントを使用すると、セッション状態を変更せずに、単一のステートメントに対してセッション変数を設定できます：

SELECT /*+ SET_VAR(exec_mem_limit = 8589934592) */ name FROM people ORDER BY name;
SELECT /*+ SET_VAR(query_timeout = 1, enable_partition_cache=true) */ sleep(3);

コメントは /*+ で開始し、SELECT キーワードの直後に記述する必要があります。

タイムゾーン変数のクエリと設定

両方のタイムゾーン変数を表示するには、次のようにします：

SHOW VARIABLES LIKE '%time_zone%';

セッションのタイムゾーンを設定するには、次のようにします：

SET time_zone = 'Asia/Shanghai';

その後のすべてのセッションに対してクラスターのタイムゾーンを設定するには、次のようにします：

SET GLOBAL time_zone = 'Asia/Shanghai';

サポートされているタイムゾーン形式

一部のデータインポート方法では、上記に記載されていない追加のタイムゾーン形式を受け入れる場合があります。本番環境では非標準の形式に依存しないでください。ApsaraDB for SelectDB は、いつでもその処理方法を変更する可能性があります。

タイムゾーン設定が関数とデータに与える影響

影響を受ける関数

以下の関数は、現在の time_zone 設定に基づいて結果を返します。

SHOW LOAD と SHOW BACKENDS の出力も、設定されたタイムゾーンを反映します。

タイムゾーン設定の影響を受けないもの：

• CREATE TABLE における時間型パーティションキー列の less than 値

• DATE 型または DATETIME 型として保存される値（保存される値自体は変更されません）

インポート時の時間型データ

DATE、DATEV2、DATETIME、または DATETIMEV2 型のデータをインポートする場合、ApsaraDB for SelectDB は次のようにタイムゾーン変換を処理します：

• タイムゾーン接尾辞を含むデータ（例：2020-12-12 12:12:12+08:00）：クラスターの現在の time_zone に変換されます。たとえば、time_zone が +00:00 の場合、保存される値は 2020-12-12 04:12:12 になります。

• タイムゾーン接尾辞を含まないデータ（例：2020-12-12 12:12:12）：絶対時刻として扱われ、変換なしでそのままインポートされます。

夏時間

夏時間の調整は、名前付きタイムゾーンに組み込まれています。たとえば、America/Los_Angeles は、3 月に -08:00 から -07:00 に移行し、11 月に戻ります。

夏時間の移行を回避するには、America/Los_Angeles のような名前付きゾーンではなく、固定 UTC オフセット（例：-08:00）に time_zone を設定してください。

タイムゾーンデータのソース

各バックエンド (BE) ノードで、ApsaraDB for SelectDB は、以下の場所からこの順序でタイムゾーンデータを検索します：

1. TZDIR 環境変数で指定されたディレクトリ

2. /usr/share/zoneinfo

3. BE デプロイメントディレクトリ内の zoneinfo ディレクトリ

いずれの場所でもタイムゾーンデータが見つからない場合、BE ノードは起動に失敗します。

タイムゾーン対応データ

データをインポートする前に、タイムゾーン情報を一貫して扱う方法を決定してください。 DATETIME などの時刻型データにはタイムゾーンが格納されません。 ApsaraDB for SelectDB では、次の 2 つに分類します：

絶対時刻：データにタイムゾーンが含まれず、インポート時にもタイムゾーンが設定されていない場合です。例： 2023-12-12 08:00:00。保存時もクエリ時もそのまま扱われ、time_zone の影響を受けません。

特定のタイムゾーンの時刻：データにタイムゾーンサフィックスが含まれます。例： 2020-12-12 12:12:12+02:00。どのタイムゾーン設定が適用されるかは、インポート方法によって決まります：

• INSERT INTO：time_zone セッション変数に従います。

• ストリームロードまたはブローカーロード：timezone リクエストヘッダーに従います。 timezone ヘッダーが time_zone セッション変数と競合する場合は、timezone ヘッダーが優先されます。

ApsaraDB for SelectDB は、インポート時に、入力データ内のリテラルタイムゾーンを time_zone で設定されたタイムゾーンに変換します。

推奨する方法：インポート前に time_zone を 1 度設定し、その後は一貫して同じ値を使用してください。タイムゾーン対応データをインポートした後に time_zone を変更すると、以降のクエリで保存値が誤って解釈されます。

次の例は、セッションの途中で time_zone を変更した場合の動作を示しています：

-- 現在のタイムゾーン：Asia/Hong_Kong
SELECT @@time_zone;
-- +----------------+
-- | @@time_zone    |
-- +----------------+
-- | Asia/Hong_Kong |
-- +----------------+

-- リテラルタイムゾーン +02:00 のデータをインポート
-- 2020-12-12 18:12:12 として保存される (Asia/Hong_Kong に変換)
INSERT INTO dtv23 VALUES('2020-12-12 12:12:12+02:00');

SELECT * FROM dtv23;
-- +-------------------------+
-- | k0                      |
-- +-------------------------+
-- | 2020-12-12 18:12:12.000 |
-- +-------------------------+

-- time_zone を変更しても保存値は更新されない
SET time_zone = 'America/Los_Angeles';

-- 2 回目のインポートでは、変換に America/Los_Angeles が使用される
INSERT INTO dtv23 VALUES('2020-12-12 12:12:12+02:00');

SELECT * FROM dtv23;
-- 行のタイムゾーンセマンティクスが不整合になる
-- +-------------------------+
-- | k0                      |
-- +-------------------------+
-- | 2020-12-12 02:12:12.000 |  -- America/Los_Angeles でインポート
-- | 2020-12-12 18:12:12.000 |  -- Asia/Hong_Kong でインポート
-- +-------------------------+

タイムゾーンのベストプラクティスの概要：

• データをインポートする前に、クラスターの time_zone を確認し、インポート後は変更しないでください。

• ストリームロードまたはブローカーロードを使用する場合は、timezone ヘッダーを time_zone セッション変数と同じ値に設定してください。

• 絶対時刻データはタイムゾーンサフィックスなしでインポートしてください。タイムゾーン対応データはタイムゾーンサフィックスを含め、変換は ApsaraDB for SelectDB に任せてください。

夏時間の精度

名前付きタイムゾーンのデータ (夏時間の開始日と終了日を含む) は、Internet Assigned Numbers Authority (IANA) によって管理されています。各 BE ノードに保存されているデータは、当年について IANA が確認した最新の変更を反映していない場合があります。

ワークロードで最新の夏時間スケジュールが必要な場合は、各 BE ノードのタイムゾーンデータソースに最新の IANA tz データベースのリリースが含まれていることを確認してください。最新データについては、The tz-announce Archives をご参照ください。

サポートされている変数