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

SHOW 文

注記

SHOW CREATE (TABLE|DATABASE|USER) は、以下の設定がオンになっていない限り、秘密情報を隠します:

加えて、ユーザーはdisplaySecretsInShowAndSelect特権を持っている必要があります。

SHOW CREATE TABLE | DICTIONARY | VIEW | DATABASE

これらの文は、指定されたオブジェクトの作成に使用されたCREATEクエリを含む、文字列型の1つのカラムを返します。

構文

注記

この文を使用してシステムテーブルのCREATEクエリを取得すると、テーブル構造を宣言するだけのフェイククエリが返され、テーブルを作成することはできません。

SHOW DATABASES

この文は、すべてのデータベースのリストを印刷します。

構文

これは以下のクエリと同じです:

この例では、SHOWを使用して名前に'se'を含むデータベース名を取得します:

また、ケースインセンシティブな方法でも行えます:

名前に'de'を含まないデータベース名を取得することも可能です:

最後に、最初の2つのデータベース名だけを取得することもできます:

関連項目

SHOW TABLES

SHOW TABLES文は、テーブルのリストを表示します。

構文

FROM句が指定されていない場合、クエリは現在のデータベースのテーブルのリストを返します。

この文は以下のクエリと同じです:

この例では、SHOW TABLES文を使用して名前に'user'を含むすべてのテーブルを見つけます:

ケースインセンシティブな方法でも行えます:

名前に's'を含まないテーブルを見つけるためにも使用できます:

最後に、最初の2つのテーブル名だけを取得できます:

関連項目

SHOW COLUMNS

SHOW COLUMNS文は、カラムのリストを表示します。

構文

データベースとテーブル名は、<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

この例では、SHOW COLUMNS文を使用して、'orders'テーブルのすべてのカラムに関する情報を取得します。'delivery_'から始めます:

関連項目

SHOW DICTIONARIES

SHOW DICTIONARIES文は、ディクショナリのリストを表示します。

構文

FROM句が指定されていない場合、クエリは現在のデータベースからのディクショナリのリストを返します。

SHOW DICTIONARIESクエリと同じ結果を以下のように得ることができます:

次のクエリは、名前にregを含むsystemデータベース内のテーブルのリストから最初の2つの行を選択します:

SHOW INDEX

テーブルの主キーおよびデータスキッピングインデックスのリストを表示します。

この文は主にMySQLとの互換性のために存在します。システムテーブルsystem.tables(主キー用)およびsystem.data_skipping_indices(データスキッピングインデックス用)は、ClickHouseによりネイティブな形式で同等の情報を提供します。

構文

データベースおよびテーブル名は、<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はパックされたインデックスをサポートしないため常にNULLNullable(String)
null現在未使用
index_typeインデックスタイプ、例:PRIMARYMINMAXBLOOM_FILTERなど。String
commentインデックスについての追加情報、現在は常に''(空文字列)。String
index_commentインデックスにはCOMMENTフィールドを持てないため''(空文字列)。String
visibleインデックスがオプティマイザに見える場合、常にYESString
expressionデータスキッピングインデックスの場合、インデックス表現。プライマリキーインデックスの場合は''(空文字列)。String

この例では、SHOW INDEX文を使用して'tbl'テーブルのすべてのインデックスに関する情報を取得します:

関連項目

SHOW PROCESSLIST

system.processesテーブルの内容を出力し、現在処理されているクエリのリストを表示します。SHOW PROCESSLISTクエリを除きます。

構文

SELECT * FROM system.processesクエリは、すべての現在のクエリに関するデータを返します。

ヒント

コンソールで実行:

SHOW GRANTS

SHOW GRANTS文は、ユーザーの特権を表示します。

構文

ユーザーが指定されていない場合、クエリは現在のユーザーの特権を返します。

WITH IMPLICIT修飾子を使用すると、暗黙のグラント(例:GRANT SELECT ON system.one)を表示できます。

FINAL修飾子は、ユーザーとその付与されたロールからのすべてのグラントをマージします(継承を伴う)

SHOW CREATE USER

SHOW CREATE USER文は、ユーザー作成時に使用されたパラメーターを表示します。

構文

SHOW CREATE ROLE

SHOW CREATE ROLE文は、ロール作成時に使用されたパラメーターを表示します。

構文

SHOW CREATE ROW POLICY

SHOW CREATE ROW POLICY文は、行ポリシー作成時に使用されたパラメーターを表示します。

構文

SHOW CREATE QUOTA

SHOW CREATE QUOTA文は、クォータ作成時に使用されたパラメーターを表示します。

構文

SHOW CREATE SETTINGS PROFILE

SHOW CREATE SETTINGS PROFILE文は、設定プロファイル作成時に使用されたパラメーターを表示します。

構文

SHOW USERS

SHOW USERS文は、ユーザーアカウントの名前のリストを返します。 ユーザーアカウントのパラメータを表示するには、システムテーブルsystem.usersを参照してください。

構文

SHOW ROLES

SHOW ROLES文は、ロールのリストを返します。 他のパラメータを表示するには、システムテーブルsystem.rolesおよびsystem.role_grantsを参照してください。

構文

SHOW PROFILES

SHOW PROFILES文は、設定プロファイルのリストを返します。 ユーザーアカウントのパラメータを表示するには、システムテーブルsettings_profilesを参照してください。

構文

SHOW POLICIES

SHOW POLICIES文は、指定されたテーブルの行ポリシーのリストを返します。 ユーザーアカウントのパラメータを表示するには、システムテーブルsystem.row_policiesを参照してください。

構文

SHOW QUOTAS

SHOW QUOTAS文は、クォータのリストを返します。 クォータのパラメータを表示するには、システムテーブルsystem.quotasを参照してください。

構文

SHOW QUOTA

SHOW QUOTA文は、すべてのユーザーまたは現在のユーザーのクォータの消費を返します。 他のパラメータを表示するには、システムテーブルsystem.quotas_usageおよびsystem.quota_usageを参照してください。

構文

SHOW ACCESS

SHOW ACCESS文は、すべてのユーザーロールプロファイルなどを示し、すべてのグラントを表示します。

構文

SHOW CLUSTER(S)

SHOW CLUSTER(S)文は、クラスターのリストを返します。 利用可能なすべてのクラスターは、system.clustersテーブルにリストされています。

注記

SHOW CLUSTER nameクエリは、指定されたクラスタ名のsystem.clustersテーブルの内容を表示します。

構文

SHOW SETTINGS

SHOW SETTINGS文は、システム設定とその値のリストを返します。 system.settingsテーブルからデータを選択します。

構文

LIKE|ILIKEを使用すると、設定名の一致パターンを指定できます。 %_のようなグロブを含めることができます。LIKE句は大文字と小文字を区別し、ILIKEは大文字と小文字を区別しません。

CHANGED句を使用すると、デフォルト値から変更された設定のみがクエリで返されます。

LIKE句を使用したクエリ:

ILIKE句を使用したクエリ:

CHANGED句を使用したクエリ:

SHOW SETTING

SHOW SETTING文は、指定された設定名の設定値を出力します。

構文

関連項目

SHOW FILESYSTEM CACHES

関連項目

SHOW ENGINES

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

構文

関連項目

SHOW FUNCTIONS

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

構文

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

関連項目

SHOW MERGES

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

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

構文