SHOW 文
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
クエリを含む、文字列型の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 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 |
例
この例では、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 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はパックされたインデックスをサポートしないため常にNULL 。 | Nullable(String) |
null | 現在未使用 | |
index_type | インデックスタイプ、例:PRIMARY 、MINMAX 、BLOOM_FILTER など。 | String |
comment | インデックスについての追加情報、現在は常に'' (空文字列)。 | String |
index_comment | インデックスにはCOMMENT フィールドを持てないため'' (空文字列)。 | String |
visible | インデックスがオプティマイザに見える場合、常にYES 。 | String |
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
文は、指定された設定名の設定値を出力します。
構文
関連項目
system.settings
テーブル
SHOW FILESYSTEM CACHES
例
関連項目
system.settings
テーブル
SHOW ENGINES
SHOW ENGINES
文は、system.table_engines
テーブルの内容を出力し、サーバーがサポートするテーブルエンジンの説明とその機能サポート情報を含みます。
構文
関連項目
SHOW FUNCTIONS
SHOW FUNCTIONS
文は、system.functions
テーブルの内容を出力します。
構文
LIKE
またはILIKE
句が指定された場合、クエリは指定された<pattern>
に一致するシステム関数のリストを返します。
関連項目
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 | マージプロセスのメモリ消費。 |