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 | マージプロセスのメモリ消費。 |
