> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> SHOW 문서

# SHOW SQL 문

<Note>
  `SHOW CREATE (TABLE|DATABASE|USER)`는 다음 설정을 활성화하지 않으면 시크릿을 숨깁니다:

  * [`display_secrets_in_show_and_select`](/ko/reference/settings/server-settings/settings#display_secrets_in_show_and_select) (server 설정)
  * [`format_display_secrets_in_show_and_select` ](/ko/reference/settings/formats#format_display_secrets_in_show_and_select) (포맷 설정)

  또한 사용자에게는 [`displaySecretsInShowAndSelect`](/ko/reference/statements/grant#displaysecretsinshowandselect) 권한이 있어야 합니다.
</Note>

<div id="show-create-table--dictionary--view--database">
  ## SHOW CREATE TABLE | DICTIONARY | VIEW | DATABASE
</div>

이 SQL 문들은 String 유형의 단일 컬럼을 반환하며,
여기에는 지정된 객체를 생성하는 데 사용된 `CREATE` 쿼리가 포함됩니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW [CREATE] TABLE | TEMPORARY TABLE | DICTIONARY | VIEW | DATABASE [db.]table|view [INTO OUTFILE filename] [FORMAT format]
```

<Note>
  이 구문으로 system tables의 `CREATE` 쿼리를 가져오면,
  테이블 구조만 선언하는 *가짜* 쿼리만 반환되며,
  이 쿼리로는 테이블을 생성할 수 없습니다.
</Note>

<div id="show-databases">
  ## SHOW DATABASES
</div>

이 문은 모든 데이터베이스 목록을 표시합니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW DATABASES [[NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
```

다음 쿼리와 동일합니다.

```sql theme={null}
SELECT name FROM system.databases [WHERE name [NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
```

<div id="examples">
  ### 예시
</div>

이 예시에서는 이름에 'de'라는 문자열이 포함된 데이터베이스 이름을 확인하기 위해 `SHOW`를 사용합니다:

```sql title="Query" theme={null}
SHOW DATABASES LIKE '%de%'
```

```text title="Response" theme={null}
┌─name────┐
│ default │
└─────────┘
```

대소문자를 구분하지 않는 방식으로도 사용할 수 있습니다:

```sql title="Query" theme={null}
SHOW DATABASES ILIKE '%DE%'
```

```text title="Response" theme={null}
┌─name────┐
│ default │
└─────────┘
```

또는 이름에 'de'가 포함되지 않은 데이터베이스 이름을 조회할 수도 있습니다:

```sql title="Query" theme={null}
SHOW DATABASES NOT LIKE '%de%'
```

```text title="Response" theme={null}
┌─name───────────────────────────┐
│ _temporary_and_external_tables │
│ system                         │
│ test                           │
│ tutorial                       │
└────────────────────────────────┘
```

마지막으로, 처음 두 개 데이터베이스의 이름만 가져올 수 있습니다:

```sql title="Query" theme={null}
SHOW DATABASES LIMIT 2
```

```text title="Response" theme={null}
┌─name───────────────────────────┐
│ _temporary_and_external_tables │
│ default                        │
└────────────────────────────────┘
```

<div id="see-also">
  ### 관련 항목
</div>

* [`CREATE DATABASE`](/ko/reference/statements/create/database)

<div id="show-tables">
  ## SHOW TABLES
</div>

`SHOW TABLES` 문은 테이블 목록을 출력합니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW [FULL] [TEMPORARY] TABLES [{FROM | IN} <db>] [[NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
```

`FROM` 절을 지정하지 않으면 현재 데이터베이스의 테이블 목록이 반환됩니다.

이 문은 다음 쿼리와 동일합니다:

```sql theme={null}
SELECT name FROM system.tables [WHERE name [NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
```

<div id="examples">
  ### 예시
</div>

이 예시에서는 테이블 이름에 'user'가 포함된 모든 테이블을 찾기 위해 `SHOW TABLES` 문을 사용합니다:

```sql title="Query" theme={null}
SHOW TABLES FROM system LIKE '%user%'
```

```text title="Response" theme={null}
┌─name─────────────┐
│ user_directories │
│ users            │
└──────────────────┘
```

대소문자를 구분하지 않고도 수행할 수 있습니다:

```sql title="Query" theme={null}
SHOW TABLES FROM system ILIKE '%USER%'
```

```text title="Response" theme={null}
┌─name─────────────┐
│ user_directories │
│ users            │
└──────────────────┘
```

또는 이름에 's'가 들어 있지 않은 테이블을 찾으려면:

```sql title="Query" theme={null}
SHOW TABLES FROM system NOT LIKE '%s%'
```

```text title="Response" theme={null}
┌─name─────────┐
│ metric_log   │
│ metric_log_0 │
│ metric_log_1 │
└──────────────┘
```

마지막으로, 처음 두 개 테이블(table)의 이름만 조회할 수 있습니다:

```sql title="Query" theme={null}
SHOW TABLES FROM system LIMIT 2
```

```text title="Response" theme={null}
┌─name───────────────────────────┐
│ aggregate_function_combinators │
│ asynchronous_metric_log        │
└────────────────────────────────┘
```

<div id="see-also">
  ### 관련 항목
</div>

* [`테이블 생성`](/ko/reference/statements/create/table)
* [`SHOW CREATE TABLE`](#show-create-table--dictionary--view--database)

<div id="show_columns">
  ## SHOW COLUMNS
</div>

`SHOW COLUMNS` 문은 컬럼 목록을 보여줍니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
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`와 `FULL`도 있습니다. `EXTENDED` 키워드는 현재 아무런 효과가 없으며,
MySQL 호환성을 위해 존재합니다. `FULL` 키워드를 사용하면 출력에 collation, comment, privilege 컬럼이 포함됩니다.

`SHOW COLUMNS` 문은 다음 구조의 결과 테이블을 생성합니다:

| Column      | Description                                                                                 | Type               |
| ----------- | ------------------------------------------------------------------------------------------- | ------------------ |
| `field`     | 컬럼 이름                                                                                       | `String`           |
| `type`      | 컬럼의 데이터 타입입니다. 쿼리가 MySQL wire 프로토콜을 통해 수행된 경우 MySQL에서 대응되는 type name이 표시됩니다.                | `String`           |
| `null`      | 컬럼 데이터 타입이 Nullable이면 `YES`, 그렇지 않으면 `NO`                                                   | `String`           |
| `key`       | 컬럼이 primary key의 일부이면 `PRI`, sorting key의 일부이면 `SOR`, 그 외에는 빈 값                             | `String`           |
| `default`   | 컬럼 타입이 `ALIAS`, `DEFAULT`, 또는 `MATERIALIZED`인 경우 컬럼의 기본 표현식, 그렇지 않으면 `NULL`                 | `Nullable(String)` |
| `extra`     | 추가 정보로, 현재는 사용되지 않습니다                                                                       | `String`           |
| `collation` | (`FULL` 키워드를 지정한 경우에만) 컬럼의 Collation입니다. ClickHouse는 컬럼별 collations를 지원하지 않으므로 항상 `NULL`입니다 | `Nullable(String)` |
| `comment`   | (`FULL` 키워드를 지정한 경우에만) 컬럼에 대한 comment                                                       | `String`           |
| `privilege` | (`FULL` 키워드를 지정한 경우에만) 이 컬럼에 대해 보유한 privilege로, 현재는 사용할 수 없습니다                              | `String`           |

<div id="examples">
  ### 예시
</div>

이 예시에서는 `SHOW COLUMNS` 문을 사용하여 'orders' 테이블에서 'delivery\_'로
시작하는 모든 컬럼에 대한 정보를 가져옵니다:

```sql title="Query" theme={null}
SHOW COLUMNS FROM 'orders' LIKE 'delivery_%'
```

```text title="Response" theme={null}
┌─field───────────┬─type─────┬─null─┬─key─────┬─default─┬─extra─┐
│ delivery_date   │ DateTime │    0 │ PRI SOR │ ᴺᵁᴸᴸ    │       │
│ delivery_status │ Bool     │    0 │         │ ᴺᵁᴸᴸ    │       │
└─────────────────┴──────────┴──────┴─────────┴─────────┴───────┘
```

<div id="see-also">
  ### 관련 항목
</div>

* [`system.columns`](/ko/reference/system-tables/columns)

<div id="show-dictionaries">
  ## SHOW DICTIONARIES
</div>

`SHOW DICTIONARIES` 문은 [딕셔너리](/ko/reference/statements/create/dictionary) 목록을 표시합니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW DICTIONARIES [FROM <db>] [LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
```

`FROM` 절을 지정하지 않으면 현재 데이터베이스에 있는 딕셔너리 목록을 반환합니다.

다음과 같이 하면 `SHOW DICTIONARIES` 쿼리와 동일한 결과를 얻을 수 있습니다:

```sql theme={null}
SELECT name FROM system.dictionaries WHERE database = <db> [AND name LIKE <pattern>] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
```

<div id="examples">
  ### 예시
</div>

다음 쿼리는 `system` 데이터베이스의 테이블 목록에서 이름에 `reg`가 포함된 처음 두 행을 선택합니다.

```sql title="Query" theme={null}
SHOW DICTIONARIES FROM db LIKE '%reg%' LIMIT 2
```

```text title="Response" theme={null}
┌─name─────────┐
│ regions      │
│ region_names │
└──────────────┘
```

<div id="show-index">
  ## SHOW INDEX
</div>

테이블의 프라이머리 인덱스와 데이터 스키핑 인덱스 목록을 표시합니다.

이 문은 주로 MySQL과의 호환성을 위해 존재합니다. 시스템 테이블(system table)인 [`system.tables`](/ko/reference/system-tables/tables)는 기본 키에 대한 정보를, [`system.data_skipping_indices`](/ko/reference/system-tables/data_skipping_indices)는 데이터 스키핑 인덱스에 대한 정보를 제공하며, ClickHouse에 더 네이티브한 방식으로 동일한 정보를 확인할 수 있습니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
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`   | 기본 키 인덱스인 경우 컬럼 이름입니다. 데이터 스키핑 인덱스인 경우 `''`(빈 문자열)이며, field "expression"를 참조하십시오. | `String`           |
| `collation`     | 인덱스에서 컬럼의 정렬 방식입니다. 오름차순이면 `A`, 내림차순이면 `D`, 정렬되지 않은 경우 `NULL`입니다.                 | `Nullable(String)` |
| `cardinality`   | 인덱스 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` field를 가질 수 없으므로(MySQL과 달리) `''`(빈 문자열)입니다.            | `String`           |
| `visible`       | 인덱스가 옵티마이저에 표시되는지 여부이며, 항상 `YES`입니다.                                              | `String`           |
| `expression`    | 데이터 스키핑 인덱스인 경우 인덱스 표현식입니다. 기본 키 인덱스인 경우 `''`(빈 문자열)입니다.                          | `String`           |

<div id="examples">
  ### 예시
</div>

이 예시에서는 `SHOW INDEX` 문을 사용하여 테이블 'tbl'에 있는 모든 인덱스의 정보를 확인합니다.

```sql title="Query" theme={null}
SHOW INDEX FROM 'tbl'
```

```text title="Response" theme={null}
┌─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          │
└───────┴────────────┴──────────┴──────────────┴─────────────┴───────────┴─────────────┴──────────┴────────┴──────┴──────────────┴─────────┴───────────────┴─────────┴────────────┘
```

<div id="see-also">
  ### 관련 항목
</div>

* [`system.tables`](/ko/reference/system-tables/tables)
* [`system.data_skipping_indices`](/ko/reference/system-tables/data_skipping_indices)

<div id="show-processlist">
  ## SHOW PROCESSLIST
</div>

현재 처리 중인 쿼리 목록을 포함하는 [`system.processes`](/ko/reference/system-tables/processes) 테이블의 내용을 출력합니다. 단, `SHOW PROCESSLIST` 쿼리는 제외됩니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW PROCESSLIST [INTO OUTFILE filename] [FORMAT format]
```

`SELECT * FROM system.processes` 쿼리는 현재 실행 중인 모든 쿼리의 정보를 반환합니다.

<Tip>
  콘솔에서 다음을 실행하세요:

  ```bash theme={null}
  $ watch -n1 "clickhouse-client --query='SHOW PROCESSLIST'"
  ```
</Tip>

<div id="show-grants">
  ## SHOW GRANTS
</div>

`SHOW GRANTS` 문은 사용자에게 부여된 권한을 표시합니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW GRANTS [FOR user1 [, user2 ...]] [WITH IMPLICIT] [FINAL]
```

사용자를 지정하지 않으면 쿼리는 현재 사용자의 권한을 반환합니다.

`WITH IMPLICIT` 수정자를 사용하면 암시적으로 권한이 부여된 항목(예: `GRANT SELECT ON system.one`)을 표시할 수 있습니다.

`FINAL` 수정자는 사용자와 해당 사용자에게 부여된 역할의 모든 권한 부여를 머지하여 표시합니다(상속 포함).

<div id="show-create-user">
  ## SHOW CREATE USER
</div>

`SHOW CREATE USER` 문은 [사용자 생성](/ko/reference/statements/create/user) 시 사용된 매개변수를 표시합니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW CREATE USER [name1 [, name2 ...] | CURRENT_USER]
```

<div id="show-create-role">
  ## SHOW CREATE ROLE
</div>

`SHOW CREATE ROLE` SQL 문은 [역할 생성](/ko/reference/statements/create/role) 시 사용된 매개변수를 표시합니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW CREATE ROLE name1 [, name2 ...]
```

<div id="show-create-row-policy">
  ## SHOW CREATE ROW POLICY
</div>

`SHOW CREATE ROW POLICY` 문은 [ROW POLICY 생성](/ko/reference/statements/create/row-policy)에 사용된 매개변수를 보여줍니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW CREATE [ROW] POLICY name ON [database1.]table1 [, [database2.]table2 ...]
```

<div id="show-create-quota">
  ## SHOW CREATE QUOTA
</div>

`SHOW CREATE QUOTA` SQL 문은 [QUOTA creation](/ko/reference/statements/create/quota) 시 사용된 매개변수를 표시합니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW CREATE QUOTA [name1 [, name2 ...] | CURRENT]
```

<div id="show-create-settings-profile">
  ## SHOW CREATE SETTINGS PROFILE
</div>

`SHOW CREATE SETTINGS PROFILE` 문은 [설정 프로필 생성](/ko/reference/statements/create/settings-profile)에 사용된 매개변수를 표시합니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW CREATE [SETTINGS] PROFILE name1 [, name2 ...]
```

<div id="show-users">
  ## SHOW USERS
</div>

`SHOW USERS` 문은 [사용자 계정](/ko/concepts/features/security/access-rights#user-account-management) 이름 목록을 반환합니다.
사용자 계정의 매개변수를 확인하려면 시스템 테이블(system table) [`system.users`](/ko/reference/system-tables/users)를 참조하십시오.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW USERS
```

<div id="show-roles">
  ## SHOW ROLES
</div>

`SHOW ROLES` 문은 [역할](/ko/concepts/features/security/access-rights#role-management) 목록을 반환합니다.
다른 매개변수를 확인하려면
시스템 테이블 [`system.roles`](/ko/reference/system-tables/roles) 및 [`system.role_grants`](/ko/reference/system-tables/role_grants)를 참조하십시오.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW [CURRENT|ENABLED] ROLES
```

<div id="show-profiles">
  ## SHOW PROFILES
</div>

`SHOW PROFILES` 문은 [설정 프로필](/ko/concepts/features/security/access-rights#settings-profiles-management) 목록을 반환합니다.
사용자 계정의 매개변수를 확인하려면 시스템 테이블(system table) [`settings_profiles`](/ko/reference/system-tables/settings_profiles)를 참조하십시오.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW [SETTINGS] PROFILES
```

<div id="show-policies">
  ## SHOW POLICIES
</div>

`SHOW POLICIES` 문은 지정된 테이블의 [ROW POLICY](/ko/concepts/features/security/access-rights#row-policy-management) 목록을 반환합니다.
사용자 계정 매개변수를 보려면 시스템 테이블(system table) [`system.row_policies`](/ko/reference/system-tables/row_policies)를 참조하십시오.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW [ROW] POLICIES [ON [db.]table]
```

<div id="show-quotas">
  ## SHOW QUOTAS
</div>

`SHOW QUOTAS` 문은 [QUOTA](/ko/concepts/features/security/access-rights#quotas-management) 목록을 반환합니다.
QUOTA 매개변수를 확인하려면 시스템 테이블(system table) [`system.quotas`](/ko/reference/system-tables/quotas)를 참조하십시오.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW QUOTAS
```

<div id="show-quota">
  ## SHOW QUOTA
</div>

`SHOW QUOTA` 문은 모든 사용자 또는 현재 사용자에 대한 [QUOTA](/ko/concepts/features/configuration/server-config/quotas) 사용량을 반환합니다.
다른 매개변수는 시스템 테이블 [`system.quotas_usage`](/ko/reference/system-tables/quotas_usage) 및 [`system.quota_usage`](/ko/reference/system-tables/quota_usage)에서 확인하십시오.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW [CURRENT] QUOTA
```

<div id="show-access">
  ## SHOW ACCESS
</div>

`SHOW ACCESS` 문은 모든 [사용자](/ko/concepts/features/security/access-rights#user-account-management), [역할](/ko/concepts/features/security/access-rights#role-management), [프로필](/ko/concepts/features/security/access-rights#settings-profiles-management) 등과 해당 항목에 대한 모든 [권한 부여](/ko/reference/statements/grant#privileges)를 표시합니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW ACCESS
```

<div id="show-clusters">
  ## SHOW CLUSTER(S)
</div>

`SHOW CLUSTER(S)` 문은 클러스터 목록을 반환합니다.
사용 가능한 모든 클러스터는 [`system.clusters`](/ko/reference/system-tables/clusters) 테이블에 나열되어 있습니다.

<Note>
  `SHOW CLUSTER name` 쿼리는 지정한 클러스터 이름에 대해 `system.clusters` 테이블의 `cluster`, `shard_num`, `replica_num`, `host_name`, `host_address`, `port`를 표시합니다.
</Note>

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW CLUSTER '<name>'
SHOW CLUSTERS [[NOT] LIKE|ILIKE '<pattern>'] [LIMIT <N>]
```

<div id="examples">
  ### 예시
</div>

```sql title="Query" theme={null}
SHOW CLUSTERS;
```

```text title="Response" theme={null}
┌─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 title="Query" theme={null}
SHOW CLUSTERS LIKE 'test%' LIMIT 1;
```

```text title="Response" theme={null}
┌─cluster─────────────────┐
│ test_cluster_two_shards │
└─────────────────────────┘
```

```sql title="Query" theme={null}
SHOW CLUSTER 'test_shard_localhost' FORMAT Vertical;
```

```text title="Response" theme={null}
행 1:
──────
cluster:                 test_shard_localhost
shard_num:               1
replica_num:             1
host_name:               localhost
host_address:            127.0.0.1
port:                    9000
```

<div id="show-settings">
  ## SHOW SETTINGS
</div>

`SHOW SETTINGS` 문은 시스템 설정과 그 값을 목록으로 반환합니다.
이 문은 [`system.settings`](/ko/reference/system-tables/settings) 테이블(table)에서 데이터를 조회합니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW [CHANGED] SETTINGS LIKE|ILIKE <name>
```

<div id="clauses">
  ### 절
</div>

`LIKE|ILIKE`를 사용하면 설정 이름에 대한 일치 패턴을 지정할 수 있습니다. 패턴에는 `%` 또는 `_`와 같은 글롭 패턴이 포함될 수 있습니다. `LIKE` 절은 대소문자를 구분하고 `ILIKE`는 대소문자를 구분하지 않습니다.

`CHANGED` 절을 사용하면 기본값에서 변경된 설정만 쿼리 결과로 반환됩니다.

<div id="examples">
  ### 예시
</div>

`LIKE` 절을 사용한 쿼리:

```sql title="Query" theme={null}
SHOW SETTINGS LIKE 'send_timeout';
```

```text title="Response" theme={null}
┌─name─────────┬─type────┬─value─┐
│ send_timeout │ Seconds │ 300   │
└──────────────┴─────────┴───────┘
```

`ILIKE` 절을 사용하는 쿼리:

```sql title="Query" theme={null}
SHOW SETTINGS ILIKE '%CONNECT_timeout%'
```

```text title="Response" theme={null}
┌─name────────────────────────────────────┬─type─────────┬─value─┐
│ connect_timeout                         │ Seconds      │ 10    │
│ connect_timeout_with_failover_ms        │ Milliseconds │ 50    │
│ connect_timeout_with_failover_secure_ms │ Milliseconds │ 100   │
└─────────────────────────────────────────┴──────────────┴───────┘
```

`CHANGED` 절을 사용한 쿼리:

```sql title="Query" theme={null}
SHOW CHANGED SETTINGS ILIKE '%MEMORY%'
```

```text title="Response" theme={null}
┌─name─────────────┬─type───┬─value───────┐
│ max_memory_usage │ UInt64 │ 10000000000 │
└──────────────────┴────────┴─────────────┘
```

<div id="show-setting">
  ## SHOW SETTING
</div>

`SHOW SETTING` 문은 지정한 설정 이름의 값을 출력합니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW SETTING <name>
```

<div id="see-also">
  ### 관련 항목
</div>

* [`system.settings`](/ko/reference/system-tables/settings) 테이블

<div id="show-filesystem-caches">
  ## SHOW FILESYSTEM CACHES
</div>

<div id="examples">
  ### 예시
</div>

```sql title="Query" theme={null}
SHOW FILESYSTEM CACHES
```

```text title="Response" theme={null}
┌─Caches────┐
│ s3_cache  │
└───────────┘
```

<div id="see-also">
  ### 관련 항목
</div>

* [`system.settings`](/ko/reference/system-tables/settings) 테이블

<div id="show-engines">
  ## SHOW ENGINES
</div>

`SHOW ENGINES` 문은 [`system.table_engines`](/ko/reference/system-tables/table_engines) 테이블의 내용을 출력합니다. 이 테이블에는 서버에서 지원하는 테이블 엔진의 설명과 각 엔진의 기능 지원 정보가 포함되어 있습니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW ENGINES [INTO OUTFILE filename] [FORMAT format]
```

<div id="see-also">
  ### 관련 항목
</div>

* [system.table\_engines](/ko/reference/system-tables/table_engines) 테이블

<div id="show-functions">
  ## SHOW FUNCTIONS
</div>

`SHOW FUNCTIONS` 문은 [`system.functions`](/ko/reference/system-tables/functions) 테이블의 내용을 출력합니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW FUNCTIONS [LIKE | ILIKE '<pattern>']
```

`LIKE` 또는 `ILIKE` 절 중 하나를 지정하면, 쿼리는 이름이 제공된 `<pattern>`과 일치하는 시스템 함수 목록을 반환합니다.

<div id="see-also">
  ### 관련 항목
</div>

* [`system.functions`](/ko/reference/system-tables/functions) 테이블

<div id="show-merges">
  ## SHOW MERGES
</div>

`SHOW MERGES` 문은 머지 목록을 반환합니다.
모든 머지는 [`system.merges`](/ko/reference/system-tables/merges) 테이블에 나열됩니다:

| Column              | Description                   |
| ------------------- | ----------------------------- |
| `table`             | 테이블 이름입니다.                    |
| `database`          | 테이블이 속한 데이터베이스의 이름입니다.        |
| `estimate_complete` | 완료까지의 예상 시간(초)입니다.            |
| `elapsed`           | 머지가 시작된 후 경과한 시간(초)입니다.       |
| `progress`          | 완료된 작업의 비율(0\~100%)입니다.       |
| `is_mutation`       | 이 프로세스가 파트 mutation인 경우 1입니다. |
| `size_compressed`   | 병합된 파트의 압축된 데이터 총크기입니다.       |
| `memory_usage`      | 머지 프로세스의 메모리 사용량입니다.          |

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW MERGES [[NOT] LIKE|ILIKE '<table_name_pattern>'] [LIMIT <N>]
```

<div id="examples">
  ### 예시
</div>

```sql title="Query" theme={null}
SHOW MERGES;
```

```text title="Response" theme={null}
┌─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 title="Query" theme={null}
SHOW MERGES LIKE 'your_t%' LIMIT 1;
```

```text title="Response" theme={null}
┌─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 │
└────────────┴──────────┴───────────────────┴─────────┴──────────┴─────────────┴─────────────────┴──────────────┘
```

<div id="show-create-masking-policy">
  ## SHOW CREATE MASKING POLICY
</div>

`SHOW CREATE MASKING POLICY` SQL 문은 [마스킹 정책 생성](/ko/reference/statements/create/masking-policy)에 사용된 매개변수를 표시합니다.

<div id="syntax">
  ### 구문
</div>

```sql title="Syntax" theme={null}
SHOW CREATE MASKING POLICY name ON [database.]table
```
