> ## 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`](/ru/reference/system-tables/disks) перечислены экземпляры дисков, настроенные на сервере.

<div id="columns">
  ## Столбцы
</div>

* `name` ([String](/ru/reference/data-types/index)) — Название типа диска, указанное в `type` конфигурации диска.
* `description` ([String](/ru/reference/data-types/index)) — Общее описание назначения типа диска.
* `syntax` ([String](/ru/reference/data-types/index)) — Как указывается тип диска в конфигурации диска.
* `examples` ([String](/ru/reference/data-types/index)) — Примеры использования.
* `introduced_in` ([String](/ru/reference/data-types/index)) — Версия ClickHouse, в которой этот тип диска был впервые представлен, в формате major.minor.
* `related` ([Array(String)](/ru/reference/data-types/index)) — Названия связанных типов дисков.

<div id="configuration-examples">
  ## Примеры конфигурации
</div>

Диск можно настроить двумя способами: **статически**, в файлах конфигурации сервера (XML или YAML), или **динамически**, в настройках запроса `CREATE`/`ATTACH` с помощью функции `disk`. В обоих случаях поддерживаются один и тот же тип диска и один и тот же набор параметров.

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

Диск также можно определить прямо в параметрах запроса `CREATE`/`ATTACH`, без предварительного объявления диска в конфигурационных файлах, с помощью функции `disk`:

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

См. [Настройка внешнего хранилища](/ru/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`](/ru/reference/system-tables/disks) — Диски, настроенные на сервере.
* [`system.storage_policies`](/ru/reference/system-tables/storage_policies) — Политики хранения и тома.