Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Section


Column
width50%

프로퍼티란 $MACHBASE_HOME/conf/machbase.conf 파일에 정의되어 있는 키-값 의 쌍을 의미한다.

이 값들은 마크베이스 서버가 시작할 때 설정되고 실행시 지속적으로 이용된다. 성능 튜닝을 위해서 이 값을 변경하려면 이 값들에 대한 의미를 이해하고, 주의 깊게 설정하여야 한다.


CPU_AFFINITY_BEGIN_ID

마크베이스 서버가 사용할 CPU의 시작 번호이다. 마크베이스 서버의 CPU사용량을 조절하기 위해서 사용한다.


Value
최소값0
최대값2 ^ 32 - 1
기본값0

CPU_AFFINITY_COUNT

마크베이스 서버가 사용할 CPU의 수이다. 0으로 설정하면 마크베이스 서버가 모든 CPU를 사용한다.


Value
최소값0
최대값2 ^ 32 - 1
기본값0

CPU_COUNT

시스템에 설정된 CPU의 수를 지정한다. 이 값을 기반으로 마크베이스의 스레드 수를 결정한다. 0으로 지정한 경우에는 시스템의 모든 CPU를 사용한다.


Value
최소값0 (시스템에 물리적으로 설치된 CPU수)
최대값2^32 -1
기본값0

CPU_PARALLEL

CPU당 생성할 스레드의 수를 지정한다. 만약 이 값이 2이고 cpu의 수가 2인 경우, 두개의 CPU마다 병렬 스레드가 2개씩 생성되므로 병렬처리 스레드의 수가 4가 된다. 이 값이 너무 큰 경우, 메모리가 빨리 소모될 수 있다.


Value
최소값1
최대값2^32 -1
기본값1

DBS_PATH

마크베이스 서버의 기본 데이터가 저장될 경로를 지정한다. 기본값은 "?/dbs"로, $MACHBASE_HOME/dbs 를 의미한다.


Value
기본값?/dbs

DEFAULT_LSM_MAX_LEVEL

LSM인덱스의 기본 레벨을 설정한다. 인덱스를 생성할 때 MAX_LEVEL값을 입력하지 않으면 이 값이 적용된다.


Value
최소값0
최대값3
기본값2

DISK_BUFFER_COUNT

디스크 입출력을 위한 버퍼의 수를 지정한다.


Value
최소값1
최대값4G (4 * 1024 * 1024 * 1024)2^32 - 1
기본값16

DISK_COLUMNAR_INDEX_CHECKPOINT_INTERVAL_SEC

인덱스에 대한 체크포인트 주기를 설정한다. 너무 길게 설정할 경우, 인덱스 빌드에 오류가 발생할 수 있다.


Value
최소값1 (sec)
최대값2^32 -1 (sec)
기본값120 (sec)

DISK_COLUMNAR_INDEX_FDCACHE_COUNT

오픈한 인덱스 파티션 파일 디스크립터의 수를 지정한다.


Value
최소값0
최대값2^32 -1
기본값0



ui-text-box
Column
width45%

목차


Table of Contents
maxLevel3
indent20px
exclude목차
classtoc




DISK_COLUMNAR_INDEX_SHUTDOWN_BUILD_FINISH

...

데이터 쓰기 연산에 DIRECT I/O 를 사용할 것인지 설정한다.

...

설정한다. 파일 시스템에 따라서 DIRECT I/O 지원하지 않는 경우(ex: ZFS), 0으로 설정한다.


Value
최소값0
최대값1
기본값1

DISK_TAG_AUTO_RECLAIM

TAG 데이터에 대해서 사용되지 않는 공간을 자동 확보할 것인지의 여부를 결정한다. 기본값인 1인 경우, 자동 공간 확보 기능이 동작하고 0 인 경우에는 동작하지 않으며 사용자가 ALTER TABLE문을 이용하여 해당 기능을 직접 수행해야 한다.

...

LSM 인덱스의 생성을 위한 병합 연산을 수행하는 스레드의 수를 결정한다.


Value
최소값1
최대값1024
기본값3

MAX_QPX_MEM

...

LOOKUP_APPEND_UPDATE_ON_DUPKEY

Lookup 테이블에 Append 할 때 Primary Key가 중복일 경우 어떻게 처리할지 지정한다.

  • 0 : Append 실패
  • 1 : 해당 Primary Key 에 대해서 Row를 Update 한다.

Value
최소값0
최대값1
기본값0

MAX_QPX_MEM

GROUP BY, DISTINCT, ORDER BY 절을 수행하기 위해서 질의처리기가  이용하는 메모리의 최대 양을 설정한다.
하나의 질의문이 이보다 큰 값으로 메모리를 사용하게 되면 질의는 취소된다. 이때, 에러메시지를 클라이언트에 전송하고, machbase.trc 파일에 관련 내용이 기록된다.

...

_ARRIVAL_TIME 컬럼은 기본 설정으로는 SELECT * FROM 질의에 의해서 표시되지 않는다. 그러나 이 값이 1로 설정된 경우에는 해당 컬럼을 표시한다.


Value
최소값0
최대값1
기본값0

...

TABLE_

...

SCAN_

...

DIRECTION

태그 테이블의 스캔 방향을 설정할 수 있다. 프로퍼티 값은 -1,0, 1중 택일이며 기본값은 0이다.

  • -1 : 역방향 스캔
  • 0  : Tag Table(정방향 스캔), Log Table(역방향 스캔)
  • 1  : 정방향 스캔

Value
최소값-1
최대값1
기본값0

TAGDATA_AUTO_META_INSERT

ui-text-box
typeinfo

5.5 에서는 TAGDATA_AUTO_NAME_INSERT 이다. 값의 범위도 0/1 이다.
5.7 이하에서는 기본값이 1 이다.

...

  • 0 : 입력이 실패한다.
  • 1 : 입력을 원하는 TAG_NAME 값을 입력한다. 추가 메타데이터 컬럼이 존재할 경우, 해당 컬럼의 값은 모두 NULL 로 입력된다.
  • 2 : 입력을 원하는 TAG_NAME 값과 함께, 추가 메타데이터 컬럼 값도 같이 입력한다.
    • APPEND 에서만 유효한 설정이며, INSERT 는 추가 메타데이터 컬럼 값을 입력할 수 없기 때문에 1과 같이 작동한다.
    • 이 설정을 한 이후에는, APPEND 에서 반드시 메타데이터 컬럼 값까지 포함시킨 APPEND Parameter 로 입력해야 한다.

Value
최소값0
최대값2
기본값2

TAG_TABLE_META_MAX_SIZE

TAGDATA Table 생성 시 Metadata 영역을 보관할 메모리의 최대 크기를 설정한다.


Value
최소값1024*1024
최대값2^32-1
기본값100*1024*1024

TRACE_LOGFILE_COUNT

TRACE_LOGFILE_PATH에 생성되는 로그 트레이스 파일의 최대 수를 지정한다. 디스크 공간을 절약하기 위해서, 최대 개수 이상의 로그파일이 생성되면 가장 오래된 로그파일을 삭제한다.

로그 트레이스 파일의 최대 개수 이상의 로그파일이 생성되어 가장 오래된 파일이 삭제될 경우 삭제된 파일의 이름이 가장 최신의 로그파일로 저장이 된다.


Value
최소값1
최대값2^32 - 1
기본값1000

...

로그 트레이스 파일들(machbase.trc, machadmin.trc, machcollector.trc, machsql.trc)의 경로를 설정한다.
이 파일들은 마크베이스의 시작, 종료, 실행시 내부 정보를 지속적으로 기록한다. 기본값인 ?/trc의 의미는 $MACHBASE_HOME/trc 를 의미한다.

...

TRACE_LOGFILE_SIZE

 로그 트레이스 파일의 최대 크기를 설정한다. 만약 크기 이상의 데이터를 기록하여야 한다면, 신규로 log 파일을 생성할 것이다.

...

UNIX_PATH

Unix domain socket 파일의 경로를 설정한다. 사용자가 설정하지 않았을 경우의 기본 값은 ?/conf/machbase-unix 이다.

...

VOLATILE_TABLESPACE_MEMORY_MAX_SIZE

시스템의 모든 volatile, lookup 테이블의 메모리 사용량 총계의 한도를 설정한다.

...

DISK_BUFFER_COUNT

디스크 I/O를 수행하기 위한 버퍼의 수를 지정한다.

...

LOOKUP_APPEND_UPDATE_ON_DUPKEY

Lookup 테이블에 Append 할 때 Primary Key가 중복일 경우 어떻게 처리할지 지정한다.

...

trc)의 경로를 설정한다.
이 파일들은 마크베이스의 시작, 종료, 실행시 내부 정보를 지속적으로 기록한다. 기본값인 ?/trc의 의미는 $MACHBASE_HOME/trc 를 의미한다.


Value
기본값?/conf


TRACE_LOGFILE_PATH 값trc 디렉터리 위치
지정되지 않음$MACHBASE_HOME/trc/
?/test$MACHBASE_HOME/test/
/tmp/tmp/

TRACE_LOGFILE_SIZE

 로그 트레이스 파일의 최대 크기를 설정한다. 만약 크기 이상의 데이터를 기록하여야 한다면, 신규로 log 파일을 생성할 것이다.


Value
최소값10 * 1024 * 1024
최대값2^32 - 1
기본값10 * 1024 * 1024

UNIX_PATH

Unix domain socket 파일의 경로를 설정한다. 사용자가 설정하지 않았을 경우의 기본 값은 ?/conf/machbase-unix 이다.


Value
기본값?/conf/machbase-unix

VOLATILE_TABLESPACE_MEMORY_MAX_SIZE

시스템의 모든 volatile, lookup 테이블의 메모리 사용량 총계의 한도를 설정한다.


Value
최소값0
최대값2^64 - 1
기본값02 * 1024 * 1024 * 1024