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

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

# system.disk_types

<div id="description">
  ## 설명
</div>

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

이 테이블에는 사용 가능한 디스크 *유형*이 나열되어 있으며, [`system.disks`](/ko/reference/system-tables/disks)에는 서버에 구성된 디스크 인스턴스가 나열됩니다.

<div id="columns">
  ## 컬럼
</div>

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

<div id="configuration-examples">
  ## 구성 예시
</div>

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

<div id="static-configuration">
  ### 정적 구성
</div>

디스크는 서버 구성의 `storage_configuration` 아래에 정의합니다. 다음 예시에서는 `s3` 디스크와 이를 사용하는 스토리지 정책을 정의합니다.

```xml title="config.xml" theme={null}
<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로 표현하면 다음과 같습니다:

```yaml title="config.yaml" theme={null}
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
```

이후 테이블에서 스토리지 정책을 통해 해당 디스크를 사용할 수 있습니다:

```sql title="Query" theme={null}
CREATE TABLE test (a Int32, b String)
ENGINE = MergeTree() ORDER BY a
SETTINGS storage_policy = 's3_policy';
```

<div id="dynamic-configuration">
  ### 동적 구성
</div>

`disk` 함수를 사용하면 설정 파일에 디스크를 미리 정의하지 않아도 `CREATE`/`ATTACH` 쿼리의 설정에서 직접 디스크를 정의할 수 있습니다:

```sql title="Query" theme={null}
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
);
```

각 디스크 유형에 대한 전체 매개변수 목록은 [외부 스토리지 구성](/ko/concepts/features/configuration/server-config/storing-data)을 참조하십시오.

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

```sql title="Query" theme={null}
SELECT name, description
FROM system.disk_types
WHERE name IN ('local', 'object_storage')
ORDER BY name
```

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

* [`system.disks`](/ko/reference/system-tables/disks) — server에 구성된 디스크 인스턴스입니다.
* [`system.storage_policies`](/ko/reference/system-tables/storage_policies) — 스토리지 정책과 볼륨입니다.