속성 참조

속성 참조 (Properties reference)

이 섹션은 Trino를 튜닝하거나 필요할 때 동작을 바꾸는 데 사용할 수 있는 가장 중요한 구성 속성과 (해당하는 경우) 그에 대응하는 세션 속성을 설명해요.

출처: 문서

본문

별도로 지정하지 않는 한, 구성 속성은 코디네이터와 모든 워커 노드에 설정해야 해요.

아래 페이지들은 Trino에서 사용할 수 있는 모든 구성·세션 속성의 완전한 목록이 아니며, 커넥터별 카탈로그 구성 속성은 포함하지 않아요. 카탈로그 구성 속성에 대한 자세한 내용은 커넥터 문서를 참고하세요.

속성 값 타입 (Property value types)

Trino 구성 속성은 각각 고유한 허용 값과 문법을 가진 다양한 값 타입을 지원해요. 속성마다 추가 제한이 적용되며, 허용되지 않는 값은 검증 오류가 발생해요.

`boolean`

boolean 타입 속성은 true 또는 false 두 값을 지원해요.

`data size`

data size 타입 속성은 바이트 기반 단위로 측정한 데이터 양을 나타내는 값을 지원해요. 이 단위는 1024의 배수로 증가하므로, 1메가바이트는 1024킬로바이트, 1킬로바이트는 1024바이트 등이에요. 예를 들어 6GB 값은 6기가바이트, 즉 (6 * 1024 * 1024 * 1024) = 6442450944바이트를 나타내요.

data size 타입은 다음 단위를 지원해요:

B: 바이트
kB: 킬로바이트
MB: 메가바이트
GB: 기가바이트
TB: 테라바이트
PB: 페타바이트

`double`

double 타입 속성은 1.6 같은 소수를 포함한 숫자 값을 지원해요. double 타입 값은 특정 속성이 지원하면 음수가 될 수 있어요.

`duration`

duration 타입 속성은 음수가 아닌 숫자 다음에 시간 단위가 오는 문법으로 시간 양을 나타내는 값을 지원해요. 예를 들어 7m 값은 7분을 나타내요.

duration 타입은 다음 단위를 지원해요:

ns: 나노초
us: 마이크로초
ms: 밀리초
s: 초
m: 분
h: 시간
d: 일

0의 지속 시간은 뒤에 오는 단위와 관계없이 0으로 처리돼요. 예를 들어 0s와 0m은 같은 의미예요.

duration 타입 속성은 2.25d 같은 소수 값도 지원해요. 이것은 지정된 단위의 분수 값으로 처리돼요. 예를 들어 1.5m 값은 1분 30초, 즉 90초와 같아요.

`heap size`

heap size 타입 속성은 힙 메모리 양을 지정하는 값을 지원해요. 이 값은 data size 속성과 같은 형식으로 제공하거나, double 값 뒤에 % 접미사를 붙여 제공할 수 있어요. % 접미사는 노드에서 사용 가능한 최대 힙 메모리의 백분율을 나타내요. 허용되는 최솟값은 1B, 최댓값은 100%이며, 이는 노드에서 사용 가능한 최대 힙 메모리에 해당해요.

`integer`

integer 타입 속성은 5, 1000 같은 정수 숫자 값을 지원해요. -7 같은 음수 값도 지원돼요. integer 타입 값은 정수여야 하며 2.5 같은 소수 값은 지원되지 않아요.

일부 integer 타입 속성은 자체 최솟값·최댓값을 강제해요.

`string`

string 타입 속성은 일련의 문자로 구성된 값 집합을 지원해요. 허용 값은 속성마다 정의되며, 특정 속성에서 지원 값과 기본값을 확인하세요.

더 알아보기 (Learn more)

세션 속성을 설정하는 방법이 궁금하다면 SET SESSION 문서를 이어서 읽어 보세요.