INFORMATION_SCHEMA(또는 information_schema)는 데이터베이스 객체의 메타데이터에 대해 (어느 정도) 표준화된 DBMS 비종속적 뷰(view)를 제공하는 system 데이터베이스입니다. INFORMATION_SCHEMA의 뷰(view)는 일반적으로 일반 시스템 테이블보다 기능이 다소 제한적이지만, 도구에서 DBMS 전반에 걸쳐 기본 정보를 얻는 데 사용할 수 있습니다. INFORMATION_SCHEMA의 뷰(view) 구조와 내용은 하위 호환성을 유지하는 방식으로 발전하도록 설계되어 있습니다. 즉, 새로운 기능만 추가되고 기존 기능은 변경되거나 제거되지 않습니다. 내부 구현 측면에서 INFORMATION_SCHEMA의 뷰(view)는 일반적으로 system.columns, system.databases, system.tables와 같은 일반 시스템 테이블에 매핑됩니다.
INFORMATION_SCHEMA에는 다음 뷰(view)가 포함되어 있습니다:
- CHARACTER_SETS
- COLUMNS
- COLUMN_PRIVILEGES
- COLLATIONS
- ENGINES
- KEY_COLUMN_USAGE
- REFERENTIAL_CONSTRAINTS
- SCHEMATA
- SCHEMA_PRIVILEGES
- STATISTICS
- TABLES
- TABLE_PRIVILEGES
- USER_PRIVILEGES
- VIEWS
INFORMATION_SCHEMA.columns)도 제공합니다. 이는 이러한 뷰(view)의 모든 컬럼에도 동일하게 적용되며, 소문자(예: table_name)와 대문자(TABLE_NAME) 형태를 모두 제공합니다.
COLUMNS
system.columns 시스템 테이블(system table)에서 읽은 컬럼과, ClickHouse에서 지원되지 않거나 의미가 없지만(항상NULL) 표준상 반드시 포함되어야 하는 컬럼을 포함합니다.
컬럼:
table_catalog(String) — 현재는 사용되지 않습니다.table_schema(String) — 현재는 사용되지 않습니다.table_name(String) — 현재는 사용되지 않습니다.non_unique(Int32) — 현재는 사용되지 않습니다.index_schema(String) — 현재는 사용되지 않습니다.index_name(Nullable(String)) — 현재는 사용되지 않습니다.seq_in_index(UInt32) — 현재는 사용되지 않습니다.column_name(Nullable(String)) — 현재는 사용되지 않습니다.collation(Nullable(String)) — 현재는 사용되지 않습니다.cardinality(Nullable(Int64)) — 현재는 사용되지 않습니다.sub_part(Nullable(Int64)) — 현재는 사용되지 않습니다.packed(Nullable(String)) — 현재는 사용되지 않습니다.nullable(String) — 현재는 사용되지 않습니다.index_type(String) — 현재는 사용되지 않습니다.comment(String) — 현재는 사용되지 않습니다.index_comment(String) — 현재는 사용되지 않습니다.is_visible(String) — 현재는 사용되지 않습니다.expression(Nullable(String)) — 현재는 사용되지 않습니다.
Query
Response
SCHEMATA
system.databases 시스템 테이블에서 읽어온 컬럼과, ClickHouse에서 지원되지 않거나 의미가 없지만(항상NULL) 표준상 반드시 포함되어야 하는 컬럼을 포함합니다.
컬럼:
catalog_name(String) — 데이터베이스 이름입니다.schema_name(String) — 데이터베이스 이름입니다.schema_owner(String) — 스키마 소유자 이름이며, 항상'default'입니다.default_character_set_catalog(Nullable(String)) —NULL이며, 지원되지 않습니다.default_character_set_schema(Nullable(String)) —NULL이며, 지원되지 않습니다.default_character_set_name(Nullable(String)) —NULL이며, 지원되지 않습니다.sql_path(Nullable(String)) —NULL이며, 지원되지 않습니다.
Query
Response
TABLES
system.tables 시스템 테이블에서 읽어 온 컬럼을 포함합니다. 컬럼:table_catalog(String) — 테이블이 위치한 데이터베이스의 이름입니다.table_schema(String) — 테이블이 위치한 데이터베이스의 이름입니다.table_name(String) — 테이블 이름입니다.table_type(String) — 테이블 유형입니다. 가능한 값:BASE TABLEVIEWFOREIGN TABLELOCAL TEMPORARYSYSTEM VIEW
table_rows(Nullable(UInt64)) — 전체 행 수입니다. 확인할 수 없는 경우 NULL입니다.data_length(Nullable(UInt64)) — 디스크에 저장된 데이터 크기입니다. 확인할 수 없는 경우 NULL입니다.index_length(Nullable(UInt64)) — 프라이머리 키, 보조 인덱스, 그리고 모든 마크의 전체 크기입니다.table_collation(Nullable(String)) — 테이블의 기본 콜레이션입니다. 항상utf8mb4_0900_ai_ci입니다.table_comment(Nullable(String)) — 테이블 생성 시 사용된 설명입니다.
Query
Response
VIEWS
테이블 엔진 View을 사용하는 경우 system.tables 시스템 테이블에서 읽어온 컬럼이 포함됩니다. 컬럼:table_catalog(String) — 테이블이 위치한 데이터베이스의 이름입니다.table_schema(String) — 테이블이 위치한 데이터베이스의 이름입니다.table_name(String) — 테이블 이름입니다.view_definition(String) — 뷰의SELECT쿼리입니다.check_option(String) —NONE, 검사를 수행하지 않음을 의미합니다.is_updatable(Enum8) —NO, 뷰는 업데이트되지 않습니다.is_insertable_into(Enum8) — 생성된 뷰가 구체화된 뷰(Materialized View)인지 여부를 나타냅니다. 가능한 값은 다음과 같습니다:NO— 생성된 뷰는 구체화된 뷰가 아닙니다.YES— 생성된 뷰는 구체화된 뷰입니다.
is_trigger_updatable(Enum8) —NO, 트리거는 업데이트되지 않습니다.is_trigger_deletable(Enum8) —NO, 트리거는 삭제되지 않습니다.is_trigger_insertable_into(Enum8) —NO, 트리거에 데이터가 삽입되지 않습니다.
Query
Response
KEY_COLUMN_USAGE
제약 조건이 적용된 system.tables 시스템 테이블의 컬럼을 포함합니다. 컬럼:constraint_catalog(String) — 현재 사용되지 않습니다. 항상def입니다.constraint_schema(String) — 제약 조건이 속한 스키마(데이터베이스)의 이름입니다.constraint_name(Nullable(String)) — 제약 조건의 이름입니다.table_catalog(String) — 현재 사용되지 않습니다. 항상def입니다.table_schema(String) — 테이블이 속한 스키마(데이터베이스)의 이름입니다.table_name(String) — 제약 조건이 적용된 테이블의 이름입니다.column_name(Nullable(String)) — 제약 조건이 적용된 컬럼의 이름입니다.ordinal_position(UInt32) — 현재 사용되지 않습니다. 항상1입니다.position_in_unique_constraint(Nullable(UInt32)) — 현재 사용되지 않습니다. 항상NULL입니다.referenced_table_schema(Nullable(String)) — 현재 사용되지 않습니다. 항상NULL입니다.referenced_table_name(Nullable(String)) — 현재 사용되지 않습니다. 항상NULL입니다.referenced_column_name(Nullable(String)) — 현재 사용되지 않습니다. 항상NULL입니다.
Query
Response
REFERENTIAL_CONSTRAINTS
외래 키에 대한 정보를 포함합니다. 현재는 빈 결과(행 없음)만 반환하며, 이는 Tableau Online과 같은 타사 도구와의 호환성을 제공하는 데 필요한 최소한의 수준입니다. 컬럼:constraint_catalog(String) — 현재 사용되지 않습니다.constraint_schema(String) — 현재 사용되지 않습니다.constraint_name(Nullable(String)) — 현재 사용되지 않습니다.unique_constraint_catalog(String) — 현재 사용되지 않습니다.unique_constraint_schema(String) — 현재 사용되지 않습니다.unique_constraint_name(Nullable(String)) — 현재 사용되지 않습니다.match_option(String) — 현재 사용되지 않습니다.update_rule(String) — 현재 사용되지 않습니다.delete_rule(String) — 현재 사용되지 않습니다.table_name(String) — 현재 사용되지 않습니다.referenced_table_name(String) — 현재 사용되지 않습니다.
STATISTICS
테이블 인덱스에 대한 정보를 제공합니다. 현재는 빈 결과(행 없음)만 반환하며, Tableau Online과 같은 타사 도구와의 호환성을 유지하는 데 필요한 최소한의 수준만 제공합니다.COLLATIONS
사용 가능한 콜레이션 정보를 제공합니다. system.collations의 콜레이션과 MySQL 호환성을 위한 2개의 행을 포함합니다.utf8mb4_0900_ai_ci는 MySQL 프로토콜이 핸드셰이크, SCHEMATA.DEFAULT_COLLATION_NAME, TABLES.TABLE_COLLATION에서 알리는 콜레이션이며, binary는 MySQL 프로토콜이 결과 집합 메타데이터의 숫자형 및 기타 비문자열 컬럼에 지정하는 의사 콜레이션입니다. 따라서 알린 콜레이션을 따라 이 뷰를 조회하는 MySQL 지원 클라이언트도 해당 항목을 찾을 수 있습니다.
컬럼:
collation_name(String) — 콜레이션의 이름입니다.character_set_name(Nullable(String)) — 연결된 문자 집합입니다(utf8mb4_0900_ai_ci의 경우utf8mb4,binary의 경우binary, 그 외에는NULL). MySQL 호환성을 위해 제공됩니다.id(Nullable(UInt64)) — MySQL 콜레이션 ID입니다(utf8mb4_0900_ai_ci의 경우255,binary의 경우63, 그 외에는NULL). MySQL 호환성을 위해 제공됩니다.is_default(Nullable(String)) — 콜레이션이 해당 문자 집합의 기본값인지 여부입니다(MySQL 호환성 행 2개 모두Yes, 그 외에는NULL). MySQL 호환성을 위해 제공됩니다.is_compiled(Nullable(String)) — 콜레이션이 서버에 컴파일되어 있는지 여부입니다(MySQL 호환성 행 2개 모두Yes, 그 외에는NULL). MySQL 호환성을 위해 제공됩니다.sortlen(Nullable(UInt64)) — 최소 정렬 길이입니다(utf8mb4_0900_ai_ci의 경우0,binary의 경우1, 그 외에는NULL). MySQL 호환성을 위해 제공됩니다.pad_attribute(Nullable(String)) — 패딩 속성으로,NO PAD또는PAD SPACE입니다(MySQL 호환성 행 2개 모두NO PAD, 그 외에는NULL). MySQL 호환성을 위해 제공됩니다.
CHARACTER_SETS
MySQL 도구와의 호환성을 위해 문자 집합(character set)의 정적 목록(utf8, utf8mb4, ascii, binary)을 제공합니다. ClickHouse 자체는 UTF-8로 동작합니다.
컬럼:
character_set_name(String) — 문자 집합 이름입니다.
ENGINES
system.table_engines 시스템 테이블에서 읽어온, 사용 가능한 테이블 엔진에 대한 정보를 제공합니다. MySQL 호환성을 위해 제공됩니다. 컬럼:engine(String) — 테이블 엔진의 이름입니다.support(String) — default_table_engine으로 설정된 엔진이면DEFAULT, 그 외에는YES입니다.
USER_PRIVILEGES
system.grants 시스템 테이블에서 읽어 온 전역 권한 정보(데이터베이스가 지정되지 않은 행)를 제공합니다.*_PRIVILEGES 뷰(view)는 와일드카드를 사용하지 않는 긍정 권한 부여만 표시합니다. 부분 철회, 와일드카드 권한 부여(예: GRANT SELECT ON db_prefix*.*), 매개변수화된 권한 유형에서 이름이 지정된 특정 객체에 대한 권한 부여(예: GRANT TABLE ENGINE ON TinyLog)는 MySQL 호환 포맷으로 표현할 수 없어 생략됩니다. 따라서 부분 철회로 제한된 권한 수혜자도 제한이 없는 권한 부여로 표시됩니다. 매개변수화된 유형의 ON * 권한 부여는 일반 전역 권한으로 표시됩니다. 권한 정보의 기준이 되는 소스는 system.grants입니다. MySQL과 달리 이 뷰(view)는 모든 사용자와 역할의 권한 부여를 표시하며, 이를 조회하려면 system.grants에 대한 액세스 권한이 필요합니다. 권한이 없으면 쿼리가 ACCESS_DENIED 예외를 발생시키며 실패합니다. ClickHouse는 권한을 부여한 주체를 기록하지 않으므로 GRANTOR 컬럼은 제공되지 않습니다.
컬럼:
grantee(String) — 권한을 부여받은 사용자 또는 역할로, MySQL 포맷인'name'@'%'형태로 표시됩니다. 역할은 MySQL에 대응하는 개념이 없으므로 사용자와 동일한 방식으로 렌더링됩니다.table_catalog(String) — 항상def입니다.privilege_type(String) — 권한 이름입니다(예:SELECT또는ALTER UPDATE). 전체 목록은 system.privileges를 참조하십시오.is_grantable(String) — 권한이WITH GRANT OPTION으로 부여된 경우YES, 그렇지 않으면NO입니다.grantee_type(String) —USER또는ROLE입니다. 비표준 컬럼으로, ClickHouse에서는 사용자와 역할이 같은 이름을 가질 수 있으므로 이 컬럼으로 두 권한 수혜자를 구분합니다.
SCHEMA_PRIVILEGES
데이터베이스 수준 권한에 대한 정보를 제공하며, 이 정보는 system.grants 시스템 테이블에서 읽어 옵니다(데이터베이스는 지정되어 있지만 테이블은 지정되지 않은 행). 모든*_PRIVILEGES 뷰(view)에 공통으로 적용되는 제한 사항은 USER_PRIVILEGES를 참고하십시오.
컬럼:
grantee(String) — 권한을 부여받은 사용자 또는 역할이며, MySQL 형식'name'@'%'으로 표시됩니다.table_catalog(String) — 항상def입니다.table_schema(String) — 데이터베이스 이름입니다.privilege_type(String) — 권한 이름입니다.is_grantable(String) — 권한이WITH GRANT OPTION으로 부여된 경우YES, 그렇지 않으면NO입니다.grantee_type(String) —USER또는ROLE입니다. 비표준 컬럼으로, ClickHouse에서는 사용자와 역할이 같은 이름을 가질 수 있으므로 이 컬럼을 통해 두 권한 수혜자를 구분합니다.
TABLE_PRIVILEGES
테이블 수준 권한에 대한 정보를 제공하며, 이 정보는 system.grants 시스템 테이블에서 테이블은 지정되어 있고 컬럼은 지정되지 않은 행을 읽어 가져옵니다. 모든*_PRIVILEGES 뷰(view)에 공통으로 적용되는 제한 사항은 USER_PRIVILEGES를 참고하십시오.
컬럼:
grantee(String) — 권한을 부여받은 사용자 또는 역할이며, MySQL 포맷('name'@'%')으로 표시됩니다.table_catalog(String) — 항상def입니다.table_schema(String) — 데이터베이스 이름입니다.table_name(String) — 테이블 이름입니다.privilege_type(String) — 권한 이름입니다.is_grantable(String) — 권한이WITH GRANT OPTION으로 부여된 경우YES, 그렇지 않으면NO입니다.grantee_type(String) —USER또는ROLE입니다. 비표준 컬럼으로, ClickHouse에서는 사용자와 역할이 같은 이름을 가질 수 있으므로 이 컬럼을 통해 해당 권한 수혜자를 구분합니다.
COLUMN_PRIVILEGES
system.grants 시스템 테이블에서 읽어 온 열 수준(column-level) 권한 정보를 제공합니다(컬럼이 지정된 행만 포함하며, 컬럼당 1개의 행으로 표시됩니다). 모든*_PRIVILEGES 뷰(view)에 공통으로 적용되는 제한 사항은 USER_PRIVILEGES를 참조하십시오.
컬럼:
grantee(String) — 권한을 부여받은 사용자 또는 역할로, MySQL 형식('name'@'%')으로 표시됩니다.table_catalog(String) — 항상def입니다.table_schema(String) — 데이터베이스 이름입니다.table_name(String) — 테이블 이름입니다.column_name(String) — 컬럼 이름입니다.privilege_type(String) — 권한 이름입니다.is_grantable(String) — 권한이WITH GRANT OPTION으로 부여된 경우YES, 그렇지 않으면NO입니다.grantee_type(String) —USER또는ROLE입니다. 비표준 컬럼으로, ClickHouse에서는 사용자와 역할이 같은 이름을 가질 수 있으므로 이 컬럼을 통해 권한 수혜자를 구분합니다.