SHOW CREATE (TABLE|DATABASE|USER)는 다음 설정을 활성화하지 않으면 시크릿을 숨깁니다:display_secrets_in_show_and_select(server 설정)format_display_secrets_in_show_and_select(포맷 설정)
displaySecretsInShowAndSelect 권한이 있어야 합니다.SHOW CREATE TABLE | DICTIONARY | VIEW | DATABASE
CREATE 쿼리가 포함됩니다.
구문
Syntax
이 구문으로 system tables의
CREATE 쿼리를 가져오면,
테이블 구조만 선언하는 가짜 쿼리만 반환되며,
이 쿼리로는 테이블을 생성할 수 없습니다.SHOW DATABASES
구문
Syntax
예시
SHOW를 사용합니다:
Query
Response
Query
Response
Query
Response
Query
Response
관련 항목
SHOW TABLES
SHOW TABLES 문은 테이블 목록을 출력합니다.
구문
Syntax
FROM 절을 지정하지 않으면 현재 데이터베이스의 테이블 목록이 반환됩니다.
이 문은 다음 쿼리와 동일합니다:
예시
SHOW TABLES 문을 사용합니다:
Query
Response
Query
Response
Query
Response
Query
Response
관련 항목
SHOW COLUMNS
SHOW COLUMNS 문은 컬럼 목록을 보여줍니다.
구문
Syntax
<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 |
예시
SHOW COLUMNS 문을 사용하여 ‘orders’ 테이블에서 ‘delivery_‘로
시작하는 모든 컬럼에 대한 정보를 가져옵니다:
Query
Response
관련 항목
SHOW DICTIONARIES
SHOW DICTIONARIES 문은 딕셔너리 목록을 표시합니다.
구문
Syntax
FROM 절을 지정하지 않으면 현재 데이터베이스에 있는 딕셔너리 목록을 반환합니다.
다음과 같이 하면 SHOW DICTIONARIES 쿼리와 동일한 결과를 얻을 수 있습니다:
예시
system 데이터베이스의 테이블 목록에서 이름에 reg가 포함된 처음 두 행을 선택합니다.
Query
Response
SHOW INDEX
system.tables는 기본 키에 대한 정보를, system.data_skipping_indices는 데이터 스키핑 인덱스에 대한 정보를 제공하며, ClickHouse에 더 네이티브한 방식으로 동일한 정보를 확인할 수 있습니다.
구문
Syntax
<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 |
예시
SHOW INDEX 문을 사용하여 테이블 ‘tbl’에 있는 모든 인덱스의 정보를 확인합니다.
Query
Response
관련 항목
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 SQL 문은 역할 생성 시 사용된 매개변수를 표시합니다.
구문
Syntax
SHOW CREATE ROW POLICY
SHOW CREATE ROW POLICY 문은 ROW POLICY 생성에 사용된 매개변수를 보여줍니다.
구문
Syntax
SHOW CREATE QUOTA
SHOW CREATE QUOTA SQL 문은 QUOTA creation 시 사용된 매개변수를 표시합니다.
구문
Syntax
SHOW CREATE SETTINGS PROFILE
SHOW CREATE SETTINGS PROFILE 문은 설정 프로필 생성에 사용된 매개변수를 표시합니다.
구문
Syntax
SHOW USERS
SHOW USERS 문은 사용자 계정 이름 목록을 반환합니다.
사용자 계정의 매개변수를 확인하려면 시스템 테이블(system table) system.users를 참조하십시오.
구문
Syntax
SHOW ROLES
SHOW ROLES 문은 역할 목록을 반환합니다.
다른 매개변수를 확인하려면
시스템 테이블 system.roles 및 system.role_grants를 참조하십시오.
구문
Syntax
SHOW PROFILES
SHOW PROFILES 문은 설정 프로필 목록을 반환합니다.
사용자 계정의 매개변수를 확인하려면 시스템 테이블(system table) settings_profiles를 참조하십시오.
구문
Syntax
SHOW POLICIES
SHOW POLICIES 문은 지정된 테이블의 ROW POLICY 목록을 반환합니다.
사용자 계정 매개변수를 보려면 시스템 테이블(system table) system.row_policies를 참조하십시오.
구문
Syntax
SHOW QUOTAS
SHOW QUOTAS 문은 QUOTA 목록을 반환합니다.
QUOTA 매개변수를 확인하려면 시스템 테이블(system table) system.quotas를 참조하십시오.
구문
Syntax
SHOW QUOTA
SHOW QUOTA 문은 모든 사용자 또는 현재 사용자에 대한 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 테이블의 cluster, shard_num, replica_num, host_name, host_address, port를 표시합니다.구문
Syntax
예시
Query
Response
Query
Response
Query
Response
SHOW SETTINGS
SHOW SETTINGS 문은 시스템 설정과 그 값을 목록으로 반환합니다.
이 문은 system.settings 테이블(table)에서 데이터를 조회합니다.
구문
Syntax
절
LIKE|ILIKE를 사용하면 설정 이름에 대한 일치 패턴을 지정할 수 있습니다. 패턴에는 % 또는 _와 같은 글롭 패턴이 포함될 수 있습니다. LIKE 절은 대소문자를 구분하고 ILIKE는 대소문자를 구분하지 않습니다.
CHANGED 절을 사용하면 기본값에서 변경된 설정만 쿼리 결과로 반환됩니다.
예시
LIKE 절을 사용한 쿼리:
Query
Response
ILIKE 절을 사용하는 쿼리:
Query
Response
CHANGED 절을 사용한 쿼리:
Query
Response
SHOW SETTING
SHOW SETTING 문은 지정한 설정 이름의 값을 출력합니다.
구문
Syntax
관련 항목
system.settings테이블
SHOW FILESYSTEM CACHES
예시
Query
Response
관련 항목
system.settings테이블
SHOW ENGINES
SHOW ENGINES 문은 system.table_engines 테이블의 내용을 출력합니다. 이 테이블에는 서버에서 지원하는 테이블 엔진의 설명과 각 엔진의 기능 지원 정보가 포함되어 있습니다.
구문
Syntax
관련 항목
SHOW FUNCTIONS
SHOW FUNCTIONS 문은 system.functions 테이블의 내용을 출력합니다.
구문
Syntax
LIKE 또는 ILIKE 절 중 하나를 지정하면, 쿼리는 이름이 제공된 <pattern>과 일치하는 시스템 함수 목록을 반환합니다.
관련 항목
system.functions테이블
SHOW MERGES
SHOW MERGES 문은 머지 목록을 반환합니다.
모든 머지는 system.merges 테이블에 나열됩니다:
| Column | Description |
|---|---|
table | 테이블 이름입니다. |
database | 테이블이 속한 데이터베이스의 이름입니다. |
estimate_complete | 완료까지의 예상 시간(초)입니다. |
elapsed | 머지가 시작된 후 경과한 시간(초)입니다. |
progress | 완료된 작업의 비율(0~100%)입니다. |
is_mutation | 이 프로세스가 파트 mutation인 경우 1입니다. |
size_compressed | 병합된 파트의 압축된 데이터 총크기입니다. |
memory_usage | 머지 프로세스의 메모리 사용량입니다. |
구문
Syntax
예시
Query
Response
Query
Response
SHOW CREATE MASKING POLICY
SHOW CREATE MASKING POLICY SQL 문은 마스킹 정책 생성에 사용된 매개변수를 표시합니다.
구문
Syntax