SHOW VARIABLES を使用したシステムおよびテーブル属性のクエリ - Lindorm

SHOW VARIABLES 文を使用すると、現在のシステム属性またはテーブル属性の値を確認できます。この文は、CREATE TABLE 文または ALTER TABLE 文の実行後に実行し、変更が正しく反映されたかを確認するほか、スロークエリログの記録や認証などのシステムレベル設定が有効になっているかを確認するために使用します。

前提条件

開始する前に、以下の点を確認してください。

Lindorm SQL のバージョンが 2.6.3.2 以降 である必要があります。バージョンの確認方法については、「SQL のバージョン」をご参照ください。
使用したい機能に対応するエンジンの最小バージョン要件を満たしている必要があります。「対応エンジンおよびバージョン」をご参照ください。

対応エンジンおよびバージョン

エンジン	最小バージョン	備考
LindormTable	2.6.2	`TABLE` 範囲を指定する場合は、LindormTable 2.6.3+ および Lindorm SQL 2.6.6+ が必要です。
LindormTSDB	3.4.35	`SYSTEM` 範囲のみサポートされます。

エンジンバージョンを表示またはスペックアップするには、「LindormTable のリリースノート」、「LindormTSDB のリリースノート」、および「Lindorm インスタンスのマイナーエンジンバージョンをスペックアップする」をご参照ください。

構文

show_variables_statement  ::= SHOW scope_expression VARIABLES
                              [ FROM table_identifier]
                              [ LIKE pattern_expression]
scop_expression           ::= { SYSTEM | TABLE }

パラメーター

scope_expression

システム属性またはテーブル属性のいずれを表示するかを指定します。

値	LindormTable	LindormTSDB	説明
`SYSTEM`	対応	対応	変更済みのすべてのシステム属性を返します。
`TABLE`	対応（2.6.3+、Lindorm SQL 2.6.6+）	非対応	`FROM` 句で指定したテーブルの属性を返します。

説明

SYSTEM では、明示的に設定された属性のみが返されます。システム属性が変更されていない場合、結果は空になります。

FROM table_identifier

FROM キーワードは、scope_expression パラメーターが TABLE に設定されている場合にのみサポートされ、SYSTEM には該当しません。

LIKE pattern_expression

属性名の文字列パターンによるフィルタリングを行います。次の 2 種類のワイルドカードがサポートされています。

ワイルドカード	一致対象
`%`	0 文字以上
`_`	ちょうど 1 文字

返される結果

SYSTEM 範囲：変更済みのシステム属性を返します。システム属性が変更されていない場合、結果は返されません。設定可能なシステム属性の完全な一覧については、「対応設定項目」をご参照ください。
TABLE 範囲：テーブル属性を返します。これは、CREATE TABLE 構文で設定可能な属性を含むが、それに限定されません。設定可能なテーブル属性の完全な一覧については、「テーブルオプション」をご参照ください。

例

すべての例では、2 列の結果セット（Variable_name および Value）が使用されます。

すべてのシステム属性を表示

SHOW SYSTEM VARIABLES;

結果：

+--------------------------+-------+
|      Variable_name       | Value |
+--------------------------+-------+
| SLOW_QUERY_RECORD_ENABLE | true  |
| FILE_FORMAT_VERSION      | 5     |
+--------------------------+-------+

結果には、明示的に設定された属性のみが表示されます。システム属性が変更されていない場合、結果は空になります。

特定のテーブル属性を表示

以下の例では、次の文で作成したテーブルを使用します。

CREATE TABLE dt (p1 VARCHAR, c1 INTEGER, PRIMARY KEY(p1)) WITH (COMPRESSION = 'LZ4');

dt テーブルに設定された圧縮アルゴリズムを表示するには、次のように実行します。

SHOW TABLE VARIABLES FROM dt LIKE 'COMPRESSION';

結果：

+---------------+-------+
| Variable_name | Value |
+---------------+-------+
| COMPRESSION   | LZ4   |
+---------------+-------+

ワイルドカードを使用したシステム属性のフィルタリング

% を使用してプレフィックスを一致させ、FILE で始まるすべての属性名を返すには、次のように実行します。

SHOW SYSTEM VARIABLES LIKE 'FILE%';

結果：

+---------------------+-------+
|    Variable_name    | Value |
+---------------------+-------+
| FILE_FORMAT_VERSION | 5     |
+---------------------+-------+

LIKE を使用して正確な属性名を指定すると、単一の属性のみが返されます。

SHOW SYSTEM VARIABLES LIKE 'FILE_FORMAT_VERSION';

結果：

+---------------------+-------+
|    Variable_name    | Value |
+---------------------+-------+
| FILE_FORMAT_VERSION | 5     |
+---------------------+-------+

次のステップ

ALTER SYSTEM — システムレベルの属性を変更
CREATE TABLE — テーブル作成時にテーブル属性を設定
ALTER TABLE — テーブル作成後にテーブル属性を変更