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

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 프로세스가 시작될 때 fe.conf의 설정 항목을 읽습니다. fe.conf에 없는 설정 항목에는 기본값을 사용합니다.
MySQL 프로토콜을 통한 동적 설정

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

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

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

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

이 방법으로 수정한 설정 항목은 FE 프로세스를 다시 시작하면 효력이 사라집니다.

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

자세한 내용은 설정 지정 작업을 참조하세요.

이 방법으로는 수정한 설정 항목을 영구 저장할 수도 있습니다. 설정 항목은 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에 쓸 때 복제본의 ack 타임아웃입니다. 비교적 큰 로그를 기록할 때 ack가 시간 내에 도착하지 않아 로그 쓰기가 실패할 수 있습니다. 이 경우 값을 적절히 늘릴 수 있습니다.

`bdbje_lock_timeout_second`

기본값：5

bdbje 작업의 잠금 타임아웃입니다. FE WARN 로그에 LockTimeoutException이 많이 발생하면 이 값을 늘려 볼 수 있습니다.

`bdbje_heartbeat_timeout_second`

기본값：30

Master와 Follower 사이의 bdbje 하트비트 타임아웃입니다. 기본값은 30초로 bdbje의 기본값과 같습니다. 일시적인 네트워크 문제나 예상치 못한 긴 Java GC로 문제가 발생하는 경우, 이 값을 늘려 잘못된 타임아웃 판단을 줄일 수 있습니다.

`replica_ack_policy`

기본값：SIMPLE_MAJORITY

옵션: ALL, NONE, SIMPLE_MAJORITY

bdbje의 복제본 ack 정책입니다. 자세한 내용은 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

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

`master_sync_policy`

기본값：SYNC

옵션：SYNC, NO_SYNC, WRITE_NO_SYNC

Master FE의 bdbje 동기화 정책입니다. Follower FE를 하나만 배포하는 경우 '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를 비교적 오랫동안 중지해야 하지만 비 Master FE가 계속 읽기 서비스를 제공하기를 원하는 경우 유용합니다.

`meta_delay_toleration_second`

기본값: 300 (5분)

메타데이터 지연 차이가 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로 설정하면 checkpoint 스레드가 JVM 메모리 사용률과 관계없이 checkpoint를 생성합니다.

`metadata_checkpoint_memory_threshold`

기본값：60 （60%）

IsMutable：true

MasterOnly：true

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

`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의 이름은 재생성 후에도 유지되지만, 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

서비스

`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 선택 전략을 지정합니다. 이 목록과 일치하는 IP는 최대 하나여야 합니다. 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를 지원합니다. 그 외에는 HTTP와 HTTPS를 모두 지원하며 HTTP 요청은 자동으로 HTTPS로 리디렉션됩니다. enable_https가 true이면 fe.conf에 SSL 인증서 정보를 설정해야 합니다.

`enable_ssl`

기본값：true

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

`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' 모델을 사용합니다. 이는 논블로킹 I/O 모델인 master-slave Reactor 모델로, 다수의 동시 연결 요청에 신속히 응답할 수 있으며 대부분의 상황에서 우수한 성능을 보입니다.

이 매개변수가 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 값을 영으로 설정합니다.

`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가 정상적으로 오프라인 상태가 된 후 BE 노드를 삭제합니다. false이면 BE가 정상적으로 오프라인 상태가 된 후에도 DECOMMISSION 상태로 유지되며 삭제되지 않습니다.

이 설정은 특정 상황에서 유용합니다. Doris 클러스터의 초기 상태가 BE 노드당 디스크 하나라고 가정합니다. 일정 기간 운영 후 수직 확장을 수행하여 각 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`

기본값：비어 있음

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

`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로 전달하여 HTTP 메시지 프로토콜의 파싱을 처리하게 하고, 마지막으로 workers가 요청을 처리합니다. 앞의 두 스레드 풀은 논블로킹 모델을 사용하므로 하나의 스레드가 여러 소켓의 읽기와 쓰기를 처리할 수 있어 필요한 스레드 수가 적습니다.

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

작업 스레드 풀은 기본적으로 설정되지 않습니다. 필요에 맞게 설정하세요.

`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)

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

쿼리 엔진

`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와 동일한 호스트에 있는 tablet 복제본을 선택하려고 시도합니다. 다음과 같은 경우 네트워크 전송량을 줄일 수 있습니다.

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

IsMutable：true

Colocate 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이면 count distinct를 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 문 처리 중 오류가 발생해도 사용자에게 label을 반환합니다. 사용자는 이 label로 데이터 적재 작업의 상태를 확인할 수 있습니다. 기본값은 false이며, INSERT 작업에서 오류가 발생하면 데이터 적재 label 없이 사용자 클라이언트에 예외를 직접 반환합니다.

`disable_load_job`

기본값：false

IsMutable：true

MasterOnly：true

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

대기 중인 모든 데이터 적재 작업은 begin txn API 호출 시 실패합니다.
prepare 상태의 모든 데이터 적재 작업은 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

show 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 Load 작업에서 Broker 스캐너가 처리할 수 있는 최대 바이트 수입니다. 일반적으로 각 Backend에는 Broker 스캐너가 하나씩 있습니다.

`default_load_parallelism`

기본값: 8

IsMutable：true

MasterOnly：true

단일 노드에서 Broker Load 실행 계획의 기본 병렬도입니다. 사용자가 Broker Load를 제출할 때 병렬도를 설정하면 이 매개변수는 무시됩니다. 이 매개변수는 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로 보내는 Routine Load 태스크 수를 제한하며, BE의 Routine Load 태스크 스레드 풀 크기인 BE 설정 'routine_load_thread_pool_size'(기본값 10)보다 작아야 합니다.

`max_routine_load_task_concurrent_num`

기본값：5

IsMutable：true

MasterOnly：true

단일 Routine Load 작업에서 동시에 실행할 수 있는 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 Load를 임시로 활성화할지 여부입니다. 기본적으로 활성화되지 않습니다.

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

`spark_load_checker_interval_second`

기본값：60

Spark Load 스케줄러의 실행 주기입니다. 기본값은 60초입니다.

`async_loading_load_task_pool_size`

기본값：10

IsMutable：false

MasterOnly：true

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

현재는 Broker Load의 loading_load 작업만 제한합니다.

`async_pending_load_task_pool_size`

기본값：10

IsMutable：false

MasterOnly：true

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

현재는 Broker Load와 Spark Load의 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 Load에서 단일 복제본 쓰기를 활성화할지 여부입니다.

`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 Load의 기본 타임아웃입니다.

`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 Load의 기본 타임아웃입니다.

`spark_load_default_timeout_second`

기본값: 86400 (1일)

IsMutable：true

MasterOnly：true

Spark Load의 기본 타임아웃입니다.

`hadoop_load_default_timeout_second`

기본값: 86400 * 3 (3일)

IsMutable：true

MasterOnly：true

Hadoop Load의 기본 타임아웃입니다.

`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로 정의됩니다. 모든 미니 배치 데이터 적재 작업은 HIGH 우선순위이며, 다른 유형의 데이터 적재 작업은 NORMAL 우선순위입니다. 느린 데이터 적재 작업이 스레드를 오랫동안 점유하지 않도록 우선순위를 설정합니다. 이는 내부 스케줄링 최적화 정책입니다. 현재 작업 우선순위를 수동으로 지정할 수 없으며, 동작을 충분히 이해한 경우에만 이 설정을 변경하세요.

`load_checker_interval_second`

기본값：5 （s）

데이터 적재 스케줄러의 실행 주기입니다. 데이터 적재 작업은 PENDING에서 LOADING을 거쳐 FINISHED로 상태가 전환됩니다. 데이터 적재 스케줄러가 PENDING에서 LOADING으로 전환하고, 트랜잭션 콜백이 LOADING에서 FINISHED로 전환합니다. 따라서 동시 실행 수가 상한에 도달하지 않은 경우 데이터 적재 작업의 완료까지 최대 한 주기가 소요됩니다.

`s3_load_endpoint_white_list`

기본값: 비어 있음

동적 설정 가능 여부: 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`

기본값: 비어 있음

동적 설정 가능 여부: 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에 tablet 위치 정보를 전송하며, 각 BE는 이를 사용하여 자신이 기본 복제본을 보유한 로컬 버킷 집합을 파악합니다. 단일 tablet에 기록한 데이터양이 임계값(기본값 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은 label_keep_max_second가 지나면 제거됩니다.

제거된 label은 재사용할 수 있습니다.
시간을 짧게 설정하면 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 정리기가 label_clean_interval_second마다 실행되어 오래된 작업을 정리합니다.

`label_regex_length`

기본값: 128 (문자)

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

`transaction_clean_interval_second`

기본값：30

트랜잭션이 visible 또는 aborted 상태가 되면 transaction_clean_interval_second초 후에 정리됩니다. 이 간격과 각 정리 주기의 소요 시간은 가능한 한 짧게 유지해야 합니다.

`sync_commit_interval_second`

트랜잭션 커밋 사이의 최대 시간 간격입니다. 이 시간이 지난 후에도 채널에 제출되지 않은 데이터가 남아 있으면 소비자가 채널에 트랜잭션을 제출하도록 알립니다.

기본값: 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)보다 작은지 확인하세요. 그렇지 않으면 FE가 ack 전에 저장 공간보다 큰 데이터를 가져오려고 시도하여, 저장소 큐가 타임아웃될 때까지 차단될 수 있습니다.

기본값: 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

내보내기 쿼리 계획당 tablet 수입니다.

`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는 로그 파일을 2개 생성합니다.

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"}

slow_query에는 소요 시간이 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으로 압축합니다.

`nereids_trace_log_dir`

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

Nereids 추적 로그의 디렉터리를 지정합니다.

스토리지

`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

tablet당 최소 복제본 수를 설정합니다.

`max_replication_num_per_tablet`

기본값: 32767

tablet당 최대 복제본 수를 설정합니다.

`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의 모든 복제본이 손실될 수 있습니다. 이 경우 데이터는 사실상 손실된 상태입니다. 하지만 일부 업무에서는 데이터가 손실되더라도 쿼리에서 오류가 발생하지 않도록 하여 사용자에게 미치는 영향을 줄이기를 원할 수 있습니다. 이때 빈 Tablet으로 누락된 복제본을 채우면 쿼리가 정상적으로 실행되도록 할 수 있습니다.

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

`min_clone_task_timeout_sec` `And max_clone_task_timeout_sec`

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

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가 tablet의 저장 매체를 검사하지 않고 스토리지 냉각 기능을 비활성화합니다. 기본값은 false입니다. tablet의 저장 매체가 중요하지 않은 경우 true로 설정할 수 있습니다.

`decommission_tablet_check_threshold`

기본값：5000

IsMutable：true

MasterOnly：true

Master FE가 해제된 BE의 tablet 상태를 확인할지 제어하는 설정입니다. 해제된 BE의 tablet 수가 이 임계값보다 작으면 FE가 주기적인 검사를 시작합니다. 해당 BE의 모든 tablet이 회수되면 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

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

`max_balancing_tablets`

기본값：100

IsMutable：true

MasterOnly：true

TabletScheduler에서 밸런싱 중인 tablet 수가 max_balancing_tablets를 초과하면 더 이상 밸런싱 검사를 수행하지 않습니다.

`max_scheduling_tablets`

기본값：2000

IsMutable：true

MasterOnly：true

TabletScheduler에서 스케줄링된 tablet 수가 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로 설정하면 tablet 스케줄러가 동작하지 않으므로 모든 tablet 복구/밸런싱 작업이 동작하지 않습니다.

`enable_force_drop_redundant_replica`

기본값: false

동적 설정 가능: true

Master FE에만 적용: true

true로 설정하면 시스템이 tablet 스케줄링 로직에서 중복 복제본을 즉시 삭제합니다. 이로 인해 해당 복제본에 쓰기 중인 일부 데이터 적재 작업이 실패할 수 있지만, tablet의 밸런싱 및 복구 속도를 높일 수 있습니다. 클러스터에서 밸런싱 또는 복구를 기다리는 복제본이 많다면 이 설정을 사용해 볼 수 있습니다. 일부 데이터 적재 성공률을 희생하는 대신 복제본의 밸런싱 및 복구 속도를 높입니다.

`colocate_group_relocate_delay_second`

기본값: 1800

동적 설정 가능: true

Master FE에만 적용: true

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

`allow_replica_on_same_host`

기본값: false

동적 설정 가능: false

Master FE에만 적용: false

동일한 tablet의 여러 복제본을 같은 호스트에 배치하도록 허용할지 여부입니다. 주로 로컬 테스트에서 여러 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

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

`schedule_slot_num_per_ssd_path`

기본값：8

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

`tablet_repair_delay_factor_second`

기본값：60 （s）

IsMutable：true

MasterOnly：true

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

우선순위가 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）

tablet 통계의 갱신 주기입니다. 모든 Frontend는 매 주기마다 모든 Backend에서 tablet 통계를 가져옵니다.

`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 스토리지 경로의 최소 잔여 용량을 제한합니다. 두 제한에 모두 도달하면 해당 스토리지 경로를 tablet 밸런싱 대상으로 선택할 수 없습니다. 다만 tablet 복구 시에는 데이터 무결성을 최대한 유지하기 위해 이 제한을 초과할 수 있습니다.

`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

단일 일관성 검사 작업의 기본 타임아웃입니다. tablet 크기에 맞게 충분히 길게 설정하세요.

`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가 복제를 통해 복구를 시도하기까지의 최소 지연 시간이며 단위는 초입니다.

`tablet_create_timeout_second`

기본값：1（s）

IsMutable：true

MasterOnly：true

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

예: tablet이 #m개이고 각 tablet의 복제본이 #n개인 테이블을 생성하면, 테이블 생성 요청은 최대 (m n tablet_create_timeout_second) 동안 실행된 후 타임아웃됩니다.

`tablet_delete_timeout_second`

기본값：2

IsMutable：true

MasterOnly：true

tablet_create_timeout_second와 의미는 같지만 tablet을 삭제할 때 사용합니다.

`delete_job_max_timeout_second`

기본값: 300(s)

변경 가능: true

Master 전용: 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

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

외부 테이블

`external_meta_cache_max_weight`

기본값: 0

동적 설정 가능 여부: false

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

버전 4.1.4에서 추가되었습니다. FE 수준 외부 메타데이터 캐시의 전체 용량 제한입니다.

단위가 포함된 바이트 크기(예: 1024MB 또는 4GB)나 JVM 최대 힙 크기에 대한 백분율(예: 10%)을 값으로 지정할 수 있습니다. 값이 0이면 전역 할당량을 설정하지 않으며, 이전 버전과 동일하게 동작합니다.

이 할당량은 Hive 파티션 값, Iceberg 테이블 / 스냅샷 / 매니페스트, Paimon 스냅샷 등 다양한 외부 테이블 메타데이터 캐시의 메모리 사용량을 통합하여 제한합니다. 개별 Catalog는 meta.cache.max-weight 및 meta.cache.<engine>.<entry>.max-weight 속성으로 더 세밀하게 제어할 수 있으며, information_schema.catalog_meta_cache_statistics 시스템 테이블에서 캐시 사용량을 확인할 수 있습니다.

`jdbc_driver_url_white_list`

기본값: 비어 있음

동적 설정 가능 여부: 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 인덱스의 shard 정보를 가져옵니다.

외부 리소스

`ai_resource_allowed_user`

기본값: *

동적 설정 가능 여부: false

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

버전 4.1.5부터 지원됩니다. AI Resources를 생성할 수 있는 사용자 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 Launcher 로그 디렉터리를 지정합니다.

`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 클러스터에서는 메타데이터 변경(파티션 삭제 등) 후 tablet 보고를 처리하는 데 몇 초가 걸릴 수 있습니다. 각 Backend가 1분마다 tablet 정보를 보고하므로 보고를 무제한으로 수신할 수는 없습니다. 앞으로 tablet 보고 처리 속도를 최적화할 예정이지만, 현재는 큐 크기가 제한을 초과하면 보고를 버립니다. 일부 운영 환경의 소요 시간: 1. disk report: 0-1 msta 2. sk report: 0-1 ms 3. tablet report 4. 10000 replicas: 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

백업 작업당 포함할 수 있는 tablet의 최대 개수를 제어하여, 메타데이터를 너무 많이 저장함으로써 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 Load에서 표시하는 오류 tablet의 최대 개수입니다.

`default_db_max_running_txn_num`

기본값：-1

IsMutable：true

MasterOnly：true

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

기본값 -1은 max_running_txn_num_per_db를 사용하고 default_db_max_running_txn_num은 사용하지 않음을 의미합니다.

개별 데이터베이스의 할당량은 다음과 같이 설정할 수 있습니다.

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 롤링 주기를 지정하여 메타데이터 쓰기가 드물더라도 주기적인 checkpoint를 진행할 수 있도록 합니다. 이 주기는 로그 항목을 추가할 때 확인합니다. 새 항목이 없을 때 독립적인 타이머가 강제로 롤링하지는 않습니다. 양수가 아닌 값으로 설정하면 시간 기반 롤링이 비활성화됩니다. 로그 항목 수에 따른 롤링은 계속 활성화됩니다.

`cloud_version_syncer_interval_second`

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

동적 설정 가능 여부: false

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

컴퓨팅 및 스토리지 분리 모드에서 모든 FE가 백그라운드에서 테이블 및 파티션 버전을 동기화하는 주기입니다. 백그라운드 동기화를 사용하려면 cloud_enable_version_syncer=true여야 하며, 전역/기본 테이블 또는 파티션 버전 캐시 TTL 중 하나 이상이 Long.MAX_VALUE로 설정되어 있어야 합니다. 유한한 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부터 동적으로 갱신하면 워밍업 실행기의 크기도 조정됩니다. 양수가 아닌 값은 새 워밍업 작업의 스케줄링을 일시 중지합니다.

`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 배치를 여러 BE로 분산하는 것을 방지합니다.

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에서 추가되었습니다. 메타데이터 이미지를 로드할 때와 tablet 밸런싱 주기 중에, 더 이상 존재하지 않는 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​

서비스​

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​

http_sql_submitter_max_worker_threads​

설정 항목 조회

설정 항목 지정

예제

설정 목록

메타데이터 및 클러스터

`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`

서비스

`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`

`http_sql_submitter_max_worker_threads`