최종 수정: 2026년 10월 21일에

FE 설정

이 문서에서는 FE 관련 설정 항목을 설명합니다.

FE 설정 파일 fe.conf는 일반적으로 FE 배포 경로의 conf/ 디렉터리에 있습니다. 버전 0.14부터는 또 다른 설정 파일인 fe_custom.conf가 도입됩니다. 이 파일은 운영 중 사용자가 동적으로 설정하고 영구 저장한 항목을 기록합니다.

FE 프로세스가 시작되면 먼저 fe.conf의 설정 항목을 읽고, 이어서 fe_custom.conf의 설정 항목을 읽습니다. fe_custom.conf의 항목은 fe.conf에 있는 동일한 항목을 덮어씁니다.

fe_custom.conf 파일의 위치는 fe.conf에서 custom_config_dir 설정 항목으로 지정할 수 있습니다.

설정 항목 조회

FE 설정 항목은 다음 두 가지 방법으로 조회할 수 있습니다.

FE 웹 페이지

브라우저에서 FE 웹 페이지 http://fe_host:fe_http_port/variable을 엽니다. Configure Info에서 현재 적용 중인 FE 설정 항목을 볼 수 있습니다.
명령으로 조회

FE가 시작된 후 MySQL 클라이언트에서 다음 명령으로 FE 설정 항목을 조회할 수 있습니다. 구체적인 구문은 SHOW-CONFIG를 참조하세요.

SHOW FRONTEND CONFIG;

결과 열의 의미는 다음과 같습니다.
- Key: 설정 항목의 이름입니다.
- Value: 현재 설정 항목의 값입니다.
- Type: 정수 또는 문자열과 같은 설정 항목 값의 형식입니다.
- IsMutable: 동적으로 설정할 수 있는지 나타냅니다. true이면 실행 중에 동적으로 설정할 수 있습니다. false이면 fe.conf에서만 설정할 수 있으며 FE를 다시 시작한 후 적용됩니다.
- MasterOnly: Master FE 노드에만 해당하는 설정 항목인지 나타냅니다. true이면 Master FE 노드에서만 의미가 있고 다른 유형의 FE 노드에는 의미가 없습니다. false이면 모든 유형의 FE 노드에서 의미가 있습니다.
- Comment: 설정 항목의 설명입니다.

설정 항목 지정

버전 4.1.5부터 SHOW FRONTEND CONFIG와 설정 내보내기 엔드포인트는 비어 있지 않은 민감한 값을 ********로 마스킹합니다. 여기에는 initial_root_password, TLS 개인 키 비밀번호, HTTPS Key Store 비밀번호, MySQL SSL 인증서 비밀번호가 포함됩니다. 빈 값은 설정되지 않았음을 나타내도록 그대로 비어 있습니다. 마스킹은 실제 적용되는 설정을 변경하지 않습니다.

FE 설정 항목은 다음 두 가지 방법으로 지정할 수 있습니다.

정적 설정

conf/fe.conf 파일에 설정 항목을 추가하고 값을 지정합니다. fe.conf의 설정 항목은 FE 프로세스 시작 시 읽힙니다. fe.conf에 없는 항목에는 기본값이 사용됩니다.
MySQL 프로토콜을 통한 동적 설정

FE 시작 후 다음 명령으로 설정 항목을 동적으로 지정할 수 있습니다. 이 명령에는 관리자 권한이 필요합니다.

ADMIN SET FRONTEND CONFIG (" fe_config_name "=" fe_config_value ");

모든 설정 항목이 동적 설정을 지원하는 것은 아닙니다. SHOW FRONTEND CONFIG; 명령 결과의 IsMutable 열에서 지원 여부를 확인할 수 있습니다.

MasterOnly 설정 항목을 수정하면 명령이 Master FE로 직접 전달되고 Master FE의 해당 항목만 변경됩니다.

이 방법으로 변경한 설정 항목은 FE 프로세스를 다시 시작하면 적용되지 않습니다.

이 명령에 관한 자세한 도움말은 HELP ADMIN SET CONFIG; 명령으로 확인할 수 있습니다.
HTTP 프로토콜을 통한 동적 설정

자세한 내용은 Set Config Action을 참조하세요.

이 방법을 사용하면 변경한 설정 항목을 영구 저장할 수도 있습니다. 항목은 fe_custom.conf 파일에 저장되므로 FE를 다시 시작한 후에도 적용됩니다.

예시

async_pending_load_task_pool_size 변경

SHOW FRONTEND CONFIG;에서 이 항목은 동적으로 설정할 수 없음을 확인할 수 있습니다(IsMutable이 false). fe.conf에 다음 항목을 추가해야 합니다.

async_pending_load_task_pool_size = 20

그런 다음 설정을 적용하려면 FE 프로세스를 다시 시작합니다.
dynamic_partition_enable 변경

SHOW FRONTEND CONFIG;에서 이 항목은 동적으로 설정할 수 있고(IsMutable이 true) Master FE 전용 설정임을 확인할 수 있습니다. 먼저 아무 FE에나 연결하여 다음 명령을 실행하면 설정을 변경할 수 있습니다.
```
ADMIN SET FRONTEND CONFIG ("dynamic_partition_enable" = "true"); `
```
이후 다음 명령으로 변경된 값을 조회할 수 있습니다.
```
set forward_to_master = true;
SHOW FRONTEND CONFIG;
```
이 방법으로 변경한 후 Master FE가 다시 시작되거나 Master 선출이 수행되면 설정이 무효화됩니다. 영구 적용하려면 설정 항목을 fe.conf에 직접 추가하고 FE를 다시 시작합니다.
max_distribution_pruner_recursion_depth 변경

SHOW FRONTEND CONFIG;에서 이 항목은 동적으로 설정할 수 있고(IsMutable이 true) Master FE 전용이 아님을 확인할 수 있습니다.

마찬가지로 동적 설정 명령으로 변경할 수 있습니다. Master FE 전용 설정이 아니므로 모든 FE가 변경된 값을 사용하게 하려면 각 FE에 개별적으로 연결하여 설정을 동적으로 변경해야 합니다.

설정 항목

메타데이터와 클러스터

`meta_dir`

기본값：DORIS_HOME_DIR + "/doris-meta"

형식: string 설명: Doris 메타데이터가 여기에 저장됩니다. 이 디렉터리의 스토리지에는 다음을 강력히 권장합니다.

높은 쓰기 성능(SSD)
안전성(RAID）

`catalog_try_lock_timeout_ms`

기본값：5000 （ms）

IsMutable：true

Catalog 잠금의 tryLock 제한 시간 설정입니다. 테스트 목적이 아니라면 일반적으로 변경할 필요가 없습니다.

`enable_bdbje_debug_mode`

기본값：false

true로 설정하면 FE가 BDBJE 디버그 모드로 시작됩니다.

`max_bdbje_clock_delta_ms`

기본값：5000 （5s）

Master FE 호스트와 Master가 아닌 FE 사이에서 허용되는 최대 시계 오차를 설정합니다. Master가 아닌 FE가 BDBJE를 통해 Master FE에 연결할 때마다 이 값을 검사합니다. 시계 오차가 이 값보다 크면 연결을 포기합니다.

`metadata_failure_recovery`

기본값：false

true이면 FE가 bdbje 복제 그룹을 재설정하여 선출 가능한 모든 노드 정보를 제거하고 Master로 시작하도록 시도합니다. 선출 가능한 노드가 모두 시작되지 않는 경우 메타데이터를 다른 노드에 복사하고 이 설정을 true로 지정하여 FE 재시작을 시도할 수 있습니다.

`txn_rollback_limit`

기본값：100

그룹에 다시 참여할 때 bdbje가 롤백할 수 있는 최대 트랜잭션 수입니다.

`grpc_threadmgr_threads_nums`

기본값: 4096

grpc_threadmgr에서 grpc 이벤트를 처리하는 스레드 수입니다.

`bdbje_replica_ack_timeout_second`

기본값：10 (s)

bdbje에 쓸 때 복제본 응답을 기다리는 제한 시간입니다. 비교적 큰 로그를 쓰는 동안 응답 시간이 초과되어 로그 쓰기에 실패할 수 있습니다. 이 경우 값을 적절히 늘릴 수 있습니다.

`bdbje_lock_timeout_second`

기본값：5

bdbje 작업의 잠금 제한 시간입니다. FE WARN 로그에 LockTimeoutException이 많이 발생하면 이 값을 늘려 볼 수 있습니다.

`bdbje_heartbeat_timeout_second`

기본값：30

Master와 Follower 사이의 bdbje 하트비트 제한 시간입니다. 기본값은 bdbje의 기본값과 같은 30초입니다. 일시적인 네트워크 문제나 예상치 못한 긴 Java GC로 허위 시간 초과가 발생하면 이 값을 늘려 볼 수 있습니다.

`replica_ack_policy`

기본값：SIMPLE_MAJORITY

옵션: ALL, NONE, SIMPLE_MAJORITY

bdbje의 복제본 응답 정책입니다. 자세한 내용은 http://docs.oracle.com/cd/E17277_02/html/java/com/sleepycat/je/Durability.ReplicaAckPolicy.html을 참조하세요.

`replica_sync_policy`

기본값：SYNC

옵션：SYNC, NO_SYNC, WRITE_NO_SYNC

bdbje의 Follower FE 동기화 정책입니다.

`master_sync_policy`

기본값：SYNC

옵션：SYNC, NO_SYNC, WRITE_NO_SYNC

bdbje의 Master FE 동기화 정책입니다. Follower FE를 1개만 배포한다면 'SYNC'로 설정하세요. Follower FE를 3개보다 많이 배포한다면 이 항목과 아래의 'replica_sync_policy'를 WRITE_NO_SYNC로 설정할 수 있습니다. 자세한 내용은 http://docs.oracle.com/cd/E17277_02/html/java/com/sleepycat/je/Durability.SyncPolicy.html을 참조하세요.

`bdbje_reserved_disk_bytes`

복제된 JE Environment에서 유지할 예약 공간의 바이트 수에 대한 목표 상한입니다.

기본값: 1073741824

동적 설정 가능 여부: false

Master FE 노드 전용 설정 항목 여부: false

`ignore_meta_check`

기본값：false

IsMutable：true

true이면 Master가 아닌 FE는 Master FE와 자신의 메타데이터 지연 격차가 meta_delay_toleration_second를 초과해도 이를 무시하고 읽기 서비스를 계속 제공합니다. 어떤 이유로 Master FE를 비교적 오래 중지해야 하지만 Master가 아닌 FE에서 읽기 서비스를 계속 제공하려는 경우 유용합니다.

`meta_delay_toleration_second`

기본값: 300 (5 min)

메타데이터 지연 격차가 meta_delay_toleration_second를 초과하면 Master가 아닌 FE는 서비스 제공을 중지합니다.

`edit_log_port`

기본값：9010

bdbje 포트입니다.

`edit_log_type`

기본값：BDB

Edit Log 유형입니다. BDB: 로그를 bdbje에 씁니다. LOCAL: 더 이상 사용되지 않습니다.

`edit_log_roll_num`

기본값：50000

IsMutable：true

MasterOnly：true

Master FE는 메타 저널이 edit_log_roll_num개 쌓일 때마다 이미지를 저장합니다.

`force_do_metadata_checkpoint`

기본값：false

IsMutable：true

MasterOnly：true

true로 설정하면 체크포인트 스레드가 JVM 메모리 사용률과 관계없이 체크포인트를 생성합니다.

`metadata_checkpoint_memory_threshold`

기본값：60 （60%）

IsMutable：true

MasterOnly：true

JVM 메모리 사용률(힙 또는 old 메모리 풀)이 이 임계값을 초과하면 OOM을 피하기 위해 체크포인트 스레드가 작동하지 않습니다.

`max_same_name_catalog_trash_num`

Catalog 휴지통에서 같은 이름의 메타정보를 유지할 최대 개수를 설정합니다. 최대값을 초과하면 가장 먼저 삭제된 메타정보가 완전히 삭제되어 복구할 수 없습니다. 0이면 같은 이름의 객체를 보관하지 않고, 0보다 작으면 제한하지 않습니다.

참고: 같은 이름의 메타데이터인지는 정해진 범위 안에서 판단합니다. 예를 들어 이름이 같은 데이터베이스는 같은 클러스터 안에서, 이름이 같은 테이블은 같은 데이터베이스(데이터베이스 ID가 동일함) 안에서, 이름이 같은 파티션은 같은 데이터베이스(데이터베이스 ID가 동일함)와 같은 테이블(테이블 ID가 동일함) 안에서 판단합니다.

기본값: 3

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

`cluster_id`

기본값：-1

노드(FE 또는 BE)의 클러스터 ID가 같으면 동일한 Doris 클러스터에 속하는 것으로 간주합니다. 클러스터 ID는 일반적으로 Master FE가 처음 시작할 때 생성하는 임의의 정수이며, 직접 지정할 수도 있습니다.

`heartbeat_mgr_blocking_queue_size`

기본값：1024

MasterOnly：true

heartbeat_mgr에서 하트비트 작업을 저장하는 블로킹 큐의 크기입니다.

`heartbeat_mgr_threads_num`

기본값：8

MasterOnly：true

heartbeat_mgr에서 하트비트 이벤트를 처리하는 스레드 수입니다.

`disable_cluster_feature`

기본값：true

IsMutable：true

다중 클러스터 기능은 버전 0.12에서 더 이상 사용되지 않습니다. 이 설정을 true로 지정하면 다음을 포함한 모든 클러스터 관련 작업이 비활성화됩니다.

클러스터 생성/삭제
유휴 Backend 추가/클러스터에 Backend 추가/클러스터 균형 조정을 위한 노드 해제
클러스터의 Backend 수 변경
데이터베이스 연결/마이그레이션

`enable_fqdn_mode`

주로 k8s 클러스터 환경에서 사용하는 설정입니다. enable_fqdn_mode가 true이면 BE가 있는 Pod를 다시 생성해도 Pod 이름은 유지되지만 IP는 변경될 수 있습니다.

기본값: false

동적 설정 가능 여부: false

Master FE 노드 전용 설정 항목 여부: true

`enable_token_check`

기본값：true

이전 버전과의 호환성을 위한 항목이며 나중에 제거됩니다. 이미지 파일을 다운로드할 때 토큰을 확인합니다.

`fe_meta_auth_token`

기본값: "" (빈 문자열)

IsMutable: false

FE 노드 간 FE 메타서비스 HTTP 엔드포인트(image, role, check, put, journal_id 등)를 인증하는 클러스터 토큰입니다. Doris 4.0 계열의 버전 4.0.8과 4.1 계열의 버전 4.1.4에 추가되었습니다.

비어 있지 않은 값으로 설정하면 기존 노드 호스트 검사에 더해 호출자가 일치하는 토큰 헤더를 제공해야 합니다. 따라서 클러스터 구성원이 아닌 노드가 FE 메타데이터 엔드포인트에 접근할 수 없습니다. 빈 값으로 두면 이전의 노드 호스트 검사만 수행하므로 기존 클러스터와 순차 업그레이드에는 영향을 주지 않습니다.

참고

이 설정은 활성화하기 전에 모든 FE에서 동일하게 fe.conf에 기록해야 합니다. 그렇지 않으면 FE가 서로의 메타데이터 요청을 거부하여 메타데이터 동기화에 실패합니다.

`enable_multi_tags`

기본값: false

동적 설정 가능 여부: false

Master FE 노드 전용 설정 항목 여부: true

단일 BE의 다중 태그 기능을 활성화할지 지정합니다.

`initial_root_password`

root 사용자의 초기 2단계 SHA-1 암호화 비밀번호를 설정합니다. 기본값은 ''이며 root 비밀번호가 없음을 뜻합니다. 이후 root 사용자가 set password를 실행하면 초기 root 비밀번호를 덮어씁니다.

예: 일반 텍스트 비밀번호 root@123을 설정하려면 Doris SQL select password('root@123')를 실행하여 암호화된 비밀번호 *A00C34073A26B40AB4307650BFB9309D6BFA6999를 생성할 수 있습니다.

기본값: 빈 문자열

동적 설정 가능 여부: false

Master FE 노드 전용 설정 항목 여부: true

`enable_cooldown_replica_affinity`

스캔할 때 쿨다운된 복제본을 우선 사용할지 선택합니다. 기본값은 true입니다.

기본값: true

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: false

TSO (Timestamp Oracle)

SinceVersion dev

TSO는 기본값이 false이고 동적으로 변경할 수 없는 enable_feature_changelog로 활성화합니다. 현재 지원하는 TSO 매개변수는 다음과 같습니다. 사용법과 주의사항은 TSO를 참조하세요.

매개변수	형식	기본값	변경 가능	Master 전용	설명
`tso_service_update_interval_ms`	int	`50 ms`	false	true	할당 창 업데이트를 확인하는 간격입니다.
`tso_max_update_retry_count`	int	`3`	true	true	TSO 상태 업데이트를 시도하는 최대 횟수입니다.
`tso_max_get_retry_count`	int	`10`	true	true	실패를 보고하기 전에 TSO 할당을 시도하는 최대 횟수입니다.
`tso_service_window_duration_ms`	int	`1000 ms`	true	true	예약된 할당 창의 지속 시간이며, 주기적 영구 저장 간격의 상한이기도 합니다.
`tso_clock_backward_startup_threshold_ms`	long	`1800000 ms`	true	true	시작 시 보정 과정에서 재생된 창의 끝과 시스템 시계 사이에 허용되는 최대 차이입니다.
`tso_time_offset_debug_mode`	int	`0 ms`	true	false	테스트 전용 시계 오프셋입니다. 일반 운영에는 사용하지 마세요.
`enable_tso_forward_when_counter_full`	boolean	`true`	true	true	논리 카운터가 용량의 절반을 초과하고 실제 시계의 진행이 충분하지 않으면 물리 구성요소를 1 ms 전진시킵니다.

서비스

`arrow_flight_deferred_query_idle_timeout_second`

기본값: 3600 (초)

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: false

버전 4.1.5부터 지원합니다. 외부 테이블을 배치로 스캔하는 Arrow Flight SQL 쿼리는 GetFlightInfo를 반환한 후에도 FE Coordinator를 유지해야 합니다. 그래야 클라이언트가 DoGet으로 결과를 읽는 동안 BE가 split을 계속 가져올 수 있습니다. 이 설정은 유휴 세션의 쿼리가 리소스를 유지할 수 있는 시간을 제한합니다. 기간은 쿼리 시작 시점부터 계산하며 쿼리 실행 제한 시간보다 짧아지지 않습니다. 만료되면 Coordinator, Workload Group 큐 슬롯, active_queries 항목이 해제되지만 세션은 열린 상태로 유지되고 계속 wait_timeout의 적용을 받습니다. 이 기한을 비활성화하려면 0으로 설정합니다.

`query_port`

기본값：9030

FE MySQL 서버 포트입니다.

`arrow_flight_sql_port`

기본값：-1

Arrow Flight SQL 서버 포트입니다.

`frontend_address`

상태: 더 이상 사용되지 않으며 사용을 권장하지 않습니다. 나중에 삭제될 수 있습니다.

형식: string

설명: InetAddress.getByName으로 IP 주소를 가져오는 대신 FE의 IP 주소를 명시적으로 설정합니다. 일반적으로 InetAddress.getByName에서 예상한 결과를 얻지 못할 때 사용합니다. 호스트 이름은 지원하지 않으며 IP 주소만 지원합니다.

기본값: 0.0.0.0

`priority_networks`

기본값：none

IP가 여러 개인 서버의 선택 전략을 지정합니다. 이 목록과 일치하는 IP는 최대 1개여야 합니다. 목록은 세미콜론으로 구분하며 CIDR 표기법을 사용합니다. 예: 10.10.10.0/24. 일치하는 IP가 없으면 임의로 하나를 선택합니다.

`http_port`

기본값：8030

HTTP 바인딩 포트입니다. 현재 모든 FE의 HTTP 포트는 같아야 합니다.

`https_port`

기본값：8050

HTTPS 바인딩 포트입니다. 현재 모든 FE의 HTTPS 포트는 같아야 합니다.

`enable_https`

기본값：false

HTTPS 활성화 여부입니다. false이면 HTTP를 지원합니다. true이면 HTTP와 HTTPS를 모두 지원하며 HTTP 요청을 HTTPS로 자동 리디렉션합니다. enable_https가 true이면 fe.conf에 SSL 인증서 정보를 설정해야 합니다.

`enable_ssl`

기본값：true

true로 설정하면 Doris가 SSL 프로토콜을 기반으로 MySQL과 암호화된 채널을 설정합니다.

`qe_max_connection`

기본값：1024

FE당 최대 연결 수입니다.

`check_java_version`

기본값：true

Doris는 빌드에 사용한 Java 버전과 실행 중인 Java 버전의 호환성을 확인합니다. 호환되지 않으면 Java 버전 불일치 예외 메시지를 표시하고 시작을 중단합니다.

`rpc_port`

기본값：9020

FE Thrift Server 포트입니다.

`thrift_server_type`

이 설정은 FE의 Thrift Service가 사용하는 서비스 모델을 나타냅니다. String 형식이며 대소문자를 구분하지 않습니다.

'SIMPLE'이면 'TSimpleServer' 모델을 사용합니다. 일반적으로 프로덕션에 적합하지 않으며 테스트에만 사용합니다.

'THREADED'이면 'TThreadedSelectorServer' 모델을 사용합니다. 이는 마스터-슬레이브 Reactor 방식의 논블로킹 I/O 모델로, 대량의 동시 연결 요청에 신속히 응답하며 대부분의 상황에서 성능이 좋습니다.

THREAD_POOL이면 TThreadPoolServer 모델을 사용합니다. 이 모델은 블로킹 I/O와 스레드 풀로 사용자 연결을 처리합니다. 동시 연결 수는 스레드 풀 크기로 제한됩니다. 동시 요청 수를 미리 예상할 수 있고 스레드 리소스 비용을 감당할 수 있다면 더 좋은 성능을 낼 수 있습니다. 기본 서비스 모델입니다.

`thrift_server_max_worker_threads`

기본값：4096

Thrift 서버의 최대 워커 스레드 수입니다.

`thrift_backlog_num`

기본값：1024

Thrift 서버의 backlog_num입니다. 이 값을 늘릴 때는 linux의 /proc/sys/net/core/somaxconn 설정값보다 큰지 확인해야 합니다.

`thrift_client_timeout_ms`

기본값：0

Thrift 서버의 연결 및 소켓 제한 시간 설정입니다.

thrift_client_timeout_ms 값은 읽기 시간 초과를 방지하도록 0으로 설정되어 있습니다.

`thrift_max_message_size`

기본값: 100MB

Thrift 서버가 수신하는 메시지의 최대 크기(바이트)입니다. 클라이언트가 보낸 메시지가 이 제한을 넘으면 Thrift 서버가 요청을 거부하고 연결을 닫습니다. 그러면 클라이언트에 "connection has been closed by peer." 오류가 발생합니다. 이 경우 매개변수를 늘려 볼 수 있습니다.

`use_compact_thrift_rpc`

기본값: true

쿼리 계획 구조를 압축 형식으로 전송할지 지정합니다. 활성화하면 쿼리 계획 구조의 크기를 약 50% 줄여 일부 "send fragment timeout" 오류를 피할 수 있습니다. 다만 동시 실행이 많은 작은 쿼리에서는 동시 처리량이 약 10% 줄어들 수 있습니다.

`grpc_max_message_size_bytes`

기본값：1G

GRPC 클라이언트 채널의 초기 흐름 창 크기와 최대 메시지 크기를 설정합니다. 결과 집합이 크면 이 값을 늘려야 할 수 있습니다.

`max_mysql_service_task_threads_num`

기본값：4096

Task 이벤트를 담당하는 스레드 수입니다.

`mysql_service_io_threads_num`

기본값：4

FE가 NIO 모델 기반 MySQL 서버를 시작할 때 IO 이벤트를 담당하는 스레드 수입니다.

`mysql_nio_backlog_num`

기본값：1024

MySQL NIO 서버의 backlog_num입니다. 이 값을 늘릴 때는 linux의 /proc/sys/net/core/somaxconn 파일에 있는 값도 함께 늘려야 합니다.

`broker_timeout_ms`

기본값：10000 （10s）

기본 broker RPC 제한 시간입니다.

`backend_rpc_timeout_ms`

FE가 BE로 RPC 요청을 보낼 때의 제한 시간(밀리초)입니다.

기본값: 60000

동적 설정 가능 여부: false

Master FE 노드 전용 설정 항목 여부: true

`drop_backend_after_decommission`

기본값：false

IsMutable：true

MasterOnly：true

BE를 성공적으로 해제한 후 시스템에서 해당 BE를 삭제할지 제어합니다. true이면 BE가 정상적으로 오프라인 상태가 된 후 노드를 삭제합니다. false이면 BE가 오프라인 상태가 된 뒤에도 DECOMMISSION 상태로 남으며 삭제되지 않습니다.

이 설정은 특정 상황에서 유용합니다. Doris 클러스터의 초기 상태에서 각 BE 노드에 디스크가 1개씩 있다고 가정해 봅시다. 일정 기간 운영한 후 각 BE 노드에 디스크를 2개씩 추가하여 수직 확장했습니다. 현재 Doris는 BE 내부 디스크 간 데이터 균형 조정을 지원하지 않으므로 초기 디스크의 데이터량이 새 디스크보다 계속 훨씬 많을 수 있습니다. 이때 다음 작업으로 디스크 간 균형을 수동으로 맞출 수 있습니다.
1. 설정 항목을 false로 지정합니다.
2. 특정 BE 노드에 해제 작업을 수행합니다. 이 작업은 해당 BE의 모든 데이터를 다른 노드로 이동합니다.
3. 해제 작업이 끝나도 BE는 삭제되지 않습니다. 이때 BE의 해제 상태를 취소합니다. 그러면 다른 BE 노드의 데이터가 이 노드로 다시 이동하면서 균형을 맞추기 시작하고, 해당 BE의 모든 디스크에 데이터가 고르게 분산됩니다.
4. 모든 BE 노드에 2단계와 3단계를 순서대로 수행하여 전체 노드의 디스크 균형을 맞춥니다.

`max_backend_down_time_second`

기본값: 3600 (1시간)

IsMutable：true

MasterOnly：true

Backend가 max_backend_down_time_second 동안 중지되면 BACKEND_DOWN 이벤트가 발생합니다.

`disable_backend_black_list`

BE 블랙리스트 기능을 비활성화합니다. 비활성화된 상태에서 BE로 보낸 쿼리 요청이 실패해도 해당 BE는 블랙리스트에 추가되지 않습니다. 이 매개변수는 간헐적인 버그로 많은 회귀 테스트가 실패하는 일을 줄이려는 회귀 테스트 환경에 적합합니다.

기본값: false

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: false

`max_backend_heartbeat_failure_tolerance_count`

BE 노드의 하트비트 실패를 허용하는 최대 횟수입니다. 연속 실패 횟수가 이 값을 넘으면 BE 상태가 dead로 설정됩니다. 이 매개변수는 간헐적인 하트비트 실패로 많은 회귀 테스트가 실패하는 일을 줄이려는 회귀 테스트 환경에 적합합니다.

기본값: 1

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

`abort_txn_after_lost_heartbeat_time_second`

하트비트가 끊긴 후 트랜잭션을 중단할 때까지의 시간입니다. 기본값 300은 하트비트가 끊긴 지 300s 후 BE의 트랜잭션이 중단됨을 뜻합니다.

기본값: 300(s)

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

`enable_access_file_without_broker`

기본값：false

IsMutable：true

MasterOnly：true

broker를 통해 bos 또는 다른 클라우드 스토리지에 접근할 때 broker를 건너뛸지 시도하는 설정입니다.

`agent_task_resend_wait_time_ms`

기본값：5000

IsMutable：true

MasterOnly：true

agent_task에 create_time이 설정된 경우 에이전트 작업을 다시 보낼지 결정합니다. current_time - create_time > agent_task_resend_wait_time_ms일 때만 ReportHandler가 작업을 다시 보낼 수 있습니다.

현재 이 설정은 주로 PUBLISH_VERSION 에이전트 작업이 반복 전송되는 문제를 해결하는 데 사용됩니다. 현재 기본값인 5000은 실험적으로 정한 값입니다.

에이전트 작업을 AgentTaskQueue에 제출한 시점과 BE에 제출한 시점 사이에는 시간 지연이 있으므로 이 값을 늘리면 중복 전송 문제를 효과적으로 줄일 수 있습니다.

반면 제출 또는 실행에 실패한 에이전트 작업을 다시 실행하기까지 걸리는 시간도 길어집니다.

`max_agent_task_threads_num`

기본값：4096

MasterOnly：true

에이전트 작업 스레드 풀에서 에이전트 작업을 처리하는 최대 스레드 수입니다.

`remote_fragment_exec_timeout_ms`

기본값：30000 （ms）

IsMutable：true

비동기 원격 Fragment 실행 제한 시간입니다. 보통 비동기 원격 Fragment는 짧은 시간 안에 실행됩니다. 시스템 부하가 높다면 제한 시간을 늘려 보세요.

`auth_token`

기본값：empty

내부 인증에 사용하는 클러스터 토큰입니다.

`enable_http_server_v2`

기본값: 공식 버전 0.14.0 출시 후에는 true이며, 그전에는 false입니다.

HTTP Server V2는 SpringBoot로 구현되었으며 프런트엔드와 백엔드를 분리한 아키텍처를 사용합니다. HTTPv2가 활성화되어야 새 프런트엔드 UI를 사용할 수 있습니다.

`http_api_extra_base_path`

일부 배포 환경에서는 HTTP API의 공통 접두사로 추가 기본 경로를 지정해야 합니다. 사용자는 이 매개변수로 추가 접두사를 지정할 수 있습니다. 설정 후 GET /api/basepath 인터페이스에서 값을 가져올 수 있습니다. 새 UI도 URL을 구성할 때 먼저 이 기본 경로를 가져오려고 시도합니다. enable_http_server_v2가 true일 때만 유효합니다.

기본값은 비어 있으며, 설정되지 않았음을 뜻합니다.

`jetty_server_acceptors`

기본값：2

`jetty_server_selectors`

기본값：4

`jetty_server_workers`

기본값：0

위 세 매개변수가 제어하는 Jetty 스레드 아키텍처는 acceptors, selectors, workers의 세 스레드 풀로 구성됩니다. Acceptors가 새 연결을 받아 selectors로 넘기면, selectors가 HTTP 메시지 프로토콜을 파싱하고 마지막으로 workers가 요청을 처리합니다. 앞의 두 스레드 풀은 논블로킹 모델을 사용하므로 한 스레드가 여러 소켓의 읽기와 쓰기를 처리할 수 있어 스레드 수가 적어도 됩니다.

대부분의 프로젝트에는 acceptors 스레드 1-2개와 selectors 스레드 2~4개면 충분합니다. Workers는 블로킹 비즈니스 로직을 처리하며 데이터베이스 작업이 많은 경우가 많아 스레드가 많이 필요합니다. 구체적인 수는 애플리케이션의 QPS와 IO 이벤트 비율에 따라 달라집니다. QPS가 높을수록 스레드가 더 필요하고, IO 비율이 높을수록 대기 중인 스레드와 전체 스레드가 더 많이 필요합니다.

Worker 스레드 풀은 기본적으로 설정되지 않으므로 필요에 맞게 설정하세요.

`jetty_server_max_http_post_size`

기본값：100 * 1024 * 1024 （100MB）

put 또는 post 메서드로 업로드하는 파일의 최대 바이트 수입니다. 기본값은 100MB입니다.

`jetty_server_max_http_header_size`

기본값：1048576 （1M）

HTTP 헤더 크기 설정 매개변수입니다. 기본값은 1M입니다.

`http_sql_submitter_max_worker_threads`

기본값：2

HTTP SQL 제출자의 최대 작업 스레드 수입니다.

`http_load_submitter_max_worker_threads`

기본값：2

HTTP 업로드 제출자의 최대 작업 스레드 수입니다.

동작 변경(4.1.4)

버전 4.1.4에서 /api/upload 엔드포인트가 제거되었으며 이 설정 항목도 함께 제거되었습니다. Upload Action을 참조하세요.

쿼리 엔진

`default_max_query_instances`

사용자 속성 max_query_instances가 0 이하일 때 사용할 기본값입니다. 사용자별 최대 인스턴스 수를 제한합니다. 이 매개변수가 0 이하이면 제한이 없습니다.

기본값은 -1입니다.

`max_query_retry_time`

기본값：3

IsMutable：true

쿼리 재시도 횟수입니다. RPC 예외가 발생했고 사용자에게 결과가 아직 전송되지 않았다면 쿼리를 재시도할 수 있습니다. 연쇄 장애를 방지하려면 이 값을 줄일 수 있습니다.

`max_dynamic_partition_num`

기본값：500

IsMutable：true

MasterOnly：true

동적 파티션 테이블을 생성할 때 한 번에 너무 많은 파티션이 생성되지 않도록 최대 생성 파티션 수를 제한합니다. 이 수는 동적 파티션 매개변수의 "start"와 "end"로 결정됩니다.

`dynamic_partition_enable`

기본값：true

IsMutable：true

MasterOnly：true

동적 파티션 스케줄러를 활성화할지 지정합니다. 기본적으로 활성화됩니다.

`dynamic_partition_check_interval_seconds`

기본값：600 （s）

IsMutable：true

MasterOnly：true

동적 파티션을 확인하는 간격을 결정합니다.

`max_multi_partition_num`

기본값：4096

IsMutable：true

MasterOnly：true

이 매개변수로 다중 파티션의 파티션 이름 접두사를 설정합니다. 동적 파티션에는 적용되지 않고 다중 파티션에만 적용됩니다. 기본 접두사는 "p_"입니다.

`multi_partition_name_prefix`

기본값：p_

IsMutable：true

MasterOnly：true

`partition_in_memory_update_interval_secs`

기본값：300 (s)

IsMutable：true

MasterOnly：true

메모리에 있는 전역 파티션 정보를 업데이트하는 간격입니다.

`enable_concurrent_update`

기본값：false

IsMutable：false

MasterOnly：true

동시 업데이트를 활성화할지 지정합니다.

`lower_case_table_names`

기본값：0

IsMutable：false

MasterOnly：true

이 설정은 클러스터 초기화 중에만 지정할 수 있으며 초기화가 완료된 후 클러스터를 다시 시작하거나 업그레이드할 때 변경할 수 없습니다.

0: 테이블 이름을 지정한 그대로 저장하고 대소문자를 구분하여 비교합니다. 1: 테이블 이름을 소문자로 저장하고 대소문자를 구분하지 않고 비교합니다. 2: 테이블 이름을 지정한 그대로 저장하되 소문자로 변환하여 비교합니다.

`table_name_length_limit`

기본값：64

IsMutable：true

MasterOnly：true

테이블 이름의 최대 길이를 제어합니다.

`cache_enable_sql_mode`

기본값：true

IsMutable：true

MasterOnly：false

이 스위치를 켜면 SQL 쿼리 결과 집합을 캐시합니다. 쿼리에 포함된 모든 테이블의 모든 파티션에서 마지막 버전 접근 이후의 시간이 cache_last_version_interval_second보다 길고, 결과 행 수가 cache_result_max_row_count보다 적고, 데이터 크기가 cache_result_max_data_size보다 작으면 결과 집합을 캐시합니다. 이후 동일한 SQL은 캐시를 사용합니다.

true이면 FE에서 SQL 결과 캐시를 활성화합니다. 오프라인 데이터 업데이트 환경에 적합합니다.

	case1	case2	case3	case4
enable_sql_cache	false	true	true	false
enable_partition_cache	false	false	true	true

`cache_enable_partition_mode`

기본값：true

IsMutable：true

MasterOnly：false

true이면 FE가 BE 캐시에서 데이터를 가져옵니다. 일부 파티션이 실시간으로 업데이트되는 환경에 적합합니다.

`cache_result_max_row_count`

기본값：3000

IsMutable：true

MasterOnly：false

메모리를 지나치게 사용하지 않도록 캐시 가능한 최대 행 수는 기본적으로 3000입니다. 이 임계값을 초과하면 캐시할 수 없습니다.

`cache_result_max_data_size`

기본값: 31457280

IsMutable: true

MasterOnly: false

메모리를 지나치게 사용하지 않도록 캐시 가능한 행의 최대 데이터 크기는 기본적으로 10MB입니다. 이 임계값을 초과하면 캐시할 수 없습니다.

`cache_last_version_interval_second`

기본값：30

IsMutable：true

MasterOnly：false

테이블의 최신 파티션 버전에 대한 시간 간격은 데이터 업데이트와 현재 버전 사이의 시간을 뜻합니다. 일반적으로 900초로 설정하며, 이를 통해 오프라인 적재와 실시간 적재를 구분합니다.

`max_allowed_in_element_num_of_delete`

기본값：1024

IsMutable：true

MasterOnly：true

DELETE 문에서 InPredicate의 요소 수를 제한합니다.

`max_running_rollup_job_num_per_table`

기본값：1

IsMutable：true

MasterOnly：true

Rollup 작업의 동시 실행 한도를 제어합니다.

`max_distribution_pruner_recursion_depth`

기본값：100

IsMutable：true

MasterOnly：false

해시 분포 프루너의 최대 재귀 깊이를 제한합니다. 예: where a in (5 elements) and b in (4 elements) and c in (3 elements) and d in (2 elements). a/b/c/d가 분포 열이면 재귀 깊이는 5 4 3 * 2 = 120으로 100보다 큽니다. 따라서 분포 프루너가 작동하지 않고 모든 버킷을 반환합니다. 깊이를 늘리면 더 많은 요소에 대해 분포 프루닝을 사용할 수 있지만 CPU 사용량이 늘 수 있습니다.

`enable_local_replica_selection`

기본값：false

IsMutable：true

true이면 Planner가 해당 Frontend와 같은 호스트에 있는 태블릿 복제본을 선택하려고 시도합니다. 다음 상황에서는 네트워크 전송을 줄일 수 있습니다.

N개 호스트에 N개의 Backend와 N개의 Frontend가 배포되어 있습니다.
데이터에 N개의 복제본이 있습니다.
동시 실행이 많은 쿼리가 모든 Frontend에 고르게 전달됩니다.

이 경우 모든 Frontend는 로컬 복제본만 사용해 쿼리를 실행할 수 있습니다. 로컬 복제본이 없을 때 다른 호스트의 복제본을 사용하려면 enable_local_replica_selection_fallback을 true로 설정하세요.

`enable_local_replica_selection_fallback`

기본값：false

IsMutable：true

enable_local_replica_selection과 함께 사용합니다. 로컬 복제본을 사용할 수 없으면 다른 호스트의 복제본으로 전환합니다.

`expr_depth_limit`

기본값：3000

IsMutable：true

표현식 트리의 깊이 제한입니다. 이를 초과하면 데이터베이스 읽기 잠금을 유지한 채 분석 시간이 길어질 수 있습니다. 동작을 충분히 이해하지 못했다면 변경하지 마세요.

`expr_children_limit`

기본값：10000

IsMutable：true

표현식 트리의 자식 표현식 수 제한입니다. 이를 초과하면 데이터베이스 읽기 잠금을 유지한 채 분석 시간이 길어질 수 있습니다.

`be_exec_version`

Fragment 사이에서 블록을 전달할 때 사용하는 직렬화 형식을 정의합니다.

코드 변경으로 블록의 데이터 형식이 달라지는 경우가 있습니다. 순차 업그레이드 중에도 BE 간 호환성을 유지하려면 FE가 데이터 버전을 내려 보내 어떤 형식으로 데이터를 전송할지 결정해야 합니다.

예를 들어 클러스터에 BE가 2개 있고, 업그레이드된 하나는 최신 $v_1$ 을 지원하지만 다른 하나는 $v_0$ 만 지원한다고 가정합니다. 이때 FE는 아직 업그레이드되지 않았으므로 $v_0을 일괄적으로 내려 보냅니다.$ , BE는 이전 데이터 형식으로 통신합니다. 모든 BE를 업그레이드한 후 FE를 업그레이드하면 새 FE가 $v_1$ 을 내려 보내고 클러스터 전체가 새 데이터 형식으로 전환됩니다.

기본값은 max_be_exec_version입니다. 특별한 요구가 있으면 형식 버전을 수동으로 낮출 수 있지만 min_be_exec_version보다 낮아서는 안 됩니다.

모든 BE에 대해 이 변수의 값은 항상 BeExecVersionManager::min_be_exec_version과 BeExecVersionManager::max_be_exec_version 사이여야 합니다. 즉, 업그레이드를 마친 클러스터를 다운그레이드하려면 FE를 먼저 다운그레이드한 다음 BE를 다운그레이드하거나, 설정에서 이 변수를 수동으로 낮춘 뒤 BE를 다운그레이드해야 합니다.

`max_be_exec_version`

현재 지원하는 최신 데이터 버전입니다. 변경할 수 없으며 해당 버전 BE의 BeExecVersionManager::max_be_exec_version과 일치해야 합니다.

`min_be_exec_version`

현재 지원하는 가장 오래된 데이터 버전입니다. 변경할 수 없으며 해당 버전 BE의 BeExecVersionManager::min_be_exec_version과 일치해야 합니다.

`max_query_profile_num`

쿼리 프로필의 최대 개수입니다.

기본값: 100

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: false

`publish_version_interval_ms`

기본값：10 （ms）

두 버전 게시 작업 사이의 최소 간격입니다.

`publish_version_timeout_second`

기본값：30 （s）

IsMutable：true

MasterOnly：true

한 트랜잭션의 모든 버전 게시 작업이 완료되기를 기다리는 최대 시간입니다.

`query_colocate_join_memory_limit_penalty_factor`

기본값：1

Colocote join PlanFragment 인스턴스의 memory_limit = exec_mem_limit / min (query_colocate_join_memory_limit_penalty_factor, instance_num)

`rewrite_count_distinct_to_bitmap_hll`

기본값: true

이 변수는 세션 변수이며 세션 수준에서 적용됩니다.

형식: boolean
설명: AGG 모델 테이블에만 적용됩니다. 변수가 true이고 사용자 쿼리에 count(distinct c1) 같은 집계 함수가 있을 때, c1 열의 형식이 bitmap이면 count distinct가 bitmap_union_count(c1)로 다시 작성됩니다. c1 열의 형식이 hll이면 hll_union_agg(c1)로 다시 작성됩니다. 변수가 false이면 다시 작성하지 않습니다.

데이터 적재 및 내보내기

`streaming_cdc_fetch_splits_batch_size`

기본값: 16 (4.1.5 이전에는 100)

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

Streaming CDC 요청당 가져오는 split 수입니다. 버전 4.1.5에서는 각 요청의 크기를 줄이기 위해 기본값을 100에서 16으로 낮췄습니다.

`max_export_history_job_num`

기본값: 1000

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

EXPORT 작업 기록의 정리 임계값입니다. 버전 4.1.5부터 정리 작업은 FINISHED / CANCELLED 작업만 제거하고 실행 중인 작업은 유지합니다. 따라서 활성 작업 때문에 전체 기록 수가 이 값을 넘을 수 있습니다.

`enable_pipeline_load`

기본값: true

IsMutable: true

Streamload와 같은 데이터 적재 작업을 Pipeline 엔진으로 수행할지 지정합니다.

`enable_vectorized_load`

기본값: true

벡터화된 데이터 적재를 활성화할지 지정합니다.

`enable_new_load_scan_node`

기본값: true

파일 스캔 노드를 활성화할지 지정합니다.

`default_max_filter_ratio`

기본값：0

IsMutable：true

MasterOnly：true

데이터 형식 오류 등의 이유로 필터링할 수 있는 데이터의 최대 비율입니다. 기본값은 0입니다.

`max_running_txn_num_per_db`

기본값：1000

IsMutable：true

MasterOnly：true

주로 동일한 데이터베이스에서 동시에 실행할 수 있는 데이터 적재 작업 수를 제어합니다.

클러스터에서 실행 중인 데이터 적재 작업이 너무 많으면 새로 제출한 작업에 다음 오류가 발생할 수 있습니다.

current running txns on db xxx is xx, larger than limit xx

이 오류는 현재 클러스터에서 실행 중인 데이터 적재 작업 수가 설정값을 초과했다는 뜻입니다. 이 경우 애플리케이션에서 기다렸다가 데이터 적재 작업을 재시도하는 것이 좋습니다.

Connector를 사용하는 경우 이 매개변수를 적절히 조정할 수 있으며 수천 개 수준도 문제없습니다.

`using_old_load_usage_pattern`

기본값：false

IsMutable：true

MasterOnly：true

true이면 처리 오류가 발생한 INSERT 문도 사용자에게 레이블을 반환합니다. 사용자는 이 레이블로 데이터 적재 작업의 상태를 확인할 수 있습니다. 기본값은 false이므로 INSERT 작업에서 오류가 발생하면 데이터 적재 레이블 없이 예외가 사용자 클라이언트로 바로 전달됩니다.

`disable_load_job`

기본값：false

IsMutable：true

MasterOnly：true

true로 설정하면 다음과 같이 동작합니다.

대기 중인 모든 데이터 적재 작업은 begin txn API 호출 시 실패합니다.
준비 중인 모든 데이터 적재 작업은 commit txn API 호출 시 실패합니다.
커밋된 모든 데이터 적재 작업은 게시를 기다립니다.

`commit_timeout_second`

기본값：30

IsMutable：true

MasterOnly：true

한 트랜잭션 전에 삽입된 모든 데이터가 커밋되기를 기다리는 최대 시간입니다. "commit" 명령의 제한 시간(초)입니다.

`max_unfinished_load_job`

기본값：1000

IsMutable：true

MasterOnly：true

PENDING, ETL, LOADING, QUORUM_FINISHED 상태를 포함한 데이터 적재 작업의 최대 수입니다. 이 수를 초과하면 작업을 제출할 수 없습니다.

`db_used_data_quota_update_interval_secs`

기본값：300 (s)

IsMutable：true

MasterOnly：true

Master 데몬 스레드가 db_used_data_quota_update_interval_secs마다 데이터베이스 트랜잭션 관리자의 데이터베이스 사용 데이터 할당량을 업데이트합니다.

데이터 적재 성능을 높이기 위해 적재 전 데이터베이스의 사용량이 할당량을 초과하는지 확인할 때 실시간으로 사용량을 계산하지 않고, 데몬 스레드가 주기적으로 업데이트한 값을 가져옵니다.

이 설정은 데이터베이스 사용 데이터량을 업데이트하는 간격을 지정합니다.

`disable_show_stream_load`

기본값：false

IsMutable：true

MasterOnly：true

Stream Load 표시를 비활성화하고 메모리의 Stream Load 기록을 지울지 지정합니다.

`max_stream_load_record_size`

기본값：5000

IsMutable：true

MasterOnly：true

메모리에 저장할 수 있는 최근 Stream Load 기록의 기본 최대 개수입니다.

`fetch_stream_load_record_interval_second`

기본값：120

IsMutable：true

MasterOnly：true

Stream Load 기록을 가져오는 간격입니다.

`max_bytes_per_broker_scanner`

기본값：500 * 1024 * 1024 * 1024L （500G）

IsMutable：true

MasterOnly：true

하나의 broker 데이터 적재 작업에서 broker 스캐너 하나가 처리할 수 있는 최대 바이트 수입니다. 일반적으로 Backend마다 broker 스캐너가 하나씩 있습니다.

`default_load_parallelism`

기본값: 8

IsMutable：true

MasterOnly：true

단일 노드에서 broker 데이터 적재 실행 계획의 기본 병렬도입니다. 사용자가 broker 데이터 적재 작업을 제출할 때 병렬도를 지정하면 이 매개변수는 무시됩니다. 이 매개변수는 max broker concurrency, min bytes per broker scanner 등의 여러 설정과 함께 데이터 적재 작업의 동시 실행 수준을 결정합니다.

`max_broker_concurrency`

기본값：10

IsMutable：true

MasterOnly：true

broker 스캐너의 최대 동시 실행 수입니다.

`min_bytes_per_broker_scanner`

기본값：67108864L (64M)

IsMutable：true

MasterOnly：true

단일 broker 스캐너가 읽는 최소 바이트 수입니다.

`period_of_auto_resume_min`

기본값：5 （s）

IsMutable：true

MasterOnly：true

Routine Load를 자동으로 재개하는 주기입니다.

`max_tolerable_backend_down_num`

기본값：0

IsMutable：true

MasterOnly：true

BE가 하나라도 중지되면 Routine Load를 자동으로 재개할 수 없습니다.

`max_routine_load_task_num_per_be`

기본값：5

IsMutable：true

MasterOnly：true

BE당 동시에 실행할 수 있는 Routine Load 작업의 최대 수입니다. BE로 보내는 작업 수를 제한하며, BE의 Routine Load 작업 스레드 풀 크기를 나타내는 'routine_load_thread_pool_size'(기본값 10)보다 작아야 합니다.

`max_routine_load_task_concurrent_num`

기본값：5

IsMutable：true

MasterOnly：true

단일 Routine Load 작업에서 동시에 실행할 수 있는 태스크의 최대 수입니다.

`max_routine_load_job_num`

기본값：100

NEED_SCHEDULED, RUNNING, PAUSE 상태를 포함한 Routine Load 작업의 최대 수입니다.

`desired_max_waiting_jobs`

기본값：100

IsMutable：true

MasterOnly：true

Routine Load와 버전 2 데이터 적재에서 기다리는 작업의 기본 목표 수입니다. Master 전환과 같은 상황에서는 현재 작업 수가 desired_max_waiting_jobs보다 많을 수 있습니다.

`disable_hadoop_load`

기본값：false

IsMutable：true

MasterOnly：true

Hadoop 클러스터를 사용하는 데이터 적재는 향후 더 이상 지원되지 않습니다. 이 유형의 적재를 비활성화하려면 true로 설정합니다.

`enable_spark_load`

기본값：false

IsMutable：true

MasterOnly：true

Spark 데이터 적재를 일시적으로 활성화할지 지정합니다. 기본적으로 활성화되지 않습니다.

참고: 이 매개변수는 버전 1.2에서 삭제되었으며 spark_load는 기본적으로 활성화됩니다.

`spark_load_checker_interval_second`

기본값：60

Spark 데이터 적재 스케줄러의 실행 간격입니다. 기본값은 60초입니다.

`async_loading_load_task_pool_size`

기본값：10

IsMutable：false

MasterOnly：true

loading_load 작업 실행자 풀의 크기입니다. 이 풀 크기로 동시에 실행되는 loading_load 작업의 최대 수를 제한합니다.

현재는 broker 데이터 적재의 loading_load 작업만 제한합니다.

`async_pending_load_task_pool_size`

기본값：10

IsMutable：false

MasterOnly：true

pending_load 작업 실행자 풀의 크기입니다. 이 풀 크기로 동시에 실행되는 pending_load 작업의 최대 수를 제한합니다.

현재는 broker 데이터 적재와 Spark 데이터 적재의 pending_load 작업만 제한합니다.

'max_running_txn_num_per_db'보다 작아야 합니다.

`async_load_task_pool_size`

기본값：10

IsMutable：false

MasterOnly：true

이 설정은 이전 버전과의 호환성을 위한 것입니다. async_loading_load_task_pool_size로 대체되었으며 향후 제거됩니다.

`enable_single_replica_load`

기본값：false

IsMutable：true

MasterOnly：true

Stream Load와 broker 데이터 적재에서 단일 복제본 쓰기를 활성화할지 지정합니다.

`min_load_timeout_second`

기본값：1 （1s）

IsMutable：true

MasterOnly：true

모든 유형의 데이터 적재에 적용되는 최소 Stream Load 제한 시간입니다.

`max_stream_load_timeout_second`

기본값: 259200 (3일)

IsMutable：true

MasterOnly：true

Stream Load 제한 시간 설정을 제한하는 항목입니다. 사용자가 제한 시간을 지나치게 길게 설정하여 실패한 Stream Load 트랜잭션을 빠르게 취소하지 못하는 일을 방지합니다.

`max_load_timeout_second`

기본값: 259200 (3일)

IsMutable：true

MasterOnly：true

Stream Load를 제외한 모든 데이터 적재 유형에 적용되는 최대 제한 시간입니다.

`stream_load_default_timeout_second`

기본값: 86400 * 3 (3일)

IsMutable：true

MasterOnly：true

Stream Load와 스트리밍 mini load의 기본 제한 시간입니다.

`stream_load_default_precommit_timeout_second`

기본값：3600（s）

IsMutable：true

MasterOnly：true

Stream Load 사전 제출의 기본 제한 시간입니다.

`stream_load_default_memtable_on_sink_node`

기본값：false

IsMutable：true

MasterOnly：true

Stream Load의 sink 노드에서 memtable을 기본적으로 활성화합니다. HTTP 헤더 memtable_on_sink_node가 설정되지 않았을 때 적용됩니다.

`insert_load_default_timeout_second`

기본값: 3600 (1시간)

IsMutable：true

MasterOnly：true

INSERT 데이터 적재의 기본 제한 시간입니다.

`mini_load_default_timeout_second`

기본값: 3600 (1시간)

IsMutable：true

MasterOnly：true

비스트리밍 mini load의 기본 제한 시간입니다.

`broker_load_default_timeout_second`

기본값: 14400 (4시간)

IsMutable：true

MasterOnly：true

broker 데이터 적재의 기본 제한 시간입니다.

`spark_load_default_timeout_second`

기본값: 86400 (1일)

IsMutable：true

MasterOnly：true

Spark 데이터 적재의 기본 제한 시간입니다.

`hadoop_load_default_timeout_second`

기본값: 86400 * 3 (3일)

IsMutable：true

MasterOnly：true

Hadoop 데이터 적재의 기본 제한 시간입니다.

`load_running_job_num_limit`

기본값：0

IsMutable：true

MasterOnly：true

실행 중인 데이터 적재 작업 수를 제한합니다. 기본값 0은 제한이 없음을 뜻합니다.

`load_input_size_limit_gb`

기본값：0

IsMutable：true

MasterOnly：true

데이터 적재 작업에 입력되는 데이터의 크기를 제한합니다. 기본값 0은 제한이 없음을 뜻합니다.

`load_etl_thread_num_normal_priority`

기본값：10

NORMAL 우선순위 ETL 데이터 적재 작업의 동시 실행 수입니다. 동작을 충분히 이해하지 못했다면 변경하지 마세요.

`load_etl_thread_num_high_priority`

기본값：3

HIGH 우선순위 ETL 데이터 적재 작업의 동시 실행 수입니다. 동작을 충분히 이해하지 못했다면 변경하지 마세요.

`load_pending_thread_num_normal_priority`

기본값：10

NORMAL 우선순위로 대기 중인 데이터 적재 작업의 동시 실행 수입니다. 동작을 충분히 이해하지 못했다면 변경하지 마세요.

`load_pending_thread_num_high_priority`

기본값：3

HIGH 우선순위로 대기 중인 데이터 적재 작업의 동시 실행 수입니다. 데이터 적재 작업의 우선순위는 HIGH 또는 NORMAL입니다. 모든 mini batch 데이터 적재 작업은 HIGH이고 다른 유형은 NORMAL입니다. 우선순위는 느린 작업이 스레드를 장시간 점유하는 일을 방지하기 위해 설정됩니다. 내부 스케줄링 최적화 정책이며 현재 작업 우선순위를 수동으로 지정할 수 없습니다. 동작을 충분히 이해하지 못했다면 변경하지 마세요.

`load_checker_interval_second`

기본값：5 （s）

데이터 적재 스케줄러의 실행 간격입니다. 데이터 적재 작업은 PENDING에서 LOADING을 거쳐 FINISHED로 상태가 바뀝니다. 스케줄러가 PENDING에서 LOADING으로 전환하고, 트랜잭션 콜백이 LOADING에서 FINISHED로 전환합니다. 따라서 동시 실행 수가 상한에 도달하지 않았다면 작업을 완료하는 데 최대 한 간격이 걸립니다.

`s3_load_endpoint_white_list`

기본값: empty

동적 설정 가능 여부: false

S3 Load가 사용할 수 있는 엔드포인트의 허용 목록입니다. 여러 값은 쉼표로 구분합니다. 예: s3_load_endpoint_white_list=a,b,c. 빈 값이면 허용 목록이 설정되지 않은 것입니다.

동작 변경(4.1.4)

보안상의 이유로 버전 4.1.4부터 이 설정 항목은 더 이상 동적으로 변경할 수 없습니다. fe.conf에서만 설정할 수 있으며 FE를 다시 시작한 후 적용됩니다. ADMIN SET FRONTEND CONFIG로는 변경할 수 없습니다.

`resource_group_load_success_quorum`

기본값: empty

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

버전 4.1.4에 추가되었습니다. 데이터 적재 트랜잭션을 커밋할 때 리소스 그룹(BE의 Location Tag)별로 쓰기 성공이 필요한 최소 복제본 수를 설정합니다.

값은 쉼표로 구분한 목록이며 각 항목의 형식은 <resource_group>:<min_success_replicas>입니다. <min_success_replicas>는 음수가 아닌 정수입니다. 예:

resource_group_load_success_quorum=group_a:2,group_b:1

트랜잭션 커밋 시 설정된 리소스 그룹에서 쓰기에 성공한 복제본 수가 지정된 값보다 적으면 커밋에 실패합니다. 설정에 없는 리소스 그룹은 검사하지 않습니다. 형식이 잘못된 항목은 무시하고 fe.log에 경고를 출력합니다.

여러 데이터 센터나 가용 영역에 배포한 경우 이 설정을 사용하면 지정한 데이터 센터에서 정해진 수의 복제본 쓰기가 끝난 뒤에만 데이터 적재를 성공으로 간주할 수 있습니다.

`enable_adaptive_random_bucket_load`

기본값: true

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

버전 4.1.4에 추가되었습니다. 적응형 랜덤 버킷 데이터 적재를 활성화할지 지정합니다.

활성화하면 FE가 BE에 태블릿 위치 정보를 보내고, 각 BE는 이 정보를 사용해 자신이 기본 복제본을 보유한 로컬 버킷 집합을 파악합니다. 단일 태블릿에 쓴 데이터량이 임계값(기본값 200 MB)을 초과하면 로컬 버킷 사이에서 쓰기 대상을 순환합니다. 이를 통해 랜덤 버킷(DISTRIBUTED BY RANDOM) 테이블의 적재 시 메모리 부담을 줄이고 처리량을 높이며 모든 데이터 적재 방식에 동일하게 적용됩니다.

이 기능은 BE 설정 enable_table_memtable_flush_backpressure와 table_memtable_flush_pending_count_limit의 제한도 받습니다. BE 설정을 참조하세요.

`enable_forward_group_commit_stream_load_to_follower`

기본값: false

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

버전 4.1.4에 추가되었습니다. Group Commit을 사용하는 Stream Load 요청을 Follower FE로 전달할지 지정합니다.

활성화하면 Group Commit 모드의 Stream Load 요청을 라운드 로빈 방식으로 Follower FE에 전달하여 배치 처리 부담을 여러 FE에 분산합니다.

대상 테이블의 light_schema_change 속성이 false이면 전달을 지원하지 않으며 요청이 오류로 실패합니다.

`streaming_job_snapshot_offset_persist_interval_sec`

기본값: 300 (s)

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

버전 4.1.4에 추가되었습니다. Streaming Job(연속 데이터 적재 작업)의 전체 스냅샷 단계에서 오프셋을 영구 저장하는 두 작업 사이의 최소 간격(초)입니다. 값을 줄이면 작업 재시작 후 재생해야 하는 데이터량이 줄지만 메타데이터 쓰기 빈도는 높아집니다.

`label_keep_max_second`

기본값：3 * 24 * 3600 (3일)

IsMutable：true

MasterOnly：true

완료되거나 취소된 데이터 적재 작업의 레이블은 label_keep_max_second 후 제거됩니다.

제거된 레이블은 재사용할 수 있습니다.
시간을 짧게 설정하면 FE 메모리 사용량이 줄어듭니다. 제거되기 전까지 모든 데이터 적재 작업의 정보가 메모리에 유지되기 때문입니다.

동시 쓰기가 많아 작업이 대량으로 밀리고 Frontend 서비스 호출이 실패한다면 로그를 확인하세요. 메타데이터 쓰기가 잠금을 너무 오래 유지한다면 이 값을 12시간 또는 6시간 이하로 조정할 수 있습니다.

`streaming_label_keep_max_second`

기본값: 43200 (12시간)

IsMutable：true

MasterOnly：true

INSERT, STREAMING LOAD, ROUTINE_LOAD_TASK와 같이 빈도가 높은 데이터 적재 작업에 적용됩니다. 기간이 만료되면 완료된 작업이나 태스크를 삭제합니다.

`label_clean_interval_second`

기본값：1 * 3600 (1시간)

데이터 적재 레이블 정리기가 label_clean_interval_second마다 실행되어 오래된 작업을 정리합니다.

`label_regex_length`

기본값: 128 (문자)

데이터 적재 레이블의 최대 문자 길이입니다. 기본값은 128자입니다.

`transaction_clean_interval_second`

기본값：30

트랜잭션이 가시화되거나 중단되면 transaction_clean_interval_second초 후 정리합니다. 이 간격을 가능한 한 짧게 하고 각 정리 주기를 빠르게 완료해야 합니다.

`sync_commit_interval_second`

트랜잭션을 커밋하는 최대 시간 간격입니다. 이 시간이 지난 뒤에도 채널에 제출되지 않은 데이터가 남아 있으면 consumer가 채널에 트랜잭션 제출을 알립니다.

기본값: 10 (초)

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

`sync_checker_interval_second`

데이터 동기화 작업의 실행 상태를 확인합니다.

기본값: 10 (s)

`max_sync_task_threads_num`

데이터 동기화 작업 스레드 풀의 최대 스레드 수입니다.

기본값：10

`min_sync_commit_size`

트랜잭션을 커밋하기 위해 충족해야 하는 최소 이벤트 수입니다. FE가 받은 이벤트 수가 이 값보다 적으면 sync_commit_interval_second가 지날 때까지 다음 데이터 배치를 기다립니다. 기본값은 이벤트 10000개입니다. 이 설정을 변경하려면 canal 측의 canal.instance.memory.buffer.size 설정(기본값 16384)보다 작은지 확인하세요. 그렇지 않으면 FE가 ack 전에 저장소보다 긴 큐에서 더 많은 이벤트를 가져오려고 시도하여 저장소 큐가 시간 초과까지 차단될 수 있습니다.

기본값: 10000

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

`min_bytes_sync_commit`

트랜잭션 커밋에 필요한 최소 데이터 크기입니다. FE가 받은 데이터 크기가 이 값보다 작으면 sync_commit_interval_second가 지날 때까지 다음 데이터 배치를 기다립니다. 기본값은 15MB입니다. 이 설정을 변경하려면 canal 측 canal.instance.memory.buffer.size와 canal.instance.memory.buffer.memunit의 곱(기본값 16MB)보다 작은지 확인하세요. 그렇지 않으면 ack 전에 FE가 저장 공간보다 많은 데이터를 가져오려고 시도하여 저장소 큐가 시간 초과까지 차단될 수 있습니다.

기본값: 15*1024*1024 (15M)

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

`max_bytes_sync_commit`

데이터 동기화 작업 스레드 풀의 최대 스레드 수입니다. FE 전체에 스레드 풀은 하나만 있으며, FE에서 BE로 데이터를 보내는 모든 데이터 동기화 태스크를 처리합니다. 스레드 풀은 SyncTaskPool 클래스에 구현되어 있습니다.

기본값: 10

동적 설정 가능 여부: false

Master FE 노드 전용 설정 항목 여부: false

`enable_outfile_to_local`

기본값：false

outfile 기능이 결과를 로컬 디스크로 내보내도록 허용할지 지정합니다.

`export_tablet_num_per_task`

기본값：5

IsMutable：true

MasterOnly：true

내보내기 쿼리 계획당 태블릿 수입니다.

`export_task_default_timeout_second`

기본값: 2 * 3600 (2시간)

IsMutable：true

MasterOnly：true

내보내기 작업의 기본 제한 시간입니다.

`export_running_job_num_limit`

기본값：5

IsMutable：true

MasterOnly：true

실행 중인 내보내기 작업의 동시 실행 한도입니다. 기본값은 5이고, 0이면 제한이 없습니다.

`export_checker_interval_second`

기본값：5

내보내기 검사기의 실행 간격입니다.

`enable_stream_load_profile`

기본값: false

MasterOnly: false

Stream Load 프로필을 활성화할지 지정합니다.

로그

`log_roll_size_mb`

기본값：1024 （1G）

시스템 로그 파일과 감사 로그 파일 각각의 최대 크기입니다.

`sys_log_dir`

기본값: DorisFE.DORIS_HOME_DIR + "/log"

FE 로그 디렉터리를 지정합니다. FE는 다음 두 로그 파일을 생성합니다.

fe.log: FE 프로세스의 모든 로그입니다. fe.warn.log FE 프로세스의 모든 WARNING 및 ERROR 로그입니다.

`sys_log_level`

기본값：INFO

로그 수준: INFO, WARN, ERROR, FATAL

`sys_log_roll_num`

기본값：10

하나의 sys_log_roll_interval 동안 유지할 FE 로그 파일의 최대 수입니다. 기본값 10은 하루에 최대 10개 로그 파일이 있다는 뜻입니다.

`sys_log_verbose_modules`

기본값：{}

상세 로그 모듈입니다. VERBOSE 수준은 log4j DEBUG 수준으로 구현됩니다.

예： sys_log_verbose_modules = org.apache.doris.catalog 이 경우 org.apache.doris.catalog 패키지와 모든 하위 패키지에 있는 파일의 디버그 로그만 출력합니다.

`sys_log_roll_interval`

기본값：DAY

sys_log_roll_interval:

DAY: 로그 접미사는 yyyyMMdd입니다.
HOUR: 로그 접미사는 yyyyMMddHH입니다.

`sys_log_delete_age`

기본값：7d

기본값은 7일이며 로그 파일을 마지막으로 수정한 지 7일이 지나면 삭제합니다.

지원 형식:

7d 7일
10h 10시간
60m 60분
120s 120초

`sys_log_roll_mode`

기본값：SIZE-MB-1024

로그 분할 크기입니다. 1 G마다 로그 파일을 분할합니다.

`sys_log_enable_compress`

기본값: false

true이면 fe.log와 fe.warn.log를 gzip으로 압축합니다.

`audit_log_dir`

기본값：DORIS_HOME_DIR + "/log"

audit_log_dir： FE 감사 로그 디렉터리를 지정합니다. 감사 로그 fe.audit.log에는 사용자, 호스트, 소요 시간, 상태 등의 관련 정보와 함께 모든 요청이 기록됩니다.

`audit_log_roll_num`

기본값：90

하나의 audit_log_roll_interval 동안 유지할 FE 감사 로그 파일의 최대 수입니다.

`audit_log_modules`

기본값：{"slow_query", "query", "load", "stream_load"}

느린 쿼리에는 소요 시간이 qe_slow_log_ms를 초과한 모든 쿼리가 포함됩니다.

`qe_slow_log_ms`

기본값: 5000 (5초)

쿼리 응답 시간이 이 임계값을 초과하면 감사 로그에 slow_query로 기록합니다.

`audit_log_roll_interval`

기본값：DAY

DAY: 로그 접미사는 yyyyMMdd입니다. HOUR: 로그 접미사는 yyyyMMddHH입니다.

`audit_log_delete_age`

기본값：30d

기본값은 30일이며 로그 파일을 마지막으로 수정한 지 30일이 지나면 삭제합니다.

지원 형식:

7d 7일
10h 10시간
60m 60분
120s 120초

`audit_log_enable_compress`

기본값: false

true이면 fe.audit.log를 gzip으로 압축합니다.

스토리지

`inverted_index_storage_format`

기본값: V3

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

새 역인덱스의 기본 스토리지 형식입니다. 버전 4.1.5부터 V1 역인덱스 생성과 이 설정을 V1로 동적 변경하는 작업은 금지됩니다. fe.conf 또는 fe_custom.conf에서 실제 적용되는 값이 V1이면 FE가 시작을 거부합니다. 업그레이드 전에 V2 또는 V3으로 변경하세요. 기존 V1 테이블은 계속 읽을 수 있지만 역인덱스를 추가할 수는 없습니다. 새 인덱스가 필요하면 테이블을 V2 또는 V3 형식으로 다시 생성하세요.

`min_replication_num_per_tablet`

기본값: 1

태블릿당 최소 복제본 수를 설정합니다.

`max_replication_num_per_tablet`

기본값: 32767

태블릿당 최대 복제본 수를 설정합니다.

`default_db_data_quota_bytes`

기본값：8192PB

IsMutable：true

MasterOnly：true

기본 데이터베이스 데이터 할당량 크기를 설정합니다. 개별 데이터베이스의 할당량을 설정하려면 다음을 사용합니다.

Set the database data quota, the unit is:B/K/KB/M/MB/G/GB/T/TB/P/PB
ALTER DATABASE db_name SET DATA QUOTA quota;
View configuration
show data （Detail：HELP SHOW DATA）

`default_db_replica_quota_size`

기본값: 1073741824

IsMutable：true

MasterOnly：true

기본 데이터베이스 복제본 할당량을 설정합니다. 개별 데이터베이스의 할당량을 설정하려면 다음을 사용합니다.

Set the database replica quota
ALTER DATABASE db_name SET REPLICA QUOTA quota;
View configuration
show data （Detail：HELP SHOW DATA）

`recover_with_empty_tablet`

기본값：false

IsMutable：true

MasterOnly：true

코드 버그나 사용자 실수 같은 특수한 상황에서 일부 태블릿의 복제본을 모두 잃을 수 있습니다. 이때 데이터는 사실상 손실된 상태입니다. 하지만 일부 상황에서는 데이터 손실이 있더라도 쿼리 오류가 발생하지 않도록 하여 사용자가 받는 영향을 줄여야 할 수 있습니다. 이 경우 빈 Tablet으로 누락된 복제본을 채워 쿼리가 정상적으로 실행되도록 할 수 있습니다.

true로 설정하면 모든 복제본이 손상되거나 누락된 태블릿을 Doris가 빈 복제본으로 자동으로 채웁니다.

`min_clone_task_timeout_sec` `And max_clone_task_timeout_sec`

기본값: 최소 3분, 최대 2시간

IsMutable：true

MasterOnly：true

mix_clone_task_timeout_sec와 함께 사용하여 복제 작업의 최대 및 최소 제한 시간을 제어할 수 있습니다. 일반적으로 복제 작업의 제한 시간은 데이터량과 최소 전송 속도(5MB/s)로 추정합니다. 특수한 경우에는 이 두 설정으로 제한 시간의 상한과 하한을 정해 복제 작업이 성공적으로 완료되도록 할 수 있습니다.

`disable_storage_medium_check`

기본값：false

IsMutable：true

MasterOnly：true

disable_storage_medium_check가 true이면 ReportHandler가 태블릿의 스토리지 매체를 확인하지 않고 스토리지 쿨다운 기능을 비활성화합니다. 기본값은 false입니다. 태블릿의 스토리지 매체를 신경 쓰지 않는다면 true로 설정할 수 있습니다.

`decommission_tablet_check_threshold`

기본값：5000

IsMutable：true

MasterOnly：true

해제 중인 BE의 태블릿 상태를 Master FE가 확인해야 하는지 제어합니다. 해제 중인 BE의 태블릿 수가 이 임계값보다 적으면 FE가 주기적 확인을 시작합니다. 해당 BE의 태블릿이 모두 회수되면 FE가 즉시 BE를 삭제합니다.

성능을 고려하여 이 값을 지나치게 높게 설정하지 마세요.

`partition_rebalance_max_moves_num_per_selection`

기본값：10

IsMutable：true

MasterOnly：true

PartitionRebalancer를 사용할 때만 유효합니다.

`partition_rebalance_move_expire_after_access`

기본값：600 (s)

IsMutable：true

MasterOnly：true

PartitionRebalancer를 사용할 때만 유효합니다. 값을 변경하면 캐시된 이동 작업이 지워집니다.

`tablet_rebalancer_type`

기본값：BeLoad

MasterOnly：true

Rebalancer 유형입니다(대소문자 구분 없음): BeLoad, Partition. 유형을 파싱하지 못하면 기본값 BeLoad를 사용합니다.

`max_balancing_tablets`

기본값：100

IsMutable：true

MasterOnly：true

TabletScheduler에서 균형 조정 중인 태블릿 수가 max_balancing_tablets를 초과하면 추가 균형 검사를 하지 않습니다.

`max_scheduling_tablets`

기본값：2000

IsMutable：true

MasterOnly：true

TabletScheduler에서 스케줄링된 태블릿 수가 max_scheduling_tablets를 초과하면 검사를 건너뜁니다.

`disable_balance`

기본값：false

IsMutable：true

MasterOnly：true

true이면 TabletScheduler가 균형 조정을 수행하지 않습니다.

`disable_disk_balance`

기본값：true

IsMutable：true

MasterOnly：true

true이면 TabletScheduler가 디스크 균형 조정을 수행하지 않습니다.

`balance_load_score_threshold`

기본값: 0.1 (10%)

IsMutable：true

MasterOnly：true

클러스터 균형 점수의 임계값입니다. Backend의 부하 점수가 평균보다 10% 낮으면 LOW 부하로, 평균보다 10% 높으면 HIGH 부하로 표시합니다.

`capacity_used_percent_high_water`

기본값: 0.75 (75%)

IsMutable：true

MasterOnly：true

디스크 용량 사용률의 상한 수위입니다. Backend의 부하 점수를 계산할 때 사용합니다.

`clone_distribution_balance_threshold`

기본값: 0.2

IsMutable：true

MasterOnly：true

Backend 간 복제본 수의 균형 임계값입니다.

`clone_capacity_balance_threshold`

기본값: 0.2

IsMutable：true

MasterOnly：true

BE 간 데이터 크기의 균형 임계값입니다.

균형 조정 알고리즘은 다음과 같습니다.
1. 전체 클러스터의 평균 사용 용량(AUC)을 계산합니다. (전체 데이터 크기 / 전체 Backend 수)
2. 상한 수위는 (AUC * (1 + clone_capacity_balance_threshold))입니다.
3. 하한 수위는 (AUC * (1 - clone_capacity_balance_threshold))입니다.
4. Clone 검사기가 상한 수위의 BE에서 하한 수위의 BE로 복제본을 이동하려고 시도합니다.

`disable_colocate_balance`

기본값：false

IsMutable：true

MasterOnly：true

true로 설정하면 colocate 테이블의 자동 재배치와 균형 조정을 비활성화할 수 있습니다. 'disable_colocate_balance'가 true이면 ColocateTableBalancer가 colocate 테이블을 재배치하거나 균형 조정하지 않습니다.

주의:

일반적으로 균형 조정을 끌 필요는 없습니다.
균형 조정을 끄면 불안정한 colocate 테이블이 복구되지 않을 수 있습니다.
결국 쿼리에서 colocate 계획을 사용하지 못할 수 있습니다.

`balance_slot_num_per_path`

기본값: 1

IsMutable：true

MasterOnly：true

균형 조정 중 경로당 기본 슬롯 수입니다.

`disable_tablet_scheduler`

기본값:false

IsMutable：true

MasterOnly：true

true이면 태블릿 스케줄러가 작동하지 않으므로 모든 태블릿 복구 및 균형 조정 작업이 실행되지 않습니다.

`enable_force_drop_redundant_replica`

기본값: false

동적 설정 가능 여부: true

Master FE 전용 여부: true

true이면 시스템이 태블릿 스케줄링 과정에서 불필요한 복제본을 즉시 삭제합니다. 해당 복제본에 쓰고 있는 일부 데이터 적재 작업은 실패할 수 있지만 태블릿 균형 조정과 복구가 빨라집니다. 클러스터에 균형 조정이나 복구를 기다리는 복제본이 많다면 일부 데이터 적재의 성공률을 희생하여 복제본 균형 조정과 복구를 앞당기기 위해 이 설정을 사용할 수 있습니다.

`colocate_group_relocate_delay_second`

기본값: 1800

동적 설정 가능 여부: true

Master FE 전용 여부: true

colocation 그룹을 재배치하면 클러스터 내에서 많은 태블릿이 이동할 수 있습니다. 따라서 가능한 한 재배치를 피하도록 신중한 전략을 사용해야 합니다. 재배치는 보통 BE 노드가 오프라인 상태가 되거나 중지된 후에 발생합니다. 이 매개변수는 BE 노드를 사용할 수 없다고 판단하는 시점을 늦춥니다. 기본값은 30분으로, BE 노드가 30분 안에 복구되면 colocation 그룹 재배치를 시작하지 않습니다.

`allow_replica_on_same_host`

기본값: false

동적 설정 가능 여부: false

Master FE 전용 여부: false

같은 태블릿의 여러 복제본을 동일한 호스트에 배치하도록 허용할지 지정합니다. 주로 로컬 테스트에서 여러 BE를 구성하여 다중 복제본 상황을 시험할 때 사용합니다. 테스트 이외의 환경에서는 사용하지 마세요.

`repair_slow_replica`

기본값: false

IsMutable：true

MasterOnly: true

true이면 compaction이 느린 복제본을 자동으로 감지하여 다른 머신으로 이동합니다. 가장 빠른 복제본의 버전 수가 min_version_count_indicate_replica_compaction_too_slow 값을 초과하고, 가장 빠른 복제본과의 버전 수 차이 비율이 valid_version_count_delta_ratio_between_replicas 값을 초과하면 감지 조건을 충족합니다.

`min_version_count_indicate_replica_compaction_too_slow`

기본값: 200

동적 설정 가능 여부: true

Master FE 전용 여부: false

복제본의 compaction이 너무 느린지 판단하는 데 사용하는 버전 수 임계값입니다.

`skip_compaction_slower_replica`

기본값: true

동적 설정 가능 여부: true

Master FE 전용 여부: false

true이면 쿼리 가능한 복제본을 선택할 때 compaction이 느린 복제본을 건너뜁니다.

`valid_version_count_delta_ratio_between_replicas`

기본값: 0.5

동적 설정 가능 여부: true

Master FE 전용 여부: true

가장 느린 복제본과 가장 빠른 복제본의 버전 수 차이에 대한 유효 비율 임계값입니다. repair_slow_replica가 true일 때 가장 느린 복제본을 복구할지 결정하는 데 사용합니다.

`min_bytes_indicate_replica_too_large`

기본값: 2 * 1024 * 1024 * 1024 (2G)

동적 설정 가능 여부: true

Master FE 전용 여부: true

복제본이 너무 큰지 판단하는 데이터 크기 임계값입니다.

`schedule_slot_num_per_hdd_path`

기본값：4

태블릿 스케줄러에서 HDD 경로당 기본 슬롯 수입니다. 이 설정을 제거하고 복제 작업 통계에 따라 동적으로 조정합니다.

`schedule_slot_num_per_ssd_path`

기본값：8

태블릿 스케줄러에서 SSD 경로당 기본 슬롯 수입니다. 이 설정을 제거하고 복제 작업 통계에 따라 동적으로 조정합니다.

`tablet_repair_delay_factor_second`

기본값：60 （s）

IsMutable：true

MasterOnly：true

태블릿 복구를 결정하기 전 지연 시간의 계수입니다.

우선순위가 VERY_HIGH이면 즉시 복구합니다.
HIGH이면 tablet_repair_delay_factor_second * 1만큼 지연합니다.
NORMAL이면 tablet_repair_delay_factor_second * 2만큼 지연합니다.
LOW이면 tablet_repair_delay_factor_second * 3만큼 지연합니다.

`tablet_stat_update_interval_second`

기본값：300（5min）

태블릿 통계의 업데이트 간격입니다. 모든 Frontend가 각 간격마다 모든 Backend에서 태블릿 통계를 가져옵니다.

`storage_flood_stage_usage_percent`

기본값：95 （95%）

IsMutable：true

MasterOnly：true

`storage_flood_stage_left_capacity_bytes`

기본값：1 * 1024 * 1024 * 1024 (1GB)

IsMutable：true

MasterOnly：true

디스크 용량이 'storage_flood_stage_usage_percent'와 'storage_flood_stage_left_capacity_bytes'의 기준에 도달하면 다음 작업을 거부합니다.

데이터 적재 작업
복원 작업

`storage_high_watermark_usage_percent`

기본값：85 (85%)

IsMutable：true

MasterOnly：true

`storage_min_left_capacity_bytes`

기본값： 2 * 1024 * 1024 * 1024 (2GB)

IsMutable：true

MasterOnly：true

'storage_high_watermark_usage_percent'는 Backend 스토리지 경로의 최대 용량 사용률을 제한합니다. 'storage_min_left_capacity_bytes'는 Backend 스토리지 경로에 남아 있어야 하는 최소 용량을 제한합니다. 두 제한에 모두 도달하면 해당 경로를 태블릿 균형 조정의 대상으로 선택할 수 없습니다. 다만 데이터 무결성을 최대한 유지하기 위해 태블릿 복구 시에는 제한을 초과할 수 있습니다.

`catalog_trash_expire_second`

기본값: 86400L (1일)

IsMutable：true

MasterOnly：true

데이터베이스(테이블/파티션)를 삭제한 후 RECOVER 문으로 복구할 수 있습니다. 이 설정은 데이터를 유지하는 최대 시간을 지정하며, 시간이 지나면 데이터가 영구적으로 삭제됩니다.

`default_storage_medium`

기본값：HDD

테이블 또는 파티션을 생성할 때 스토리지 매체(HDD 또는 SSD)를 지정할 수 있습니다. 지정하지 않으면 이 기본 매체를 사용합니다.

`default_compression_type`

기본값: LZ4F (4.0.3 이전), ZSTD (4.0.3부터)

테이블을 생성할 때 압축 알고리즘을 지정할 수 있습니다. 지정하지 않으면 이 기본 압축 형식을 사용합니다. 유효한 값은 LZ4, LZ4F, LZ4HC, ZLIB, ZSTD, SNAPPY, NONE이며 대소문자를 구분하지 않습니다.

`enable_storage_policy`

Storage Policy 기능을 활성화할지 지정합니다. 이 설정으로 자주 사용하는 데이터와 그렇지 않은 데이터를 분리할 수 있습니다. 기본값: false

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

`check_consistency_default_timeout_second`

기본값: 600 (10분)

IsMutable：true

MasterOnly：true

단일 일관성 검사 작업의 기본 제한 시간입니다. 태블릿 크기를 처리하기에 충분히 길게 설정하세요.

`consistency_check_start_time`

기본값：23

IsMutable：true

MasterOnly：true

일관성 검사 시작 시간입니다.

일관성 검사기는 consistency_check_start_time부터 consistency_check_end_time까지 실행됩니다.

두 시간이 같으면 일관성 검사가 시작되지 않습니다.

`consistency_check_end_time`

기본값：23

IsMutable：true

MasterOnly：true

일관성 검사 종료 시간입니다.

일관성 검사기는 consistency_check_start_time부터 consistency_check_end_time까지 실행됩니다.

두 시간이 같으면 일관성 검사가 시작되지 않습니다.

`replica_delay_recovery_second`

기본값：0

IsMutable：true

MasterOnly：true

복제본에 장애가 발생한 시점부터 FE가 clone으로 복구를 시도하기까지의 최소 지연 시간(초)입니다.

`tablet_create_timeout_second`

기본값：1（s）

IsMutable：true

MasterOnly：true

단일 복제본 생성을 기다리는 최대 시간입니다.

예: 태블릿이 #m개이고 각 태블릿의 복제본이 #n개인 테이블을 생성하면, 테이블 생성 요청은 시간 초과 전 최대 (m n tablet_create_timeout_second) 동안 실행됩니다.

`tablet_delete_timeout_second`

기본값：2

IsMutable：true

MasterOnly：true

tablet_create_timeout_second와 같은 의미이지만 태블릿 삭제 시 사용합니다.

`delete_job_max_timeout_second`

기본값: 300(s)

Mutable: true

Master only: true

삭제 작업의 최대 제한 시간(초)입니다.

`alter_table_timeout_second`

기본값: 86400 * 30 (1개월)

IsMutable：true

MasterOnly：true

ALTER TABLE 요청의 최대 제한 시간입니다. 테이블 데이터 크기를 처리하기에 충분히 길게 설정하세요.

`max_replica_count_when_schema_change`

OlapTable에서 스키마 변경을 수행할 때 허용되는 최대 복제본 수입니다. 복제본이 너무 많으면 FE에서 OOM이 발생할 수 있습니다.

기본값: 100000

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

`history_job_keep_max_second`

기본값：7 * 24 * 3600 （7일）

IsMutable：true

MasterOnly：true

스키마 변경 작업, Rollup 작업 등 일부 작업 유형의 최대 보관 시간입니다.

`max_create_table_timeout_second`

기본값：60 （s）

IsMutable：true

MasterOnly：true

테이블(인덱스) 생성을 너무 오래 기다리지 않도록 최대 제한 시간을 설정합니다.

`autobucket_min_buckets`

기본값: 3 (4.0.8 / 4.1.4 이전에는 1)

IsMutable: true

MasterOnly: true

자동 버킷 전략(DISTRIBUTED BY ... BUCKETS AUTO)이 생성하는 최소 버킷 수입니다.

Doris 4.0 계열의 버전 4.0.8과 4.1 계열의 버전 4.1.4부터 기본값이 1에서 3으로 변경되었습니다. 이전 기본값에서는 작은 파티션이 단일 버킷으로 처리되어 병렬성과 데이터 분산이 부족했습니다. 변경 후에는 자동 버킷 전략이 3개 미만의 버킷을 생성하지 않습니다. 이 변경은 새로 생성되는 파티션에만 적용되며 기존 파티션의 버킷 수는 바뀌지 않습니다.

`autobucket_max_buckets`

기본값: 128

IsMutable: true

MasterOnly: true

자동 버킷 전략이 생성하는 최대 버킷 수입니다. 계산 결과가 이 값보다 크면 이 값으로 제한합니다.

외부 테이블

`jdbc_driver_url_white_list`

기본값: empty

동적 설정 가능 여부: false

JDBC Catalog를 생성할 때 허용되는 driver_url 값의 허용 목록입니다. 여러 값은 쉼표로 구분합니다. 예: jdbc_driver_url_white_list=a,b,c. 빈 값이면 허용 목록이 설정되지 않은 것입니다.

동작 변경(4.1.4)

`force_sqlserver_jdbc_encrypt_false`

기본값: false

동적 설정 가능 여부: false

SQLServer JDBC Catalog의 encrypt 매개변수를 강제로 false로 설정할지 지정합니다.

동작 변경(4.1.4)

이 설정은 SQLServer JDBC의 전송 암호화를 끄므로 보안에 민감합니다. 버전 4.1.4부터 더 이상 동적으로 변경할 수 없으며, fe.conf에서만 설정할 수 있고 FE를 다시 시작한 후 적용됩니다.

`file_scan_node_split_num`

기본값：128

IsMutable：true

MasterOnly：false

여러 Catalog에서 동시에 파일을 스캔하는 스레드 수입니다.

`file_scan_node_split_size`

기본값：256 * 1024 * 1024

IsMutable：true

MasterOnly：false

여러 Catalog에서 동시에 파일을 스캔하는 크기입니다.

`enable_odbc_mysql_broker_table`

기본값：false

IsMutable：true

MasterOnly：false

버전 2.1부터 ODBC, JDBC, broker 외부 테이블 생성을 지원하지 않습니다. ODBC와 MySQL 외부 테이블은 JDBC 테이블 또는 JDBC Catalog를 사용하세요. broker 테이블은 테이블 값 함수를 사용하세요.

`max_hive_partition_cache_num`

Hive 파티션의 최대 캐시 수입니다.

기본값: 100000

동적 설정 가능 여부: false

Master FE 노드 전용 설정 항목 여부: false

`hive_metastore_client_timeout_second`

Hive Metastore의 기본 연결 제한 시간입니다.

기본값: 10

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

`max_external_cache_loader_thread_pool_size`

외부 메타데이터 캐시를 적재하는 스레드 풀의 최대 크기입니다.

기본값: 10

동적 설정 가능 여부: false

Master FE 노드 전용 설정 항목 여부: false

`max_external_file_cache_num`

외부 테이블에서 사용할 파일 캐시의 최대 수입니다.

기본값: 100000

동적 설정 가능 여부: false

Master FE 노드 전용 설정 항목 여부: false

`max_external_schema_cache_num`

외부 테이블에서 사용할 스키마 캐시의 최대 수입니다.

기본값: 10000

동적 설정 가능 여부: false

Master FE 노드 전용 설정 항목 여부: false

`external_cache_expire_time_minutes_after_access`

마지막 접근 후 캐시 데이터가 만료되기까지의 시간을 분 단위로 설정합니다. External Schema Cache와 Hive Partition Cache 모두에 적용됩니다.

기본값: 1440

동적 설정 가능 여부: false

Master FE 노드 전용 설정 항목 여부: false

`es_state_sync_interval_second`

기본값：10

FE는 es_state_sync_interval_secs마다 es API를 호출하여 es 인덱스 샤드 정보를 가져옵니다.

외부 리소스

`ai_resource_allowed_user`

기본값: *

동적 설정 가능 여부: false

Master FE 노드 전용 설정 항목 여부: false

버전 4.1.5부터 지원합니다. AI Resource를 생성할 수 있는 사용자 ID를 제한합니다. *는 사용자 ID를 제한하지 않지만 기존 권한 검사는 계속 적용됩니다. 다른 값은 'user'@'host' 형식을 사용하며 현재 사용자 ID와 일치해야 합니다. 변경 사항을 적용하려면 FE를 다시 시작해야 합니다.

`dpp_hadoop_client_path`

기본값：/lib/hadoop-client/hadoop/bin/hadoop

`dpp_bytes_per_reduce`

기본값：100 * 1024 * 1024L (100M)

`dpp_default_cluster`

기본값：palo-dpp

`dpp_default_config_str`

기본값：{ hadoop_configs : 'mapred.job.priority=NORMAL;mapred.job.map.capacity=50;mapred.job.reduce.capacity=50;mapred.hce.replace.streaming=false;abaci.long.stored.job=true;dce.shuffle.enable=false;dfs.client.authserver.force_stop=true;dfs.client.auth.method=0' }

`dpp_config_str`

기본값：{ palo-dpp : { hadoop_palo_path : '/dir', hadoop_configs : 'fs.default.name=hdfs://host:port;mapred.job.tracker=host:port;hadoop.job.ugi=user,password' } }

`yarn_config_dir`

기본값: DorisFE.DORIS_HOME_DIR + "/lib/yarn-config"

기본 yarn 설정 파일 디렉터리입니다. yarn 명령을 실행할 때마다 이 경로에 설정 파일이 있는지 확인하고, 없으면 생성해야 합니다.

`yarn_client_path`

기본값：DORIS_HOME_DIR + "/lib/yarn-client/hadoop/bin/yarn"

기본 yarn 클라이언트 경로입니다.

`spark_launcher_log_dir`

기본값： sys_log_dir + "/spark_launcher_log"

지정된 Spark 실행기 로그 디렉터리입니다.

`spark_resource_path`

기본값：none

Spark 의존성 파일의 기본 경로입니다.

`spark_home_default_dir`

기본값：DORIS_HOME_DIR + "/lib/spark2x"

기본 Spark 홈 디렉터리입니다.

`spark_dpp_version`

기본값: 1.0.0

기본 Spark DPP 버전입니다.

기타

`tmp_dir`

기본값: DorisFE.DORIS_HOME_DIR + "/temp_dir"

백업 및 복원 과정 같은 일부 프로세스의 중간 결과를 저장하는 임시 디렉터리입니다. 프로세스가 완료되면 이 디렉터리의 파일을 정리합니다.

`custom_config_dir`

기본값: DorisFE.DORIS_HOME_DIR + "/conf"

사용자 지정 설정 파일 디렉터리입니다.

fe_custom.conf 파일의 위치를 지정합니다. 기본 위치는 conf/ 디렉터리입니다.

일부 배포 환경에서는 시스템 업그레이드 중 conf/ 디렉터리가 덮어써질 수 있습니다. 그러면 사용자가 변경한 설정 항목도 덮어써집니다. 이 경우 fe_custom.conf를 별도로 지정한 디렉터리에 저장하면 설정 파일이 덮어써지는 일을 막을 수 있습니다.

`plugin_dir`

기본값：DORIS_HOME + "/plugins

플러그인 설치 디렉터리입니다.

`plugin_enable`

기본값:true

IsMutable：true

MasterOnly：true

플러그인 활성화 여부입니다. 기본적으로 활성화됩니다.

`small_file_dir`

기본값：DORIS_HOME_DIR/small_files

작은 파일을 저장합니다.

`max_small_file_size_bytes`

기본값：1M

IsMutable：true

MasterOnly：true

SmallFileMgr에 저장하는 단일 파일의 최대 크기입니다.

`max_small_file_number`

기본값：100

IsMutable：true

MasterOnly：true

SmallFileMgr에 저장하는 파일의 최대 수입니다.

`enable_metric_calculator`

기본값：true

true이면 메트릭 수집기가 데몬 타이머로 실행되어 일정한 간격으로 메트릭을 수집합니다.

`report_queue_size`

기본값： 100

IsMutable：true

MasterOnly：true

FE에 보고 작업이 너무 많이 쌓여 OOM 예외가 발생하는 일을 막기 위한 임계값입니다. 예를 들어 Backend가 100개이고 복제본이 천만 개 있는 대규모 Doris 클러스터에서는 파티션 삭제 같은 메타데이터 변경 후 태블릿 보고를 처리하는 데 몇 초가 걸릴 수 있습니다. Backend는 1분마다 태블릿 정보를 보고하므로 보고를 무제한으로 받는 것은 적절하지 않습니다. 향후 태블릿 보고 처리 속도를 개선할 예정이지만 현재는 큐 크기가 제한을 넘으면 보고를 버립니다. 실제 환경에서 측정한 일부 소요 시간: 1. 디스크 보고: 0-1 msta 2. sk 보고: 0-1 ms 3. 태블릿 보고 4. 복제본 10000개: 200ms

`backup_job_default_timeout_ms`

기본값: 86400 * 1000 (1일)

IsMutable：true

MasterOnly：true

백업 작업의 기본 제한 시간입니다.

`backup_upload_snapshot_batch_size`

기본값：10

IsMutable：true

MasterOnly：true

백업 중 업로드 태스크 하나에 할당하는 스냅샷의 최대 수입니다. 기본값은 10입니다.

`restore_download_snapshot_batch_size`

기본값：10

IsMutable：true

MasterOnly：true

복원 중 다운로드 태스크 하나에 할당하는 스냅샷의 최대 수입니다. 기본값은 10입니다.

`max_backup_restore_job_num_per_db`

기본값: 10

주로 각 데이터베이스에 기록하는 백업 및 복원 작업의 수를 제어합니다.

`max_backup_tablets_per_job`

기본값: 300000

IsMutable：true

MasterOnly：true

메타데이터를 지나치게 많이 저장하여 FE OOM이 발생하지 않도록 백업 작업당 포함할 수 있는 최대 태블릿 수를 제어합니다.

`enable_quantile_state_type`

기본값：false

IsMutable：true

MasterOnly：true

quantile_state 데이터 형식을 활성화할지 지정합니다.

`enable_date_conversion`

기본값：true

IsMutable：true

MasterOnly：true

FE가 date/datetime을 datev2/datetimev2(0)으로 자동 변환합니다.

`enable_decimal_conversion`

기본값：true

IsMutable：true

MasterOnly：true

FE가 DecimalV2를 DecimalV3으로 자동 변환합니다.

`proxy_auth_magic_prefix`

기본값：x@8

`proxy_auth_enable`

기본값：false

`enable_func_pushdown`

기본값：true

IsMutable：true

MasterOnly：false

ODBC 및 JDBC 외부 테이블 쿼리를 실행할 때 함수가 포함된 필터 조건을 MySQL로 푸시다운할지 지정합니다.

`jdbc_drivers_dir`

기본값: ${DORIS_HOME}/jdbc_drivers;

IsMutable：false

MasterOnly：false

JDBC 드라이버를 저장하는 기본 디렉터리입니다.

`max_error_tablet_of_broker_load`

기본값: 3;

IsMutable：true

MasterOnly：true

broker 데이터 적재에서 표시할 오류 태블릿의 최대 수입니다.

`default_db_max_running_txn_num`

기본값：-1

IsMutable：true

MasterOnly：true

기본 데이터베이스 트랜잭션 할당량을 설정합니다.

기본값 -1은 default_db_max_running_txn_num 대신 max_running_txn_num_per_db를 사용한다는 뜻입니다.

개별 데이터베이스의 할당량을 설정하려면 다음을 사용합니다.

Set the database transaction quota
ALTER DATABASE db_name SET TRANSACTION QUOTA quota;
View configuration
show data （Detail：HELP SHOW DATA）

`prefer_compute_node_for_external_table`

기본값：false

IsMutable：true

MasterOnly：false

true이면 외부 테이블의 쿼리를 컴퓨팅 노드에 우선 할당합니다. 컴퓨팅 노드의 최대 수는 min_backend_num_for_external_table로 제어합니다. false이면 외부 테이블의 쿼리를 아무 노드에나 할당합니다.

`min_backend_num_for_external_table`

기본값：3

IsMutable：true

MasterOnly：false

prefer_compute_node_for_external_table이 true일 때만 적용됩니다. 컴퓨팅 노드 수가 이 값보다 적으면 외부 테이블의 쿼리를 일부 혼합 노드에도 할당하여 전체 노드 수가 이 값에 도달하도록 시도합니다. 컴퓨팅 노드 수가 이 값보다 많으면 컴퓨팅 노드에만 할당합니다.

`infodb_support_ext_catalog`

기본값: false

IsMutable: true

MasterOnly: false

false이면 information_schema 데이터베이스의 테이블을 조회한 결과에 외부 Catalog의 테이블 정보가 포함되지 않습니다. 외부 Catalog에 접근할 수 없을 때 쿼리 시간이 길어지는 일을 피하기 위한 설정입니다.

`enable_query_hit_stats`

기본값: false

IsMutable: true

MasterOnly: false

쿼리 적중 통계를 활성화할지 제어합니다. 기본값은 false입니다.

`div_precision_increment`

기본값: 4

이 변수는 / 연산자로 수행한 나눗셈 결과의 소수 자릿수를 얼마나 늘릴지 나타냅니다.

`enable_convert_light_weight_schema_change`

기본값：true

임시 설정입니다. 활성화하면 백그라운드 스레드가 시작되어 모든 OLAP 테이블을 경량 스키마 변경 방식으로 자동 전환합니다. show convert_light_schema_change [from db] 명령으로 변경 결과를 확인할 수 있으며, 경량 스키마 변경 방식을 사용하지 않던 모든 테이블의 전환 결과가 표시됩니다.

`disable_local_deploy_manager_drop_node`

기본값：true

cluster.info 파일의 오류로 노드가 삭제되지 않도록 LocalDeployManager의 노드 삭제를 금지합니다.

`mysqldb_replace_name`

기본값: mysql

MySQL 생태계와의 호환성을 위해 Doris에는 mysql이라는 내장 데이터베이스가 있습니다. 이 데이터베이스가 사용자 데이터베이스와 충돌하면 이 필드를 변경하여 Doris 내장 MySQL 데이터베이스의 이름을 다른 이름으로 바꾸세요.

`max_auto_partition_num`

기본값: 2000

자동 파티션 테이블에서 사용자가 실수로 많은 파티션을 생성하지 않도록 OLAP 테이블당 허용되는 파티션 수를 max_auto_partition_num으로 제한합니다. 기본값은 2000입니다.

`profile_manager_gc_interval_seconds`

기본값: 1

ProfileManager의 프로필 가비지 컬렉션 간격을 제어합니다. 가비지 컬렉션 중에는 메모리를 절약하기 위해 ProfileManager가 메모리와 디스크에서 초과하거나 만료된 프로필을 제거합니다.

컴퓨팅 및 스토리지 분리 모드

`cloud_edit_log_roll_interval_second`

기본값: 3600 (초)

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

버전 4.1.5부터 지원합니다. 컴퓨팅 및 스토리지 분리 모드에서 시간 기준으로 Edit Log를 순환하는 간격입니다. 메타데이터 쓰기 빈도가 낮아도 주기적인 체크포인트를 진행할 수 있게 합니다. 간격은 로그 항목을 추가할 때 확인하므로 새 항목이 없을 때 독립적인 타이머가 순환을 강제하지는 않습니다. 0 이하의 값은 시간 기준 순환을 비활성화합니다. 로그 항목 수에 따른 순환은 계속 활성화됩니다.

`cloud_version_syncer_interval_second`

기본값: 60 (초, 4.1.5 이전에는 20)

동적 설정 가능 여부: false

Master FE 노드 전용 설정 항목 여부: false

컴퓨팅 및 스토리지 분리 모드에서 모든 FE가 백그라운드에서 테이블과 파티션 버전을 동기화하는 간격입니다. 백그라운드 동기화에는 cloud_enable_version_syncer=true와 Long.MAX_VALUE로 설정된 전역/기본 테이블 또는 파티션 버전 캐시 TTL이 하나 이상 필요합니다. 유한한 TTL의 캐시는 읽을 때 지연 갱신됩니다. 버전 4.1.5에서는 Meta Service 요청을 줄이기 위해 기본 간격을 20초에서 60초로 늘렸습니다. 변경 사항을 적용하려면 FE를 다시 시작해야 합니다.

`cloud_get_version_task_batch_size`

기본값: 200 (4.1.5 이전에는 2000)

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: false

컴퓨팅 및 스토리지 분리 모드의 버전 동기화 중 Get Version 배치 하나에 포함할 수 있는 테이블 또는 파티션의 최대 수입니다. 버전 4.1.5에서는 요청 크기를 줄이기 위해 기본값을 2000에서 200으로 낮췄습니다.

`cloud_version_syncer_get_version_retry_times`

기본값: 3

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: false

버전 4.1.5부터 지원합니다. 컴퓨팅 및 스토리지 분리 모드의 백그라운드 동기화 중 테이블 또는 파티션 버전을 가져오려고 시도하는 최대 횟수이며 첫 요청도 포함합니다. 기본값은 첫 요청 이후 3번 재시도하는 것이 아니라 총 3번 시도한다는 뜻입니다. 이 설정은 포그라운드 쿼리의 Meta Service RPC 재시도 설정과 독립적입니다.

`cloud_warm_up_job_scheduler_interval_millisecond`

기본값: 1000 (밀리초)

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

캐시 워밍 작업의 스케줄링 간격입니다. 버전 4.1.5부터 동적 변경 시 0보다 큰 값이 필요하며, 그렇지 않으면 cloud_warm_up_job_scheduler_interval_millisecond must be greater than 0을 반환합니다.

`max_active_cloud_warm_up_job`

기본값: 10

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: true

동시에 스케줄링되는 캐시 워밍 작업의 수입니다. 버전 4.1.5부터 동적으로 값을 변경하면 워밍 실행자의 크기도 조정됩니다. 0 이하의 값은 새 워밍 작업의 스케줄링을 일시 중지합니다.

`cluster_id`

기본값：-1

노드(FE 또는 BE)의 클러스터 ID가 같으면 동일한 Doris 클러스터에 속하는 것으로 간주합니다. 컴퓨팅 및 스토리지 분리 모드에서는 임의의 정수를 하나 지정해야 합니다.

`deploy_mode`

기본값: ""

설명: FE가 실행되는 모드입니다. cloud는 스토리지와 컴퓨팅이 분리된 모드를 나타냅니다.

`meta_service_endpoint`

기본값: ""

Meta Service 엔드포인트는 'host1:port,host2:port' 형식으로 지정해야 합니다. 컴퓨팅 및 스토리지 분리 모드에서 필요한 설정입니다.

`enable_group_commit_streamload_be_forward`

기본값: false

IsMutable: true

컴퓨팅 및 스토리지 분리 모드에서 Group Commit을 위한 Stream Load BE 전달을 활성화할지 지정합니다. 분리 모드이며 요청에서 Group Commit을 사용할 때만 적용됩니다.

활성화하면 FE가 Stream Load 요청을 _stream_load_forward 엔드포인트로 리디렉션하고, 요청을 받은 BE가 해당 테이블의 대상 BE로 전달합니다. 이를 통해 로드 밸런서가 같은 테이블의 Group Commit 배치 요청을 분산시키지 않도록 합니다.

FE와 BE 양쪽에서 같은 이름의 설정을 활성화해야 합니다. Doris 4.0 계열의 버전 4.0.8과 4.1 계열의 버전 4.1.4부터 BE 측 _stream_load_forward 엔드포인트는 BE 설정에 따라 제어됩니다. 비활성화되어 있으면 403 Forbidden을 반환하며, 활성화된 후에는 요청이 인증을 통과하고 전역 LOAD 권한을 보유해야 합니다. Group Commit과 BE 설정을 참조하세요.

`default_get_version_from_ms_timeout_second`

기본값: 30 (s)

동적 설정 가능 여부: false

FE가 Meta Service에서 버전을 가져올 때의 제한 시간입니다.

동작 변경(4.1.4)

버전 4.1.4에서 기본값이 3초에서 30초로 변경되었습니다. 이전에는 Meta Service에 일시적인 지연이 생기거나 부하가 높을 때 3초 제한 시간으로 인해 쿼리가 쉽게 실패했습니다. 값이 커지면서 이러한 간헐적인 실패가 크게 줄어듭니다.

`enable_cloud_replica_stale_route_clean`

기본값: true

동적 설정 가능 여부: true

버전 4.1.4에 추가되었습니다. 메타데이터 이미지를 로드할 때와 태블릿 균형 조정 주기 중, 더 이상 존재하지 않는 Backend를 가리키는 CloudReplica의 기본 및 보조 경로 기록을 정리할지 지정합니다.

이러한 오래된 기록은 쿼리 시 이미 무시되며 복제본을 다시 해시하여 Backend에 배치합니다. 따라서 기록은 FE 메모리와 메타데이터 이미지 크기만 낭비합니다. 정리하지 않던 기존 동작을 유지하려면 false로 설정합니다.

`enable_cloud_colocate_consistent_hash`

기본값: true

동적 설정 가능 여부: false

Master FE 노드 전용 설정 항목 여부: true

버전 4.1.4에 추가되었습니다. 컴퓨팅 및 스토리지 분리 모드의 colocate 테이블에서 버킷 배치에 rendezvous 일관 해싱을 사용할지 지정합니다. false이면 이전의 모듈로 기반 배치로 돌아갑니다. fe.conf에서만 설정할 수 있으며 다시 시작한 후 적용됩니다.

`meta_service_rpc_rate_limit_enabled`

기본값: true (4.1.5 이전에는 false)

동적 설정 가능 여부: true

버전 4.1.4에 추가되었습니다. FE에서 Meta Service로 보내는 RPC의 QPS 속도 제한을 평가할지 지정합니다. 버전 4.1.5부터 meta_service_rpc_rate_limit_dry_run과 함께 기본적으로 활성화됩니다. 따라서 기본 동작에서는 요청을 지연하거나 거부하지 않고 예상 대기 및 거부만 기록합니다. 속도 제한을 실제로 적용하려면 이 설정을 true로 유지하고 dry-run을 false로 설정합니다.

`meta_service_rpc_rate_limit_dry_run`

기본값: true

동적 설정 가능 여부: true

Master FE 노드 전용 설정 항목 여부: false

버전 4.1.5부터 지원합니다. meta_service_rpc_rate_limit_enabled=true일 때만 적용됩니다. true이면 요청을 기다리게 하거나 거부하지 않고 속도 제한을 평가하여 메트릭을 기록합니다. false이면 설정된 QPS, 버스트 창, 대기 제한 시간을 적용합니다. dry-run 모드의 대기 메트릭은 예상 대기 시간을 나타냅니다.

`meta_service_rpc_rate_limit_default_qps_per_core`

기본값: 50

동적 설정 가능 여부: true

버전 4.1.4에 추가되었습니다. meta_service_rpc_rate_limit_qps_per_core_config에서 개별 설정하지 않은 Meta Service RPC 메서드에 허용하는 CPU 코어당 기본 QPS입니다. 값이 0 이하이면 속도를 제한하지 않습니다.

`meta_service_rpc_rate_limit_qps_per_core_config`

기본값: getPartitionVersion:500;getTableVersion:500;getTabletStats:50;beginTxn:50

동적 설정 가능 여부: true

버전 4.1.4에 추가되었습니다. Meta Service RPC 메서드별 코어당 QPS 제한을 method1:qps1;method2:qps2 형식으로 지정합니다. 값이 0 이하이면 해당 메서드의 속도를 제한하지 않습니다.

`meta_service_rpc_rate_limit_burst_seconds`

기본값: 2 (s)

동적 설정 가능 여부: true

버전 4.1.4에 추가되었습니다. Meta Service RPC 속도 제한에서 버스트 창의 길이(초)입니다. 장기 평균 QPS는 그대로 유지하면서 이 창 안에서 버스트를 허용합니다.

`meta_service_rpc_rate_limit_wait_timeout_ms`

기본값: 1000 (ms)

동적 설정 가능 여부: true

버전 4.1.4에 추가되었습니다. RPC에 속도 제한이 적용될 때 기다리는 최대 시간(밀리초)입니다. 0이면 기다리지 않고 요청이 즉시 실패합니다.

Report issue

이 페이지의 내용

설정 항목 조회
설정 항목 지정
예시
설정 항목

설정 항목 조회​

설정 항목 지정​

예시​

설정 항목​

메타데이터와 클러스터​

meta_dir​

catalog_try_lock_timeout_ms​

enable_bdbje_debug_mode​

max_bdbje_clock_delta_ms​

metadata_failure_recovery​

txn_rollback_limit​

grpc_threadmgr_threads_nums​

bdbje_replica_ack_timeout_second​

bdbje_lock_timeout_second​

bdbje_heartbeat_timeout_second​

replica_ack_policy​

replica_sync_policy​

master_sync_policy​

bdbje_reserved_disk_bytes​

ignore_meta_check​

meta_delay_toleration_second​

edit_log_port​

edit_log_type​

edit_log_roll_num​

force_do_metadata_checkpoint​

metadata_checkpoint_memory_threshold​

max_same_name_catalog_trash_num​

cluster_id​

heartbeat_mgr_blocking_queue_size​

heartbeat_mgr_threads_num​

disable_cluster_feature​

enable_fqdn_mode​

enable_token_check​

fe_meta_auth_token​

enable_multi_tags​

initial_root_password​

enable_cooldown_replica_affinity​

TSO (Timestamp Oracle)​

서비스​

arrow_flight_deferred_query_idle_timeout_second​

query_port​

arrow_flight_sql_port​

frontend_address​

priority_networks​

http_port​

https_port​

enable_https​

enable_ssl​

qe_max_connection​

check_java_version​

rpc_port​

thrift_server_type​

thrift_server_max_worker_threads​

thrift_backlog_num​

thrift_client_timeout_ms​

thrift_max_message_size​

use_compact_thrift_rpc​

grpc_max_message_size_bytes​

max_mysql_service_task_threads_num​

mysql_service_io_threads_num​

mysql_nio_backlog_num​

broker_timeout_ms​

backend_rpc_timeout_ms​

drop_backend_after_decommission​

max_backend_down_time_second​

disable_backend_black_list​

max_backend_heartbeat_failure_tolerance_count​

abort_txn_after_lost_heartbeat_time_second​

enable_access_file_without_broker​

agent_task_resend_wait_time_ms​

max_agent_task_threads_num​

remote_fragment_exec_timeout_ms​

auth_token​

enable_http_server_v2​

http_api_extra_base_path​

jetty_server_acceptors​

jetty_server_selectors​

jetty_server_workers​

jetty_server_max_http_post_size​

jetty_server_max_http_header_size​

설정 항목 조회

설정 항목 지정

예시

설정 항목

메타데이터와 클러스터

`meta_dir`

`catalog_try_lock_timeout_ms`

`enable_bdbje_debug_mode`

`max_bdbje_clock_delta_ms`

`metadata_failure_recovery`

`txn_rollback_limit`

`grpc_threadmgr_threads_nums`

`bdbje_replica_ack_timeout_second`

`bdbje_lock_timeout_second`

`bdbje_heartbeat_timeout_second`

`replica_ack_policy`

`replica_sync_policy`

`master_sync_policy`

`bdbje_reserved_disk_bytes`

`ignore_meta_check`

`meta_delay_toleration_second`

`edit_log_port`

`edit_log_type`

`edit_log_roll_num`

`force_do_metadata_checkpoint`

`metadata_checkpoint_memory_threshold`

`max_same_name_catalog_trash_num`

`cluster_id`

`heartbeat_mgr_blocking_queue_size`

`heartbeat_mgr_threads_num`

`disable_cluster_feature`

`enable_fqdn_mode`

`enable_token_check`

`fe_meta_auth_token`

`enable_multi_tags`

`initial_root_password`

`enable_cooldown_replica_affinity`

TSO (Timestamp Oracle)

서비스

`arrow_flight_deferred_query_idle_timeout_second`

`query_port`

`arrow_flight_sql_port`

`frontend_address`

`priority_networks`

`http_port`

`https_port`

`enable_https`

`enable_ssl`

`qe_max_connection`

`check_java_version`

`rpc_port`

`thrift_server_type`

`thrift_server_max_worker_threads`

`thrift_backlog_num`

`thrift_client_timeout_ms`

`thrift_max_message_size`

`use_compact_thrift_rpc`

`grpc_max_message_size_bytes`

`max_mysql_service_task_threads_num`

`mysql_service_io_threads_num`

`mysql_nio_backlog_num`

`broker_timeout_ms`

`backend_rpc_timeout_ms`

`drop_backend_after_decommission`

`max_backend_down_time_second`

`disable_backend_black_list`

`max_backend_heartbeat_failure_tolerance_count`

`abort_txn_after_lost_heartbeat_time_second`

`enable_access_file_without_broker`

`agent_task_resend_wait_time_ms`

`max_agent_task_threads_num`

`remote_fragment_exec_timeout_ms`

`auth_token`

`enable_http_server_v2`

`http_api_extra_base_path`

`jetty_server_acceptors`

`jetty_server_selectors`

`jetty_server_workers`

`jetty_server_max_http_post_size`

`jetty_server_max_http_header_size`