すべてのプロダクト
Search

このプロダクト

    Lindorm:ALTER SYSTEM

    ドキュメントセンター

    Lindorm:ALTER SYSTEM

    最終更新日:Mar 07, 2026

    この文は、動的システムパラメーターを変更します。

    対応エンジンとバージョン

    ALTER SYSTEM 文は、LindormTable および LindormTSDB で使用できます。

    重要

    この文を使用するには、Lindorm SQL バージョン 2.6.3.2 以降が必要です。Lindorm SQL のバージョン確認方法については、「SQL バージョンガイド」をご参照ください。

    構文

    alter_system_statement ::= ALTER SYSTEM SET configuration_identifier = configuration_literal

    注意事項

    パラメーター

    説明

    configuration_identifier

    動的構成パラメーターの名前です。SQL 識別子である必要があります。サポートされる設定項目の一覧については、「サポートされる設定項目」をご参照ください。

    configuration_literal

    動的構成パラメーターの値です。SQL 定数である必要があります。SQL 定数の値は、動的構成パラメーターの名前に応じて以下のとおり異なります：

    • BIGINT 型定数

    • DOUBLE 型定数

    • BOOLEAN 型定数

    • VARCHAR 型定数

    サポートされる設定項目

    設定項目名

    データ型

    対応エンジン

    説明

    FILE_FORMAT_VERSION

    INTEGER

    LindormTable

    LindormTable のデータファイルのバージョンを設定します。LindormTable データファイルのデフォルトバージョンは 2 です。

    説明

    使用中に Cell Tag is not supported since ldFileVersion is too small=2 エラーが発生した場合は、ファイルバージョンを 5 に設定することで解消できます。

    SLOW_QUERY_RECORD_ENABLE

    BOOLEAN

    LindormTable

    LindormTable のスロークエリシステムビューを有効化します。有効化すると、クエリの実行時間が一定のしきい値を超えた場合、クエリ情報が lindorm._slow_query_ ビューに記録されます。これにより、運用・保守（O&M）における検査およびトラブルシューティングが容易になります。値の選択肢は以下のとおりです：

    • TRUE

    • FALSE（デフォルト）

    SLOW_QUERY_TIME_MS

    INTEGER

    LindormTable

    lindorm_slow_query に記録されるスロークエリの実行時間しきい値を設定します。単位：ミリ秒（ms）。デフォルト値：10000 ミリ秒（10 秒）。

    説明

    この値を変更して適用した後、Lindorm サーバーに送信されたクエリは、新しいしきい値に基づいてスロークエリビューに記録される可能性があります。

    MAX_CONN

    INTEGER

    LindormTable

    LindormTable の最大接続数を設定します。値は 0 より大きい必要があります。

    重要

    • SQL エンジンバージョンは2.7.0.0 以降である必要があります。

    • シングルノードごとにデフォルトの最大接続数制限が設定されています。接続数がこのデフォルト値に達すると、新しい接続は拒否され、エラー 1040 が返されます。まず、アプリケーションコードにおける接続の使用状況を確認してください。また、SQL 文を用いて LindormTable の最大接続数を変更することもできます。

      シングルノードのデフォルト最大接続数は以下のとおりです：

    AUDIT_LEVEL

    INTEGER

    LindormTable

    LindormTable の監査ログレベルを設定します。値の選択肢は以下のとおりです：

    • 0（デフォルト）：DDL および DCL ログを出力

    • 1：DDL、DCL、DML ログを出力

    • 2：DDL、DCL、DQL ログを出力

    • 3：DDL、DCL、DML、DQL ログを出力

    ERROR_LANG

    VARCHAR

    LindormTable

    Lindorm SQL エラーメッセージの言語を設定します。サポートされる言語は以下のとおりです：

    • en：英語

    • zh_CN：簡体字中国語

    重要

    • SQL エンジンバージョンは2.9.0.0 以降である必要があります。

    • SQL エンジンのエラーメッセージのデフォルト言語は、インスタンスが作成されたリージョンによって異なります。

    USER_AUTH

    BOOLEAN

    LindormTSDB

    LindormTSDB のユーザー認証および権限検証機能を有効化または無効化します。値の選択肢は以下のとおりです：

    • TRUE：ユーザー認証および権限検証を有効化します。LindormTSDB への接続には、ユーザー名およびパスワードが必要です。LindormTSDB は、その接続から実行された SQL 文におけるデータオブジェクトに対してユーザーを認証し、権限を検証します。

    • FALSE（デフォルト）：ユーザー認証および権限検証を無効化します。LindormTSDB への接続には、ユーザー名およびパスワードは不要です。

      重要

      LindormTSDB でユーザー認証および権限検証が有効化されている場合、その後のすべてのアクセスにはユーザー情報が必須となります。ユーザー情報を含めない場合、認証に失敗する可能性があります（現在の接続で ALTER SYSTEM 文を実行してユーザー認証および権限検証を有効化する場合も同様です）。そのため、この機能を有効化すると、既存の一部のビジネスアクセスが失敗する可能性があります。この機能を有効化する前に、十分な検討と影響評価を行ってください。

    QUERY_MAX_MEM

    BIGINT

    LindormTable

    Lindorm SQL エンジンにおける単一クエリが消費できる最大メモリ量です。デフォルト値：8388608 バイト（8 MB）。

    重要

    • SQL エンジンバージョンは2.9.6.0 以降である必要があります。

    • クエリがメモリ制限をトリガーした場合、必要に応じてこの構成値を増分（例：2 倍など）で増加させてください。ただし、このパラメーターは各クエリのメモリ制限を制御するため、設定値を高すぎると LindormTable におけるメモリ負荷が急激に増加し、システムの安定性リスクを招く可能性があることにご注意ください。

    lindorm.allow.range.delete

    BOOLEAN

    LindormTable

    バッチ削除を許可します。値の選択肢は以下のとおりです：

    • TRUE

    • FALSE（デフォルト）

    重要

    • SQL エンジンバージョンは2.9.1.0 以降である必要があります。

    • バッチクエリを有効化して大量のデータを削除すると、リクエストがタイムアウトする可能性があります。タイムアウト期間は HINT を用いて設定してください。また、大量のデータを削除すると多数の削除マーカーが生成され、クエリパフォーマンスに影響を与える可能性があります。

    lindorm.indexed.non.primary.key.columns.max

    INTEGER

    LindormTable

    インデックスキー列として使用可能な非プライマリキー列の最大数です。デフォルト値は 3 です。

    重要

    • SQL エンジンバージョンは2.9.6.0 以降である必要があります。

    • インデックステーブルにプライマリキーが多すぎると、インデックステーブルの行キーが長くなりすぎて、クエリパフォーマンスに影響を与える可能性があります。

    lindorm.max.index.number

    INTEGER

    LindormTable

    許可されるセカンダリインデックスの最大数です。デフォルト値：5。

    重要

    • SQL エンジンバージョンは2.9.6.0 以降である必要があります。

    • セカンダリインデックスが多すぎると、書き込みパフォーマンスが低下し、ディスク使用率が上昇する可能性があります。

    lindorm.schema.column.nonpklength.max

    INTEGER

    LindormTable

    単一の非プライマリキー列が格納できる最大データ量です。これはテーブルレベルの構成です。単位：バイト。デフォルト値：2097152 バイト（2 MB）。

    重要

    • SQL エンジンバージョンは2.9.1.0 以降である必要があります。

    • 大規模な KV の読み取りおよび書き込み操作を多数実行すると、GC ジッターが発生しやすくなります。

    SYSTEM_TIME_ZONE

    STRING

    LindormTable

    データベースシステム全体のデフォルトタイムゾーンを指定します。デフォルト値：UTC + 08:00。

    使用例

    LindormTable のファイルバージョンの変更

    LindormTable のデータファイルバージョンを 5 に設定します。

    ALTER SYSTEM SET FILE_FORMAT_VERSION = 5;

    ワイドテーブルのスロークエリ記録しきい値の設定

    LindormTable のスロークエリビューを有効化し、スロークエリの記録しきい値を設定します。

    -- スロークエリ記録を有効化
ALTER SYSTEM SET SLOW_QUERY_RECORD_ENABLE = TRUE; 

-- スロークエリしきい値を 1 秒（1000 ms）に設定
ALTER SYSTEM SET SLOW_QUERY_TIME_MS = 1000;

    ワイドテーブルの最大接続数の変更

    LindormTable の最大接続数を 5000 に設定します。

    ALTER SYSTEM SET MAX_CONN = 5000;

    LindormTSDB の認証の有効化／無効化

    -- 認証を有効化
ALTER SYSTEM SET USER_AUTH=TRUE; 

-- 認証を無効化
ALTER SYSTEM SET USER_AUTH=FALSE;

    ワイドテーブルの SQL 例外メッセージ言語の変更

    LindormTable の SQL エラーメッセージ言語を簡体字中国語に設定します。

    ALTER SYSTEM SET ERROR_LANG = 'zh_CN';

    バッチ削除の許可設定

    バッチ削除操作を許可するかどうかを構成できます。デフォルト値は FALSE です。

    ALTER SYSTEM SET `lindorm.allow.range.delete`=TRUE;

    インデックス列として使用する非プライマリキー列の数の変更

    インデックス列のプライマリキーとして使用可能な非プライマリキー列の数を 5 に設定します。

    ALTER SYSTEM SET `lindorm.indexed.non.primary.key.columns.max`= 5;

    セカンダリインデックスの数の変更

    セカンダリインデックスの数を 5 に設定します。

    ALTER SYSTEM SET `lindorm.max.index.number`= 5;

    単一の非プライマリキー列で許容されるデータ量の変更

    単一の非プライマリキー列で許容される最大データ量を 3670016 バイト（3.5 MB）に設定します。

    ALTER TABLE tableName SET 'MAX_NONPK_LEN'='3670016';

    結果を確認する

    SHOW SYSTEM VARIABLES LIKE configuration_identifier; 文を用いて、設定が正常に反映されたかを確認できます。ここで、configuration_identifier はパラメーター名です。

    説明

    ALTER SYSTEM SET コマンドでパラメーターを設定していない場合、SHOW SYSTEM VARIABLES コマンドはそのパラメーターの動的構成を返しません。