---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/reference/configuration/table_service_config.md
  - https://ydb.tech/docs/ru/reference/configuration/table_service_config.md
  - href: ru/reference/configuration/table_service_config.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/core/reference/configuration/table_service_config.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# table_service_config

Секция `table_service_config` содержит параметры конфигурации для сервиса таблиц, включая настройки спиллинга.

## spilling_service_config

[Спиллинг](https://ydb.tech/docs/ru/concepts/query_execution/spilling.md) — это механизм управления памятью в YDB, который временно сохраняет данные на диск при нехватке оперативной памяти.

### Основные параметры конфигурации

```yaml
table_service_config:
  spilling_service_config:
    local_file_config:
      root: ""
      max_total_size: 21474836480
      io_thread_pool:
        workers_count: 2
        queue_size: 1000
```

### Конфигурация директории

#### local_file_config.root

**Тип:** `string`  
**По умолчанию:** `""` (временная директория)  
**Описание:** Файловая директория для сохранения файлов спиллинга.

Для каждого процесса `ydbd` создается отдельная директория с уникальным именем. Директории спиллинга имеют следующий формат имени:

`node_<node_id>_<spilling_service_id>`

Где:

- `node_id` — идентификатор [узла](https://ydb.tech/docs/ru/concepts/glossary.md#node)
- `spilling_service_id` — уникальный идентификатор экземпляра, который создается при инициализации [Spilling Service](https://ydb.tech/docs/ru/contributor/spilling-service.md) один раз при запуске процесса ydbd

Файлы спиллинга хранятся внутри каждой такой директории.

Пример полного пути к директории спиллинга:

```bash
/tmp/spilling-tmp-<username>/node_1_32860791-037c-42b4-b201-82a0a337ac80
```

Где:

- `/tmp` — значение параметра `root`
- `<username>` — имя пользователя, под которым запускается процесс `ydbd`

**Важные замечания:**

- При запуске процесса все существующие директории спиллинга в указанной директории автоматически удаляются. Директории спиллинга имеют специальный формат имени, который включает идентификатор экземпляра, генерируемый один раз при запуске процесса ydbd. При запуске нового процесса все директории в директории спиллинга, которые соответствуют формату имени, но имеют другой `spilling_service_id` от текущего, удаляются.
- Директория должна иметь достаточные права на запись и чтение для пользователя, под которым запускается ydbd

{% note info %}

Спиллинг выполняется только на [узлах базы данных](https://ydb.tech/docs/ru/concepts/glossary.md#database-node).

{% endnote %}

##### Возможные ошибки

- `Permission denied` — недостаточные права доступа к директории. См. [Permission denied](https://ydb.tech/docs/ru/troubleshooting/spilling/permission-denied.md)

#### local_file_config.max_total_size

**Тип:** `uint64`  
**По умолчанию:** `21474836480` (20 GiB)  
**Описание:** Максимальный суммарный размер всех файлов спиллинга на каждом [узле](https://ydb.tech/docs/ru/concepts/glossary.md#node). При превышении лимита операции спиллинга завершаются ошибкой. Общий лимит спиллинга во всем кластере равен сумме значений `max_total_size` со всех узлов.

##### Рекомендации

- Устанавливайте значение исходя из доступного дискового пространства

##### Возможные ошибки

- `Total size limit exceeded: X/YMb` — превышен максимальный суммарный размер файлов спиллинга. См. [Total size limit exceeded](https://ydb.tech/docs/ru/troubleshooting/spilling/total-size-limit-exceeded.md)

### Конфигурация пула потоков

{% note info %}

Потоки пула I/O для спиллинга создаются дополнительно к потокам, выделяемым для [акторной системы](https://ydb.tech/docs/ru/concepts/glossary.md#actor-system). При планировании количества потоков учитывайте общую нагрузку на систему.

**Важно:** Пул потоков спиллинга отделен от пулов потоков акторной системы.

Для получения информации о настройке пулов потоков акторной системы и их влиянии на производительность системы см. [Конфигурация акторной системы](https://ydb.tech/docs/ru/reference/configuration/index.md#actor-system) и [Изменение конфигурации акторной системы](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v1/change_actorsystem_configs.md). Для Configuration V2 настройки акторной системы описаны в [настройках Configuration V2](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/config-settings.md).

{% endnote %}

#### local_file_config.io_thread_pool.workers_count

**Тип:** `uint32`  
**По умолчанию:** `2`  
**Описание:** Количество рабочих потоков для обработки операций ввода-вывода спиллинга.

##### Рекомендации

- Увеличивайте для высоконагруженных систем

##### Возможные ошибки

- `Can not run operation` — переполнение очереди операций в пуле потоков I/O. См. [Can not run operation](https://ydb.tech/docs/ru/troubleshooting/spilling/can-not-run-operation.md)

#### local_file_config.io_thread_pool.queue_size

**Тип:** `uint32`  
**По умолчанию:** `1000`  
**Описание:** Размер очереди операций спиллинга. Каждая задача отправляет только один блок данных на спиллинг одновременно, поэтому большие значения обычно не требуются.

##### Возможные ошибки

- `Can not run operation` — переполнение очереди операций в пуле потоков I/O. См. [Can not run operation](https://ydb.tech/docs/ru/troubleshooting/spilling/can-not-run-operation.md)

### Управление памятью {#memory-management}

#### Связь с memory_controller_config

Активация спиллинга тесно связана с настройками контроллера памяти. Подробная конфигурация `memory_controller_config` описана в [отдельной статье](https://ydb.tech/docs/ru/reference/configuration/memory_controller_config.md).

Ключевым параметром для спиллинга является **`activities_limit_percent`**, который определяет объем памяти, выделяемый для активностей по обработке запросов. От этого параметра зависит доступная память для пользовательских запросов и, соответственно, частота активации спиллинга.

#### Влияние на спиллинг

- При увеличении `activities_limit_percent` больше памяти доступно для запросов → спиллинг активируется реже
- При уменьшении `activities_limit_percent` меньше памяти доступно для запросов → спиллинг активируется чаще

{% note warning %}

Однако важно учитывать, что сам спиллинг также требует память. Если установить `activities_limit_percent` слишком высоким, память может все равно закончиться несмотря на спиллинг, поскольку механизм спиллинга сам потребляет ресурсы памяти.

{% endnote %}

### Требования к файловой системе

#### Файловые дескрипторы

{% note info %}

Для получения информации о настройке лимитов файловых дескрипторов при первоначальном развертывании см. раздел [Лимиты файловых дескрипторов](../../../devops/deployment-options/manual/initial-deployment.html#file-descriptors).

{% endnote %}

### Примеры конфигурации

#### Высоконагруженная система

Для максимальной производительности в высоконагруженных системах рекомендуется увеличить размер спиллинга и количество рабочих потоков:

```yaml
table_service_config:
  spilling_service_config:
    local_file_config:
      root: ""
      max_total_size: 107374182400   # 100 GiB
      io_thread_pool:
        workers_count: 8
        queue_size: 2000
```

#### Ограниченные ресурсы

Для систем с ограниченными ресурсами рекомендуется использовать консервативные настройки:

```yaml
table_service_config:
  spilling_service_config:
    local_file_config:
      root: ""
      max_total_size: 5368709120     # 5 GiB
      io_thread_pool:
        workers_count: 1
        queue_size: 500
```

### Расширенная конфигурация

#### Включение и отключение спиллинга

Следующие параметры управляют включением и отключением различных типов спиллинга. Их следует изменять только при наличии специфических требований системы.

##### local_file_config.enable

**Расположение:** `table_service_config.spilling_service_config.local_file_config.enable`
**Тип:** `boolean`  
**По умолчанию:** `true`  
**Описание:** Включает или отключает сервис спиллинга. При отключении (`false`) [спиллинг](https://ydb.tech/docs/ru/concepts/query_execution/spilling.md) не функционирует, что может привести к ошибкам при обработке больших объемов данных.

##### Возможные ошибки

- `Spilling Service not started` / `Service not started` — попытка использования спиллинга при выключенном Spilling Service. См. [Spilling Service not started](https://ydb.tech/docs/ru/troubleshooting/spilling/service-not-started.md)

```yaml
table_service_config:
  spilling_service_config:
    local_file_config:
      enable: true
```

##### enable_spilling_nodes

**Расположение:** `table_service_config.enable_spilling_nodes`  
**Тип:** `bool`  
**По умолчанию:** `true`  
**Описание:** Включает спиллинг на узлах базы данных. При отключении (`false`) спиллинг не функционирует на узлах базы данных.

```yaml
table_service_config:
  enable_spilling_nodes: true
```

##### enable_query_service_spilling

**Расположение:** `table_service_config.enable_query_service_spilling`  
**Тип:** `boolean`  
**По умолчанию:** `true`  
**Описание:** Глобальная опция, которая включает транспортный спиллинг при передаче данных между задачами.

```yaml
table_service_config:
  enable_query_service_spilling: true
```

{% note info %}

Эта настройка работает совместно с локальной конфигурацией сервиса спиллинга. При отключении (`false`) транспортный спиллинг не функционирует даже при включенном `spilling_service_config`.

{% endnote %}

### Полный пример

```yaml
table_service_config:
  enable_spilling_nodes: true
  enable_query_service_spilling: true
  spilling_service_config:
    local_file_config:
      enable: true
      root: "/var/spilling"
      max_total_size: 53687091200    # 50 GiB
      io_thread_pool:
        workers_count: 4
        queue_size: 1500
```

## См. также

- [Концепция спиллинга](https://ydb.tech/docs/ru/concepts/query_execution/spilling.md)
- [Архитектура Spilling Service](https://ydb.tech/docs/ru/contributor/spilling-service.md)
- [Устранение неполадок спиллинга](https://ydb.tech/docs/ru/troubleshooting/spilling/index.md)
- [Конфигурация контроллера памяти](https://ydb.tech/docs/ru/reference/configuration/memory_controller_config.md)
- [Мониторинг YDB](https://ydb.tech/docs/ru/devops/observability/monitoring.md)
- [Диагностика производительности](https://ydb.tech/docs/ru/troubleshooting/performance/index.md)