SHOW Statements
SHOW CREATE (TABLE|DATABASE|USER)
は、以下の設定が有効でない限り、シークレットを隠します:
display_secrets_in_show_and_select
(サーバー設定)format_display_secrets_in_show_and_select
(フォーマット設定)
さらに、ユーザーは displaySecretsInShowAndSelect
権限を持っている必要があります。
SHOW CREATE TABLE | DICTIONARY | VIEW | DATABASE
これらのステートメントは、指定されたオブジェクトを作成するために使用された CREATE
クエリを含む、String 型の単一カラムを返します。
Syntax
このステートメントを使用して、システムテーブルの CREATE
クエリを取得すると、
テーブル構造を宣言するだけの 偽 クエリが得られ、テーブルを作成するためには使用できません。
SHOW DATABASES
このステートメントは、すべてのデータベースのリストを表示します。
Syntax
これは、次のクエリと同じです:
Examples
この例では、SHOW
を使用して、名前にシンボルのシーケンス 'de' を含むデータベース名を取得します:
大文字小文字を区別せずに行うこともできます:
また、名前に 'de' を含まないデータベース名を取得することもできます:
最終的に、最初の2つのデータベースの名前を取得できます:
See also
SHOW TABLES
SHOW TABLES
ステートメントは、テーブルのリストを表示します。
Syntax
FROM
句が指定されていない場合、クエリは現在のデータベースからのテーブルのリストを返します。
このステートメントは、次のクエリと同じです:
Examples
この例では、SHOW TABLES
ステートメントを使用して、名前に 'user' を含むすべてのテーブルを検索します:
大文字小文字を区別せずに行うこともできます:
また、名前に 's' を含まないテーブルを見つけることもできます:
最終的に、最初の2つのテーブルの名前を取得できます:
See also
SHOW COLUMNS
SHOW COLUMNS
ステートメントは、カラムのリストを表示します。
Syntax
データベースとテーブル名は <db>.<table>
として省略形で指定でき、
これは FROM tab FROM db
と FROM db.tab
が同等であることを意味します。
データベースが指定されていない場合、クエリは現在のデータベースからのカラムのリストを返します。
EXTENDED
と FULL
の2つのオプションのキーワードがあります。EXTENDED
キーワードは現在は効果がなく、MySQLの互換性のために存在します。FULL
キーワードは、出力に照合順序、コメント、権限カラムを含ませます。
SHOW COLUMNS
ステートメントは、次の構造の結果テーブルを生成します:
Column | Description | Type |
---|---|---|
field | カラムの名前 | String |
type | カラムのデータ型。クエリがMySQLワイヤプロトコルを介して行われた場合、同等の型名がMySQLで表示されます。 | String |
null | カラムのデータ型がNullableであれば YES 、そうでなければ NO | String |
key | カラムが主キーの一部であれば PRI 、ソートキーの一部であれば SOR 、それ以外は空 | String |
default | カラムが ALIAS 、 DEFAULT 、または MATERIALIZED の型の場合のデフォルト表現、それ以外は NULL 。 | Nullable(String) |
extra | 追加情報、現在は未使用 | String |
collation | ( FULL キーワードが指定された場合のみ) カラムの照合順序、ClickHouseにはカラムごとの照合順序がないため常に NULL | Nullable(String) |
comment | ( FULL キーワードが指定された場合のみ) カラムに関するコメント | String |
privilege | ( FULL キーワードが指定された場合のみ) このカラムに対する権限、現在は利用不可 | String |
Examples
この例では、SHOW COLUMNS
ステートメントを使用して、テーブル 'orders' のすべてのカラムに関する情報を取得します。
'delivery_' で始まるカラムを対象にします:
See also
SHOW DICTIONARIES
SHOW DICTIONARIES
ステートメントは、Dictionariesのリストを表示します。
Syntax
FROM
句が指定されていない場合、クエリは現在のデータベースからの辞書のリストを返します。
次のようにして、SHOW DICTIONARIES
クエリと同じ結果を取得できます:
Examples
以下のクエリは、system
データベース内のテーブルのリストから最初の2行を選択し、名前に reg
を含むものを表示します。
SHOW INDEX
テーブルの主キーとデータスキッピングインデックスのリストを表示します。
このステートメントは主にMySQLとの互換性のために存在します。
システムテーブル system.tables
(主キー用) および system.data_skipping_indices
(データスキッピングインデックス用) は、ClickHouseによりよりネイティブな方法で同等の情報を提供します。
Syntax
データベースとテーブル名は <db>.<table>
として省略形で指定でき、
つまりFROM tab FROM db
と FROM db.tab
が同等です。
データベースが指定されていない場合、クエリは現在のデータベースを前提とします。
オプションのキーワード EXTENDED
は現在効果がなく、MySQLの互換性のために存在します。
ステートメントは次の構造の結果テーブルを生成します:
Column | Description | Type |
---|---|---|
table | テーブルの名前。 | String |
non_unique | ClickHouseは一意制約を支持していないため、常に 1 。 | UInt8 |
key_name | インデックスの名前、インデックスが主キーインデックスの場合は PRIMARY 。 | String |
seq_in_index | 主キーインデックスの場合、1から始まるカラムの位置。データスキッピングインデックスの場合は常に 1 。 | UInt8 |
column_name | 主キーインデックスの場合、『カラムの名前。データスキッピングインデックスの場合、空文字列、"expression" フィールドを参照。 | String |
collation | インデックス内のカラムのソート:昇順の場合は A 、降順の場合は D 、ソートされていない場合は NULL 。 | Nullable(String) |
cardinality | インデックスのカーディナリティの推定 (インデックス内の一意の値の数)。現在は常に 0。 | UInt64 |
sub_part | ClickHouseはMySQLのようなインデックスプレフィックスをサポートしないため、常に NULL 。 | Nullable(String) |
packed | ClickHouseはMySQLのような圧縮されたインデックスをサポートしないため、常に NULL 。 | Nullable(String) |
null | 現在未使用 | |
index_type | インデックスのタイプ、例: PRIMARY , MINMAX , BLOOM_FILTER など。 | String |
comment | インデックスに関する追加情報、現在は常に空文字列。 | String |
index_comment | ClickHouseではインデックスに COMMENT フィールドを持つことができないため、空文字列。 | String |
visible | インデックスがオプティマイザーに見える場合、常に YES 。 | String |
expression | データスキッピングインデックスの場合、インデックスの式。主キーインデックスの場合は、空文字列。 | String |
Examples
この例では、SHOW INDEX
ステートメントを使用して、テーブル 'tbl' のすべてのインデックスに関する情報を取得します。
See also
SHOW PROCESSLIST
system.processes
テーブルの内容を出力します。
このテーブルには、現在処理中のクエリのリストが含まれており、 SHOW PROCESSLIST
クエリは除外されます。
Syntax
SELECT * FROM system.processes
クエリは、現在のすべてのクエリに関するデータを返します。
コンソールで実行する:
SHOW GRANTS
SHOW GRANTS
ステートメントは、ユーザーの権限を表示します。
Syntax
ユーザーが指定されていない場合、クエリは現在のユーザーの権限を返します。
WITH IMPLICIT
修飾子を使うと、暗黙の権限(例: GRANT SELECT ON system.one
)を表示できます。
FINAL
修飾子は、ユーザーとその付与されたロール(継承を含む)のすべての権限をマージします。
SHOW CREATE USER
SHOW CREATE USER
ステートメントは、ユーザー作成時 に使用されたパラメーターを表示します。
Syntax
SHOW CREATE ROLE
SHOW CREATE ROLE
ステートメントは、ロール作成時 に使用されたパラメーターを表示します。
Syntax
SHOW CREATE ROW POLICY
SHOW CREATE ROW POLICY
ステートメントは、行ポリシー作成時 に使用されたパラメーターを表示します。
Syntax
SHOW CREATE QUOTA
SHOW CREATE QUOTA
ステートメントは、クォータ作成時 に使用されたパラメーターを表示します。
Syntax
SHOW CREATE SETTINGS PROFILE
SHOW CREATE SETTINGS PROFILE
ステートメントは、設定プロファイル作成時 に使用されたパラメーターを表示します。
Syntax
SHOW USERS
SHOW USERS
ステートメントは、ユーザーアカウント名のリストを返します。
ユーザーアカウントパラメータを表示するには、システムテーブル system.users
を参照してください。
Syntax
SHOW ROLES
SHOW ROLES
ステートメントは、ロールのリストを返します。
他のパラメータを表示するには、システムテーブル system.roles
および system.role_grants
を参照してください。
Syntax
SHOW PROFILES
SHOW PROFILES
ステートメントは、設定プロファイルのリストを返します。
ユーザーアカウントパラメータを表示するには、システムテーブル settings_profiles
を参照してください。
Syntax
SHOW POLICIES
SHOW POLICIES
ステートメントは、指定されたテーブルに対する行ポリシーのリストを返します。
ユーザーアカウントパラメータを表示するには、システムテーブル system.row_policies
を参照してください。
Syntax
SHOW QUOTAS
SHOW QUOTAS
ステートメントは、クォータのリストを返します。
クォータパラメータを表示するには、システムテーブル system.quotas
を参照してください。
Syntax
SHOW QUOTA
SHOW QUOTA
ステートメントは、すべてのユーザーまたは現在のユーザーのクォータ消費量を返します。
他のパラメータを表示するには、システムテーブル system.quotas_usage
および system.quota_usage
を参照してください。
Syntax
SHOW ACCESS
SHOW ACCESS
ステートメントは、すべてのユーザー、ロール、プロファイルなどとそのすべての権限を表示します。
Syntax
SHOW CLUSTER(S)
SHOW CLUSTER(S)
ステートメントは、クラスタのリストを返します。
すべての利用可能なクラスタは、system.clusters
テーブルにリストされています。
SHOW CLUSTER name
クエリは指定されたクラスタ名に対して、 system.clusters
テーブルから cluster
、shard_num
、replica_num
、host_name
、host_address
、port
を表示します。
Syntax
Examples
SHOW SETTINGS
SHOW SETTINGS
ステートメントは、システム設定とその値のリストを返します。
system.settings
テーブルからデータを選択します。
Syntax
Clauses
LIKE|ILIKE
は、設定名に対する一致パターンを指定することを可能にします。
ワイルドカード( %
や _
)を含めることができます。 LIKE
句は大文字小文字を区別し、ILIKE
は区別しません。
CHANGED
句が使用されている場合、クエリはデフォルト値から変更された設定のみを返します。
Examples
LIKE
句を使用したクエリ:
ILIKE
句を使用したクエリ:
CHANGED
句を使用したクエリ:
SHOW SETTING
SHOW SETTING
ステートメントは、指定された設定名の設定値を出力します。
Syntax
See also
system.settings
テーブル
SHOW FILESYSTEM CACHES
Examples
See also
system.settings
テーブル
SHOW ENGINES
SHOW ENGINES
ステートメントは、system.table_engines
テーブルの内容を出力します。
このテーブルには、サーバーがサポートするテーブルエンジンの説明とその機能サポート情報が含まれています。
Syntax
See also
- system.table_engines テーブル
SHOW FUNCTIONS
SHOW FUNCTIONS
ステートメントは、system.functions
テーブルの内容を出力します。
Syntax
LIKE
または ILIKE
句が指定されている場合、クエリは指定された <pattern>
に一致するシステム関数のリストを返します。
See Also
system.functions
テーブル
SHOW MERGES
SHOW MERGES
ステートメントは、マージのリストを返します。
すべてのマージは system.merges
テーブルにリストされています:
Column | Description |
---|---|
table | テーブル名。 |
database | テーブルが属するデータベース名。 |
estimate_complete | 完了推定時間(秒単位)。 |
elapsed | マージが開始されてから経過した時間(秒単位)。 |
progress | 完了した作業の割合(0-100%)。 |
is_mutation | このプロセスが部分的なマージであれば 1。 |
size_compressed | マージされた部分の圧縮データの合計サイズ。 |
memory_usage | マージプロセスのメモリ消費。 |