27 KiB
| slug | sidebar_position | sidebar_label |
|---|---|---|
| /ja/sql-reference/statements/show | 37 | SHOW |
SHOW ステートメント
N.B. 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
SHOW [CREATE] [TEMPORARY] TABLE|DICTIONARY|VIEW|DATABASE [db.]table|view [INTO OUTFILE filename] [FORMAT format]
指定されたオブジェクトを作成するために使用されたCREATEクエリを含む、String型の単一のカラムを返します。
SHOW TABLE t および SHOW DATABASE db は SHOW CREATE TABLE|DATABASE t|db と同じ意味を持ちますが、SHOW t および SHOW db はサポートされていません。
システムテーブルの CREATE クエリを取得するためにこのステートメントを使用すると、テーブル構造のみを宣言する 偽の クエリが返され、テーブルを作成するために使用することはできません。
SHOW DATABASES
すべてのデータベースの一覧を表示します。
SHOW DATABASES [[NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
このステートメントは、次のクエリと同一です：
SELECT name FROM system.databases [WHERE name [NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
例
名前に 'de' というシーケンスを含むデータベース名を取得する：
SHOW DATABASES LIKE '%de%'
結果:
┌─name────┐
│ default │
└─────────┘
大文字小文字を区別しない方法で、名前に 'de' というシーケンスを含むデータベース名を取得する：
SHOW DATABASES ILIKE '%DE%'
結果:
┌─name────┐
│ default │
└─────────┘
名前に 'de' というシーケンスを含まないデータベース名を取得する：
SHOW DATABASES NOT LIKE '%de%'
結果:
┌─name───────────────────────────┐
│ _temporary_and_external_tables │
│ system │
│ test │
│ tutorial │
└────────────────────────────────┘
データベース名から最初の二行を取得する：
SHOW DATABASES LIMIT 2
結果:
┌─name───────────────────────────┐
│ _temporary_and_external_tables │
│ default │
└────────────────────────────────┘
参考
SHOW TABLES
テーブルのリストを表示します。
SHOW [FULL] [TEMPORARY] TABLES [{FROM | IN} <db>] [[NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
FROM 句が指定されていない場合、クエリは現在のデータベースのテーブルリストを返します。
このステートメントは、次のクエリと同一です：
SELECT name FROM system.tables [WHERE name [NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
例
名前に 'user' というシーケンスを含むテーブル名を取得する：
SHOW TABLES FROM system LIKE '%user%'
結果:
┌─name─────────────┐
│ user_directories │
│ users │
└──────────────────┘
大文字小文字を区別しない方法で、名前に 'user' を含むテーブル名を取得する：
SHOW TABLES FROM system ILIKE '%USER%'
結果:
┌─name─────────────┐
│ user_directories │
│ users │
└──────────────────┘
名前に 's' というシンボルシーケンスを含まないテーブル名を取得する：
SHOW TABLES FROM system NOT LIKE '%s%'
結果:
┌─name─────────┐
│ metric_log │
│ metric_log_0 │
│ metric_log_1 │
└──────────────┘
テーブル名から最初の二行を取得する：
SHOW TABLES FROM system LIMIT 2
結果:
┌─name───────────────────────────┐
│ aggregate_function_combinators │
│ asynchronous_metric_log │
└────────────────────────────────┘
参考
SHOW COLUMNS
カラムのリストを表示します
SHOW [EXTENDED] [FULL] COLUMNS {FROM | IN} <table> [{FROM | IN} <db>] [{[NOT] {LIKE | ILIKE} '<pattern>' | WHERE <expr>}] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
データベース名とテーブル名は、<db>.<table> の省略形で指定でき、FROM tab FROM db および FROM db.tab は等価です。データベースが指定されていない場合、クエリは現在のデータベースからカラムのリストを返します。
オプションのキーワード EXTENDED は現在、効果はありません。これはMySQLとの互換性のために存在します。
オプションのキーワード FULL は、出力に照合順序、コメント、特権カラムを含めるようにします。
このステートメントは以下の構造を持つ結果テーブルを生成します：
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)
例
'order' テーブル内の 'delivery_' で始まるすべてのカラムの情報を取得：
SHOW COLUMNS FROM 'orders' LIKE 'delivery_%'
結果:
┌─field───────────┬─type─────┬─null─┬─key─────┬─default─┬─extra─┐
│ delivery_date │ DateTime │ 0 │ PRI SOR │ ᴺᵁᴸᴸ │ │
│ delivery_status │ Bool │ 0 │ │ ᴺᵁᴸᴸ │ │
└─────────────────┴──────────┴──────┴─────────┴─────────┴───────┘
参考
SHOW DICTIONARIES
Dictionary のリストを表示します。
SHOW DICTIONARIES [FROM <db>] [LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
FROM 句が指定されていない場合、クエリは現在のデータベースからのDictionaryのリストを返します。
SHOW DICTIONARIES クエリと同じ結果を次の方法で取得できます：
SELECT name FROM system.dictionaries WHERE database = <db> [AND name LIKE <pattern>] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
例
次のクエリは、名前に reg を含む、system データベースのテーブルから最初の2行を選択します。
SHOW DICTIONARIES FROM db LIKE '%reg%' LIMIT 2
┌─name─────────┐
│ regions │
│ region_names │
└──────────────┘
SHOW INDEX
テーブルの主キー及びデータスキッピングインデックスのリストを表示します。
このステートメントは主にMySQLとの互換性のために存在します。システムテーブル system.tables (主キー用) および system.data_skipping_indices (データスキッピングインデックス用) は、ClickHouseによりネイティブな形で同等の情報を提供します。
SHOW [EXTENDED] {INDEX | INDEXES | INDICES | KEYS } {FROM | IN} <table> [{FROM | IN} <db>] [WHERE <expr>] [INTO OUTFILE <filename>] [FORMAT <format>]
データベースおよびテーブル名は、<db>.<table> の省略形で指定でき、FROM tab FROM db および FROM db.tab は等価です。データベースが指定されていない場合、クエリは現在のデータベースをデータベースとして想定します。
オプションのキーワード EXTENDED は現在、効果はありません。これはMySQLとの互換性のために存在します。
このステートメントは以下の構造を持つ結果テーブルを生成します：
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フィールド（MySQLのような）を持たせることができないため、''（空文字列）。(String)visible- インデックスがオプティマイザに見える場合、常にYES。(String)expression- データスキッピングインデックスの場合、インデックス式。主キーインデックスの場合：''（空文字列）。(String)
例
'tbl' テーブル内のすべてのインデックスの情報を取得：
SHOW INDEX FROM 'tbl'
結果:
┌─table─┬─non_unique─┬─key_name─┬─seq_in_index─┬─column_name─┬─collation─┬─cardinality─┬─sub_part─┬─packed─┬─null─┬─index_type───┬─comment─┬─index_comment─┬─visible─┬─expression─┐
│ tbl │ 1 │ blf_idx │ 1 │ 1 │ ᴺᵁᴸᴸ │ 0 │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ BLOOM_FILTER │ │ │ YES │ d, b │
│ tbl │ 1 │ mm1_idx │ 1 │ 1 │ ᴺᵁᴸᴸ │ 0 │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ MINMAX │ │ │ YES │ a, c, d │
│ tbl │ 1 │ mm2_idx │ 1 │ 1 │ ᴺᵁᴸᴸ │ 0 │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ MINMAX │ │ │ YES │ c, d, e │
│ tbl │ 1 │ PRIMARY │ 1 │ c │ A │ 0 │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ PRIMARY │ │ │ YES │ │
│ tbl │ 1 │ PRIMARY │ 2 │ a │ A │ 0 │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ PRIMARY │ │ │ YES │ │
│ tbl │ 1 │ set_idx │ 1 │ 1 │ ᴺᵁᴸᴸ │ 0 │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ SET │ │ │ YES │ e │
└───────┴────────────┴──────────┴──────────────┴─────────────┴───────────┴─────────────┴──────────┴────────┴──────┴──────────────┴─────────┴───────────────┴─────────┴────────────┘
参考
SHOW PROCESSLIST
SHOW PROCESSLIST [INTO OUTFILE filename] [FORMAT format]
system.processes テーブルの内容を出力します。このテーブルには、現在処理中のクエリのリストが含まれており、SHOW PROCESSLIST クエリは除外されます。
SELECT * FROM system.processes クエリは、すべての現在のクエリに関するデータを返します。
Tip (コンソールで実行):
$ watch -n1 "clickhouse-client --query='SHOW PROCESSLIST'"
SHOW GRANTS
ユーザーの特権を表示します。
構文
SHOW GRANTS [FOR user1 [, user2 ...]] [WITH IMPLICIT] [FINAL]
ユーザーが指定されていない場合、クエリは現在のユーザーの特権を返します。
WITH IMPLICIT 修飾子は、暗黙の権限を表示することを可能にします（例：GRANT SELECT ON system.one）
FINAL 修飾子は、ユーザーとその付与された役割（継承付き）からすべての権限をマージします。
SHOW CREATE USER
ユーザー作成で使用されたパラメーターを表示します。
構文
SHOW CREATE USER [name1 [, name2 ...] | CURRENT_USER]
SHOW CREATE ROLE
ロール作成で使用されたパラメーターを表示します。
構文
SHOW CREATE ROLE name1 [, name2 ...]
SHOW CREATE ROW POLICY
ローポリシー作成で使用されたパラメーターを表示します。
構文
SHOW CREATE [ROW] POLICY name ON [database1.]table1 [, [database2.]table2 ...]
SHOW CREATE QUOTA
クォータ作成で使用されたパラメーターを表示します。
構文
SHOW CREATE QUOTA [name1 [, name2 ...] | CURRENT]
SHOW CREATE SETTINGS PROFILE
設定プロファイル作成で使用されたパラメーターを表示します。
構文
SHOW CREATE [SETTINGS] PROFILE name1 [, name2 ...]
SHOW USERS
ユーザーアカウントの名前を返します。ユーザーアカウントのパラメーターを表示するには、システムテーブル system.users を参照してください。
構文
SHOW USERS
SHOW ROLES
ロールのリストを返します。他のパラメーターを表示するには、システムテーブル system.roles および system.role_grants を参照してください。
構文
SHOW [CURRENT|ENABLED] ROLES
SHOW PROFILES
設定プロファイルのリストを返します。ユーザーアカウントのパラメーターを表示するには、システムテーブル settings_profiles を参照してください。
構文
SHOW [SETTINGS] PROFILES
SHOW POLICIES
指定されたテーブルのローポリシーのリストを返します。ユーザーアカウントのパラメーターを表示するには、システムテーブル system.row_policies を参照してください。
構文
SHOW [ROW] POLICIES [ON [db.]table]
SHOW QUOTAS
クォータのリストを返します。クォータのパラメーターを表示するには、システムテーブル system.quotas を参照してください。
構文
SHOW QUOTAS
SHOW QUOTA
全てのユーザーまたは現在のユーザーのクォータ消費量を返します。他のパラメーターを表示するには、システムテーブル system.quotas_usage および system.quota_usage を参照してください。
構文
SHOW [CURRENT] QUOTA
SHOW ACCESS
すべてのユーザー、ロール、プロファイルなどとそのすべての付与を表示します。
構文
SHOW ACCESS
SHOW CLUSTER(S)
クラスタのリストを返します。すべての利用可能なクラスタは system.clusters テーブルにリストされています。
:::note
SHOW CLUSTER name クエリは、このクラスタに対する system.clusters テーブルの内容を表示します。
:::
構文
SHOW CLUSTER '<name>'
SHOW CLUSTERS [[NOT] LIKE|ILIKE '<pattern>'] [LIMIT <N>]
例
クエリ:
SHOW CLUSTERS;
結果:
┌─cluster──────────────────────────────────────┐
│ test_cluster_two_shards │
│ test_cluster_two_shards_internal_replication │
│ test_cluster_two_shards_localhost │
│ test_shard_localhost │
│ test_shard_localhost_secure │
│ test_unavailable_shard │
└──────────────────────────────────────────────┘
クエリ:
SHOW CLUSTERS LIKE 'test%' LIMIT 1;
結果:
┌─cluster─────────────────┐
│ test_cluster_two_shards │
└─────────────────────────┘
クエリ:
SHOW CLUSTER 'test_shard_localhost' FORMAT Vertical;
結果:
Row 1:
──────
cluster: test_shard_localhost
shard_num: 1
shard_weight: 1
replica_num: 1
host_name: localhost
host_address: 127.0.0.1
port: 9000
is_local: 1
user: default
default_database:
errors_count: 0
estimated_recovery_time: 0
SHOW SETTINGS
システム設定とその値のリストを返します。 system.settings テーブルからデータを選択します。
構文
SHOW [CHANGED] SETTINGS LIKE|ILIKE <name>
句
LIKE|ILIKE は、設定名の一致パターンを指定することができます。% や _ などのグロブを含むことができます。LIKE 句は大文字小文字を区別し、ILIKE は大文字小文字を区別しません。
CHANGED 句を使用した場合、クエリはデフォルト値から変更された設定のみを返します。
例
LIKE 句を使用したクエリ：
SHOW SETTINGS LIKE 'send_timeout';
結果:
┌─name─────────┬─type────┬─value─┐
│ send_timeout │ Seconds │ 300 │
└──────────────┴─────────┴───────┘
ILIKE 句を使用したクエリ：
SHOW SETTINGS ILIKE '%CONNECT_timeout%'
結果:
┌─name────────────────────────────────────┬─type─────────┬─value─┐
│ connect_timeout │ Seconds │ 10 │
│ connect_timeout_with_failover_ms │ Milliseconds │ 50 │
│ connect_timeout_with_failover_secure_ms │ Milliseconds │ 100 │
└─────────────────────────────────────────┴──────────────┴───────┘
CHANGED 句を使用したクエリ：
SHOW CHANGED SETTINGS ILIKE '%MEMORY%'
結果:
┌─name─────────────┬─type───┬─value───────┐
│ max_memory_usage │ UInt64 │ 10000000000 │
└──────────────────┴────────┴─────────────┘
SHOW SETTING
SHOW SETTING <name>
指定された設定名の設定値を出力します。
関連項目
- system.settings テーブル
SHOW FILESYSTEM CACHES
SHOW FILESYSTEM CACHES
結果:
┌─Caches────┐
│ s3_cache │
└───────────┘
関連項目
- system.settings テーブル
SHOW ENGINES
SHOW ENGINES [INTO OUTFILE filename] [FORMAT format]
サーバーがサポートするテーブルエンジンとそれに関連する機能サポート情報の説明を含む system.table_engines テーブルの内容を出力します。
関連項目
- system.table_engines テーブル
SHOW FUNCTIONS
SHOW FUNCTIONS [LIKE | ILIKE '<pattern>']
system.functions テーブルの内容を出力します。
LIKE または ILIKE 句が指定された場合、クエリは名前が提供された <pattern> に一致するシステム関数のリストを返します。
関連項目
- system.functions テーブル
SHOW MERGES
マージのリストを返します。すべてのマージは system.merges テーブルにリストされています。
table-- テーブル名。database-- テーブルが存在するデータベース名。estimate_complete-- 完了までの推定時間（秒）。elapsed-- マージ開始からの経過時間（秒）。progress-- 完了した作業の割合（0-100パーセント）。is_mutation-- このプロセスが部分的な変異である場合は 1。size_compressed-- マージされたパーツの圧縮データの合計サイズ。memory_usage-- マージプロセスのメモリ消費量。
構文
SHOW MERGES [[NOT] LIKE|ILIKE '<table_name_pattern>'] [LIMIT <N>]
例
クエリ:
SHOW MERGES;
結果:
┌─table──────┬─database─┬─estimate_complete─┬─elapsed─┬─progress─┬─is_mutation─┬─size_compressed─┬─memory_usage─┐
│ your_table │ default │ 0.14 │ 0.36 │ 73.01 │ 0 │ 5.40 MiB │ 10.25 MiB │
└────────────┴──────────┴───────────────────┴─────────┴──────────┴─────────────┴─────────────────┴──────────────┘
クエリ:
SHOW MERGES LIKE 'your_t%' LIMIT 1;
結果:
┌─table──────┬─database─┬─estimate_complete─┬─elapsed─┬─progress─┬─is_mutation─┬─size_compressed─┬─memory_usage─┐
│ your_table │ default │ 0.14 │ 0.36 │ 73.01 │ 0 │ 5.40 MiB │ 10.25 MiB │
└────────────┴──────────┴───────────────────┴─────────┴──────────┴─────────────┴─────────────────┴──────────────┘