---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ydb.tech/docs/en/yql/reference/syntax/create_table/family.md
  - https://ydb.tech/docs/ru/yql/reference/syntax/create_table/family.md
sourcePath: ru/core/yql/reference/syntax/create_table/family.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# Группы колонок

Колонки одной таблицы можно объединять в группы, чтобы задать следующие параметры:

* `DATA` — тип устройства хранения для данных колонок этой группы. Допустимые значения: `"ssd"`, `"rot"`.


<!-- source: ru/_includes/only_allow_for_oltp_note.md -->
{% note warning %}

<!-- source: ru/_includes/only_allow_for_oltp_text.md -->
Поддерживается только для [строковых](https://ydb.tech/docs/ru/concepts/datamodel/table.md#row-oriented-tables) таблиц.
<!-- endsource: ru/_includes/only_allow_for_oltp_text.md -->

{% endnote %}
<!-- endsource: ru/_includes/only_allow_for_oltp_note.md -->


* `COMPRESSION` — кодек сжатия данных. Допустимые значения: `"off"`, `"lz4"`, `"zstd"`.


<!-- source: ru/_includes/codec_zstd_allow_for_olap_note.md -->
{% note warning %}

<!-- source: ru/_includes/codec_zstd_allow_for_olap_text.md -->
Кодек `"zstd"` поддерживается только для [колоночных](https://ydb.tech/docs/ru/concepts/datamodel/table.md#column-oriented-tables) таблиц.
<!-- endsource: ru/_includes/codec_zstd_allow_for_olap_text.md -->

{% endnote %}
<!-- endsource: ru/_includes/codec_zstd_allow_for_olap_note.md -->


* `COMPRESSION_LEVEL` — уровень сжатия кодека, если кодек поддерживает уровень сжатия.


<!-- source: ru/_includes/only_allow_for_olap_note.md -->
{% note warning %}

<!-- source: ru/_includes/only_allow_for_olap_text.md -->
Поддерживается только для [колоночных](https://ydb.tech/docs/ru/concepts/datamodel/table.md#column-oriented-tables) таблиц.
<!-- endsource: ru/_includes/only_allow_for_olap_text.md -->

{% endnote %}
<!-- endsource: ru/_includes/only_allow_for_olap_note.md -->


* `CACHE_MODE` — [режим кэширования](https://ydb.tech/docs/ru/concepts/datamodel/table.md#cache-modes). Допустимые значения: `"in_memory"`, `"regular"`.


<!-- source: ru/_includes/only_allow_for_oltp_note.md -->
{% note warning %}

<!-- source: ru/_includes/only_allow_for_oltp_text.md -->
Поддерживается только для [строковых](https://ydb.tech/docs/ru/concepts/datamodel/table.md#row-oriented-tables) таблиц.
<!-- endsource: ru/_includes/only_allow_for_oltp_text.md -->

{% endnote %}
<!-- endsource: ru/_includes/only_allow_for_oltp_note.md -->


По умолчанию все колонки находятся в одной группе с именем `default`. При необходимости параметры этой группы тоже можно переопределить. В противном случае применяются предопределённые значения.

В примерах ниже для создаваемых таблиц добавляется группа колонок `family_large`, которая устанавливается для колонки `series_info`, а также переопределяются параметры для группы `default`, которая по умолчанию применяется ко всем остальным колонкам.


{% list tabs %}

- Создание строковой таблицы

    ```sql
    CREATE TABLE series_with_families (
        series_id Uint64,
        title Utf8,
        series_info Utf8 FAMILY family_large,
        release_date Uint64,
        PRIMARY KEY (series_id),
        FAMILY default (
            DATA = "ssd",
            COMPRESSION = "off",
            CACHE_MODE = "in_memory"
        ),
        FAMILY family_large (
            DATA = "rot",
            COMPRESSION = "lz4",
            CACHE_MODE = "regular"
        )
    );
    ```

- Создание колоночной таблицы

    ```sql
    CREATE TABLE series_with_families (
        series_id Uint64 NOT NULL,
        title Utf8,
        series_info Utf8 FAMILY family_large,
        release_date Uint64,
        PRIMARY KEY (series_id),
        FAMILY default (
            COMPRESSION = "lz4"
        ),
        FAMILY family_large (
            COMPRESSION = "zstd",
            COMPRESSION_LEVEL = 5
        )
    ) 
    WITH (STORE = COLUMN);
    ```

{% endlist %}

{% note info %}

Доступные типы устройств хранения зависят от конфигурации кластера YDB.

{% endnote %}