SET SESSION

SET SESSION (세션 속성 설정)

세션 속성이나 카탈로그 세션 속성 값을 설정하는 문법이에요. 쿼리 실행 방식을 현재 연결에 한해 일시적으로 바꿀 수 있어요.

출처: 문서

본문

세션 속성 값 또는 카탈로그 세션 속성을 설정해요.

세션 속성

세션 속성은 사용자가 Trino 클러스터에 대한 현재 연결 세션 동안 일시적으로 수정할 수 있는 구성 속성이에요. 많은 구성 속성에는 구성 속성과 동일한 값을 받는 대응 세션 속성이 있어요.

세션 속성에는 두 가지 유형이 있어요:

• 시스템 세션 속성은 전체 클러스터에 적용돼요. 달리 명시하지 않으면 대부분의 세션 속성은 시스템 세션 속성이에요.
• 카탈로그 세션 속성은 커넥터가 정의한 세션 속성으로, 카탈로그별로 설정할 수 있어요. 이 속성들은 catalogname.property_name처럼 카탈로그 이름을 접두사로 포함해 카탈로그마다 따로 설정해야 해요.

세션 속성은 현재 세션에 묶여 있어서, 사용자가 같은 세션 속성에 대해 서로 다른 값을 갖는 여러 연결을 클러스터에 가질 수 있어요. 연결을 끊거나 새 세션을 만들어 세션이 끝나면, 이전 세션 동안 세션 속성에 가한 모든 변경은 사라져요.

예시

다음 예시는 최대 쿼리 실행 시간을 바꾸는 시스템 세션 속성을 설정해요:

SET SESSION query_max_run_time = '10m';

다음 예시는 Iceberg 커넥터를 사용하는 example 카탈로그에 대해 incremental_refresh_enabled 카탈로그 세션 속성을 설정해요:

SET SESSION example.incremental_refresh_enabled=false;

관련 카탈로그 구성 속성 iceberg.incremental-refresh-enabled는 기본적으로 true이며, 세션 속성은 이 설정을 특정 카탈로그와 현재 세션에 대해 재정의할 수 있게 해요. example.incremental_refresh_enabled 카탈로그 세션 속성은 다른 카탈로그가 Iceberg 커넥터를 사용하더라도 그 카탈로그에는 적용되지 않아요.

더 알아보기 (Learn more)

설정한 세션 속성을 기본값으로 되돌리려면 RESET SESSION을, 현재 세션 속성 목록을 보려면 SHOW SESSION을 사용해요.