mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-19 04:42:37 +00:00
706 lines
27 KiB
Markdown
706 lines
27 KiB
Markdown
---
|
||
slug: /ja/sql-reference/statements/show
|
||
sidebar_position: 37
|
||
sidebar_label: SHOW
|
||
---
|
||
|
||
# SHOW ステートメント
|
||
|
||
N.B. `SHOW CREATE (TABLE|DATABASE|USER)` は、[`display_secrets_in_show_and_select` サーバー設定](../../operations/server-configuration-parameters/settings#display_secrets_in_show_and_select)が有効になっておらず、[`format_display_secrets_in_show_and_select` フォーマット設定](../../operations/settings/formats#format_display_secrets_in_show_and_select)が有効になっておらず、またユーザーに[`displaySecretsInShowAndSelect`](grant.md#display-secrets) 権限がない限り、秘密情報を隠すようにします。
|
||
|
||
## SHOW CREATE TABLE | DICTIONARY | VIEW | DATABASE
|
||
|
||
``` sql
|
||
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
|
||
|
||
すべてのデータベースの一覧を表示します。
|
||
|
||
```sql
|
||
SHOW DATABASES [[NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
|
||
```
|
||
|
||
このステートメントは、次のクエリと同一です：
|
||
|
||
```sql
|
||
SELECT name FROM system.databases [WHERE name [NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
|
||
```
|
||
|
||
**例**
|
||
|
||
名前に 'de' というシーケンスを含むデータベース名を取得する：
|
||
|
||
``` sql
|
||
SHOW DATABASES LIKE '%de%'
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─name────┐
|
||
│ default │
|
||
└─────────┘
|
||
```
|
||
|
||
大文字小文字を区別しない方法で、名前に 'de' というシーケンスを含むデータベース名を取得する：
|
||
|
||
``` sql
|
||
SHOW DATABASES ILIKE '%DE%'
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─name────┐
|
||
│ default │
|
||
└─────────┘
|
||
```
|
||
|
||
名前に 'de' というシーケンスを含まないデータベース名を取得する：
|
||
|
||
``` sql
|
||
SHOW DATABASES NOT LIKE '%de%'
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─name───────────────────────────┐
|
||
│ _temporary_and_external_tables │
|
||
│ system │
|
||
│ test │
|
||
│ tutorial │
|
||
└────────────────────────────────┘
|
||
```
|
||
|
||
データベース名から最初の二行を取得する：
|
||
|
||
``` sql
|
||
SHOW DATABASES LIMIT 2
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─name───────────────────────────┐
|
||
│ _temporary_and_external_tables │
|
||
│ default │
|
||
└────────────────────────────────┘
|
||
```
|
||
|
||
**参考**
|
||
- [CREATE DATABASE](https://clickhouse.com/docs/ja/sql-reference/statements/create/database/#query-language-create-database)
|
||
|
||
## SHOW TABLES
|
||
|
||
テーブルのリストを表示します。
|
||
|
||
```sql
|
||
SHOW [FULL] [TEMPORARY] TABLES [{FROM | IN} <db>] [[NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
|
||
```
|
||
|
||
`FROM` 句が指定されていない場合、クエリは現在のデータベースのテーブルリストを返します。
|
||
|
||
このステートメントは、次のクエリと同一です：
|
||
|
||
```sql
|
||
SELECT name FROM system.tables [WHERE name [NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
|
||
```
|
||
|
||
**例**
|
||
|
||
名前に 'user' というシーケンスを含むテーブル名を取得する：
|
||
|
||
``` sql
|
||
SHOW TABLES FROM system LIKE '%user%'
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─name─────────────┐
|
||
│ user_directories │
|
||
│ users │
|
||
└──────────────────┘
|
||
```
|
||
|
||
大文字小文字を区別しない方法で、名前に 'user' を含むテーブル名を取得する：
|
||
|
||
``` sql
|
||
SHOW TABLES FROM system ILIKE '%USER%'
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─name─────────────┐
|
||
│ user_directories │
|
||
│ users │
|
||
└──────────────────┘
|
||
```
|
||
|
||
名前に 's' というシンボルシーケンスを含まないテーブル名を取得する：
|
||
|
||
``` sql
|
||
SHOW TABLES FROM system NOT LIKE '%s%'
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─name─────────┐
|
||
│ metric_log │
|
||
│ metric_log_0 │
|
||
│ metric_log_1 │
|
||
└──────────────┘
|
||
```
|
||
|
||
テーブル名から最初の二行を取得する：
|
||
|
||
``` sql
|
||
SHOW TABLES FROM system LIMIT 2
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─name───────────────────────────┐
|
||
│ aggregate_function_combinators │
|
||
│ asynchronous_metric_log │
|
||
└────────────────────────────────┘
|
||
```
|
||
|
||
**参考**
|
||
|
||
- [Create Tables](https://clickhouse.com/docs/ja/getting-started/tutorial/#create-tables)
|
||
- [SHOW CREATE TABLE](https://clickhouse.com/docs/ja/sql-reference/statements/show/#show-create-table)
|
||
|
||
## SHOW COLUMNS {#show_columns}
|
||
|
||
カラムのリストを表示します
|
||
|
||
```sql
|
||
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_' で始まるすべてのカラムの情報を取得：
|
||
|
||
```sql
|
||
SHOW COLUMNS FROM 'orders' LIKE 'delivery_%'
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─field───────────┬─type─────┬─null─┬─key─────┬─default─┬─extra─┐
|
||
│ delivery_date │ DateTime │ 0 │ PRI SOR │ ᴺᵁᴸᴸ │ │
|
||
│ delivery_status │ Bool │ 0 │ │ ᴺᵁᴸᴸ │ │
|
||
└─────────────────┴──────────┴──────┴─────────┴─────────┴───────┘
|
||
```
|
||
|
||
**参考**
|
||
- [system.columns](https://clickhouse.com/docs/ja/operations/system-tables/columns)
|
||
|
||
## SHOW DICTIONARIES
|
||
|
||
[Dictionary](../../sql-reference/dictionaries/index.md) のリストを表示します。
|
||
|
||
``` sql
|
||
SHOW DICTIONARIES [FROM <db>] [LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
|
||
```
|
||
|
||
`FROM` 句が指定されていない場合、クエリは現在のデータベースからのDictionaryのリストを返します。
|
||
|
||
`SHOW DICTIONARIES` クエリと同じ結果を次の方法で取得できます：
|
||
|
||
``` sql
|
||
SELECT name FROM system.dictionaries WHERE database = <db> [AND name LIKE <pattern>] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
|
||
```
|
||
|
||
**例**
|
||
|
||
次のクエリは、名前に `reg` を含む、`system` データベースのテーブルから最初の2行を選択します。
|
||
|
||
``` sql
|
||
SHOW DICTIONARIES FROM db LIKE '%reg%' LIMIT 2
|
||
```
|
||
|
||
``` text
|
||
┌─name─────────┐
|
||
│ regions │
|
||
│ region_names │
|
||
└──────────────┘
|
||
```
|
||
|
||
## SHOW INDEX
|
||
|
||
テーブルの主キー及びデータスキッピングインデックスのリストを表示します。
|
||
|
||
このステートメントは主にMySQLとの互換性のために存在します。システムテーブル [system.tables](../../operations/system-tables/tables.md) (主キー用) および [system.data_skipping_indices](../../operations/system-tables/data_skipping_indices.md) (データスキッピングインデックス用) は、ClickHouseによりネイティブな形で同等の情報を提供します。
|
||
|
||
```sql
|
||
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' テーブル内のすべてのインデックスの情報を取得：
|
||
|
||
```sql
|
||
SHOW INDEX FROM 'tbl'
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─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 │
|
||
└───────┴────────────┴──────────┴──────────────┴─────────────┴───────────┴─────────────┴──────────┴────────┴──────┴──────────────┴─────────┴───────────────┴─────────┴────────────┘
|
||
```
|
||
|
||
**参考**
|
||
- [system.tables](../../operations/system-tables/tables.md)
|
||
- [system.data_skipping_indices](../../operations/system-tables/data_skipping_indices.md)
|
||
|
||
## SHOW PROCESSLIST
|
||
|
||
``` sql
|
||
SHOW PROCESSLIST [INTO OUTFILE filename] [FORMAT format]
|
||
```
|
||
|
||
[system.processes](../../operations/system-tables/processes.md#system_tables-processes) テーブルの内容を出力します。このテーブルには、現在処理中のクエリのリストが含まれており、`SHOW PROCESSLIST` クエリは除外されます。
|
||
|
||
`SELECT * FROM system.processes` クエリは、すべての現在のクエリに関するデータを返します。
|
||
|
||
Tip (コンソールで実行):
|
||
|
||
``` bash
|
||
$ watch -n1 "clickhouse-client --query='SHOW PROCESSLIST'"
|
||
```
|
||
|
||
## SHOW GRANTS
|
||
|
||
ユーザーの特権を表示します。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
SHOW GRANTS [FOR user1 [, user2 ...]] [WITH IMPLICIT] [FINAL]
|
||
```
|
||
|
||
ユーザーが指定されていない場合、クエリは現在のユーザーの特権を返します。
|
||
|
||
`WITH IMPLICIT` 修飾子は、暗黙の権限を表示することを可能にします（例：`GRANT SELECT ON system.one`）
|
||
|
||
`FINAL` 修飾子は、ユーザーとその付与された役割（継承付き）からすべての権限をマージします。
|
||
|
||
## SHOW CREATE USER
|
||
|
||
[ユーザー作成](../../sql-reference/statements/create/user.md)で使用されたパラメーターを表示します。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
SHOW CREATE USER [name1 [, name2 ...] | CURRENT_USER]
|
||
```
|
||
|
||
## SHOW CREATE ROLE
|
||
|
||
[ロール作成](../../sql-reference/statements/create/role.md)で使用されたパラメーターを表示します。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
SHOW CREATE ROLE name1 [, name2 ...]
|
||
```
|
||
|
||
## SHOW CREATE ROW POLICY
|
||
|
||
[ローポリシー作成](../../sql-reference/statements/create/row-policy.md)で使用されたパラメーターを表示します。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
SHOW CREATE [ROW] POLICY name ON [database1.]table1 [, [database2.]table2 ...]
|
||
```
|
||
|
||
## SHOW CREATE QUOTA
|
||
|
||
[クォータ作成](../../sql-reference/statements/create/quota.md)で使用されたパラメーターを表示します。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
SHOW CREATE QUOTA [name1 [, name2 ...] | CURRENT]
|
||
```
|
||
|
||
## SHOW CREATE SETTINGS PROFILE
|
||
|
||
[設定プロファイル作成](../../sql-reference/statements/create/settings-profile.md)で使用されたパラメーターを表示します。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
SHOW CREATE [SETTINGS] PROFILE name1 [, name2 ...]
|
||
```
|
||
|
||
## SHOW USERS
|
||
|
||
[ユーザーアカウント](../../guides/sre/user-management/index.md#user-account-management)の名前を返します。ユーザーアカウントのパラメーターを表示するには、システムテーブル [system.users](../../operations/system-tables/users.md#system_tables-users) を参照してください。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
SHOW USERS
|
||
```
|
||
|
||
## SHOW ROLES
|
||
|
||
[ロール](../../guides/sre/user-management/index.md#role-management)のリストを返します。他のパラメーターを表示するには、システムテーブル [system.roles](../../operations/system-tables/roles.md#system_tables-roles) および [system.role_grants](../../operations/system-tables/role-grants.md#system_tables-role_grants) を参照してください。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
SHOW [CURRENT|ENABLED] ROLES
|
||
```
|
||
|
||
## SHOW PROFILES
|
||
|
||
[設定プロファイル](../../guides/sre/user-management/index.md#settings-profiles-management)のリストを返します。ユーザーアカウントのパラメーターを表示するには、システムテーブル [settings_profiles](../../operations/system-tables/settings_profiles.md#system_tables-settings_profiles) を参照してください。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
SHOW [SETTINGS] PROFILES
|
||
```
|
||
|
||
## SHOW POLICIES
|
||
|
||
指定されたテーブルの[ローポリシー](../../guides/sre/user-management/index.md#row-policy-management)のリストを返します。ユーザーアカウントのパラメーターを表示するには、システムテーブル [system.row_policies](../../operations/system-tables/row_policies.md#system_tables-row_policies) を参照してください。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
SHOW [ROW] POLICIES [ON [db.]table]
|
||
```
|
||
|
||
## SHOW QUOTAS
|
||
|
||
[クォータ](../../guides/sre/user-management/index.md#quotas-management)のリストを返します。クォータのパラメーターを表示するには、システムテーブル [system.quotas](../../operations/system-tables/quotas.md#system_tables-quotas) を参照してください。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
SHOW QUOTAS
|
||
```
|
||
|
||
## SHOW QUOTA
|
||
|
||
全てのユーザーまたは現在のユーザーの[クォータ](../../operations/quotas.md)消費量を返します。他のパラメーターを表示するには、システムテーブル [system.quotas_usage](../../operations/system-tables/quotas_usage.md#system_tables-quotas_usage) および [system.quota_usage](../../operations/system-tables/quota_usage.md#system_tables-quota_usage) を参照してください。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
SHOW [CURRENT] QUOTA
|
||
```
|
||
|
||
## SHOW ACCESS
|
||
|
||
すべての[ユーザー](../../guides/sre/user-management/index.md#user-account-management)、[ロール](../../guides/sre/user-management/index.md#role-management)、[プロファイル](../../guides/sre/user-management/index.md#settings-profiles-management)などとそのすべての[付与](../../sql-reference/statements/grant.md#privileges)を表示します。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
SHOW ACCESS
|
||
```
|
||
|
||
## SHOW CLUSTER(S)
|
||
|
||
クラスタのリストを返します。すべての利用可能なクラスタは [system.clusters](../../operations/system-tables/clusters.md) テーブルにリストされています。
|
||
|
||
:::note
|
||
`SHOW CLUSTER name` クエリは、このクラスタに対する system.clusters テーブルの内容を表示します。
|
||
:::
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
SHOW CLUSTER '<name>'
|
||
SHOW CLUSTERS [[NOT] LIKE|ILIKE '<pattern>'] [LIMIT <N>]
|
||
```
|
||
|
||
**例**
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SHOW CLUSTERS;
|
||
```
|
||
|
||
結果:
|
||
|
||
```text
|
||
┌─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 │
|
||
└──────────────────────────────────────────────┘
|
||
```
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SHOW CLUSTERS LIKE 'test%' LIMIT 1;
|
||
```
|
||
|
||
結果:
|
||
|
||
```text
|
||
┌─cluster─────────────────┐
|
||
│ test_cluster_two_shards │
|
||
└─────────────────────────┘
|
||
```
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SHOW CLUSTER 'test_shard_localhost' FORMAT Vertical;
|
||
```
|
||
|
||
結果:
|
||
|
||
```text
|
||
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](../../operations/system-tables/settings.md) テーブルからデータを選択します。
|
||
|
||
**構文**
|
||
|
||
```sql
|
||
SHOW [CHANGED] SETTINGS LIKE|ILIKE <name>
|
||
```
|
||
|
||
**句**
|
||
|
||
`LIKE|ILIKE` は、設定名の一致パターンを指定することができます。`%` や `_` などのグロブを含むことができます。`LIKE` 句は大文字小文字を区別し、`ILIKE` は大文字小文字を区別しません。
|
||
|
||
`CHANGED` 句を使用した場合、クエリはデフォルト値から変更された設定のみを返します。
|
||
|
||
**例**
|
||
|
||
`LIKE` 句を使用したクエリ：
|
||
|
||
```sql
|
||
SHOW SETTINGS LIKE 'send_timeout';
|
||
```
|
||
結果:
|
||
|
||
```text
|
||
┌─name─────────┬─type────┬─value─┐
|
||
│ send_timeout │ Seconds │ 300 │
|
||
└──────────────┴─────────┴───────┘
|
||
```
|
||
|
||
`ILIKE` 句を使用したクエリ：
|
||
|
||
```sql
|
||
SHOW SETTINGS ILIKE '%CONNECT_timeout%'
|
||
```
|
||
|
||
結果:
|
||
|
||
```text
|
||
┌─name────────────────────────────────────┬─type─────────┬─value─┐
|
||
│ connect_timeout │ Seconds │ 10 │
|
||
│ connect_timeout_with_failover_ms │ Milliseconds │ 50 │
|
||
│ connect_timeout_with_failover_secure_ms │ Milliseconds │ 100 │
|
||
└─────────────────────────────────────────┴──────────────┴───────┘
|
||
```
|
||
|
||
`CHANGED` 句を使用したクエリ：
|
||
|
||
```sql
|
||
SHOW CHANGED SETTINGS ILIKE '%MEMORY%'
|
||
```
|
||
|
||
結果:
|
||
|
||
```text
|
||
┌─name─────────────┬─type───┬─value───────┐
|
||
│ max_memory_usage │ UInt64 │ 10000000000 │
|
||
└──────────────────┴────────┴─────────────┘
|
||
```
|
||
|
||
## SHOW SETTING
|
||
|
||
``` sql
|
||
SHOW SETTING <name>
|
||
```
|
||
|
||
指定された設定名の設定値を出力します。
|
||
|
||
**関連項目**
|
||
- [system.settings](../../operations/system-tables/settings.md) テーブル
|
||
|
||
## SHOW FILESYSTEM CACHES
|
||
|
||
```sql
|
||
SHOW FILESYSTEM CACHES
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─Caches────┐
|
||
│ s3_cache │
|
||
└───────────┘
|
||
```
|
||
|
||
**関連項目**
|
||
- [system.settings](../../operations/system-tables/settings.md) テーブル
|
||
|
||
## SHOW ENGINES
|
||
|
||
``` sql
|
||
SHOW ENGINES [INTO OUTFILE filename] [FORMAT format]
|
||
```
|
||
|
||
サーバーがサポートするテーブルエンジンとそれに関連する機能サポート情報の説明を含む [system.table_engines](../../operations/system-tables/table_engines.md) テーブルの内容を出力します。
|
||
|
||
**関連項目**
|
||
- [system.table_engines](../../operations/system-tables/table_engines.md) テーブル
|
||
|
||
## SHOW FUNCTIONS
|
||
|
||
``` sql
|
||
SHOW FUNCTIONS [LIKE | ILIKE '<pattern>']
|
||
```
|
||
|
||
[system.functions](../../operations/system-tables/functions.md) テーブルの内容を出力します。
|
||
|
||
`LIKE` または `ILIKE` 句が指定された場合、クエリは名前が提供された `<pattern>` に一致するシステム関数のリストを返します。
|
||
|
||
**関連項目**
|
||
- [system.functions](../../operations/system-tables/functions.md) テーブル
|
||
|
||
## SHOW MERGES
|
||
|
||
マージのリストを返します。すべてのマージは [system.merges](../../operations/system-tables/merges.md) テーブルにリストされています。
|
||
|
||
- `table` -- テーブル名。
|
||
- `database` -- テーブルが存在するデータベース名。
|
||
- `estimate_complete` -- 完了までの推定時間（秒）。
|
||
- `elapsed` -- マージ開始からの経過時間（秒）。
|
||
- `progress` -- 完了した作業の割合（0-100パーセント）。
|
||
- `is_mutation` -- このプロセスが部分的な変異である場合は 1。
|
||
- `size_compressed` -- マージされたパーツの圧縮データの合計サイズ。
|
||
- `memory_usage` -- マージプロセスのメモリ消費量。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
SHOW MERGES [[NOT] LIKE|ILIKE '<table_name_pattern>'] [LIMIT <N>]
|
||
```
|
||
|
||
**例**
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SHOW MERGES;
|
||
```
|
||
|
||
結果:
|
||
|
||
```text
|
||
┌─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 │
|
||
└────────────┴──────────┴───────────────────┴─────────┴──────────┴─────────────┴─────────────────┴──────────────┘
|
||
```
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SHOW MERGES LIKE 'your_t%' LIMIT 1;
|
||
```
|
||
|
||
結果:
|
||
|
||
```text
|
||
┌─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 │
|
||
└────────────┴──────────┴───────────────────┴─────────┴──────────┴─────────────┴─────────────────┴──────────────┘
|
||
```
|