cn.conf

spill_local_storage_dir

properties
    spill_local_storage_dir=/data1/spill;/data2/spill

query_scratch_dirs

query_pool_spill_mem_limit_threshold

1.0

query_pool_limit * threshold

0.8

spill_local_storage_dir

StarRocksCluster

yaml
    cn:
      spillStorageSize: 100Gi  # Sets the PVC size for spilling

cn.conf

sql
-- Enable spilling
SET GLOBAL enable_spill = true;

-- Set mode to auto (spill when memory is tight) or force (always spill)
SET GLOBAL spill_mode = 'auto';

spill_local_storage_dir

storage_root_path

Unknown database

enable_table_name_case_insensitive

admin show config like '%case_insensitive%';

sql
    SHOW DATABASES FROM <oracle_catalog_name>;

sql
    SELECT * FROM <oracle_catalog_name>."MY_SCHEMA"."MY_TABLE";

schema_resolver

sql
CREATE EXTERNAL CATALOG oracle_catalog
PROPERTIES (
    "type" = "jdbc",
    "user" = "...",
    "password" = "...",
    "jdbc_uri" = "jdbc:oracle:thin:@...",
    "driver_class" = "oracle.jdbc.driver.OracleDriver",
    "schema_resolver" = "oracle"  -- 명시적으로 지정
);

jdbc_meta_default_cache_enable

SHOW DATABASES FROM [카탈로그]

enable_table_name_case_insensitive

query_queue_v2_schedule_strategy

query_queue_v2_cpu_costs_per_slot

query_queue_v2_schedule_strategy

query_queue_v2_concurrency_level

query_queue_slots_estimator_strategy

MAX

root

CREATE EXTERNAL CATALOG

root

db_admin

sql
    GRANT CREATE EXTERNAL CATALOG ON SYSTEM TO USER 'username'@'%';

sql
    -- 역할 생성
    CREATE ROLE catalog_admin;
    -- 역할에 권한 부여
    GRANT CREATE EXTERNAL CATALOG ON SYSTEM TO ROLE catalog_admin;
    -- 사용자에게 역할 할당
    GRANT 'catalog_admin' TO USER 'username'@'%';

ON SYSTEM

CREATE EXTERNAL CATALOG

USAGE

GRANT USAGE ON CATALOG <catalog_name> TO USER <user>;

ANALYZE TABLE <table_name>

ANALYZE

sql
-- 자동 트리거를 끄고 싶다면 끈 후, 수동으로 실행
ANALYZE TABLE iceberg_catalog.db.table_name WITH SYNC MODE (col1, col2);

fe.audit.log

fe.audit.log

State=ERR

bash
    grep 'State=ERR' fe.audit.log

queryId

startTime

state

errorCode

errorMessage

sql
    SELECT queryId, stmt, errorCode, errorMessage
    FROM starrocks_audit_db*.starrocks_audit_tbl*
    WHERE state = 'ERR'
    ORDER BY timestamp DESC;

http://<FE_IP>:<FE_HTTP_PORT>/api/query_detail

queryId

state

sql

errorMessage

SELECT * FROM information_schema.loads WHERE STATE = 'CANCELLED';

SELECT * FROM information_schema.task_runs WHERE STATE = 'FAILED';

SHOW PROC

SHOW PROC

SHOW PROC

OPERATE

sql
    -- 특정 사용자에게 권한 부여
    GRANT OPERATE ON SYSTEM TO USER 'username'@'%';

    -- 또는 역할을 생성하여 권한 부여 후 사용자에게 할당 (권장)
    CREATE ROLE proc_admin;
    GRANT OPERATE ON SYSTEM TO ROLE proc_admin;
    GRANT proc_admin TO USER 'username'@'%';

NODE

SHOW PROC

OPERATE

sql
    SHOW USERS;

sql
    SHOW ALL AUTHENTICATION;

sql
    SHOW GRANTS FOR 'username'@'%';

user_admin

starrocks_fe_tablet_num

sum(starrocks_fe_tablet_num)

be_tablet_count

sql
SHOW PROC '/statistic';

DbId

DbName

TableNum

PartitionNum

sql
SHOW PROC '/backends';

TabletNum

sql
SHOW PROC '/dbs/<db_id>/<table_id>/partitions';

sql
SHOW TABLE STATUS LIKE 'table_name'; -- 기본적인 테이블 정보 확인

starrocks_fe_tablet_num

SHOW PROC '/statistic';

SHOW PROC '/backends';

sql
-- 테이블별로 실행 (가장 권장되는 방식)
ANALYZE TABLE <table_name> WITH FULL SCAN;

-- 만약 특정 컬럼만 집중적으로 사용한다면 (선택 사항)
-- ANALYZE TABLE <table_name> (col1, col2, ...) WITH FULL SCAN;

sql
-- 진행 상태 확인 (STATE가 FINISHED인지 확인)
SHOW ANALYZE STATUS ORDER BY StartTime DESC LIMIT 10;

sql
-- Query Queue v2 활성화 (기본값은 버전마다 다를 수 있음)
SET GLOBAL enable_query_queue_v2 = true;

-- (선택) 특정 리소스 그룹에 대해 테스트하고 싶다면 리소스 그룹 설정 확인
-- ALTER RESOURCE GROUP <group_name> WITH ('concurrency_limit' = '10');

enable_query_queue_v2 = false

enable_query_queue_v2 = true

QueryQueue

WaitTime

sql
    SELECT NOW();
    -- 또는
    SELECT CURRENT_TIMESTAMP();

sql
    SELECT CURRENT_DATE();

sql
    SELECT CURTIME();

time_zone

sql
SHOW VARIABLES LIKE '%time_zone%';

system_time_zone

time_zone

Asia/Shanghai

bash
date

SHOW VARIABLES

variables

sql
SET PASSWORD FOR 'root'@'%' = PASSWORD('새로운비밀번호');

fe.conf

fe.conf

conf
    enable_auth_check = false

bash
    mysql -h <FE_IP> -P <QUERY_PORT> -u root

sql
    SET PASSWORD FOR 'root'@'%' = PASSWORD('새로운비밀번호');

sql
SHOW GRANTS FOR 'root'@'%';

SHOW VARIABLES

fe.conf

fe.conf

password

secret

key

fe.conf

information_schema

http_port

enable_https = true

http_web_page_display_hardware = false

pipeline_dop

0

container_cpu_cfs_throttled_seconds_total

starrocks_be_cpu_idle

starrocks_be_resource_group_cpu_limit_ratio

starrocks_fe_thread_pool

starrocks_fe_query_latency

pipeline_dop

0

exclusive_cpu_cores

sql
-- 테이블별 통계 정보 업데이트 시간 및 건강도(Healthy) 확인
SHOW STATS META [WHERE table = 'table_name'];

sql
-- 최근 수집 작업의 상태(SUCCESS/FAILED) 확인
SHOW ANALYZE STATUS [WHERE table = 'table_name'];

-- 예약된 사용자 정의 수집 작업 확인
SHOW ANALYZE JOB;

sql
-- 기본 통계 정보(Row count, NDV, Min, Max 등) 조회
SELECT * FROM _statistics_.column_statistics WHERE table_name = 'your_table_name'\G

-- 히스토그램 정보 조회
SELECT * FROM _statistics_.histogram_statistics WHERE table_name = 'your_table_name'\G

sql
-- 전체 컬럼 수동 수집 (Full)
ANALYZE FULL TABLE table_name;

-- 특정 컬럼만 샘플링 수집 (속도 빠름)
ANALYZE SAMPLE TABLE table_name (col1, col2) WITH SAMPLE PERCENT 10;

-- 히스토그램 수집 (데이터 왜곡이 심한 컬럼에 권장)
ANALYZE TABLE table_name UPDATE HISTOGRAM ON col1, col2;

sql
-- 특정 테이블의 모든 통계 정보 삭제
DROP STATS table_name;

-- 히스토그램만 삭제
ANALYZE TABLE table_name DROP HISTOGRAM ON col_name;

ANALYZE

sql
-- SHOW ANALYZE STATUS에서 확인한 ID를 입력
KILL ANALYZE [ID];

INSERT INTO

INSERT OVERWRITE

ANALYZE FULL TABLE ...

ANALYZE TABLE

CREATE ANALYZE

statistic_collect_interval_sec

statistic_auto_collect_small_table_interval

statistic_auto_collect_large_table_interval

PendingTaskQueue

enable_query_trigger_analyze

SHOW ANALYZE STATUS

EXPLAIN

sql
EXPLAIN SELECT * FROM my_table WHERE id = 10;

LOGICAL

sql
EXPLAIN LOGICAL SELECT * FROM my_table JOIN other_table ON ...;

sql
SELECT * FROM my_table WHERE id = 10 LIMIT 0;

EXPLAIN

EXPLAIN ANALYZE

ERROR: ...

SHOW STATS META

sql
-- 현재 데이터베이스의 모든 테이블 통계 상태 조회
SHOW STATS META;

-- 특정 테이블의 통계 상태 조회
SHOW STATS META WHERE Table = 'your_table_name';

SHOW STATS META

Healthy

INSERT

UPDATE

DELETE

Last Refresh Time

Rows Number

Healthy

sql
-- 해당 테이블의 통계를 즉시 전체 수집 (Full Scan)
ANALYZE FULL TABLE your_table_name;

-- 또는 특정 컬럼만 샘플링하여 빠르게 수집
ANALYZE SAMPLE TABLE your_table_name WITH SAMPLE PERCENT 10;

Healthy

enable_statistic_collect

DROP STATS

_statistics_

CREATE ANALYZE

ANALYZE

sql
    -- FE 설정에서 통계 수집 시 프로파일 생성을 허용하도록 변경
    ADMIN SET FRONTEND CONFIG ("enable_statistics_collect_profile" = "true");

ANALYZE TABLE <table_name> ...

http://<fe_ip>:8030

SELECT ... FROM _statistics_

SHOW QUERY PROFILE;

PeakMemoryUsage

http://<be_ip>:<be_http_port>/mem_tracker

query_pool

statistic_full_collect_buffer

statistic_collect_max_row_count_per_query

enable_statistics_collect_profile

_statistics_

_statistics_

statistic_cache_columns

EXPLAIN

EXPLAIN <SQL>

SHOW STATS META

sql
    SHOW STATS META WHERE Table = 'table_name';

sql
-- 모든 테이블의 통계 요약 정보 및 건강도 확인
SHOW STATS META;

-- 특정 테이블의 상세 통계(컬럼별) 확인
SHOW COLUMN STATS table_name;

SHOW STATS META

Healthy

sql
-- 특정 테이블의 통계를 즉시 재수집 (메모리 적재 포함)
ANALYZE TABLE table_name;

_statistics_

EXPLAIN

DESC

sql
DESC 테이블명;
-- 또는
DESCRIBE 테이블명;

DESC catalog_name.db_name.table_name;

SHOW FULL COLUMNS

sql
SHOW FULL COLUMNS FROM 테이블명;

SHOW CREATE TABLE

sql
SHOW CREATE TABLE 테이블명;

information_schema

sql
SELECT 
    COLUMN_NAME, 
    DATA_TYPE, 
    COLUMN_COMMENT 
FROM information_schema.columns 
WHERE TABLE_NAME = '테이블명' 
  AND TABLE_SCHEMA = 'DB명';

DESC 테이블명

SHOW FULL COLUMNS FROM 테이블명

SHOW CREATE TABLE 테이블명

RANK()

ROW_NUMBER()

ORDER BY

ANALYTIC

col1 + col2

Estimates: {row: ..., cpu: ..., memory: ...}

VARCHAR

WHERE

row

row

memory

Estimates