disk_types 시스템 테이블

disk_types 시스템 테이블은 서버가 지원하는 디스크 유형 목록을 각 유형에 대한 내장 문서와 함께 담고 있어요. 디스크 유형은 디스크 구성의 type에 지정되며 디스크가 데이터를 어디에 어떻게 저장하는지 결정해요(로컬 파일시스템, 객체 스토리지, 다른 디스크 위의 캐시 등).

출처: 문서

본문

Description (설명)

서버가 지원하는 디스크 유형 목록을 각 유형에 대한 내장 문서와 함께 담고 있어요. 디스크 유형은 디스크 구성의 type에 지정되며 디스크가 데이터를 어디에 어떻게 저장하는지 결정해요(로컬 파일시스템, 객체 스토리지, 다른 디스크 위의 캐시 등). 이 테이블은 사용 가능한 디스크 유형을 나열하는 반면, system.disks는 서버에 구성된 디스크 인스턴스를 나열한다는 점에 유의해요.

Configuration examples (구성 예시)

디스크는 두 가지 방식으로 구성할 수 있어요: 정적으로 서버 구성 파일(XML 또는 YAML)에서, 또는 동적으로 disk 함수를 사용해 CREATE/ATTACH 쿼리의 설정에서요. 두 경우 모두 같은 디스크 유형과 매개변수가 받아들여져요.

Static configuration (정적 구성)

디스크는 서버 구성의 storage_configuration 아래에 정의돼요. 다음 예시는 s3 디스크와 그것을 사용하는 스토리지 정책을 정의해요.

config.xml

<clickhouse>
    <storage_configuration>
        <disks>
            <s3_disk>
                <type>s3</type>
                <endpoint>https://s3.eu-west-1.amazonaws.com/clickhouse-eu-west-1.clickhouse.com/data/</endpoint>
                <use_environment_credentials>1</use_environment_credentials>
            </s3_disk>
        </disks>
        <policies>
            <s3_policy>
                <volumes>
                    <main>
                        <disk>s3_disk</disk>
                    </main>
                </volumes>
            </s3_policy>
        </policies>
    </storage_configuration>
</clickhouse>

YAML로 같은 구성:

config.yaml

storage_configuration:
  disks:
    s3_disk:
      type: s3
      endpoint: https://s3.eu-west-1.amazonaws.com/clickhouse-eu-west-1.clickhouse.com/data/
      use_environment_credentials: 1
  policies:
    s3_policy:
      volumes:
        main:
          disk: s3_disk

그러면 테이블이 스토리지 정책을 통해 디스크를 사용할 수 있어요.

Query (쿼리)

CREATE TABLE test (a Int32, b String)
ENGINE = MergeTree() ORDER BY a
SETTINGS storage_policy = 's3_policy';

Dynamic configuration (동적 구성)

디스크는 구성 파일에 미리 정의된 디스크 없이 disk 함수를 사용해 CREATE/ATTACH 쿼리의 설정에서 직접 정의할 수도 있어요.

Query (쿼리)

CREATE TABLE test (a Int32, b String)
ENGINE = MergeTree() ORDER BY a
SETTINGS disk = disk(
    type = s3,
    endpoint = 'https://s3.eu-west-1.amazonaws.com/clickhouse-eu-west-1.clickhouse.com/data/',
    use_environment_credentials = 1
);

각 디스크 유형의 매개변수 전체 목록은 Configuring external storage을 참고해요.

Columns (열)

name (String) — 디스크 구성의 type에 지정된 대로의 디스크 유형 이름.
description (String) — 디스크 유형이 무엇을 하는지에 대한 높은 수준의 설명.
syntax (String) — 디스크 구성에서 디스크 유형이 지정되는 방식.
examples (String) — 사용 예시.
introduced_in (String) — 디스크 유형이 처음 도입된 ClickHouse 버전(major.minor 형식).
related (Array(String)) — 관련 디스크 유형의 이름.

Example (예제)

Query (쿼리)

SELECT name, description
FROM system.disk_types
WHERE name IN ('local', 'object_storage')
ORDER BY name

disk_types 시스템 테이블