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

# Обзор

## Определение прагм

Прагмы — это специальные директивы, которые переопределяют настройки выполнения запроса. Например, с их помощью можно выбрать стратегию объединения таблиц, настроить уровень логирования ошибок или указать, в каком пуле выполнять операции запроса. Прагмы могут влиять на скорость выполнения запроса, на распределение ресурсов и семантику.

Действие прагм распространяется только в рамках текущего запроса. Подробнее смотри в разделе [область действия прагм](https://ytsaurus.tech/docs/ru/yql/syntax/pragma/global.md#pragmascope).

Полный список доступных настроек [см. ниже](#pragmas).

## Синтаксис

`PRAGMA x.y = "z";` или `PRAGMA x.y("z", "z2", "z3");`:

* `x` — (опционально) категория настройки.
* `y` — название настройки.
* `z` — (опционально для флагов) значение настройки. Допустимо использование следующих суффиксов:

  * `Kb`, `Mb`, `Gb` — для объёма информации.
  * `s`, `m`, `h`, `d` — для временных значений.

Для [динамических YT-прагм](https://ytsaurus.tech/docs/ru/yql/syntax/pragma/yt.md) значение настроек можно вернуть в состояние по умолчанию — с помощью `PRAGMA my_pragma = default`. Обратите внимание — для других прагм сбросить настройку не получится.

{% note info %}

Название прагмы регистронезависимое и игнорирует подчёркивания. Следующие записи идентичны и будут интерпретированы одинаково: `PRAGMA mypragma`, `PRAGMA MyPrAgMA`, `PRAGMA my_pragma`.

{% endnote %}

## Примеры

```yql
PRAGMA AutoCommit;
```

```yql
PRAGMA TablePathPrefix = "home/yql";
```

```yql
PRAGMA Warning("disable", "1101");
```


## Доступные прагмы {#pragmas}

* [Глобальные](https://ytsaurus.tech/docs/ru/yql/syntax/pragma/global.md)
* [Yson](https://ytsaurus.tech/docs/ru/yql/syntax/pragma/yson.md)
* [Работа с файлами](https://ytsaurus.tech/docs/ru/yql/syntax/pragma/file.md)
* [Отладочные и служебные](https://ytsaurus.tech/docs/ru/yql/syntax/pragma/debug.md)
* [YT-прагмы](https://ytsaurus.tech/docs/ru/yql/syntax/pragma/yt.md)