SET SESSION#
Синтаксис#
SET SESSION name = expression
SET SESSION catalog.name = expression
Описание#
Задает значение session property или catalog session property.
Session properties#
Session property — это configuration property, которое пользователь может временно изменить на время текущей session подключения к кластеру Trino. Многие configuration properties имеют соответствующую session property, принимающую те же значения, что и config property.
Есть два типа session properties:
System session properties применяются ко всему кластеру. Большинство session properties являются system session properties, если не указано иное.
Catalog session properties — это session properties, определенные connector, которые можно задавать отдельно для каждого каталога. Эти свойства должны задаваться отдельно для каждого каталога с именем каталога в качестве префикса, например
catalogname.property_name.
Session properties привязаны к текущей session, поэтому пользователь может иметь несколько подключений к кластеру, каждое из которых имеет разные значения одних и тех же session properties. После завершения session, при отключении или создании новой session, все изменения session properties, сделанные во время предыдущей session, теряются.
Примеры#
Следующий пример задает system session property, изменяющую максимальное время выполнения запроса:
SET SESSION query_max_run_time = '10m';
Следующий пример задает catalog session property incremental_refresh_enabled
для каталога example, использующего Коннектор Iceberg:
SET SESSION example.incremental_refresh_enabled=false;
Связанное catalog configuration property iceberg.incremental-refresh-enabled
по умолчанию равно true, а session property позволяет переопределить эту
настройку для конкретного каталога и текущей session. Catalog session property
example.incremental_refresh_enabled не применяется к другим каталогам, даже
если другой каталог также использует Iceberg connector.