system.disk_types

서버에서 지원하는 디스크 유형 목록과 각 유형에 대한 내장 문서를 포함하는 시스템 테이블입니다.

설명

서버에서 지원하는 디스크 유형 목록과 각 유형에 대한 내장 문서를 포함합니다. 디스크 유형은 디스크 구성의 type에 지정되며, 디스크가 데이터를 어디에, 어떤 방식으로 저장하는지를 결정합니다(로컬 파일 시스템, 객체 스토리지, 다른 디스크 위의 캐시 등).

이 테이블에는 사용 가능한 디스크 유형이 나열되어 있으며, system.disks에는 서버에 구성된 디스크 인스턴스가 나열됩니다.

컬럼

• name (String) — 디스크 구성의 type에 지정된 디스크 유형 이름입니다.
• description (String) — 디스크 유형이 수행하는 역할에 대한 개괄적인 설명입니다.
• syntax (String) — 디스크 구성에서 디스크 유형을 지정하는 방식입니다.
• examples (String) — 사용 예시입니다.
• introduced_in (String) — 디스크 유형이 처음 도입된 ClickHouse 버전이며, 형식은 major.minor입니다.
• related (Array(String)) — 관련 디스크 유형의 이름입니다.

구성 예시

디스크는 두 가지 방식으로 구성할 수 있습니다. 정적으로는 서버 설정 파일(XML 또는 YAML)에서, 동적으로는 disk 함수를 사용하는 CREATE/ATTACH 쿼리의 설정에서 구성할 수 있습니다. 두 경우 모두 동일한 디스크 유형과 매개변수를 사용할 수 있습니다.

정적 구성

디스크는 서버 구성의 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';

동적 구성

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
);

각 디스크 유형에 대한 전체 매개변수 목록은 외부 스토리지 구성을 참조하십시오.

예시

Query

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

관련 항목

• system.disks — server에 구성된 디스크 인스턴스입니다.
• system.storage_policies — 스토리지 정책과 볼륨입니다.