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

BE 설정

이 문서에서는 BE의 주요 설정 항목을 소개합니다.

BE 설정 파일인 be.conf는 일반적으로 BE 배포 경로의 conf/ 디렉터리에 저장됩니다. 0.14 버전에서는 별도의 설정 파일인 be_custom.conf가 도입됩니다. 이 파일은 운영 중 사용자가 동적으로 설정하고 영구 저장한 설정 항목을 기록하는 데 사용됩니다.

BE 프로세스가 시작되면 먼저 be.conf의 설정 항목을 읽은 다음 be_custom.conf의 설정 항목을 읽습니다. be_custom.conf의 설정 항목은 be.conf의 동일한 설정 항목을 덮어씁니다.

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

설정 항목 조회

BE 설정 항목을 조회하는 방법은 두 가지입니다.

BE 웹 페이지

BE 웹 페이지에 접속하여 현재 설정 항목을 조회할 수 있습니다.

http://be_host:be_webserver_port/varz
명령으로 조회

MySQL 클라이언트에서 다음 명령으로 BE 설정 항목을 조회할 수 있습니다. 자세한 구문은 SHOW-CONFIG를 참조하세요.

SHOW BACKEND CONFIG;

결과에 표시되는 각 열의 의미는 다음과 같습니다.
1. BackendId: backend의 ID입니다.
2. Host: backend의 IP입니다.
3. Key: 설정 항목의 이름입니다.
4. Value: 설정 항목의 현재 값입니다.
5. Type: 정수나 문자열 등 설정 항목 값의 유형입니다.
6. IsMutable: 동적 설정 가능 여부입니다. true이면 실행 중에 동적으로 설정할 수 있습니다. false이면 be.conf에서만 설정할 수 있으며, BE를 다시 시작한 후 적용됩니다.

설정 항목 지정

BE 설정 항목을 지정하는 방법은 두 가지입니다.

정적 설정

conf/be.conf 파일에 설정 항목을 추가하고 값을 지정합니다. BE는 시작할 때 be.conf의 설정 항목을 읽습니다. be.conf에 없는 설정 항목에는 기본값이 사용됩니다.
동적 설정

BE가 시작된 후 다음 명령으로 설정 항목을 동적으로 지정할 수 있습니다.
```
curl -X POST http://{be_ip}:{be_http_port}/api/update_config?{key}={value}
```
0.13 및 이전 버전에서는 이 방식으로 변경한 설정 항목이 BE 프로세스를 다시 시작하면 무효화됩니다. 0.14 및 이후 버전에서는 다음 명령으로 변경한 설정을 영구 저장할 수 있습니다. 변경된 설정 항목은 be_custom.conf 파일에 저장됩니다.
```
curl -X POST http://{be_ip}:{be_http_port}/api/update_config?{key}={value}\&persist=true
```

예시

max_base_compaction_threads를 정적으로 변경

be.conf 파일에 다음 항목을 추가합니다.

max_base_compaction_threads=5

그런 다음 BE 프로세스를 다시 시작하면 설정이 적용됩니다.
streaming_load_max_mb를 동적으로 변경

BE가 시작된 후 다음 명령으로 streaming_load_max_mb 설정 항목을 동적으로 지정합니다.
```
curl -X POST http://{be_ip}:{be_http_port}/api/update_config?streaming_load_max_mb=1024
```
반환값이 다음과 같으면 설정이 성공한 것입니다.
```
{
    "status": "OK",
    "msg": ""
}
```
이 설정은 BE를 다시 시작하면 무효화됩니다. 변경한 결과를 영구 저장하려면 다음 명령을 사용하세요.
```
curl -X POST http://{be_ip}:{be_http_port}/api/update_config?streaming_load_max_mb=1024\&persist=true
```

설정 항목

서비스

`deploy_mode`

유형: string
설명: BE의 실행 모드입니다. cloud는 스토리지와 컴퓨팅이 분리된 모드를 나타냅니다.
기본값: ""

`bvar_max_dump_multi_dimension_metric_num`

유형: string
설명: 4.1.5 버전부터 지원됩니다. /brpc_metrics에서 내보내는 다차원 bvar 메트릭 샘플의 최대 개수입니다. 0으로 설정하면 이러한 샘플을 비활성화합니다. 변경 사항을 적용하려면 BE를 다시 시작해야 합니다.
기본값: 5000

`be_port`

유형: int32
설명: FE의 요청을 수신하는 BE의 thrift 서버 포트입니다.
기본값: 9060

`heartbeat_service_port`

유형: int32
설명: FE의 하트비트를 수신하는 BE의 하트비트 서비스 포트(thrift)입니다.
기본값: 9050

`webserver_port`

유형: int32
설명: BE의 http 서버 서비스 포트입니다.
기본값: 8040

`brpc_port`

유형: int32
설명: BE 간 통신에 사용하는 BE의 BRPC 포트입니다.
기본값: 8060

`arrow_flight_sql_port`

유형: int32
설명: Arrow Flight Client와 BE 간 통신에 사용하는 BE의 Arrow Flight SQL 서버 포트입니다.
기본값: -1

`enable_https`

유형: bool
설명: https 지원 여부입니다. 지원하려면 be.conf에 ssl_certificate_path와 ssl_private_key_path를 설정하세요.
기본값: false

`priority_networks`

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

`storage_root_path`

유형: string
설명: 데이터 루트 경로이며, ';'로 구분합니다. 각 루트 경로의 스토리지 매체를 HDD 또는 SSD로 지정할 수 있습니다. 각 루트 경로 끝에 ','로 구분하여 용량 제한을 추가할 수 있습니다. SSD와 HDD 디스크를 혼용하지 않는 경우에는 아래 예시 1 및 예시 2의 설정 방식을 사용할 필요 없이 스토리지 디렉터리만 지정하면 됩니다. FE의 기본 스토리지 매체 설정도 변경할 필요가 없습니다.

예시 1: storage_root_path=/home/disk1/doris.HDD;/home/disk2/doris.SSD;/home/disk2/doris
- 1./home/disk1/doris.HDD는 스토리지 매체가 HDD임을 나타냅니다.
- 2./home/disk2/doris.SSD는 스토리지 매체가 SSD임을 나타냅니다.
- 3./home/disk2/doris는 기본 스토리지 매체가 HDD임을 나타냅니다.
예시 2: storage_root_path=/home/disk1/doris,medium:hdd;/home/disk2/doris,medium:ssd
- 1./home/disk1/doris,medium:hdd는 스토리지 매체가 HDD임을 나타냅니다.
- 2./home/disk2/doris,medium:ssd는 스토리지 매체가 SSD임을 나타냅니다.
기본값: ${DORIS_HOME}/storage

`heartbeat_service_thread_count`

유형: int32
설명: BE에서 하트비트 서비스를 실행하는 스레드 수입니다. 기본값은 1이며 변경하지 않는 것이 좋습니다.
기본값: 1

`ignore_broken_disk`

유형: bool
설명: BE가 시작될 때 storage_root_path 설정의 모든 경로를 검사합니다.
- ignore_broken_disk=true
경로가 존재하지 않거나 해당 경로의 파일을 읽거나 쓸 수 없는 경우(디스크 장애), 해당 경로를 무시합니다. 사용 가능한 다른 경로가 있으면 시작 과정을 중단하지 않습니다.
- ignore_broken_disk=false
경로가 존재하지 않거나 해당 경로의 파일을 읽거나 쓸 수 없는 경우(디스크 장애), 시스템은 시작에 실패하고 종료됩니다.
기본값: false

`mem_limit`

유형: string
설명: BE 프로세스가 사용할 수 있는 메모리를 서버 최대 메모리의 백분율로 제한합니다. BE가 서버 메모리를 과도하게 점유하는 것을 방지하는 데 사용됩니다. 이 매개변수는 0보다 커야 합니다. 백분율이 100%보다 크면 100%로 적용됩니다.
기본값: 90%

`cluster_id`

유형: int32
설명: BE가 속한 클러스터의 ID를 설정합니다.
- 일반적으로 이 값은 FE가 하트비트를 통해 BE에 전달하므로 별도로 설정할 필요가 없습니다. BE가 특정 Doris 클러스터에 속하는 것이 확인되면 설정할 수 있습니다. 데이터 디렉터리의 cluster_id 파일도 이 매개변수와 동일한 값으로 수정해야 합니다.
기본값: -1

`custom_config_dir`

설명: be_custom.conf 파일의 위치를 설정합니다. 기본 위치는 conf/ 디렉터리입니다.
- 일부 배포 환경에서는 시스템 업그레이드로 인해 conf/ 디렉터리가 덮어써질 수 있습니다. 이 경우 사용자가 변경한 설정 항목도 덮어써집니다. 이를 방지하려면 be_custom.conf를 별도로 지정한 디렉터리에 저장할 수 있습니다.
기본값: 비어 있음

`trash_file_expire_time_sec`

설명: 휴지통을 정리하는 간격은 24시간입니다. 디스크 공간이 부족하면 휴지통의 파일 보관 기간이 이 매개변수를 따르지 않을 수 있습니다.
기본값: 86400

`es_http_timeout_ms`

설명: http를 통해 ES에 연결할 때의 타임아웃입니다.
기본값: 5000 (ms)

`es_scroll_keepalive`

설명: es scroll의 keep-alive 유지 시간입니다.
기본값: 5 (m)

`external_table_connect_timeout_sec`

유형: int32
설명: ODBC 테이블과 같은 외부 테이블에 연결할 때의 타임아웃입니다.
기본값: 5초

`pipeline_status_report_interval`

설명: 프로파일 보고 간격입니다.
기본값: 5초

`brpc_max_body_size`

설명: brpc의 max_body_size 매개변수를 변경하는 데 주로 사용됩니다.
- 쿼리가 실패하면서 BE 로그에 body_size is too large 오류 메시지가 나타나는 경우가 있습니다. SQL 패턴이 "multi distinct + no group by + 1T가 넘는 데이터"인 경우에 발생할 수 있습니다. 이 오류는 brpc 패킷 크기가 설정값을 초과했음을 나타냅니다. 설정값을 높이면 이 오류를 방지할 수 있습니다.

`brpc_socket_max_unwritten_bytes`

설명: brpc의 socket_max_unwritten_bytes 매개변수를 변경하는 데 주로 사용됩니다.
- 쿼리가 실패하면서 BE 로그에 The server is overcrowded 오류 메시지가 나타나는 경우가 있습니다. 이는 송신 측에서 버퍼링해야 할 메시지가 너무 많음을 의미하며, SQL에서 큰 bitmap 값을 전송해야 할 때 발생할 수 있습니다. 설정값을 높이면 이 오류를 방지할 수 있습니다.

`transfer_large_data_by_brpc`

유형: bool
설명: Tuple/Block 데이터 길이가 1.8G보다 클 때, protoBuf 요청을 직렬화하고 Tuple/Block 데이터를 controller attachment에 넣어 http brpc로 전송할지 제어합니다. protoBuf 요청 길이가 2G를 초과할 때 발생하는 오류인 Bad request, error_text=[E1003]Fail to compress request를 방지하기 위한 설정입니다. 이전 버전에서는 Tuple/Block 데이터를 attachment에 넣은 후 기본 baidu_std brpc로 전송했지만, attachment가 2G를 초과하면 잘렸습니다. http brpc로 전송하면 2G 제한이 없습니다.
기본값: true

`brpc_num_threads`

설명: brpc의 bthread 수를 변경하는 데 주로 사용됩니다. 기본값은 256입니다.
- 더 나은 QPS 성능을 얻으려면 이 설정값을 높일 수 있습니다. 자세한 내용은 https://github.com/apache/incubator-brpc/blob/master/docs/cn/benchmark.md를 참조하세요.
기본값: 256

`thrift_rpc_timeout_ms`

설명: thrift의 기본 타임아웃입니다.
기본값: 60000

`thrift_client_retry_interval_ms`

유형: int64
설명: BE의 thrift 클라이언트 재시도 간격을 설정하여 FE thrift 서버에 연쇄적으로 부하가 몰리는 것을 방지합니다. 단위는 ms입니다.
기본값: 1000

`thrift_connect_timeout_seconds`

설명: thrift 클라이언트의 기본 연결 타임아웃입니다.
기본값: 3 (s)

`thrift_server_type_of_fe`

유형: string
설명: FE의 Thrift 서비스에서 사용하는 서비스 모델을 나타냅니다. 유형은 string이며 대소문자를 구분하지 않습니다. FE의 thrift_server_type 매개변수 설정과 일치해야 합니다. 현재 이 매개변수는 THREADED와 THREAD_POOL 두 가지 값을 지원합니다.
- 매개변수가 THREADED이면 논블로킹 I/O 모델입니다.
- 매개변수가 THREAD_POOL이면 블로킹 I/O 모델입니다.

`thrift_max_message_size`

기본값: 100MB

thrift 서버가 수신하는 메시지의 최대 크기이며, 단위는 바이트입니다. 클라이언트가 보낸 메시지의 크기가 이 제한을 초과하면 Thrift 서버는 요청을 거부하고 연결을 닫습니다. 그 결과 클라이언트에 "connection has been closed by peer." 오류가 발생합니다. 이 경우 매개변수 값을 높여 볼 수 있습니다.

`txn_commit_rpc_timeout_ms`

설명: txn 커밋 RPC 타임아웃입니다.
기본값: 60,000 (ms)

`txn_map_shard_size`

설명: txn_map_lock의 샤드 크기입니다. 값은 2^n이며, n=0,1,2,3,4입니다. txn 관리 성능을 개선하기 위한 설정입니다.
기본값: 128

`txn_shard_size`

설명: txn_lock의 샤드 크기입니다. 값은 2^n이며, n=0,1,2,3,4입니다. txn 커밋 및 게시 성능을 개선하기 위한 설정입니다.
기본값: 1024

`unused_rowset_monitor_interval`

설명: 만료된 Rowset을 정리하는 시간 간격입니다.
기본값: 30 (s)

`max_client_cache_size_per_host`

설명: 호스트별 최대 클라이언트 캐시 수입니다. BE에는 여러 클라이언트 캐시가 있지만 현재는 동일한 캐시 크기 설정을 사용합니다. 필요하면 클라이언트 캐시별로 다른 설정을 사용하세요.
기본값: 10

`string_type_length_soft_limit_bytes`

유형: int32
설명: String 유형의 최대 길이에 대한 소프트 제한입니다.
기본값: 1,048,576

`big_column_size_buffer`

유형: int64
설명: odbc 외부 테이블을 사용할 때, odbc 원본 테이블의 열 유형이 HLL, CHAR 또는 VARCHAR이고 열 값의 길이가 이 값을 초과하면 쿼리에서 'column value length longer than buffer length' 오류가 발생합니다. 이 값을 높여 해결할 수 있습니다.
기본값: 65535

`small_column_size_buffer`

유형: int64
설명: odbc 외부 테이블을 사용할 때, odbc 원본 테이블의 열 유형이 HLL, CHAR 또는 VARCHAR가 아니고 열 값의 길이가 이 값을 초과하면 쿼리에서 'column value length longer than buffer length' 오류가 발생합니다. 이 값을 높여 해결할 수 있습니다.
기본값: 100

쿼리

`ignore_not_found_file_in_external_table`

유형: bool
설명: 외부 테이블 리더가 누락된 파일을 건너뛸 수 있는지 여부입니다. 동적 설정을 지원합니다. 4.1.5 버전부터는 커밋된 Iceberg 스냅샷의 데이터 파일이나 삭제 파일 누락을 이 설정으로 허용할 수 없습니다. true로 설정하더라도 쿼리가 실패하여, 불완전한 스냅샷을 오류 없이 반환하는 것을 방지합니다.
기본값: true

`parquet_metadata_size_limit`

유형: int64
설명: 4.1.5 버전부터 지원됩니다. 네이티브 Parquet V2 리더에서 허용하는 직렬화된 파일 푸터 메타데이터의 최대 크기이며, 단위는 바이트입니다. 0보다 커야 합니다. 제한을 초과하면 Parquet v2 footer size ... exceeds metadata limit ... 오류를 반환합니다. 동적 설정을 지원합니다. 푸터가 큰 정상 파일을 처리하려면 메모리 예산 내에서 이 값을 높이세요.
기본값: 268435456 (256 MiB)

`fragment_mgr_asynic_work_pool_queue_size`

설명: 단일 노드에서 처리할 수 있는 비동기 작업 수의 상한입니다.
기본값: 4096

`fragment_mgr_asynic_work_pool_thread_num_min`

설명: 비동기 작업을 실행하는 스레드 수입니다. 기본 최소 스레드 수는 16입니다.
기본값: 16

`fragment_mgr_asynic_work_pool_thread_num_max`

설명: 비동기 작업에 따라 스레드를 동적으로 생성하며, 최대 512개의 스레드를 생성합니다.
기본값: 512

`doris_scanner_row_num`

설명: 각 스캔 스레드가 한 번의 실행에서 반환하는 최대 데이터 행 수입니다.
기본값: 16384

`doris_scanner_row_bytes`

설명: fragment 실행 중 한 번에 읽는 행 데이터의 바이트 수입니다.
- 참고: 테이블에 열이 너무 많아 select * 실행이 멈추는 경우 이 설정을 조정할 수 있습니다.
기본값: 10485760

`doris_scanner_thread_pool_queue_size`

유형: int32
설명: Scanner 스레드 풀의 큐 길이입니다. Doris의 스캔 작업에서는 각 Scanner가 스레드 작업으로 스레드 풀에 제출되어 스케줄링을 기다립니다. 제출된 작업 수가 스레드 풀의 큐 길이를 초과하면, 이후 제출되는 작업은 큐에 빈 슬롯이 생길 때까지 차단됩니다.
기본값: 102400

`doris_scanner_thread_pool_thread_num`

유형: int32
설명: Scanner 스레드 풀의 스레드 수입니다. Doris의 스캔 작업에서는 각 Scanner가 스레드 작업으로 스레드 풀에 제출되어 스케줄링됩니다. 이 매개변수는 Scanner 스레드 풀의 크기를 결정합니다.
기본값: CPU 코어 수에 따라 결정되며, max(48, 2 * num_of_cpu_cores)입니다.

`doris_max_remote_scanner_thread_pool_thread_num`

유형: int32
설명: Remote scanner 스레드 풀의 최대 스레드 수입니다. Remote scanner 스레드 풀은 모든 외부 데이터 소스의 스캔 작업에 사용됩니다.
기본값: 512

`exchg_node_buffer_size_bytes`

유형: int32
설명: ExchangeNode 노드의 Buffer 큐 크기이며, 단위는 바이트입니다. Sender 측에서 보낸 데이터양이 ExchangeNode의 Buffer 크기를 초과하면, 이후 데이터 전송은 Buffer에 쓰기 공간이 확보될 때까지 차단됩니다.
기본값: 10485760

`doris_scan_range_max_mb`

유형: int32
설명: 각 OlapScanner가 읽는 최대 데이터양입니다.
기본값: 1024

컴팩션

`disable_auto_compaction`

유형: bool
설명: 자동 컴팩션 작업을 비활성화할지 여부입니다.
- 일반적으로 이 설정은 꺼 두어야 합니다. 디버깅 또는 테스트 환경에서 컴팩션 작업을 수동으로 실행하려면 이 설정을 켤 수 있습니다.
기본값: false

`enable_vertical_compaction`

유형: bool
설명: 수직 컴팩션을 활성화할지 여부입니다.
기본값: true

`vertical_compaction_num_columns_per_group`

유형: int32
설명: 수직 컴팩션에서 그룹별 열 수입니다.
기본값: 5

`vertical_compaction_max_row_source_memory_mb`

유형: int32
설명: 수직 컴팩션에서 row_source_buffer의 최대 메모리 사용량입니다. 단위는 MB입니다.
기본값: 200

`vertical_compaction_max_segment_size`

유형: int32
설명: 수직 컴팩션에서 대상 segment 파일의 최대 크기입니다. 단위는 m bytes입니다.
기본값: 268435456

`enable_ordered_data_compaction`

유형: bool
설명: 정렬된 데이터의 컴팩션을 활성화할지 여부입니다.
기본값: true

`ordered_data_compaction_min_segment_size`

유형: int32
설명: 정렬된 데이터의 컴팩션에서 입력 rowset의 최소 segment 크기입니다. 단위는 m bytes입니다.
기본값: 10485760

`max_base_compaction_threads`

유형: int32
설명: base compaction 스레드 풀의 최대 스레드 수입니다. -1은 디스크당 하나의 스레드를 의미합니다.
기본값: 4

`generate_compaction_tasks_interval_ms`

설명: 컴팩션 작업을 생성하는 최소 간격(ms)입니다.
기본값: 10 (ms)

`base_compaction_min_rowset_num`

설명: BaseCompaction의 트리거 조건 중 하나로, Cumulative 파일 수가 도달해야 하는 한계값입니다. 이 한계값에 도달하면 BaseCompaction이 트리거됩니다.
기본값: 5

`base_compaction_min_data_ratio`

설명: BaseCompaction의 트리거 조건 중 하나로, Cumulative 파일 크기가 Base 파일 크기에 대해 도달해야 하는 비율입니다.
기본값: 0.3 (30%)

`total_permits_for_compaction_score`

유형: int64
설명: 모든 컴팩션 작업이 보유하는 "permits"의 상한입니다. 이 설정으로 컴팩션의 메모리 사용량을 제한할 수 있습니다.
기본값: 10000
동적 변경 가능: 예

`compaction_promotion_size_mbytes`

유형: int64
설명: cumulative compaction이 출력한 rowset의 전체 디스크 크기가 이 설정값을 초과하면 해당 rowset을 base compaction에 사용합니다. 단위는 m bytes입니다.
- 일반적으로 cumulative compaction 시간이 너무 길어져 버전이 누적되는 것을 방지하려면 이 설정값을 2G 미만으로 지정합니다.
기본값: 1024

`compaction_promotion_ratio`

유형: double
설명: cumulative compaction이 출력한 rowset의 전체 디스크 크기가 base 버전 rowset에 대한 설정 비율을 초과하면 해당 rowset을 base compaction에 사용합니다.
- 일반적으로 설정값은 0.1보다 높지 않고 0.02보다 낮지 않도록 지정하는 것이 좋습니다.
기본값: 0.05

`compaction_promotion_min_size_mbytes`

유형: int64
설명: cumulative compaction이 출력한 rowset의 전체 디스크 크기가 이 설정값보다 작으면 해당 rowset은 base compaction을 거치지 않고 cumulative compaction 과정에 남습니다. 단위는 m bytes입니다.
- 일반적으로 이 설정값은 512m 이내로 지정합니다. 값이 너무 크면 초기 base 버전의 크기가 너무 작아 base compaction이 수행되지 않습니다.
기본값: 128

`compaction_min_size_mbytes`

유형: int64
설명: cumulative compaction에서 병합 대상으로 선택한 rowset의 디스크 크기가 이 설정값보다 크면 레벨 정책에 따라 나누어 병합합니다. 이 설정값보다 작으면 바로 병합합니다. 단위는 m bytes입니다.
- 일반적으로 이 설정값은 128m 이내로 지정합니다. 값이 너무 크면 cumulative compaction의 쓰기 증폭이 커집니다.
기본값: 64

`default_rowset_type`

유형: string
설명: BE가 기본적으로 선택하는 스토리지 형식을 지정합니다. 설정 가능한 값은 "ALPHA", "BETA"입니다. 주로 다음 두 가지 역할을 합니다.
- 테이블의 storage_format이 Default로 설정된 경우 이 설정으로 BE의 스토리지 형식을 선택합니다.
- BE가 Compaction을 수행할 때 사용할 스토리지 형식을 선택합니다.
기본값: BETA

`cumulative_compaction_min_deltas`

설명: cumulative compaction 전략의 최소 증분 파일 수입니다.
기본값: 5

`cumulative_compaction_max_deltas`

설명: cumulative compaction 전략의 최대 증분 파일 수입니다.
기본값: 1000

`base_compaction_trace_threshold`

유형: int32
설명: base compaction의 추적 정보를 로그에 기록하는 임계값이며, 단위는 초입니다.
기본값: 10

base compaction은 시간이 오래 걸리는 백그라운드 작업입니다. 이 설정은 추적 정보를 로그에 기록하는 임계값입니다. 로그 파일의 추적 정보는 다음과 같습니다.

W0610 11:26:33.804431 56452 storage_engine.cpp:552] execute base compaction cost 0.00319222
BaseCompaction:546859:
  - filtered_rows: 0
   - input_row_num: 10
   - input_rowsets_count: 10
   - input_rowsets_data_size: 2.17 KB
   - input_segments_num: 10
   - merge_rowsets_latency: 100000.510ms
   - merged_rows: 0
   - output_row_num: 10
   - output_rowset_data_size: 224.00 B
   - output_segments_num: 1
0610 11:23:03.727535 (+     0us) storage_engine.cpp:554] start to perform base compaction
0610 11:23:03.728961 (+  1426us) storage_engine.cpp:560] found best tablet 546859
0610 11:23:03.728963 (+     2us) base_compaction.cpp:40] got base compaction lock
0610 11:23:03.729029 (+    66us) base_compaction.cpp:44] rowsets picked
0610 11:24:51.784439 (+108055410us) compaction.cpp:46] got concurrency lock and start to do compaction
0610 11:24:51.784818 (+   379us) compaction.cpp:74] prepare finished
0610 11:26:33.359265 (+101574447us) compaction.cpp:87] merge rowsets finished
0610 11:26:33.484481 (+125216us) compaction.cpp:102] output rowset built
0610 11:26:33.484482 (+     1us) compaction.cpp:106] check correctness finished
0610 11:26:33.513197 (+ 28715us) compaction.cpp:110] modify rowsets finished
0610 11:26:33.513300 (+   103us) base_compaction.cpp:49] compaction finished
0610 11:26:33.513441 (+   141us) base_compaction.cpp:56] unused rowsets have been moved to GC queue

`cumulative_compaction_trace_threshold`

유형: int32
설명: cumulative compaction의 추적 정보를 로그에 기록하는 임계값이며, 단위는 초입니다.
- base_compaction_trace_threshold와 유사합니다.
기본값: 2

`compaction_task_num_per_disk`

유형: int32
설명: 디스크(HDD)별로 병렬 실행하는 컴팩션 작업 수입니다.
기본값: 4

`compaction_task_num_per_fast_disk`

유형: int32
설명: 고속 디스크(SSD)별로 병렬 실행하는 컴팩션 작업 수입니다.
기본값: 8

`cumulative_compaction_rounds_for_each_base_compaction_round`

유형: int32
설명: 컴팩션 작업을 생성할 때 base compaction 한 라운드당 수행하는 cumulative compaction 라운드 수입니다.
기본값: 9

`max_cumu_compaction_threads`

유형: int32
설명: cumulative compaction 스레드 풀의 최대 스레드 수입니다. -1은 디스크당 하나의 스레드를 의미합니다.
기본값: -1

`enable_segcompaction`

유형: bool
설명: 데이터 적재 중 segment compaction을 사용하여 -238 오류를 방지할지 여부입니다.
기본값: true

`segcompaction_batch_size`

유형: int32
설명: segment 수가 이 임계값을 초과하면 segment compaction이 트리거됩니다. 또한 단일 segment compaction 작업에 포함할 수 있는 원본 segment의 최대 개수를 제한합니다.
기본값: 10

`segcompaction_candidate_max_rows`

유형: int32
설명: 단일 원본 segment에 허용되는 최대 행 수입니다. 이를 초과하는 segment는 건너뜁니다.
기본값: 1048576

`segcompaction_candidate_max_bytes`

유형: int64
설명: 단일 원본 segment에 허용되는 최대 파일 크기입니다. 이를 초과하는 segment는 건너뜁니다.
기본값: 104857600

`segcompaction_task_max_rows`

유형: int32
설명: 단일 segcompaction 작업에 허용되는 최대 총 행 수입니다.
기본값: 1572864

`segcompaction_task_max_bytes`

유형: int64
설명: 단일 segcompaction 작업에 허용되는 최대 총 파일 크기입니다.
기본값: 157286400

`segcompaction_num_threads`

유형: int32
설명: 전역 segcompaction 스레드 풀의 크기입니다.
기본값: 5

`disable_compaction_trace_log`

유형: bool
설명: 컴팩션의 추적 로그를 비활성화합니다.
- true로 설정하면 cumulative_compaction_trace_threshold와 base_compaction_trace_threshold가 적용되지 않으며 로그가 비활성화됩니다.
기본값: true

`pick_rowset_to_compact_interval_sec`

유형: int64
설명: 컴팩션할 rowset을 선택하는 시간 간격이며, 단위는 초입니다.
기본값: 86400

`update_replica_infos_interval_seconds`

설명: 피어 복제본 정보를 업데이트하는 최소 간격(s)입니다.
기본값: 60 (s)

`cold_data_compaction_score_threshold`

유형: int32
설명: 콜드 데이터의 컴팩션을 트리거하는 최소 컴팩션 점수 임계값입니다. 콜드 데이터의 컴팩션 점수가 이 임계값을 초과하면 컴팩션 수행을 검토합니다. 이 값을 조정하여 원격 스토리지의 콜드 데이터에 대한 컴팩션 빈도와 수행 강도를 제어할 수 있습니다. 3.1.3부터 지원됩니다.
기본값: 100

`cold_data_compaction_thread_num`

유형: int32
설명: 콜드 데이터 컴팩션에 사용하는 스레드 수입니다. 콜드 데이터 컴팩션 작업의 병렬 처리 수준을 제어합니다. 값을 높이면 더 많은 콜드 데이터 컴팩션 작업을 동시에 실행할 수 있어 처리량이 향상될 수 있지만, 리소스 사용량도 증가합니다.
기본값: 2

`cold_data_compaction_interval_sec`

유형: int32
설명: 콜드 데이터 컴팩션을 트리거하는 시간 간격이며, 단위는 초입니다. 간격이 짧을수록 콜드 데이터 컴팩션 수행을 더 자주 검토하므로 정리 속도가 빨라질 수 있지만 리소스 사용량도 증가합니다.
기본값: 1800 (초)

`enable_compaction_pause_on_high_memory`

유형: bool
설명: 프로세스 메모리 사용량이 높을 때 컴팩션 작업을 일시 중지할지 여부입니다. 동적 변경을 지원합니다.
- 활성화하면 메모리가 부족할 때 BE가 컴팩션을 일시 중지하고 쿼리와 데이터 적재를 우선 처리합니다.
- 그러나 컴팩션을 일시 중지하면 컴팩션 점수가 높은 tablet의 병합이 더 어려워져, 줄이려던 메타데이터와 메모리 누적 문제가 오히려 심해집니다. 4.0.8 버전부터 기본값이 true에서 false로 변경되어, 기본적으로 메모리 사용량이 높아도 컴팩션을 일시 중지하지 않습니다.
- 이전 동작을 유지하려면 다시 true로 설정하세요.
기본값: false (4.0.8 이전에는 true)

데이터 적재

`request_cdc_client_timeout_ms`

유형: int32
설명: CDC 클라이언트 요청의 타임아웃이며, 단위는 밀리초입니다. 동적 설정을 지원합니다. 4.1.5 버전에서는 오래 걸리는 CDC 요청을 허용하기 위해 기본값이 60000에서 120000으로 증가했습니다.
기본값: 120000 (4.1.5 이전에는 60000)

`enable_table_memtable_flush_backpressure`

유형: bool
설명: 4.1.4 버전에서 추가되었습니다. 이 BE에서 특정 테이블의 플러시 대기 중인 MemTable이 너무 많을 때 해당 테이블에 대한 새 쓰기를 차단할지 여부입니다. FE 설정 enable_adaptive_random_bucket_load와 함께 사용하여, 적응형 랜덤 버킷 데이터 적재 중 MemTable이 쌓여 메모리 사용량이 늘어나는 것을 방지합니다.
기본값: true

`table_memtable_flush_pending_count_limit`

유형: int32
설명: 4.1.4 버전에서 추가되었습니다. 이 BE에서 단일 테이블의 플러시 대기 중인 MemTable의 최대 개수입니다. 한도를 초과하면 개수가 한도 미만으로 떨어질 때까지 새 쓰기를 차단합니다. enable_table_memtable_flush_backpressure = true일 때만 적용됩니다.
기본값: 10

`group_commit_max_wal_num_per_table`

유형: int32
설명: 4.1.4 버전에서 추가되었습니다. 단일 테이블에 존재할 수 있는 Group Commit WAL 파일의 최대 개수입니다. 0은 제한 없음을 의미합니다. WAL 재생이 계속 실패하여 WAL이 이 한도를 초과해 쌓이면, 해당 테이블의 async_mode Group Commit 데이터 적재는 EXCEEDED_LIMIT 오류로 거부되며 오류 메시지는 Too many group commit async WALs for table ... 형태로 표시됩니다. 이 제한은 WAL이 끝없이 늘어나 디스크를 가득 채우는 것을 방지합니다.
기본값: 10

`enable_stream_load_record`

유형: bool
설명: Stream Load 기록 기능을 활성화할지 여부입니다. 기본값은 false입니다.
기본값: false

`load_data_reserve_hours`

설명: mini load에 사용됩니다. 이 시간이 지나면 mini load 데이터 파일이 삭제됩니다.
기본값: 4 (h)

`push_worker_count_high_priority`

설명: HIGH 우선순위의 데이터 적재 작업을 처리하는 스레드 수입니다.
기본값: 3

`push_worker_count_normal_priority`

설명: NORMAL 우선순위의 데이터 적재 작업을 처리하는 스레드 수입니다.
기본값: 3

`enable_single_replica_load`

설명: 단일 복제본 데이터 적재 기능을 활성화할지 여부입니다.
기본값: true

`load_error_log_reserve_hours`

설명: 이 시간이 지나면 데이터 적재 오류 로그가 삭제됩니다.
기본값: 48 (h)

`load_error_log_limit_bytes`

설명: 이 값보다 큰 데이터 적재 오류 로그는 잘립니다.
기본값: 209715200 (byte)

`load_process_max_memory_limit_percent`

설명: 단일 노드에서 모든 데이터 적재 스레드가 점유할 수 있는 메모리 상한의 백분율입니다. 기본값은 50%입니다.
- Doris 업그레이드 시 데이터 적재 성능에 영향을 주지 않도록 기본값을 크게 설정했습니다. 필요한 경우 사용 환경에 맞게 설정하세요.
기본값: 50 (%)

`load_process_soft_mem_limit_percent`

설명: 소프트 제한은 단일 노드의 데이터 적재 메모리 제한에 대한 비율입니다. 예를 들어, 모든 데이터 적재 작업의 메모리 제한이 20GB라면 소프트 제한은 기본적으로 이 값의 50%, 즉 10GB입니다. 데이터 적재 메모리 사용량이 소프트 제한을 초과하면 메모리 사용량이 가장 큰 작업을 선택하여 플러시함으로써 메모리 공간을 확보합니다. 기본값은 50%입니다.
기본값: 50 (%)

`slave_replica_writer_rpc_timeout_sec`

유형: int32
설명: 단일 복제본 데이터 적재에서 master 복제본과 slave 복제본 간 brpc 타임아웃을 변경하는 데 주로 사용됩니다.
기본값: 60

`max_segment_num_per_rowset`

유형: int32
설명: 데이터 적재 중 새로 생성되는 rowset의 segment 수를 제한합니다. 임계값을 초과하면 데이터 적재가 -238 오류로 실패합니다. segment가 너무 많으면 컴팩션이 많은 메모리를 점유하여 OOM 오류를 일으킬 수 있습니다.
기본값: 200

`high_priority_flush_thread_num_per_store`

유형: int32
설명: 우선순위가 높은 데이터 적재 작업에 할당되는 스토리지 경로별 플러시 스레드 수입니다.
기본값: 1

`routine_load_consumer_pool_size`

유형: int32
설명: Routine Load에서 사용하는 데이터 consumer의 캐시 개수입니다.
기본값: 10

`multi_table_batch_plan_threshold`

유형: int32
설명: 단일 스트림 다중 테이블 데이터 적재에 사용됩니다. Kafka에서 메시지 배치를 수신할 때 배치 크기가 이 임계값을 초과하면 관련된 모든 테이블의 실행 계획을 요청합니다.
기본값: 200

`multi_table_max_wait_tables`

유형: int32
설명: 단일 스트림 다중 테이블 데이터 적재에 사용됩니다. Kafka에서 메시지 배치를 수신할 때 실행 계획을 기다리는 테이블 수가 이 임계값을 초과하면 관련된 모든 테이블의 실행 계획을 요청합니다. 한 번에 너무 많은 실행 계획을 요청하고 실행하는 것을 방지하기 위한 매개변수입니다. 데이터 적재 중 여러 테이블을 작은 배치로 처리하면 단일 RPC의 부담을 줄이고 데이터 처리의 실시간성을 높일 수 있습니다.
기본값: 5

`single_replica_load_download_num_workers`

유형: int32
설명: 단일 복제본 데이터 적재에서 segment를 다운로드하는 http 작업 스레드 수를 변경하는 데 주로 사용됩니다. 데이터 적재 동시성이 증가하면 이 매개변수를 조정하여 Slave 복제본이 Master 복제본의 데이터 파일을 제때 동기화하도록 할 수 있습니다. 필요한 경우 webserver_num_workers도 높여 IO 성능을 개선하세요.
기본값: 64

`load_task_high_priority_threshold_second`

유형: int32
설명: 데이터 적재 작업의 타임아웃이 이 임계값보다 작으면 Doris는 해당 작업을 우선순위가 높은 작업으로 간주합니다. 우선순위가 높은 작업은 별도의 플러시 스레드 풀을 사용합니다.
기본값: 120

`min_load_rpc_timeout_ms`

유형: int32
설명: 데이터 적재 작업의 각 RPC에 대한 최소 타임아웃입니다.
기본값: 20

`kafka_api_version_request`

유형: bool
설명: 사용하는 Kafka 버전이 0.10.0.0보다 낮으면 이 값을 false로 설정해야 합니다.
기본값: true

`kafka_broker_version_fallback`

설명: 사용하는 Kafka 버전이 0.10.0.0보다 낮고 kafka_api_version_request가 false로 설정되어 있으면, 대체 버전인 kafka_broker_version_fallback에 설정된 값을 사용합니다. 유효한 값은 0.9.0.x, 0.8.x.y입니다.
기본값: 0.10.0

`max_consumer_num_per_group`

설명: 데이터 consumer 그룹의 최대 consumer 수입니다. Routine Load에 사용됩니다.
기본값: 3

`streaming_load_max_mb`

유형: int64
설명: 단일 Stream Load에서 허용하는 CSV 데이터의 최대 크기를 제한합니다.
- Stream Load는 일반적으로 수 GB 미만의 데이터 적재에 적합하며, 너무 큰 데이터의 적재에는 적합하지 않습니다.
기본값: 10240 (MB)
동적 변경 가능: 예

`streaming_load_json_max_mb`

유형: int64
설명: 단일 Stream Load에서 허용하는 JSON 데이터의 최대 크기를 제한합니다. 단위는 MB입니다.
- JSON과 같은 일부 데이터 형식은 분할할 수 없습니다. Doris는 파싱을 시작하기 전에 모든 데이터를 메모리로 읽어야 합니다. 따라서 이 값으로 단일 Stream Load에서 적재할 수 있는 최대 데이터양을 제한합니다.
기본값: 100
동적 변경 가능: 예

`olap_table_sink_send_interval_microseconds`

설명: 데이터 적재 중에는 폴링 스레드가 Coordinator의 sink 노드에서 해당 BE로 데이터를 계속 전송합니다. 이 스레드는 olap_table_sink_send_interval_microseconds 마이크로초마다 전송할 데이터가 있는지 확인합니다.
기본값: 1000

`olap_table_sink_send_interval_auto_partition_factor`

설명: 자동 파티션이 활성화된 테이블에 데이터를 적재할 때 olap_table_sink_send_interval_microseconds 간격은 너무 길 수 있습니다. 이 경우 실제 간격에 이 계수를 곱합니다.
기본값: 0.001

`enable_group_commit_streamload_be_forward`

유형: bool
설명: 컴퓨팅과 스토리지가 분리된 모드에서 Group Commit용 Stream Load BE 전달을 활성화할지 여부입니다. Doris 4.0 계열의 4.0.8 버전과 4.1 계열의 4.1.4 버전에서 추가되었습니다. 동적 변경을 지원합니다.
- 로드 밸런서가 동일한 테이블의 Group Commit 요청을 서로 다른 BE에 무작위로 분산하여 효과적인 배치 처리를 방해하는 문제를 해결합니다. 활성화하면 BE가 요청을 단일 대상 BE로 전달합니다.
- 4.0.8 버전부터 BE 엔드포인트 /api/{db}/{table}/_stream_load_forward는 이 설정으로 제어됩니다. false이면 해당 엔드포인트에 대한 요청은 403 Forbidden 상태와 Stream load forward is disabled 메시지를 반환합니다. true이면 해당 엔드포인트에 대한 요청은 인증을 통과해야 하며 전역 LOAD 권한도 필요합니다.
- 이 전달 기능을 사용하는 배포 환경에서는 FE와 BE 모두에서 이 설정을 true로 지정해야 합니다(FE 설정의 동일한 이름의 FE 설정 참조).
기본값: false

스레드

`delete_worker_count`

설명: 데이터 삭제 작업을 수행하는 스레드 수입니다.
기본값: 3

`clear_transaction_task_worker_count`

설명: 트랜잭션 정리에 사용하는 스레드 수입니다.
기본값: 1

`clone_worker_count`

설명: 복제 작업을 수행하는 스레드 수입니다.
기본값: 3

`be_service_threads`

유형: int32
설명: BE의 thrift 서버 서비스 실행 스레드 수입니다. FE 요청을 실행하는 데 사용할 수 있는 스레드 수를 나타냅니다.
기본값: 64

`download_worker_count`

설명: 다운로드 스레드 수입니다.
기본값: 1

`drop_tablet_worker_count`

설명: tablet을 삭제하는 스레드 수입니다.
기본값: 3

`flush_thread_num_per_store`

설명: 스토리지별로 메모리 테이블을 플러시하는 데 사용하는 스레드 수입니다.
기본값: 2

`publish_version_worker_count`

설명: 버전을 게시하는 스레드 수입니다.
기본값: 8

`upload_worker_count`

설명: 파일 업로드에 사용하는 최대 스레드 수입니다.
기본값: 1

`webserver_num_workers`

설명: Webserver의 기본 작업 스레드 수입니다.
기본값: 48

`send_batch_thread_pool_thread_num`

유형: int32
설명: SendBatch 스레드 풀의 스레드 수입니다. NodeChannel의 데이터 전송 작업에서는 각 NodeChannel의 SendBatch 연산이 스레드 작업으로 스레드 풀에 제출되어 스케줄링됩니다. 이 매개변수는 SendBatch 스레드 풀의 크기를 결정합니다.
기본값: 64

`send_batch_thread_pool_queue_size`

유형: int32
설명: SendBatch 스레드 풀의 큐 길이입니다. NodeChannel의 데이터 전송 작업에서는 각 NodeChannel의 SendBatch 연산이 스레드 작업으로 스레드 풀에 제출되어 스케줄링을 기다립니다. 제출된 작업 수가 스레드 풀의 큐 길이를 초과하면, 이후 제출되는 작업은 큐에 빈 슬롯이 생길 때까지 차단됩니다.
기본값: 102400

`make_snapshot_worker_count`

설명: 스냅샷을 생성하는 스레드 수입니다.
기본값: 5

`release_snapshot_worker_count`

설명: 스냅샷을 해제하는 스레드 수입니다.
기본값: 5

메모리

`madvise_huge_pages`

유형: bool
설명: Linux 메모리의 huge page를 사용할지 여부입니다.
기본값: false

`max_memory_sink_batch_count`

설명: 외부 스캔 캐시의 최대 배치 수입니다. max_memory_cache_batch_count * batch_size개의 행을 캐싱한다는 의미입니다. 기본값은 20이고 batch_size의 기본값은 1024이므로, 20 * 1024개의 행을 캐싱합니다.
기본값: 20

`memory_max_alignment`

설명: 최대 메모리 정렬 크기입니다.
기본값: 16

`mmap_buffers`

설명: 메모리 할당에 mmap을 사용할지 여부입니다.
기본값: false

`memtable_mem_tracker_refresh_interval_ms`

설명: memtable flush mgr의 갱신 반복 간격이며, 단위는 밀리초입니다.
기본값: 100

`zone_map_row_num_threshold`

유형: int32
설명: 페이지의 행 수가 이 값보다 작으면 데이터 크기 증가를 줄이기 위해 zonemap을 생성하지 않습니다.
기본값: 20

`memory_mode`

유형: string
설명: tcmalloc의 GC를 제어합니다. performance 모드에서는 메모리 사용량 >= 90% * mem_limit일 때 Doris가 tcmalloc 캐시 메모리를 해제합니다. 그 외의 모드에서는 메모리 사용량 >= 50% * mem_limit일 때 Doris가 tcmalloc 캐시 메모리를 해제합니다.
기본값: performance

`max_sys_mem_available_low_water_mark_bytes`

유형: int64
설명: 시스템 /proc/meminfo/MemAvailable의 메모리 부족 기준값에 대한 상한입니다. 단위는 바이트이며 기본값은 1.6G입니다. 실제 기준값은 min(1.6G, MemTotal * 10%)로, 메모리가 16G보다 큰 서버에서 메모리가 과도하게 낭비되는 것을 방지합니다. 상한을 높이면 메모리가 16G보다 큰 서버에서 Full GC를 위한 메모리 버퍼를 더 많이 확보합니다. 상한을 낮추면 메모리를 최대한 활용합니다.
기본값: 1717986918

`memory_limitation_per_thread_for_schema_change_bytes`

설명: 단일 스키마 변경 작업에 허용되는 최대 메모리입니다.
기본값: 2147483648 (2GB)

`mem_tracker_consume_min_size_bytes`

유형: int32
설명: MemTracker의 consume/release를 수행할 때 TCMalloc Hook에서 사용하는 최소 크기입니다. 이 값보다 작은 메모리 사용량은 계속 누적하여 MemTracker의 consume/release가 자주 호출되지 않도록 합니다. 이 값을 낮추면 consume/release 호출 빈도가 증가합니다. 이 값을 높이면 MemTracker 통계가 부정확해집니다. 이론적으로 MemTracker 통계값과 실제 값의 차이는 ( mem_tracker_consume_min_size_bytes * 해당 MemTracker가 사용되는 BE 스레드 수)입니다.
기본값: 1,048,576

`min_buffer_size`

설명: 최소 읽기 버퍼 크기입니다.
기본값: 1024 (byte)

`write_buffer_size`

설명: 플러시 전 버퍼 크기입니다.
- 적재된 데이터는 먼저 BE의 메모리 블록에 기록되며, 이 메모리 블록이 임계값에 도달하면 디스크에 기록됩니다. 기본 크기는 200MB입니다. 임계값이 너무 작으면 BE에 작은 파일이 대량으로 생성될 수 있습니다. 임계값을 높이면 파일 수를 줄일 수 있지만, 너무 높으면 RPC 타임아웃이 발생할 수 있습니다.
기본값: 209,715,200

`remote_storage_read_buffer_mb`

유형: int32
설명: HDFS 또는 오브젝트 스토리지의 파일을 읽을 때 사용하는 캐시 크기입니다.
- 이 값을 높이면 원격 데이터를 읽는 호출 횟수를 줄일 수 있지만 메모리 오버헤드가 증가합니다.
기본값: 16 (MB)

`file_cache_type`

유형: string
설명: 파일 캐시 유형입니다. whole_file_cache는 전체 segment 파일을 다운로드하고, sub_file_cache는 segment 파일을 크기에 따라 여러 파일로 나눕니다. ""로 설정하면 캐시를 사용하지 않습니다. 캐시가 필요한 경우 이 매개변수를 설정하세요.
기본값: ""

`path_gc_check`

유형：bool
설명: 데이터 회수 스캔 스레드 검사를 활성화할지 여부입니다.
기본값：true

`path_gc_check_interval_second`

설명: 데이터 회수 스캔 스레드의 검사 간격입니다.
기본값：86400 (s)

`path_gc_check_step`

기본값：1000

`path_gc_check_step_interval_ms`

기본값：10 (ms)

`scan_context_gc_interval_min`

설명: context GC 스레드의 스케줄링 주기를 설정합니다. 참고: 단위는 분이며 기본값은 5분입니다.
기본값：5

스토리지

`inverted_index_skip_norms_for_variant`

유형: bool
설명: 4.1.5 버전부터 지원됩니다. 동적 설정을 지원합니다. true이면 VARIANT 하위 경로의 역색인에서 인덱스의 norms 속성과 관계없이 Norms를 생략합니다. 여러 하위 경로의 인덱스 스토리지 사용량을 줄일 수 있지만, 해당 인덱스에서는 Norms가 필요한 BM25 score() 계산을 더 이상 지원할 수 없습니다. 기본적으로 Norms는 유지됩니다. 관련도 점수 계산을 참조하세요.
기본값: false

`default_num_rows_per_column_file_block`

유형: int32
설명: 단일 RowBlock에 포함되는 데이터 행 수를 설정합니다.
기본값: 1024

`disable_storage_page_cache`

유형: bool
설명: 인덱스 캐싱에 페이지 캐시를 사용하지 않도록 합니다. 이 설정은 BETA 스토리지 형식에서만 적용되며, 일반적으로 false로 설정하는 것이 좋습니다.
기본값: false

`disk_stat_monitor_interval`

설명: 디스크 상태 검사 간격입니다.
기본값: 5 (s)

`max_free_io_buffers`

설명: 각 IO 버퍼 크기에 대해 IoMgr가 확보해 둘 최대 버퍼 수입니다. 버퍼 크기는 1024B에서 8MB까지이며, 전체 버퍼 크기는 최대 약 2GB입니다.
기본값: 128

`max_garbage_sweep_interval`

설명: 디스크 가비지 정리의 최대 간격입니다.
기본값: 3600 (s)

`max_percentage_of_error_disk`

유형: int32
설명: 스토리지 엔진이 허용하는 손상된 디스크의 백분율입니다. 손상된 디스크 비율이 이 값을 초과하면 BE가 자동으로 종료됩니다.
기본값: 0

`min_garbage_sweep_interval`

설명: 디스크 가비지 정리의 최소 간격입니다.
기본값: 180 (s)

`pprof_profile_dir`

설명: pprof 프로파일 저장 디렉터리입니다.
기본값: ${DORIS_HOME}/log

`small_file_dir`

설명: SmallFileMgr가 다운로드한 파일을 저장합니다.
기본값: ${DORIS_HOME}/lib/small_file/

`user_function_dir`

설명: udf 함수 디렉터리입니다.
기본값: ${DORIS_HOME}/lib/udf

`storage_flood_stage_left_capacity_bytes`

설명: 데이터 디렉터리에 남겨 두어야 하는 최소 바이트 수입니다.
기본값: 1073741824

`storage_flood_stage_usage_percent`

설명: storage_flood_stage_usage_percent와 storage_flood_stage_left_capacity_bytes 설정은 데이터 디렉터리의 최대 용량 사용량을 제한합니다.
기본값: 90 (90%)

`storage_medium_migrate_count`

설명: 복제를 수행하는 스레드 수입니다.
기본값: 1

`storage_page_cache_limit`

설명: 스토리지 페이지 캐시 크기입니다.
기본값: 20%

`storage_page_cache_shard_size`

설명: StoragePageCache의 샤드 크기입니다. 값은 이의 거듭제곱이어야 합니다. 잠금 경합을 줄이려면 BE의 코어 수에 가까운 값으로 설정하는 것이 좋습니다.
기본값: 16

`index_page_cache_percentage`

유형: int32
설명: 전체 스토리지 페이지 캐시에서 인덱스 페이지 캐시가 차지하는 백분율입니다. 값의 범위는 [0, 100]입니다.
기본값: 10

`segment_cache_capacity`

유형: int32
설명: segment 캐시 항목의 최대 개수입니다(키는 rowset ID). -1은 이전 버전과의 호환성을 위해 fd_number * 2/5를 사용함을 의미합니다.
기본값: -1

`storage_strict_check_incompatible_old_format`

유형: bool
설명: 호환되지 않는 이전 형식을 엄격하게 검사합니다.
기본값: true
동적 변경: false

`sync_tablet_meta`

설명: 스토리지 엔진에서 sync를 활성화하여 디스크에 영구 저장할지 여부입니다.
기본값: true

`pending_data_expire_time_sec`

설명: 스토리지 엔진이 검증되지 않은 데이터를 보관하는 최대 시간입니다.
기본값: 1800 (s)

`ignore_rowset_stale_unconsistent_delete`

유형: boolean
설명: 병합된 오래된 rowset이 일관된 버전 경로를 구성할 수 없을 때 해당 rowset을 삭제할지 결정합니다.
- 병합된 오래된 rowset의 버전 경로는 반 시간이 지나면 삭제됩니다. 비정상적인 상황에서는 이러한 버전을 삭제하면 쿼리에 필요한 일관된 경로를 구성할 수 없는 문제가 발생합니다. false로 설정하면 프로그램이 엄격하게 검사하여 오류를 보고하고 즉시 종료합니다. true로 설정하면 프로그램이 이 오류를 무시하고 정상 실행됩니다. 일반적으로 이 오류를 무시해도 쿼리에 영향을 주지 않지만, FE가 병합된 버전을 지정한 경우에는 -230 오류가 발생합니다.
기본값: false

`create_tablet_worker_count`

설명: BE가 tablet을 생성하는 작업 스레드 수입니다.
기본값: 3

`check_consistency_worker_count`

설명: tablet의 체크섬을 계산하는 작업 스레드 수입니다.
기본값: 1

`max_tablet_version_num`

유형: int
설명: 단일 tablet의 버전 수를 제한합니다. 데이터 적재가 너무 잦거나 컴팩션이 제때 수행되지 않아 버전이 대량으로 누적되는 것을 방지합니다. 제한을 초과하면 데이터 적재 작업이 거부됩니다.
기본값: 2000

`tablet_map_shard_size`

설명: tablet_map_lock의 샤드 크기입니다. 값은 2^n이며, n=0,1,2,3,4입니다. tablet 관리를 개선하기 위한 설정입니다.
기본값: 4

`tablet_meta_checkpoint_min_interval_secs`

설명: TabletMeta Checkpoint 스레드의 폴링 시간 간격입니다.
기본값: 600 (s)

`tablet_meta_checkpoint_min_new_rowsets_num`

설명: TabletMeta Checkpoint를 저장하기 위한 최소 Rowset 수입니다.
기본값: 10

`tablet_rowset_stale_sweep_time_sec`

유형: int64
설명: 병합된 rowset 버전을 정리하는 만료 시간을 제어합니다. 현재 시간 now()에서 버전 경로 내 가장 최근에 생성된 rowset의 생성 시간을 뺀 값이 tablet_rowset_stale_sweep_time_sec보다 크면, 해당 경로를 정리하고 병합된 rowset을 삭제합니다. 단위는 초입니다.
- 쓰기가 너무 빈번하면 FE가 병합된 버전을 조회하지 못해 쿼리에서 -230 오류가 발생할 수 있습니다. 이 매개변수 값을 높이면 문제를 방지할 수 있습니다.
기본값: 300

`tablet_writer_open_rpc_timeout_sec`

설명: tablet 상태 캐시의 업데이트 간격입니다.
- 데이터 적재 중 Batch(1024행)를 전송하는 RPC의 타임아웃입니다. 기본값은 60초입니다. 이 RPC는 여러 메모리 배치의 쓰기를 수반할 수 있으므로 배치 쓰기로 인해 RPC 타임아웃이 발생할 수 있습니다. 따라서 이 타임아웃을 조정하여 send batch fail과 같은 타임아웃 오류를 줄일 수 있습니다. write_buffer_size 설정값을 높이는 경우 이 매개변수도 함께 높여야 합니다.
기본값: 60

`tablet_writer_ignore_eovercrowded`

유형: bool
설명: 데이터 쓰기 시 brpc 오류 '[E1011]The server is overcrowded'를 무시하는 데 사용됩니다.
기본값: false

`streaming_load_rpc_max_alive_time_sec`

설명: TabletsChannel의 수명입니다. 이 시간 동안 채널이 데이터를 수신하지 않으면 삭제됩니다.
기본값: 1200

`alter_tablet_worker_count`

설명: 스키마 변경을 수행하는 스레드 수입니다.
기본값: 3

`alter_index_worker_count`

설명: 인덱스 변경을 수행하는 스레드 수입니다.
기본값: 3

`ignore_load_tablet_failure`

유형: bool
설명: tablet 로딩에 실패했을 때 오류를 무시하고 BE 시작을 계속 진행할지 결정합니다.
기본값: false

BE가 시작되면 데이터 디렉터리마다 별도의 스레드를 시작하여 tablet 헤더의 메타 정보를 로딩합니다. 기본 설정에서는 데이터 디렉터리에서 tablet 로딩에 실패하면 시작 과정이 종료됩니다. 동시에 be The following error message is seen in the INFO 로그에 다음 오류 메시지가 표시됩니다.

load tablets from header failed, failed tablets size: xxx, path=xxx

이 메시지는 해당 데이터 디렉터리에서 로딩에 실패한 tablet 수를 나타냅니다. 로그에는 로딩에 실패한 tablet의 구체적인 정보도 포함됩니다. 이 경우 수동으로 오류 원인을 조사해야 합니다. 원인을 파악한 후에는 일반적으로 다음 두 가지 방법으로 복구할 수 있습니다.

tablet 정보를 복구할 수 없고 다른 복제본이 정상이면 meta_tool 도구로 문제가 있는 tablet을 삭제할 수 있습니다.
ignore_load_tablet_failure를 true로 설정하면 BE는 문제가 있는 tablet을 무시하고 정상적으로 시작합니다.

`report_disk_state_interval_seconds`

설명: 에이전트가 디스크 상태를 FE에 보고하는 시간 간격입니다.
기본값: 60 (s)

`result_buffer_cancelled_interval_time`

설명: 결과 버퍼 취소 시간입니다.
기본값: 300 (s)

`snapshot_expire_time_sec`

설명: 스냅샷 파일 정리 간격입니다.
기본값:172800 (48시간)

로그

`sys_log_dir`

유형: string
설명: BE 로그 데이터의 저장 디렉터리입니다.
기본값: ${DORIS_HOME}/log

`sys_log_level`

설명: 로그 수준: INFO < WARNING < ERROR < FATAL
기본값: INFO

`sys_log_roll_mode`

설명: 로그 분할 크기입니다. 1G마다 로그 파일을 분할합니다.
기본값: SIZE-MB-1024

`sys_log_roll_num`

설명: 보관할 로그 파일 수입니다.
기본값: 10

`sys_log_verbose_level`

설명: 로그 표시 수준입니다. 코드에서 VLOG로 시작하는 로그 출력을 제어합니다.
기본값: 10

`sys_log_verbose_modules`

설명: 로그를 출력할 모듈입니다. olap을 지정하면 olap 모듈의 로그만 출력합니다.
기본값: 비어 있음

`aws_log_level`

유형: int32

설명: AWS SDK의 로그 수준입니다.

   Off = 0,
   Fatal = 1,
   Error = 2,
   Warn = 3,
   Info = 4,
   Debug = 5,
   Trace = 6

기본값: 3

`log_buffer_level`

설명: 로그 플러시 정책입니다. 기본적으로 로그는 메모리에 유지됩니다.
기본값: 비어 있음

기타

`enable_arrow_input_validation`

유형: bool
설명: 4.1.4 버전에서 추가되었습니다. Arrow 데이터를 Doris 내부 열로 변환하기 전에 Arrow 입력 버퍼를 검증할지 여부입니다. 활성화하면 검증에 약간의 추가 오버헤드가 발생하지만, 잘못된 Arrow 데이터로 인해 BE가 비정상 종료되는 것을 방지합니다.
기본값: true

`report_tablet_interval_seconds`

설명: 에이전트가 olap 테이블을 FE에 보고하는 시간 간격입니다.
기본값: 60 (s)

`report_task_interval_seconds`

설명: 에이전트가 작업 서명을 FE에 보고하는 시간 간격입니다.
기본값: 10 (s)

`periodic_counter_update_period_ms`

설명: 속도 카운터와 샘플링 카운터의 업데이트 주기입니다.
기본값: 500 (ms)

`enable_metric_calculator`

설명: true로 설정하면 메트릭 계산기가 실행되어 BE 관련 지표 정보를 수집합니다. false로 설정하면 실행되지 않습니다.
기본값: true

`enable_system_metrics`

설명: 시스템 지표 수집을 켜거나 끕니다.
기본값: true

`enable_token_check`

설명: 전방 호환성을 위해 사용되며, 추후 제거될 예정입니다.
기본값: true

`max_runnings_transactions_per_txn_map`

설명: txn manager의 각 txn_partition_map에 허용되는 최대 txn 수입니다. manager에 너무 많은 txn이 저장되는 것을 방지하는 자체 보호 설정입니다.
기본값: 2000

`max_download_speed_kbps`

설명: 최대 다운로드 속도 제한입니다.
기본값: 50000 (kb/s)

`download_low_speed_time`

설명: 다운로드 시간 제한입니다.
기본값: 300 (s)

`download_low_speed_limit_kbps`

설명: 최소 다운로드 속도입니다.
기본값: 50 (KB/s)

`enable_batch_download`

설명: 파일을 배치로 다운로드할지 여부입니다. binlog가 활성화되어 있으면 이 설정을 켜는 것이 좋습니다.
기본값: false

`priority_queue_remaining_tasks_increased_frequency`

설명: BlockingPriorityQueue에 남아 있는 작업의 우선순위를 높이는 빈도입니다.
기본값: 512

`jdbc_drivers_dir`

설명: JDBC 드라이버를 저장하는 기본 디렉터리입니다.
기본값: ${DORIS_HOME}/jdbc_drivers

`enable_simdjson_reader`

설명: Stream Load 중 JSON 파싱에 simdjson을 사용할지 여부입니다.
기본값: true

`user_files_secure_path`

설명: local 테이블 값 함수로 쿼리하는 파일의 저장 디렉터리입니다.
기본값: ${DORIS_HOME}

`brpc_streaming_client_batch_bytes`

설명: brpc streaming 클라이언트가 데이터를 전송할 때의 배치 크기입니다.
기본값: 262144

`grace_shutdown_wait_seconds`

설명: 클라우드 네이티브 배포 환경에서는 BE가 클러스터에 자주 추가되거나 제거됩니다. 종료 중인 BE에서 fragment가 실행되고 있으면 사용자 쿼리가 실패합니다. stop_be.sh --grace를 사용하면 BE가 실행 중인 모든 쿼리가 종료될 때까지 기다려 쿼리 실패를 방지할 수 있습니다. 다만 대기 시간이 제한을 초과하면 BE가 즉시 종료됩니다. 이 기간 동안 FE는 해당 BE에 쿼리를 보내지 않고 실행 중인 모든 쿼리가 종료되기를 기다립니다.
기본값: 120

`enable_java_support`

설명: BE에서 java-jni 사용을 활성화할지 여부입니다. 활성화하면 c++와 java 간 상호 호출을 허용합니다. 현재 hudi, java-udf, jdbc, max-compute, paimon, preload, avro를 지원합니다.
기본값: true

`group_commit_wal_path`

Group Commit의 WAL 디렉터리입니다.
기본값: wal이라는 디렉터리가 storage_root_path의 각 디렉터리 아래에 생성됩니다. 설정 예시는 다음과 같습니다.
```
group_commit_wal_path=/data1/storage/wal;/data2/storage/wal;/data3/storage/wal
```

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

`deploy_mode`

기본값: ""
설명: BE의 실행 모드입니다. cloud는 스토리지와 컴퓨팅이 분리된 모드를 나타냅니다.

`meta_service_endpoint`

기본값: ""

설명: 메타 서비스의 엔드포인트를 'host1:port,host2:port' 형식으로 지정합니다. 일반적으로 이 값은 FE가 하트비트를 통해 BE에 전달하므로 별도로 설정할 필요가 없습니다.

`enable_file_cache`

기본값: true (4.1.5 버전부터 기본적으로 활성화됩니다. 이전 기본값은 false이며, 컴퓨팅과 스토리지 분리 모드에서는 항상 활성화됩니다).

설명: 파일 캐시를 사용할지 여부입니다. 변경 사항을 적용하려면 BE를 다시 시작해야 합니다. 세션 변수 enable_file_cache도 활성화해야 합니다. 4.1.5 버전에서는 BE 설정과 세션 변수의 기본값이 모두 true로 변경됩니다. 기존에 명시적으로 지정한 설정과 영구 저장된 전역 변수는 각각 확인하세요.

`enable_ms_rpc_host_level_rate_limit_dry_run`

유형: bool
설명: 4.1.5 버전부터 지원됩니다. 동적 설정을 지원합니다. BE에서 Meta Service로 보내는 RPC의 호스트 수준 속도 제한을 대기 없이 평가합니다. enable_ms_rpc_host_level_rate_limit와 독립적으로 동작하므로 해당 설정이 false여도 평가를 수행합니다. 둘 다 true이면 dry-run이 우선합니다. 속도 제한을 실제로 적용하려면 enable_ms_rpc_host_level_rate_limit를 활성화하고 이 설정을 비활성화하세요.
기본값: true

`enable_ms_backpressure_handling_dry_run`

유형: bool
설명: 4.1.5 버전부터 지원됩니다. 동적 설정을 지원합니다. Meta Service의 MS_BUSY 응답으로 트리거되는 테이블 수준의 적응형 속도 제한을 대기 없이 평가합니다. enable_ms_backpressure_handling과 독립적으로 동작하며, 둘 다 true이면 dry-run이 우선합니다. 테이블 수준 속도 제한을 실제로 적용하려면 enable_ms_backpressure_handling을 활성화하고 이 설정을 비활성화하세요.
기본값: true

`cache_peer_read_failure_threshold`

유형: int32
설명: 4.2.0 버전부터 지원됩니다. 동적 설정을 지원합니다. 피어 주소의 서킷 브레이커를 열기까지 허용하는 연속 연결 실패 또는 RPC 실패 횟수입니다. 실제 적용되는 최솟값은 1입니다. 이 주소 수준 상태는 서로 다른 tablet의 피어 읽기에서 공유되므로, 연결할 수 없는 노드에 반복해서 연결하는 것을 방지합니다.
기본값: 3

`cache_peer_read_circuit_open_seconds`

유형: int32
설명: 4.2.0 버전부터 지원됩니다. 동적 설정을 지원합니다. 피어 서킷 브레이커가 열린 상태에서 해당 주소에 대한 읽기를 거부하는 시간이며, 단위는 초입니다. 음수는 0으로 처리합니다. 이 시간이 지나면 복구 여부를 확인하는 탐색 요청을 한 번 허용합니다.
기본값: 30

`delete_bitmap_store_v2_max_bytes_in_fdb`

유형: int64
설명: 컴퓨팅과 스토리지 분리 모드에서 FDB에 직접 저장하는 Delete Bitmap V2의 최대 직렬화 크기이며, 단위는 바이트입니다. 동적 설정을 지원합니다. 음이 아닌 임계값을 초과하는 데이터는 대신 오브젝트 스토리지 파일에 저장합니다. 음수로 설정하면 크기에 따른 이러한 외부 저장을 비활성화합니다. 4.1.5 버전에서는 90000바이트 청크 내에 추가 메시지 필드가 들어갈 여유를 확보하면서 기본값을 1024에서 89000으로 높였습니다.
기본값: 89000 (4.1.5 이전에는 1024)

`enable_remove_agg_pre_rowsets_delete_bitmap_by_keys`

유형: bool
설명: 4.1.5 버전부터 지원됩니다. 동적 설정을 지원합니다. 컴퓨팅과 스토리지 분리 모드에서 집계된 과거 Delete Bitmap을 교체할 때 종료 버전의 레코드를 키로 삭제합니다. 범위 삭제를 사용하려면 false로 설정하세요. 기존 정리 과정에서 레코드를 삭제하는 방식만 변경하며, 별도의 정리 작업을 활성화하지는 않습니다.
기본값: true

`enable_remove_pre_rowsets_delete_bitmap_by_keys`

유형: bool
설명: 4.1.5 버전부터 지원됩니다. 동적 설정을 지원합니다. 컴퓨팅과 스토리지 분리 모드에서 집계된 범위 내의 과거 Delete Bitmap을 정리할 때 시작 버전(포함)부터 종료 버전(제외)까지의 레코드를 키로 삭제합니다. 범위 삭제를 사용하려면 false로 설정하세요. 기존 정리 기능의 활성화 설정과 전제 조건은 계속 적용됩니다.
기본값: true

`file_cache_path`

기본값: [{"path":"${DORIS_HOME}/file_cache"}]

설명: 파일 캐시에 사용하는 디스크 경로와 기타 매개변수입니다. 디스크별 항목이 하나씩 포함된 배열로 표현합니다. path는 디스크 경로를 지정하고, total_size는 캐시 크기를 제한합니다. -1 또는 0이면 전체 디스크 공간을 사용합니다.
형식: [{"path":"/path/to/file_cache","total_size":21474836480,{"path":"/path/to/file_cache2","total_size":21474836480}]

`enable_async_file_cache_write`

유형: bool
설명: 4.1.4 버전에서 추가되었습니다. 파일 캐시를 비동기적으로 기록할지 여부입니다. 활성화하면 원격 데이터를 파일 캐시에 기록하는 작업을 백그라운드 스레드 풀에 맡겨 읽기 경로가 차단되지 않도록 하므로, 콜드 읽기의 지연 시간을 줄일 수 있습니다.
기본값: false

`async_file_cache_write_workers_per_disk`

유형: int32
설명: 4.1.4 버전에서 추가되었습니다. 파일 캐시를 비동기적으로 기록할 때 캐시 디스크별로 사용하는 쓰기 스레드 수입니다. enable_async_file_cache_write = true일 때만 적용됩니다.
기본값: 16

`async_file_cache_write_max_pending_bytes`

유형: int64
설명: 4.1.4 버전에서 추가되었습니다. 비동기 파일 캐시 쓰기를 기다리는 데이터의 최대 총 크기이며, 단위는 바이트입니다. 이 제한을 초과하는 쓰기 요청은 버려집니다. 쿼리의 정확성에는 영향을 주지 않지만 해당 데이터는 캐시되지 않습니다. -1은 제한 없음을 의미합니다.
기본값: -1

`enable_file_cache_write_from_s3_file_writer`

유형: bool
설명: 4.1.4 버전에서 추가되었습니다. 오브젝트 스토리지에 데이터를 기록하면서 로컬 파일 캐시에도 함께 기록할지 여부입니다. 이를 통해 새로 기록한 데이터를 캐시에서 바로 읽을 수 있습니다.
기본값: true

`enable_file_cache_write_index_file_only`

유형: bool
설명: 4.1.4 버전에서 추가되었습니다. 파일 캐시에 인덱스 파일만 기록할지 여부입니다. 활성화하면 캐시 공간이 제한된 경우 인덱스를 우선적으로 캐시에 유지합니다.
기본값: false

`enable_cache_read_from_peer`

유형: bool
설명: 피어 캐시 읽기의 전체 활성화 여부를 제어합니다. 켜져 있으면 로컬 File Cache에 블록이 없을 때 먼저 다른 BE의 File Cache에서 해당 블록을 읽으려고 시도합니다. 같은 컴퓨팅 그룹과 다른 컴퓨팅 그룹의 BE를 모두 대상으로 하며, 어떤 BE에도 블록이 없을 때만 오브젝트 스토리지에서 읽습니다. 같은 그룹과 다른 그룹의 피어 읽기를 이 설정으로 함께 제어하므로, 그룹 간 읽기만 별도로 끌 수는 없습니다. 그룹 간 피어 읽기는 4.2.0 버전부터 지원되며, 이 버전에서 cache_read_from_peer_expired_seconds 설정 항목도 제거되었습니다. 피어 캐시 읽기를 참조하세요.
기본값: false (필요한 경우 명시적으로 활성화)

`enable_peer_s3_race`

유형: bool
설명: 4.2.0 버전에서 추가되었습니다. 피어 읽기와 오브젝트 스토리지 읽기를 경쟁 실행하여 먼저 반환된 결과를 사용할지 여부입니다. 꺼져 있으면 순차적으로 읽습니다. 피어 후보를 하나씩 시도하고 모든 후보에서 실패한 후에만 오브젝트 스토리지에서 읽습니다.
기본값: true

`peer_race_hedge_delay_ms`

유형: int32
설명: 4.2.0 버전에서 추가되었습니다. 경쟁 실행 시 피어 읽기를 먼저 시작한 후 기다리는 시간이며, 단위는 밀리초입니다. 이 시간 내에 피어가 응답하면 오브젝트 스토리지 읽기를 요청하지 않습니다. 0이면 두 읽기를 동시에 시작합니다.
기본값: 20

`max_concurrent_peer_races`

유형: int32
설명: 4.2.0 버전에서 추가되었습니다. 단일 BE에서 피어 읽기와 오브젝트 스토리지 읽기를 동시에 경쟁 실행할 수 있는 최대 개수입니다. 이 한도를 초과하는 캐시 미스는 순차적으로 읽습니다.
기본값: 64

`peer_cache_fill_compute_group_id`

유형: string
설명: 4.2.0 버전에서 추가되었습니다. 읽기를 요청하는 BE에 설정합니다. 그룹 간 캐시 채우기를 담당하는 컴퓨팅 그룹의 ID입니다(compute_group_id 값으로, Tag 열에 표시되며 SHOW BACKENDS로 조회할 수 있습니다. 컴퓨팅 그룹 이름이 아닙니다). 선택한 피어 후보가 이 컴퓨팅 그룹에 속하고 해당 블록을 가지고 있지 않으면, 요청을 통해 해당 피어가 오브젝트 스토리지에서 블록을 가져와 자신의 File Cache에 기록하도록 합니다. 비어 있으면 캐시 채우기를 사용하지 않습니다.
기본값: ""

`enable_peer_server_cache_fill`

유형: bool
설명: 4.2.0 버전에서 추가되었습니다. 캐시를 제공하는 BE에 설정합니다. 채우기 플래그가 포함된 피어 읽기 요청을 수락할지 여부입니다. 꺼져 있으면 로컬에 캐시되지 않은 블록을 찾을 수 없다고 응답하며, 요청한 BE는 오브젝트 스토리지에서 읽습니다.
기본값: true

`peer_server_cache_fill_timeout_ms`

유형: int32
설명: 4.2.0 버전에서 추가되었습니다. 제공 측에서 단일 캐시 채우기를 기다리는 최대 시간이며, 단위는 밀리초입니다. 타임아웃이 발생하면 요청한 BE는 오브젝트 스토리지에서 읽습니다.
기본값: 6000

`max_concurrent_peer_server_fills`

유형: int32
설명: 4.2.0 버전에서 추가되었습니다. 제공 측에서 동시에 수행할 수 있는 캐시 채우기의 최대 개수입니다. 한도를 초과하는 채우기 요청은 거부되며, 요청한 BE는 오브젝트 스토리지에서 읽습니다.
기본값: 32

`peer_rpc_failure_eviction_threshold`

유형: int32
설명: 4.2.0 버전에서 추가되었습니다. 피어 후보에서 RPC가 이 횟수만큼 연속으로 실패하면 해당 피어를 후보 목록에서 제거합니다.
기본값: 3

`peer_all_miss_cooldown_threshold`

유형: int32
설명: 4.2.0 버전에서 추가되었습니다. 모든 피어 후보에서 캐시 미스가 발생한 읽기가 이 횟수만큼 연속되면 tablet이 쿨다운 상태로 전환됩니다. 쿨다운 중에는 오브젝트 스토리지에서 바로 읽습니다.
기본값: 5

`peer_all_miss_cooldown_duration_s`

유형: int64
설명: 4.2.0 버전에서 추가되었습니다. 피어 읽기의 쿨다운 시간이며, 단위는 초입니다.
기본값: 300

`peer_candidate_expiry_s`

유형: int64
설명: 4.2.0 버전에서 추가되었습니다. 마지막 사용 시점부터 계산하는 피어 후보 항목의 만료 시간이며, 단위는 초입니다. 만료된 항목은 메모리에서 제거되고, 다음 캐시 미스가 발생하면 FE에서 다시 가져옵니다.
기본값: 3600

`peer_candidate_cleanup_interval_s`

유형: int64
설명: 4.2.0 버전에서 추가되었습니다. 만료된 피어 후보를 정리하는 백그라운드 작업의 실행 간격이며, 단위는 초입니다.
기본값: 3600

`peer_fetch_queue_timeout_ms`

유형: int32
설명: 4.2.0 버전에서 추가되었습니다. 피어 읽기 요청이 제공 측의 처리 큐에서 대기할 수 있는 최대 시간이며, 단위는 밀리초입니다. 이 시간보다 오래 대기한 요청은 거부하여 요청한 BE가 빠르게 오브젝트 스토리지에서 읽도록 합니다.
기본값: 100

`brpc_peer_fetch_pool_threads`

유형: int32
설명: 4.2.0 버전에서 추가되었습니다. 제공 측에서 피어 읽기 요청을 처리하는 스레드 풀의 크기입니다. 데이터 적재처럼 부하가 큰 RPC의 스레드 풀과 분리되어 있습니다. -1은 max(64, 2 × CPU cores)를 의미합니다. 동적으로 변경할 수 없습니다.
기본값: -1

`brpc_peer_fetch_pool_max_queue_size`

유형: int32
설명: 4.2.0 버전에서 추가되었습니다. 제공 측 피어 읽기 스레드 풀의 큐 길이입니다. -1은 max(4096, 128 × CPU cores)를 의미합니다. 동적으로 변경할 수 없습니다.
기본값: -1

`min_peer_race_s3_thread_num` / `max_peer_race_s3_thread_num`

유형: int32
설명: 4.2.0 버전에서 추가되었습니다. 피어 읽기와 오브젝트 스토리지 읽기를 경쟁 실행할 때, 요청 측에서 오브젝트 스토리지 읽기를 수행하는 풀의 최소 / 최대 스레드 수입니다. 동적으로 변경할 수 없습니다.
기본값: 0 / 32

`s3_get_requests_per_second_per_core` / `s3_put_requests_per_second_per_core`

유형: int64
설명: 4.1.4 버전에서 추가되었습니다. CPU 코어당 계산하는 오브젝트 스토리지 GET / PUT 요청의 QPS 제한입니다. 음수이면 이 모드를 비활성화하고 기존의 절대 토큰 수 설정을 사용합니다. 0은 QPS를 제한하지 않음을 의미합니다.
기본값: -1

`s3_get_requests_per_second_max` / `s3_put_requests_per_second_max`

유형: int64
설명: 4.1.4 버전에서 추가되었습니다. CPU 코어 수로 계산한 GET / PUT QPS의 절대 상한입니다. 0 이하이면 상한이 없음을 의미합니다.
기본값: 0

`s3_get_bytes_per_second_per_core` / `s3_put_bytes_per_second_per_core`

유형: int64
설명: 4.1.4 버전에서 추가되었습니다. CPU 코어당 계산하는 오브젝트 스토리지 GET / PUT의 대역폭 제한입니다(코어당 초당 바이트 수). 0 이하이면 대역폭을 제한하지 않음을 의미합니다.
기본값: -1

`s3_get_bytes_per_second_max` / `s3_put_bytes_per_second_max`

유형: int64
설명: 4.1.4 버전에서 추가되었습니다. CPU 코어 수로 계산한 GET / PUT 대역폭의 절대 상한이며, 단위는 초당 바이트입니다. 0 이하이면 상한이 없음을 의미합니다.
기본값: 0

`s3_rate_limiter_cpu_cores_override`

유형: int32
설명: 4.1.4 버전에서 추가되었습니다. 위의 속도 제한을 계산하는 데 사용하는 CPU 코어 수입니다. 0 이하이면 서버의 코어 수를 자동으로 감지합니다.
기본값: 0

`s3_rate_limiter_log_interval`

유형: int64
설명: 4.1.4 버전에서 추가되었습니다. 오브젝트 스토리지 속도 제한이 트리거될 때 로그를 출력하는 최소 간격이며, 단위는 밀리초입니다.
기본값: 1000

`file_cache_mem_storage_shard_num`

유형: int32
설명: 4.1.4 버전에서 추가되었습니다. 파일 캐시 메모리 스토리지의 샤드 수입니다. 동시 접근 시 잠금 경합을 줄이는 데 사용됩니다.
기본값: 1024

`time_series_max_tablet_version_num`

유형: int
설명: 시계열 컴팩션 정책에서 단일 tablet의 버전 수를 제한합니다. 데이터 적재가 너무 잦거나 컴팩션이 제때 수행되지 않아 버전이 대량으로 누적되는 것을 방지합니다. 제한을 초과하면 데이터 적재 작업이 거부됩니다.
기본값: 20000

Report issue

이 페이지의 내용

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

설정 항목 조회​

설정 항목 지정​

예시​

설정 항목​

서비스​

deploy_mode​

bvar_max_dump_multi_dimension_metric_num​

be_port​

heartbeat_service_port​

webserver_port​

brpc_port​

arrow_flight_sql_port​

enable_https​

priority_networks​

storage_root_path​

heartbeat_service_thread_count​

ignore_broken_disk​

mem_limit​

cluster_id​

custom_config_dir​

trash_file_expire_time_sec​

es_http_timeout_ms​

es_scroll_keepalive​

external_table_connect_timeout_sec​

pipeline_status_report_interval​

brpc_max_body_size​

brpc_socket_max_unwritten_bytes​

transfer_large_data_by_brpc​

brpc_num_threads​

thrift_rpc_timeout_ms​

thrift_client_retry_interval_ms​

thrift_connect_timeout_seconds​

thrift_server_type_of_fe​

thrift_max_message_size​

txn_commit_rpc_timeout_ms​

txn_map_shard_size​

txn_shard_size​

unused_rowset_monitor_interval​

max_client_cache_size_per_host​

string_type_length_soft_limit_bytes​

big_column_size_buffer​

small_column_size_buffer​

쿼리​

ignore_not_found_file_in_external_table​

parquet_metadata_size_limit​

fragment_mgr_asynic_work_pool_queue_size​

fragment_mgr_asynic_work_pool_thread_num_min​

fragment_mgr_asynic_work_pool_thread_num_max​

doris_scanner_row_num​

doris_scanner_row_bytes​

doris_scanner_thread_pool_queue_size​

doris_scanner_thread_pool_thread_num​

doris_max_remote_scanner_thread_pool_thread_num​

exchg_node_buffer_size_bytes​

doris_scan_range_max_mb​

컴팩션​

disable_auto_compaction​

enable_vertical_compaction​

vertical_compaction_num_columns_per_group​

vertical_compaction_max_row_source_memory_mb​

vertical_compaction_max_segment_size​

enable_ordered_data_compaction​

ordered_data_compaction_min_segment_size​

max_base_compaction_threads​

generate_compaction_tasks_interval_ms​

base_compaction_min_rowset_num​

base_compaction_min_data_ratio​

total_permits_for_compaction_score​

compaction_promotion_size_mbytes​

compaction_promotion_ratio​

compaction_promotion_min_size_mbytes​

compaction_min_size_mbytes​

default_rowset_type​

cumulative_compaction_min_deltas​

cumulative_compaction_max_deltas​

base_compaction_trace_threshold​

cumulative_compaction_trace_threshold​

compaction_task_num_per_disk​

compaction_task_num_per_fast_disk​

cumulative_compaction_rounds_for_each_base_compaction_round​

설정 항목 조회

설정 항목 지정

예시

설정 항목

서비스

`deploy_mode`

`bvar_max_dump_multi_dimension_metric_num`

`be_port`

`heartbeat_service_port`

`webserver_port`

`brpc_port`

`arrow_flight_sql_port`

`enable_https`

`priority_networks`

`storage_root_path`

`heartbeat_service_thread_count`

`ignore_broken_disk`

`mem_limit`

`cluster_id`

`custom_config_dir`

`trash_file_expire_time_sec`

`es_http_timeout_ms`

`es_scroll_keepalive`

`external_table_connect_timeout_sec`

`pipeline_status_report_interval`

`brpc_max_body_size`

`brpc_socket_max_unwritten_bytes`

`transfer_large_data_by_brpc`

`brpc_num_threads`

`thrift_rpc_timeout_ms`

`thrift_client_retry_interval_ms`

`thrift_connect_timeout_seconds`

`thrift_server_type_of_fe`

`thrift_max_message_size`

`txn_commit_rpc_timeout_ms`

`txn_map_shard_size`

`txn_shard_size`

`unused_rowset_monitor_interval`

`max_client_cache_size_per_host`

`string_type_length_soft_limit_bytes`

`big_column_size_buffer`

`small_column_size_buffer`

쿼리

`ignore_not_found_file_in_external_table`

`parquet_metadata_size_limit`

`fragment_mgr_asynic_work_pool_queue_size`

`fragment_mgr_asynic_work_pool_thread_num_min`

`fragment_mgr_asynic_work_pool_thread_num_max`

`doris_scanner_row_num`

`doris_scanner_row_bytes`

`doris_scanner_thread_pool_queue_size`

`doris_scanner_thread_pool_thread_num`

`doris_max_remote_scanner_thread_pool_thread_num`

`exchg_node_buffer_size_bytes`

`doris_scan_range_max_mb`

컴팩션

`disable_auto_compaction`

`enable_vertical_compaction`

`vertical_compaction_num_columns_per_group`

`vertical_compaction_max_row_source_memory_mb`

`vertical_compaction_max_segment_size`

`enable_ordered_data_compaction`

`ordered_data_compaction_min_segment_size`

`max_base_compaction_threads`

`generate_compaction_tasks_interval_ms`

`base_compaction_min_rowset_num`

`base_compaction_min_data_ratio`

`total_permits_for_compaction_score`

`compaction_promotion_size_mbytes`

`compaction_promotion_ratio`

`compaction_promotion_min_size_mbytes`

`compaction_min_size_mbytes`

`default_rowset_type`

`cumulative_compaction_min_deltas`

`cumulative_compaction_max_deltas`

`base_compaction_trace_threshold`

`cumulative_compaction_trace_threshold`

`compaction_task_num_per_disk`

`compaction_task_num_per_fast_disk`

`cumulative_compaction_rounds_for_each_base_compaction_round`