メインコンテンツまでスキップ
メインコンテンツまでスキップ

SHOW Statements

注記

SHOW CREATE (TABLE|DATABASE|USER) は、以下の設定が有効でない限り、シークレットを隠します:

さらに、ユーザーは 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 dbFROM db.tab が同等であることを意味します。
データベースが指定されていない場合、クエリは現在のデータベースからのカラムのリストを返します。

EXTENDEDFULL の2つのオプションのキーワードがあります。EXTENDED キーワードは現在は効果がなく、MySQLの互換性のために存在します。FULL キーワードは、出力に照合順序、コメント、権限カラムを含ませます。

SHOW COLUMNS ステートメントは、次の構造の結果テーブルを生成します:

ColumnDescriptionType
fieldカラムの名前String
typeカラムのデータ型。クエリがMySQLワイヤプロトコルを介して行われた場合、同等の型名がMySQLで表示されます。String
nullカラムのデータ型がNullableであれば YES、そうでなければ NOString
keyカラムが主キーの一部であれば PRI、ソートキーの一部であれば SOR、それ以外は空String
defaultカラムが ALIASDEFAULT、または MATERIALIZED の型の場合のデフォルト表現、それ以外は NULLNullable(String)
extra追加情報、現在は未使用String
collation( FULL キーワードが指定された場合のみ) カラムの照合順序、ClickHouseにはカラムごとの照合順序がないため常に NULLNullable(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 dbFROM db.tab が同等です。
データベースが指定されていない場合、クエリは現在のデータベースを前提とします。

オプションのキーワード EXTENDED は現在効果がなく、MySQLの互換性のために存在します。

ステートメントは次の構造の結果テーブルを生成します:

ColumnDescriptionType
tableテーブルの名前。String
non_uniqueClickHouseは一意制約を支持していないため、常に 1UInt8
key_nameインデックスの名前、インデックスが主キーインデックスの場合は PRIMARYString
seq_in_index主キーインデックスの場合、1から始まるカラムの位置。データスキッピングインデックスの場合は常に 1UInt8
column_name主キーインデックスの場合、『カラムの名前。データスキッピングインデックスの場合、空文字列、"expression" フィールドを参照。String
collationインデックス内のカラムのソート:昇順の場合は A、降順の場合は D、ソートされていない場合は NULLNullable(String)
cardinalityインデックスのカーディナリティの推定 (インデックス内の一意の値の数)。現在は常に 0。UInt64
sub_partClickHouseはMySQLのようなインデックスプレフィックスをサポートしないため、常に NULLNullable(String)
packedClickHouseはMySQLのような圧縮されたインデックスをサポートしないため、常に NULLNullable(String)
null現在未使用
index_typeインデックスのタイプ、例: PRIMARY, MINMAX, BLOOM_FILTER など。String
commentインデックスに関する追加情報、現在は常に空文字列。String
index_commentClickHouseではインデックスに COMMENT フィールドを持つことができないため、空文字列。String
visibleインデックスがオプティマイザーに見える場合、常に YESString
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 テーブルから clustershard_numreplica_numhost_namehost_addressport を表示します。

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

SHOW FILESYSTEM CACHES

Examples

See also

SHOW ENGINES

SHOW ENGINES ステートメントは、system.table_engines テーブルの内容を出力します。
このテーブルには、サーバーがサポートするテーブルエンジンの説明とその機能サポート情報が含まれています。

Syntax

See also

SHOW FUNCTIONS

SHOW FUNCTIONS ステートメントは、system.functions テーブルの内容を出力します。

Syntax

LIKE または ILIKE 句が指定されている場合、クエリは指定された <pattern> に一致するシステム関数のリストを返します。

See Also

SHOW MERGES

SHOW MERGES ステートメントは、マージのリストを返します。
すべてのマージは system.merges テーブルにリストされています:

ColumnDescription
tableテーブル名。
databaseテーブルが属するデータベース名。
estimate_complete完了推定時間(秒単位)。
elapsedマージが開始されてから経過した時間(秒単位)。
progress完了した作業の割合(0-100%)。
is_mutationこのプロセスが部分的なマージであれば 1。
size_compressedマージされた部分の圧縮データの合計サイズ。
memory_usageマージプロセスのメモリ消費。

Syntax

Examples