Обзор
Определение прагм
Прагмы — это специальные директивы, которые переопределяют настройки выполнения запроса. Например, с их помощью можно выбрать стратегию объединения таблиц, настроить уровень логирования ошибок или указать, в каком пуле выполнять операции запроса. Прагмы могут влиять на скорость выполнения запроса, на распределение ресурсов и семантику.
Действие прагм распространяется только в рамках текущего запроса. Подробнее смотри в разделе область действия прагм.
Полный список доступных настроек см. ниже.
Синтаксис
PRAGMA x.y = "z"; или PRAGMA x.y("z", "z2", "z3");:
-
x— (опционально) категория настройки. -
y— название настройки. -
z— (опционально для флагов) значение настройки. Допустимо использование следующих суффиксов:Kb,Mb,Gb— для объёма информации.sec,min,h,d— для временных значений.
Для динамических прагм yt значение настроек можно вернуть в состояние по умолчанию — с помощью PRAGMA my_pragma = default;. Обратите внимание — для других прагм сбросить настройку не получится.
Примеры
PRAGMA AutoCommit;
PRAGMA TablePathPrefix = "home/yql";
PRAGMA Warning("disable", "1101");