2.Altibase 프로퍼티#

사용자는 Altibase 서버를 다양한 모드로 운영할 수 있다. Altibase 서버의 환경 설정은 Altibase 프로퍼티 파일을 이용하는 것이다. 프로퍼티 파일은 Altibase 서버의 운용 방식과 튜닝에 관한 모든 구성 요소를 포함하고 있다.

이 장에서는 Altibase를 사용자 업무에 적합한 데이터베이스로 구성하고 운영하기 위해서 설정하고 관리해야 하는 Altibase 프로퍼티들에 대해서 설명한다.

환경 설정 방법#

Altibase 서버와 관련된 환경을 설정하기 위한 방법은 세 가지가 있다.

첫째, Altibase 프로퍼티 파일, \$ALTIBASE_HOME/conf/altibase.properties를 변경하는 방식이다. 이 방식은 Altibase 서버가 실행되지 않은 상태에서 할 수 있는 정적인 환경 설정 방법으로, 프로퍼티 파일에서 해당 구성 요소를 특정 값으로 설정한 후 Altibase 서버를 재구동해야 수정된 값이 Altibase 서버에 반영된다.

둘째, Altibase 서버가 운영 중이더라도 Altibase 관련 환경 설정을 변경할 수 있는 동적인 방식이다. Altibase 서버를 내리지 않고도 변경할 수 있다는 장점이 있으나, 모든 프로퍼티에 가능하지는 않다. 프로퍼티 속성의 동적 변경이 가능한 경우, ALTER SYSTEM 문 혹은 ALTER SESSION 문을 이용하여 변경할 수 있으며 Altibase 서버 전체 혹은 세션 별로 환경 설정 값이 적용된다.

셋째, 운영체제의 환경변수를 이용하여 설정할 수 있다. 이는 프로퍼티 파일과 마찬가지로 정적인 방법이다. 프로퍼티 속성이 읽기 전용, 단일 값일 경우 환경변수로 값을 설정할 수 있다. 환경변수의 이름은 ALTIBASE_프로퍼티명 형식이며, 설정 후 데이터베이스 서버를 재구동하여야 수정된 값이 서버에 반영된다.

예를 들면 다음과 같다.

$ export ALTIBASE_DEFAULT_DATE_FORMAT=YYYY/MM/DD

프로퍼티 설정 방법에 따른 우선순위는 다음과 같다.

환경변수로 설정
Altibase 프로퍼티 파일에서 설정
시스템의 기본값 사용

다음과 같이 환경변수와 프로퍼티가 설정되었을 경우 환경변수의 우선순위가 높으므로, Altibase 프로퍼티 파일의 DEFAULT_DATE_FORMAT의 값은 무시되고 환경변수의 값이 사용된다.

$ export ALTIBASE_DEFAULT_DATE_FORMAT=YYYY-MM-DD
DEFAULT_DATE_FORMAT=YYYY-MM-DD (altibase.properties)

다음 예에서도 프로퍼티와 환경변수가 다르게 설정된 경우, 프로퍼티 파일의 NLS_USE 값은 무시되고, 환경변수의 UTF-8 이 우선 설정된다.

$ export ALTIBASE_NLS_USE=UTF8
NLS_USE=KO16KSC5601 (altibase.properties)

프로퍼티 요약#

Altibase 서버의 환경 설정에 관한 프로퍼티 파일은 ALTIBASE_HOME의 conf 디렉토리 밑에 있는 altibase.properties이며, 프로퍼티의 내용은 크게 다음과 같이 분류할 수 있다.

데이터베이스 초기화 관련 프로퍼티
성능 관련 프로퍼티
세션 관련 프로퍼티
트랜잭션 관련 프로퍼티
백업 및 복구 관련 프로퍼티
이중화 관련 프로퍼티
네트워크 및 보안 관련 프로퍼티
메시지 로그 관련 프로퍼티
데이터베이스 링크 관련 프로퍼티
감사(Auditing) 관련 프로퍼티
C/C++ 외부 프로시저용 에이전트 관련 프로퍼티
사용자 계정 보안 관련 프로퍼티
기타 프로퍼티

다음의 표는 위 분류기준에 의해서 Altibase 프로퍼티를 정리한 표이다. 참고로 표의 각 분류는 다음과 같은 의미를 지닌다.

D: 데이터베이스 초기화
P: 성능
S: 세션
T: 트랜잭션
B: 백업 및 복구
R: 이중화
NM: 네트워크 관리 및 보안(Network Management)
M: 메시지 로그
L: 데이터베이스 링크
U: 감사(Auditing)
A: 에이전트(Agent)
AS: 사용자 계정 보안(Account Security)
E: 기타

"변경 레벨" 열은 다음의 의미를 지닌다.

SESSION : ALTER SESSION 문을 이용하여 프로퍼티 값 변경 가능
SYSTEM : ALTER SYSTEM 문을 이용하여 프로퍼티 값 변경 가능
BOTH : ALTER SESSION, ALTER SYSTEM 문을 이용하여 프로퍼티 값 변경 가능
NONE: 동적 변경 불가능

분류	소분류	프로퍼티	변경 레벨
D		BUFFER_AREA_CHUNK_SIZE
		BUFFER_AREA_SIZE	SYSTEM
		BUFFER_CHECKPOINT_LIST_CNT
		BUFFER_FLUSHER_CNT
		BUFFER_FLUSH_LIST_CNT
		BUFFER_HASH_BUCKET_DENSITY
		BUFFER_HASH_CHAIN_LATCH_DENSITY
		BUFFER_LRU_LIST_CNT
		BUFFER_PREPARE_LIST_CNT
		COMPRESSION_RESOURCE_GC_SECOND
		DB_NAME
		DDL_SUPPLEMENTAL_LOG_ENABLE	SYSTEM
		DEFAULT_DISK_DB_DIR
		DEFAULT_MEM_DB_FILE_SIZE
		DEFAULT_SEGMENT_MANAGEMENT_TYPE
		DEFAULT_SEGMENT_STORAGE_INITEXTENTS
		DEFAULT_SEGMENT_STORAGE_MAXEXTENTS
		DEFAULT_SEGMENT_STORAGE_MINEXTENTS
		DEFAULT_SEGMENT_STORAGE_NEXTEXTENTS
		DIRECT_PATH_BUFFER_PAGE_COUNT	SYSTEM
		DISK_INDEX_UNBALANCED_SPLIT_RATE	SYSTEM
		DISK_LOB_COLUMN_IN_ROW_SIZE
		DISK_MAX_DB_SIZE
		DOUBLE_WRITE_DIRECTORY
		DOUBLE_WRITE_DIRECTORY_COUNT
		DRDB_FD_MAX_COUNT_PER_DATAFILE	SYSTEM
		EXPAND_CHUNK_PAGE_COUNT
		LOB_OBJECT_BUFFER_SIZE
		LOCK_MGR_CACHE_NODE
		LOCK_NODE_CACHE_COUNT
		LOGANCHOR_DIR
		LOG_DIR
		LOG_FILE_SIZE
		MAX_CLIENT
		MEM_DB_DIR
		MEM_MAX_DB_SIZE
		MEMORY_INDEX_BUILD_RUN_SIZE	SYSTEM
		MEMORY_INDEX_BUILD_VALUE_LENGTH_THRESHOLD	SYSTEM
		MEMORY_INDEX_UNBALANCED_SPLIT_RATE	SYSTEM
		MEMORY_LOB_COLUMN_IN_ROW_SIZE
		MEMORY_VARIABLE_COLUMN_IN_ROW_SIZE
		MEM_SIZE_CLASS_COUNT
		MIN_COMPRESSION_RESOURCE_COUNT
		MIN_LOG_RECORD_SIZE_FOR_COMPRESS	SYSTEM
		MIN_PAGES_ON_DB_FREE_LIST
		MIN_PAGES_ON_TABLE_FREE_LIST	SYSTEM
		MIN_TASK_COUNT_FOR_THREAD_LIVE	SYSTEM
		PCTFREE
		PCTUSED
		QP_MEMORY_CHUNK_SIZE
		RECYCLEBIN_DISK_MAX_SIZE	SYSTEM
		RECYCLEBIN_ENABLE	SESSION
		RECYCLEBIN_MEM_MAX_SIZE	SYSTEM
		REDUCE_TEMP_MEMORY_ENABLE	SYSTEM
		SECURITY_ECC_POLICY_NAME	SYSTEM
		SECURITY_MODULE_LIBRARY	SYSTEM
		SECURITY_MODULE_NAME	SYSTEM
		SERVICE_THREAD_INITIAL_LIFESPAN	SYSTEM
		SMALL_TABLE_THRESHOLD	SYSTEM
		ST_OBJECT_BUFFER_SIZE	BOTH
		SYS_DATA_FILE_INIT_SIZE
		SYS_DATA_FILE_MAX_SIZE
		SYS_DATA_FILE_NEXT_SIZE
		SYS_DATA_TBS_EXTENT_SIZE
SYS_TEMP_FILE_INIT_SIZE
SYS_TEMP_FILE_MAX_SIZE
SYS_TEMP_FILE_NEXT_SIZE
SYS_TEMP_TBS_EXTENT_SIZE
SYS_UNDO_FILE_INIT_SIZE
SYS_UNDO_FILE_MAX_SIZE
SYS_UNDO_FILE_NEXT_SIZE
SYS_UNDO_TBS_EXTENT_SIZE
TABLE_BACKUP_FILE_BUFFER_SIZE
TABLE_COMPACT_AT_SHUTDOW	SYSTEM
TEMP_HASH_BUCKET_DENSITY
TEMP_PAGE_CHUNK_COUNT
USER_DATA_FILE_INIT_SIZE
USER_DATA_FILE_MAX_SIZE
USER_DATA_FILE_NEXT_SIZE
USER_DATA_TBS_EXTENT_SIZE
USER_TEMP_FILE_INIT_SIZE
USER_TEMP_FILE_MAX_SIZE
USER_TEMP_FILE_NEXT_SIZE
USER_TEMP_TBS_EXTENT_SIZE
VOLATILE_MAX_DB_SIZE
P		AGER_WAIT_MAXIMUM
		AGER_WAIT_MINIMUM
		BUFFER_VICTIM_SEARCH_INTERVAL	SYSTEM
		BUFFER_VICTIM_SEARCH_PCT	SYSTEM
		BULKIO_PAGE_COUNT_FOR_DIRECT_PATH_INSERT	SYSTEM
		CHECKPOINT_BULK_SYNC_PAGE_COUNT	SYSTEM
		CHECKPOINT_BULK_WRITE_PAGE_COUNT	SYSTEM
		CHECKPOINT_BULK_WRITE_SLEEP_SEC	SYSTEM
		CHECKPOINT_BULK_WRITE_SLEEP_USEC	SYSTEM
		CHECKPOINT_FLUSH_COUNT	SYSTEM
		CHECKPOINT_FLUSH_MAX_GAP	SYSTEM
		CHECKPOINT_FLUSH_MAX_WAIT_SEC	SYSTEM
		CM_BUFFER_MAX_PENDING_LIST
		CM_DISPATCHER_SOCK_POLL_TYPE
		DATABASE_IO_TYPE
		DATAFILE_WRITE_UNIT_SIZE	SYSTEM
		DB_FILE_MULTIPAGE_READ_COUNT	SYSTEM
		DEDICATED_THREAD_CHECK_INTERVAL
		DEDICATED_THREAD_INIT_COUNT
		DEDICATED_THREAD_MAX_COUNT
		DEDICATED_THREAD_MODE
		DEFAULT_FLUSHER_WAIT_SEC	SYSTEM
		DELAYED_FLUSH_LIST_PCT	SYSTEM
		DELAYED_FLUSH_PROTECTION_TIME_MSEC	SYSTEM
		DIRECT_IO_ENABLED
		DISK_INDEX_BUILD_MERGE_PAGE_COUNT	SYSTEM
		EXECUTE_STMT_MEMORY_MAXIMUM	SYSTEM
		EXECUTOR_FAST_SIMPLE_QUERY
		FAST_START_IO_TARGET	SYSTEM
		FAST_START_LOGFILE_TARGET	SYSTEM
		FAST_UNLOCK_LOG_ALLOC_MUTEX
		HASH_AREA_SIZE	SYSTEM
		HASH_JOIN_MEM_TEMP_AUTO_BUCKET_COUNT_DISABLE	SYSTEM
		HASH_JOIN_MEM_TEMP_PARTITIONING_DISABLE	SYSTEM
		HIGH_FLUSH_PCT	SYSTEM
		HOT_LIST_PCT	SYSTEM
		HOT_TOUCH_CNT	SYSTEM
		INDEX_BUILD_THREAD_COUNT	SYSTEM
		INDEX_INITRANS
		INDEX_MAXTRANS
		LFG_GROUP_COMMIT_INTERVAL_USEC
		LFG_GROUP_COMMIT_RETRY_USEC
		LFG_GROUP_COMMIT_UPDATE_TX_COUNT
		LOB_CACHE_THRESHOLD	BOTH
		LOCK_ESCALATION_MEMORY_SIZE	SYSTEM
		LOG_CREATE_METHOD
		LOG_IO_TYPE
		LOW_FLUSH_PCT	SYSTEM
		LOW_PREPARE_PCT	SYSTEM
		MATHEMATICS_TEMP_MEMORY_MAXIMUM	SYSTEM
		MAX_FLUSHER_WAIT_SEC	SYSTEM
		MEM_INDEX_KEY_REDISTRIBUTION	SYSTEM
		MEM_INDEX_KEY_REDISTRIBUTION_STANDARD_RATE	SYSTEM
		MULTIPLEXING_CHECK_INTERVAL	SYSTEM
		MULTIPLEXING_MAX_THREAD_COUNT	SYSTEM
		MULTIPLEXING_THREAD_COUNT
		NORMALFORM_MAXIMUM	BOTH
		OPTIMIZER_AUTO_STATS	BOTH
		OPTIMIZER_DELAYED_EXECUTION	SESSION
		OPTIMIZER_FEATURE_ENABLE	SYSTEM
		OPTIMIZER_MODE	BOTH
		OPTIMIZER_PERFORMANCE_VIEW
		OPTIMIZER_UNNEST_AGGREGATION_SUBQUERY	SYSTEM
		OPTIMIZER_UNNEST_COMPLEX_SUBQUERY	SYSTEM
OPTIMIZER_UNNEST_SUBQUERY	SYSTEM
OUTER_JOIN_OPERATOR_TRANSFORM_ENABLE	SYSTEM
PARALLEL_LOAD_FACTOR
PARALLEL_QUERY_THREAD_MAX	SYSTEM
PARALLEL_QUERY_QUEUE_SIZE	SYSTEM
PREPARE_STMT_MEMORY_MAXIMUM	SYSTEM
QUERY_REWRITE_ENABLE	BOTH
REFINE_PAGE_COUNT
RESULT_CACHE_ENABLE	BOTH
RESULT_CACHE_MEMORY_MAXIUM	SYSTEM
SECONDARY_BUFFER_ENABLE
SECONDARY_BUFFER_FILE_DIRECTORY
SECONDARY_BUFFER_FLUSHER_CNT
SECONDARY_BUFFER_SIZE
SECONDARY_BUFFER_TYPE
SORT_AREA_SIZE	SYSTEM
SQL_PLAN_CACHE_BUCKET_CNT
SQL_PLAN_CACHE_HOT_REGION_LRU_RATIO	SYSTEM
SQL_PLAN_CACHE_PREPARED_EXECUTION_CONTEXT_CNT	SYSTEM
SQL_PLAN_CACHE_SIZE	SYSTEM
STATEMENT_LIST_PARTIAL_SCAN_COUNT	SYSTEM
TABLE_INITRANS
TABLE_LOCK_ENABLE	SYSTEM
TABLE_LOCK_MODE
TABLE_MAXTRANS
TABLESPACE_LOCK_ENABLE	BOTH
TEMP_STATS_WATCH_TIME	SYSTEM
THREAD_CPU_AFFINITY
THREAD_REUSE_ENABLE
TIMED_STATISTICS	SYSTEM
TIMER_RUNNING_LEVEL
TIMER_THREAD_RESOLUTION	SYSTEM
TOP_RESULT_CACHE_MODE	BOTH
TOTAL_WA_SIZE	SYSTEM
INIT_TOTAL_WA_SIZE	SYSTEM
TOUCH_TIME_INTERVAL	SYSTEM
TRANSACTION_SEGMENT_COUNT	SYSTEM
TRX_UPDATE_MAX_LOGSIZE	BOTH
S	일반	CM_DISCONN_DETECT_TIME
		CONCURRENT_EXEC_DEGREE_DEFAULT	SYSTEM
		CONCURRENT_EXEC_DEGREE_MAX
		CONCURRENT_EXEC_WAIT_INTERVAL	SYSTEM
		DEFAULT_THREAD_STACK_SIZE
		IPC_CHANNEL_COUNT
		IPC_FILEPATH
		IPC_SEM_KEY
		IPC_SHM_KEY
		IPCDA_CHANNEL_COUNT
		IPCDA_DATABLOCK_SIZE	SYSTEM
		IPCDA_FILEPATH
		IPCDA_SEM_KEY
		IPCDA_SHM_KEY
		MAX_LISTEN
		MAX_STATEMENTS_PER_SESSION	BOTH
		NET_CONN_IP_STACK
		NLS_COMP
		NLS_CURRENCY	SESSION
		NLS_ISO_CURRENCY	SESSION
		NLS_NCHAR_CONV_EXCP	SESSION
		NLS_NCHAR_LITERAL_REPLACE	SESSION
		NLS_NUMERIC_CHARACTERS	SESSION
		NLS_TERRITORY	SESSION
		PORT_NO
		PSM_CURSOR_OPEN_LIMIT	SYSTEM
		PSM_FILE_OPEN_LIMIT	SYSTEM
		TIME_ZONE	SESSION
		UNIXDOMAIN_FILEPATH
		USE_MEMORY_POOL
		USER_LOCK_POOL_INIT_SIZE	SYSTEM
		USER_LOCK_REQUEST_CHECK_INTERVAL	SYSTEM
		USER_LOCK_REQUEST_LIMIT	SYSTEM
		USER_LOCK_REQUEST_TIMEOUT	SYSTEM
		XA_HEURISTIC_COMPLETE
	타임아웃	BLOCK_ALL_TX_TIME_OUT	SYSTEM
		DDL_LOCK_TIMEOUT	SYSTEM
		DDL_TIMEOUT	BOTH
		FETCH_TIMEOUT	BOTH
		IDLE_TIMEOUT	BOTH
		LOGIN_TIMEOUT	SYSTEM
		MULTIPLEXING_POLL_TIMEOUT	SYSTEM
		QUERY_TIMEOUT	BOTH
		SERVICE_THREAD_RECV_TIMEOUT
		SHUTDOWN_IMMEDIATE_TIMEOUT	SYSTEM
		UTRANS_TIMEOUT	BOTH
		XA_INDOUBT_TX_TIMEOUT
T		AUTO_COMMIT	SYSTEM
		ISOLATION_LEVEL
		TRANSACTION_TABLE_SIZE
B		ARCHIVE_DIR
		ARCHIVE_FULL_ACTION
		ARCHIVE_MULTIPLEX_COUNT
		ARCHIVE_MULTIPLEX_DIR
		ARCHIVE_THREAD_AUTOSTART
		CHECKPOINT_ENABLED
		CHECKPOINT_INTERVAL_IN_LOG	SYSTEM
		CHECKPOINT_INTERVAL_IN_SEC	SYSTEM
		COMMIT_WRITE_WAIT_MODE	BOTH
		INCREMENTAL_BACKUP_CHUNK_SIZE
		INCREMENTAL_BACKUP_INFO_RETENTION_PERIOD
		LOG_BUFFER_TYPE
		LOG_MULTIPLEX_COUNT
		LOG_MULTIPLEX_DIR
		PREPARE_LOG_FILE_COUNT
		SNAPSHOT_MEM_THRESHOLD	SYSTEM
		SNAPSHOT_DISK_UNDO_THRESHOLD	SYSTEM
R		REPLICATION_ACK_XLOG_COUNT
		REPLICATION_ALLOW_DUPLICATE_HOSTS	SYSTEM
		REPLICATION_BEFORE_IMAGE_LOG_ENABLE	SYSTEM
		REPLICATION_COMMIT_WRITE_WAIT_MODE	SYSTEM
		REPLICATION_CONNECT_RECEIVE_TIMEOUT	SYSTEM
		REPLICATION_CONNECT_TIMEOUT	SYSTEM
		REPLICATION_DDL_ENABLE	SYSTEM
		REPLICATION_DDL_ENABLE_LEVEL
		REPLICATION_DDL_SYNC	SYSTEM
		REPLICATION_DDL_SYNC_TIMEOUT
		REPLICATION_EAGER_PARALLEL_FACTOR
		REPLICATION_EAGER_RECEIVER_MAX_ERROR_COUNT	SYSTEM
		REPLICATION_FAILBACK_INCREMENTAL_SYNC
		REPLICATION_GAP_UNIT
		REPLICATION_GAPLESS_ALLOW_TIME	SYSTEM
		REPLICATION_GAPLESS_MAX_WAIT_TIME	SYSTEM
		REPLICATION_GROUPING_AHEAD_READ_NEXT_LOG_FILE	SYSTEM
		REPLICATION_GROUPING_TRANSACTION_MAX_COUNT	SYSTEM
		REPLICATION_HBT_DETECT_HIGHWATER_MARK	SYSTEM
		REPLICATION_HBT_DETECT_TIME	SYSTEM
		REPLICATION_IB_LATENCY
		REPLICATION_IB_PORT_NO
		REPLICATION_INSERT_REPLACE	SYSTEM
		REPLICATION_KEEP_ALIVE_CNT
		REPLICATION_LOCK_TIMEOUT	SYSTEM
		REPLICATION_LOG_BUFFER_SIZE
		REPLICATION_MAX_COUNT
		REPLICATION_MAX_LISTEN
		REPLICATION_MAX_LOGFILE	SYSTEM
		REPLICATION_META_ITEM_COUNT_DIFF_ENABLE	SYSTEM
		REPLICATION_POOL_ELEMENT_COUNT	SYSTEM
		REPLICATION_POOL_ELEMENT_SIZE	SYSTEM
		REPLICATION_PORT_NO
		REPLICATION_RECEIVE_TIMEOUT	SYSTEM
		REPLICATION_RECEIVER_APPLIER_ASSIGN_MODE	SYSTEM
		REPLICATION_RECEIVER_APPLIER_QUEUE_SIZE	SYSTEM
		REPLICATION_PREFETCH_LOGFILE_COUNT	SYSTEM
		REPLICATION_RECEIVER_APPLIER_YIELD_COUNT
		REPLICATION_RECOVERY_MAX_LOGFILE
		REPLICATION_RECOVERY_MAX_TIME
		REPLICATION_SENDER_AUTO_START
		REPLICATION_SENDER_COMPRESS_XLOG	SYSTEM
		REPLICATION_SENDER_ENCRYPT_XLOG
		REPLICATION_SENDER_IP
		REPLICATION_SENDER_SEND_TIMEOUT	SYSTEM
		REPLICATION_SENDER_SLEEP_TIME
		REPLICATION_SENDER_SLEEP_TIMEOUT	SYSTEM
		REPLICATION_SENDER_START_AFTER_GIVING_UP	SYSTEM
		REPLICATION_SERVER_FAILBACK_MAX_TIME
		REPLICATION_SQL_APPLY_ENABLE
		REPLICATION_SYNC_APPLY_METHOD	SYSTEM
		REPLICATION_SYNC_LOCK_TIMEOUT	SYSTEM
		REPLICATION_SYNC_LOG
		REPLICATION_SYNC_TUPLE_COUNT	SYSTEM
		REPLICATION_TIMESTAMP_RESOLUTION	SYSTEM
		REPLICATION_TRANSACTION_POOL_SIZE	SYSTEM
		REPLICATION_UPDATE_REPLACE	SYSTEM
		NM		IB_CONCHKSPIN
IB_ENABLE
IB_LATENCY
IB_LISTENER_DISABLE
IB_MAX_LISTEN
IB_PORT_NO	SYSTEM
SNMP_ALARM_QUERY_TIMEOUT
SNMP_ALARM_FETCH_TIMEOUT
SNMP_ALARM_UTRANS_TIMEOUT
SNMP_ALARM_SESSION_FAILURE_COUNT
SNMP_ENABLE
SNMP_MSGLOG_FLAG	SYSTEM
SNMP_PORT_NO
SNMP_TRAP_PORT_NO
SNMP_RECV_TIMEOUT
SNMP_SEND_TIMEOUT
SSL_CA
SSL_CAPATH
SSL_CERT
SSL_CIPHER_LIST
SSL_CIPHER_SUITES
SSL_CLIENT_AUTHENTICATION
SSL_ENABLE
SSL_KEY
SSL_LOAD_CONFIG
SSL_MAX_LISTEN
SSL_PORT_NO	SYSTEM
TCP_ENABLE
M		ALL_MSGLOG_FLUSH	SYSTEM
		CM_MSGLOG_COUNT
		CM_MSGLOG_FILE
		CM_MSGLOG_SIZE
		CM_MSGLOG_FLAG
		COLLECT_DUMP_INFO	SYSTEM
		DK_MSGLOG_COUNT
		DK_MSGLOG_FILE
		DK_MSGLOG_FLAG	SYSTEM
		DK_MSGLOG_RESERVE_SIZE
		DK_MSGLOG_SIZE
		DUMP_MSGLOG_COUNT
		DUMP_MSGLOG_FILE
		DUMP_MSGLOG_SIZE
		DUMP_MSGLOG_RESERVE_SIZE
		ERROR_MSGLOG_COUNT
		ERROR_MSGLOG_FILE
		ERROR_MSGLOG_SIZE
		JOB_MSGLOG_COUNT
		JOB_MSGLOG_FILE
		JOB_MSGLOG_FLAG
		JOB_MSGLOG_SIZE
		ERROR_MSGLOG_RESERVE_SIZE
		LB_MSGLOG_COUNT
		LB_MSGLOG_FILE
		LB_MSGLOG_FLAG
		LB_MSGLOG_SIZE
		MM_MSGLOG_COUNT
		MM_MSGLOG_FILE
		MM_MSGLOG_RESERVE_SIZE
		MM_MSGLOG_SIZE
		MM_SESSION_LOGGING	SYSTEM
		NETWORK_ERROR_LOG	SYSTEM
		QP_MSGLOG_COUNT
		QP_MSGLOG_FILE
		QP_MSGLOG_FLAG	SYSTEM
		QP_MSGLOG_RESERVE_SIZE
		QP_MSGLOG_SIZE
		QUERY_PROF_FLAG	SYSTEM
		QUERY_PROF_LOG_DIR	SYSTEM
		RP_CONFLICT_MSGLOG_COUNT
		RP_CONFLICT_MSGLOG_DIR
		RP_CONFLICT_MSGLOG_ENABLE
		RP_CONFLICT_MSGLOG_FILE
		RP_CONFLICT_MSGLOG_FLAG	SYSTEM
		RP_CONFLICT_MSGLOG_SIZE
		RP_MSGLOG_COUNT
		RP_MSGLOG_FILE
		RP_MSGLOG_FLAG	SYSTEM
		RP_MSGLOG_RESERVE_SIZE
		RP_MSGLOG_SIZE
		SERVER_MSGLOG_COUNT
		SERVER_MSGLOG_DIR
		SERVER_MSGLOG_FILE
		SERVER_MSGLOG_FLAG	SYSTEM
		SERVER_MSGLOG_RESERVE_SIZE
		SERVER_MSGLOG_SIZE
		SM_MSGLOG_COUNT
		SM_MSGLOG_FILE
		SM_MSGLOG_FLAG	SYSTEM
		SM_MSGLOG_RESERVE_SIZE
		SM_MSGLOG_SIZE
		ST_MSGLOG_COUNT
		ST_MSGLOG_FILE
ST_MSGLOG_FLAG
ST_MSGLOG_SIZE
TRC_MSGLOG_RESERVE_SIZE
TRCLOG_DETAIL_PREDICATE	SYSTEM
XA_MSGLOG_COUNT
XA_MSGLOG_FILE
XA_MSGLOG_FLAG	SYSTEM
XA_MSGLOG_RESERVE_SIZE
XA_MSGLOG_SIZE
L		DBLINK_ALTILINKER_CONNECT_TIMEOUT
		DBLINK_DATA_BUFFER_ALLOC_RATIO
		DBLINK_DATA_BUFFER_BLOCK_COUNT
		DBLINK_DATA_BUFFER_BLOCK_SIZE
		DBLINK_ENABLE
		DBLINK_GLOBAL_TRANSACTION_LEVEL
		DBLINK_RECOVERY_MAX_LOGFILE	SYSTEM
		DBLINK_REMOTE_STATEMENT_AUTOCOMMIT	BOTH
		DBLINK_REMOTE_TABLE_BUFFER_SIZE
U		AUDIT_FILE_SIZE	SYSTEM
		AUDIT_LOG_DIR	SYSTEM
		AUDIT_OUTPUT_METHOD	SYSTEM
		AUDIT_TAG_NAME_IN_SYSLOG	SYSTEM
A		EXTPROC_AGENT_CONNECT_TIMEOUT	SYSTEM
		EXTPROC_AGENT_CALL_RETRY_COUNT	SYSTEM
		EXTPROC_AGENT_IDLE_TIMEOUT	SYSTEM
		EXTPROC_AGENT_SOCKET_FILEPATH
AS		CASE_SENSITIVE_PASSWORD	SYSTEM
		FAILED_LOGIN_ATTEMPTS
		PASSWORD_LOCK_TIME
		PASSWORD_LIFE_TIME
		PASSWORD_GRACE_TIME
		PASSWORD_REUSE_TIME
		PASSWORD_REUSE_MAX
		PASSWORD_VERIFY_FUNCTION
E		ACCESS_LIST
		ACCESS_LIST_FILE
		ADMIN_MODE	SYSTEM
		ARITHMETIC_OPERATION_MODE	SESSION
		CHECK_MUTEX_DURATION_TIME_ENABLE	SYSTEM
		COERCE_HOST_VAR_IN_SELECT_LIST_TO_VARCHAR
		DEFAULT_DATE_FORMAT
		EXEC_DDL_DISABLE	SYSTEM
		GROUP_CONCAT_PRECISION	SYSTEM
		JOB_SCHEDULER_ENABLE	SYSTEM
		JOB_THREAD_COUNT
		JOB_THREAD_QUEUE_SIZE
		LISTAGG_PRECISION	SYSTEM
		MSG_QUEUE_PERMISSION	SYSTEM
		PSM_CHAR_DEFAULT_PRECISION
		PSM_IGNORE_NO_DATA_FOUND_ERROR	SYSTEM
		PSM_NCHAR_UTF16_DEFAULT_PRECISION
		PSM_NCHAR_UTF8_DEFAULT_PRECISION
		PSM_NVARCHAR_UTF16_DEFAULT_PRECISION
		PSM_NVARCHAR_UTF8_DEFAULT_PRECISION
		PSM_PARAM_AND_RETURN_WITHOUT_PRECISION_ENABLE
		PSM_VARCHAR_DEFAULT_PRECISION
		QUERY_STACK_SIZE	BOTH
		RECURSION_LEVEL_MAXIMUM	SESSION
		REGEXP_MODE	BOTH
		REMOTE_SYSDBA_ENABLE	SYSTEM
		SELECT_HEADER_DISPLAY	BOTH
		SYS_CONNECT_BY_PATH_PRECISION	SYSTEM
		SERIAL_EXECUTE_MODE	BOTH
		VARRAY_MEMORY_MAXIMUM	SYSTEM

이 장에서는 각 프로퍼티를 다음과 같은 형식으로 설명하고 있다.

프로퍼티 이름
데이터 타입
기본값
속성 (읽기 전용/변경 가능, 단일 값/다중 값 허용)
값의 범위 (최대, 최솟값)
설명

데이터베이스 초기화 프로퍼티#

BUFFER_AREA_CHUNK_SIZE (단위: 바이트)#

데이터 타입#

Unsigned Long

기본값#

33554432 (32M)

속성#

읽기 전용, 단일 값

값의 범위#

[8192, 2⁶⁴-1]

설명#

설명#

설명#

설명#

DDL 연산시 로그를 추가적으로 남길 것인지 여부를 설정한다.

설명#

테이블 락(LOCK) 노드의 캐시 타입을 명시한다.

서버 운영중에는 변경할 수 없다.

0: 캐시하지 않는다.

1: 링크드 리스트(Linked List)로 캐시한다.

2: 배열로 캐시하고, 64개로 고정된다.

LOCK_NODE_CACHE_COUNT (단위: 개수)#

데이터 타입#

Unsigned Integer

기본값#

2

속성#

읽기 전용, 단일 값

값의 범위#

[0, 1024]

설명#

설명#

로그 파일의 크기를 지정하는 프로퍼티로, 지정된 크기에 도달하면 새로운 로그 파일에 기록한다. 이 프로퍼티는 데이터베이스 생성 시에 설정할 수 있으며, 생성 후에는 변경할 수 없다. 만약 사용자가 로그 파일 크기를 변경하려면, 데이터베이스를 다시 생성해야 한다.

* 제약사항

오프라인 이중화를 사용하기 위해서는 지역 서버(Active)와 원격 서버(Standby)의 이 프로퍼티의 값이 반드시 동일해야 한다.

MAX_CLIENT#

데이터 타입#

Unsigned Integer

기본값#

1000

속성#

읽기 전용, 단일 값

값의 범위#

[0, 65535]

단, JOB_THREAD_COUNT프로퍼티가 0보다 큰 값으로 설정된 경우에 최댓값은 65535에서 JOB_THREAD_COUNT값을 뺀 값이다.

설명#

Altibase에 접속할 수 있는 클라이언트의 최대 개수를 명시한다.

MEM_DB_DIR#

데이터 타입#

String

기본값#

\$ALTIBASE_HOME/dbs

속성#

읽기 전용, 다중 값

값의 범위#

없음

설명#

메모리 데이터베이스 파일이 존재할 경로를 지정한다.

최소 1개, 최대 8개 경로 지정이 가능하다. 여러 개의 경로가 지정될 경우, 데이터베이스 파일은 각 경로에 분산되어 저장된다. 이 프로퍼티로 지정되는 모든 경로는 실제 존재하는 경로여야 한다. 경로의 기본 개수는 2개, 각 경로의 기본값은 \$ALTIBASE_HOME/dbs로 동일하게 지정되어 있다.

MEM_MAX_DB_SIZE (단위: 바이트)#

데이터 타입#

Unsigned Long

기본값#

2³¹

속성#

읽기 전용, 단일 값

값의 범위#

32비트: [2097152, 2³²+1]

64비트: [2097152, 2⁶⁴]

설명#

서비스 과정 중에 동적으로 늘어날 수 있는 모든 메모리 데이터베이스 크기의 합에 대한 최댓값을 명시한다. 32비트와 64비트 모드에 관계없이 기본 값은 2G이다.

MEM_MAX_DB_SIZE를 초과해서 데이터베이스 크기가 확장될 경우 그 트랜잭션은 오류 처리되며, 이후 수행되는 SELECT 문을 제외한 모든 SQL 문은 오류 처리된다.

MEMORY_INDEX_BUILD_RUN_SIZE (단위: 바이트)#

데이터 타입#

Unsigned Long

기본값#

131072

속성#

변경 가능, 단일 값

값의 범위#

[1024, 2⁶⁴-1]

설명#

메모리 인덱스를 구축할 때 in-memory sorting 영역의 크기를 지정할 수 있다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

MEMORY_INDEX_BUILD_VALUE_LENGTH_THRESHOLD (단위: 바이트)#

데이터 타입#

Unsigned Long

기본값#

64

속성#

변경 가능, 단일 값

값의 범위#

[0, 2⁶⁴-1]

설명#

설명#

질의 처리기에서 필요한 메모리를 시스템에서 가져올 때 확장 단위를 정한다.

RECYCLEBIN_DISK_MAX_SIZE (단위: 바이트)#

데이터 타입#

Unsigned Long

기본값#

2⁶⁴-1

속성#

변경 가능, 단일 값

값의 범위#

[0, 2⁶⁴-1]

설명#

디스크 테이블이 버려지는(drop) 휴지통의 사이즈를 명시할 수 있다.

Altibase 운영 중 ALTER SYSTEM문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

RECYCLEBIN_ENABLE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

테이블이 DROP 구문으로 삭제된 경우 휴지통으로 버려지거나, 데이터베이스 시스템에서 바로 삭제할 것인지를 설정할 수 있다. 기본값은 DROP 구문을 수행하면 시스템에서 테이블이 제거된다.

휴지통으로 버려진 테이블은 이름이 변경되어 저장된다. 그리고 테이블 타입이 ‘R’ 타입으로 변경 되어 일체 다른 DDL 및 INSERT/UPDATE/DELETE 등을 수행 할 수 없다. 단 SELECT는 가능하다.

휴지통에 테이블이 존재한다면 프로퍼티의 값을 0으로 변경하더라도 휴지통의 테이블을 조회하거나 FLASHBACK 또는 PURGE 구문을 사용하여 복구 및 제거할 수 있다.

Altibase 운영 중 ALTER SESSION문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

0 : Disable(기본값)-테이블이 데이터베이스에서 삭제된다.

1 : Enable - 테이블이 휴지통으로 버려진다.

RECYCLEBIN_MEM_MAX_SIZE (단위: 바이트)#

데이터 타입#

Unsigned Long

기본값#

4 GB

속성#

변경 가능, 단일 값

값의 범위#

[0, 2⁶⁴-1]

설명#

메모리 테이블이 버려지는(drop) 휴지통의 사이즈를 명시할 수 있다.

Altibase 운영 중 ALTER SYSTEM문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REDUCE_TEMP_MEMORY_ENABLE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

가변 길이 칼럼의 데이터가 메모리 테이블스페이스에 임시로 저장될 때 차지하는 공간을 줄일 수 있는 프로퍼티이다.

Altibase 서버가 디스크 테이블이나 뷰에 대한 질의를 처리할 때 중간 결과를 임시로 저장하는 공간은 기본적으로 디스크 임시 테이블스페이스이다. 그러나 성능 향상을 목적으로 TEMP_TBS_MEMORY 힌트(Administrator's Manual, Performance Tuning Guide 참고)를 사용하여 중간 결과가 메모리 테이블스페이스에 저장되도록 할 수 있다.

기본값인 0은 가변 길이 칼럼의 데이터도 고정 길이 칼럼처럼 고정된 길이의 임시 저장 공간을 사용하여, 불필요한 공간을 차지할 수 있다. 이러한 공간 낭비를 줄이기 위해 이 프로퍼티를 1로 설정하면 가변 길이 칼럼의 실제 데이터만큼 공간을 사용한다. 그러나, 메모리 사용량은 줄어들지만 질의 처리 속도가 떨어질 수 있다.

[30, 2³²-1]

설명#

서비스 쓰레드의 해제 주기를 설정한다. 해제 주기란, 쓰레드를 해제하기 위해 쓰레드 매니저가 대기중인 서비스 쓰레드들의 상태를 확인해야 하는 횟수이다. 대기중인 서비스 쓰레드는 쓰레드 매니저가 이 프로퍼티에 설정된 확인 횟수동안 클라이언트를 할당 받지 못하면 해제된다.

대기하는 서비스 쓰레드는 MIN_TASK_COUNT_FOR_THREAD_LIVE 프로퍼티에 설정한 값보다 적은 클라이언트를 할당 받을 때 정해진다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

SMALL_TABLE_THRESHOLD#

데이터 타입#

Unsigned Integer

SYS_TEMP_FILE_INIT_SIZE (단위: 바이트)#

데이터 타입#

Unsigned long

기본값#

100M (100 * 1024 * 1024)

속성#

읽기 전용, 단일 값

값의 범위#

[ 8 * 8kB, 32GB]

설명#

SYS_TBS_DISK_TEMP 생성 시 임시 데이터 파일(temp001.dbf)의 초기 크기를 명시한다. 또한 SYS_TBS_DISK_TEMP에 임시 데이터 파일을 추가할 때 초기 크기를 지정하지 않았을 경우, 이 값이 기본값으로 사용된다.

SYS_TEMP_FILE_MAX_SIZE (단위: 바이트)#

데이터 타입#

Unsigned long

기본값#

2 * 1024 * 1024 * 1024

속성#

읽기 전용, 단일 값

값의 범위#

[8 * 8K, 32GB]

설명#

SYS_TBS_DISK_TEMP 생성 시 할당될 데이터 파일(temp001.dbf)의 최대 크기를 명시한다.

최소 SYS_TEMP_FILE_INIT_SIZE 이상의 크기를 가져야 하며, 가능한 최솟값은 64kB이다. 또한, SYS_TBS_DISK_TEMP 테이블스페이스에 임시 데이터 파일을 추가할 때 최대 크기를 지정하지 않았을 경우, 여기에 명시한 값이 기본 최대 크기가 된다.

SYS_TEMP_FILE_NEXT_SIZE (단위: 바이트)#

데이터 타입#

Unsigned long

기본값#

1 * 1024 * 1024

속성#

읽기 전용, 단일 값

값의 범위#

[8 * 8kB, 32GB]

설명#

SYS_TBS_DISK_TEMP 테이블스페이스에 데이터 파일의 공간이 부족한 경우 명시된 값만큼 데이터 파일의 크기를 확장한다.

SYS_TEMP_TBS_EXTENT_SIZE (단위: 바이트)#

데이터 타입#

Unsigned long

데이터 타입#

Unsigned long

기본값#

256 * 1024

속성#

읽기 전용, 단일 값

값의 범위#

[40kB, 32GB]

설명#

설명#

설명#

사용자 디스크 데이터 테이블스페이스에 사용자 정의 데이터 파일을 생성하거나 추가할 때 데이터 파일의 최대 크기를 명시한다.

최소 USER_DATA_FILE_INIT_SIZE 이상의 크기를 가져야 하며, 가능한 최솟값은 64K이다. 테이블 스페이스 생성시 최대 크기를 명시하지 않은 경우 기본 최대 크기를 의미한다.

USER_DATA_FILE_NEXT_SIZE (단위: 바이트)#

데이터 타입#

Unsigned long

기본값#

1 * 1024 * 1024

속성#

읽기 전용, 단일 값

값의 범위#

[8 * 8kB, 32GB]

설명#

사용자 디스크 데이터 테이블스페이스의 사용자 정의 데이터 파일에 데이터 파일 공간이 부족한 경우, 명시된 값만큼 데이터 파일의 크기를 확장한다.

USER_DATA_TBS_EXTENT_SIZE (단위: 바이트)#

데이터 타입#

Unsigned long

기본값#

512 * 1024

속성#

읽기 전용, 단일 값

값의 범위#

[2 * 8kB, 2⁶⁴-1]

설명#

사용자 디스크 데이터 테이블스페이스⁵ 생성 시 익스텐트의 크기를 명시한다.

[⁵] 사용자 디스크 데이터 테이블스페이스 (User disk data tablespace): 사용자의 객체를 저장하기 위한 테이블스페이스이다. 데이터베이스 객체 중 디스크 테이블과 디스크 인덱스만 저장된다.

USER_TEMP_FILE_INIT_SIZE (단위: 바이트)#

데이터 타입#

Unsigned long

기본값#

100 * 1024 * 1024

속성#

읽기 전용, 단일 값

값의 범위#

[8 * 8kB, 32GB]

설명#

사용자 임시 테이블스페이스에 사용자 정의 임시 데이터 파일을 생성하거나 추가할 때 데이터 파일의 초기 크기를 명시한다. 임시 데이터 파일을 생성하거나 추가할 때 초기 크기를 명시하지 않은 경우 기본 크기로 사용된다.

USER_TEMP_FILE_MAX_SIZE (단위: 바이트)#

데이터 타입#

Unsigned long

기본값#

2 * 1024 * 1024 * 1024

속성#

읽기 전용, 단일 값

값의 범위#

[8 * 8kB, 32GB]

설명#

사용자 임시 테이블스페이스에 사용자 정의 임시 데이터 파일을 생성하거나 추가할 때 할당 될 데이터파일의 최대 크기를 명시한다.

최소 USER_DATA_FILE_INIT_SIZE 이상의 크기를 가져야 하며, 가능한 최솟값은 64kB이다. 임시 데이터 파일을 생성하거나 추가할 때 최대 크기를 지정하지 않은 경우 이 프로퍼티가 최대 크기로 사용된다.

USER_TEMP_FILE_NEXT_SIZE (단위: 바이트)#

데이터 타입#

Unsigned long

기본값#

1 * 1024 * 1024

속성#

읽기 전용, 단일 값

값의 범위#

[8 * 8kB, 32GB]

설명#

사용자 임시 테이블스페이스에 사용자 정의 임시 데이터 파일에 데이터 파일의 공간이 부족한 경우 명시된 값만큼 데이터 파일의 크기를 확장한다.

USER_TEMP_TBS_EXTENT_SIZE (단위: 바이트)#

데이터 타입#

플러셔가 한 번의 주기에서 체크포인트 플러시를 할 때 플러시 할 수 있는 버퍼 페이지(프레임)의 개수를 명시한다.

CHECKPOINT_FLUSH_MAX_GAP (단위: 로그 파일 개수)#

데이터 타입#

Unsigned Integer

기본값#

10

속성#

변경 가능, 단일 값

값의 범위#

[0, 2³²-1]

설명#

설명#

Altibase 서버의 디스패처(Dispatcher)에서 소켓 감지를 위한 시스템 콜을 선택하는 프로퍼티이다. 클라이언트의 동시 접속이 1,000개 이상일 때 POLL() 시스템 콜이 사용되면 성능 향상에 도움이 된다.

1: SELECT() 시스템 콜
2: POLL() 시스템 콜; 지원되는 운영시스템에서만 사용이 가능함
3: EPOLL() 시스템 콜; 지원되는 운영시스템에서만 사용이 가능함

그러나 여기에 명시한 값의 배수가 아니고, 이 값보다 작으면 SPR(Single Page Read)로 수행한다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

DEDICATED_THREAD_CHECK_INTERVAL (단위: 초)#

데이터 타입#

Unsigned Integer

기본값#

3600

속성#

읽기 전용, 단일 값

값의 범위#

[0, 2⁶⁴-1]

설명#

전용 쓰레드(Dedicated thread) 모드에서 서비스 쓰레드가 정리되는 시간 간격을 설정하는 프로퍼티이다. 이 프로퍼티는 DEDICATED_THREAD_MODE 프로퍼티가 1일 때에만 유효하다.

이 프로퍼티에 설정한 주기로 작업이 없는 서비스 쓰레드가 해제된다. 단, DEDICATED_THREAD_INIT_COUNT에 설정된 개수만큼의 서비스 쓰레드는 유지된다.

이 프로퍼티의 값이 0인 경우, 서비스 쓰레드가 정리되지 않는다.

DEDICATED_THREAD_INIT_COUNT#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

읽기 전용, 단일 값

값의 범위#

[0, 65535]

설명#

전용 쓰레드(Dedicated thread) 모드에서 초기에 생성할 서비스 쓰레드의 개수를 지정하는 프로퍼티이다. 이 프로퍼티는 DEDICATED_THREAD_MODE 프로퍼티가 1일 때에만 유효하다.

DEDICATED_THREAD_INIT_COUNT 값은 DEDICATED_THREAD_MAX_COUNT 프로퍼티에 설정한 값보다 작아야 한다.

DEDICATED_THREAD_MAX_COUNT#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

읽기 전용, 단일 값

값의 범위#

[0, 65535]

설명#

전용 쓰레드(Dedicated thread) 모드에서 최대로 생성할 수 있는 서비스 쓰레드의 개수를 지정하는 프로퍼티이다. 이 프로퍼티는 DEDICATED_THREAD_MODE 프로퍼티가 1일 때에만 유효하다.

초기에 생성된 서비스 쓰레드가 전부 클라이언트에 할당된 경우, 서비스 쓰레드의 개수는 DEDICATED_THREAD_MAX_COUNT까지 증가하게 된다.

DEDICATED_THREAD_MAX_COUNT 값은 MAX_CLIENT 프로퍼티에 설정한 값보다 작아야 한다.

DEDICATED_THREAD_MODE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

읽기 전용, 단일 값

값의 범위#

[0, 1]

설명#

HASH_AREA_SIZE (단위: 바이트)#

데이터 타입#

Unsigned Long

기본값#

4MB

속성#

변경 가능, 단일 값

값의 범위#

[3M, 2⁶⁴-1]

설명#

서버가 해싱(hashing) 작업을 위해 사용하는 임시 테이블 하나의 메모리 크기를 지정한다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

HASH_JOIN_MEM_TEMP_AUTO_BUCKET_COUNT_DISABLE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

해쉬 조인(Hash Join)에 사용되는 메모리 해쉬 임시 테이블의 필요한 버킷(Bucket) 개수를 설정한다.

0 : 해쉬 테이블에 삽입된 실제 레코드 개수 ( DISTINCT 해싱방식에 의해 처리 되는 경우 /+ HASH BUCKET COUNT () / HINT로 HSDS 노드의 해시 버킷 수 지정 가능)

1 : 쿼리 옵티마이저가 예측한 버킷 개수 또는 힌트 /*+ HASH BUCKET COUNT () */로 지정된 버킷 개수

HASH_JOIN_MEM_TEMP_PARTITIONING_DISABLE프로퍼티의 값이 0(파티셔닝 방식)이면, 실제 레코드 개수에 기반하여 버킷 개수만큼 구역을 나누는 것이 효과적이다.

HASH_JOIN_MEM_TEMP_PARTITIONING_DISABLE프로퍼티의 값이 1(버킷 방식)이면, 이 프로퍼티의 값과 관계 없이 쿼리 옵티마이저가 예측하거나 힌트로 지정한 버킷 개수를 사용한다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

HASH_JOIN_MEM_TEMP_PARTITIONING_DISABLE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

해쉬 조인(Hash Join)에 사용되는 메모리 해쉬 임시 테이블의 레코드를 어떠한 방식으로 삽입하고 탐색할 것인지를 설정할 수 있다.

0 : 파티셔닝 방식

[1, 512]

설명#

설명#

설명#

클라이언트 LOB 캐시에 저장될 수 있는 LOB 데이터의 최대 크기를 지정하는 프로퍼티이다. 이 프로퍼티에 0보다 큰 값을 지정하면, 설정한 크기 이하의 LOB 데이터는 클라이언트에 임시로 저장된다. 0으로 설정하면 클라이언트에 LOB 데이터가 임시 저장되지 않는다.

이 프로퍼티를 이용해서 임계치를 적절히 조절하면, LOB 데이터가 클라이언트 LOB 캐시에 저장되어 Bulk-select 속도가 향상된다.

Altibase 운영 중 ALTER SYSTEM 또는 ALTER SESSION 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

LOCK_ESCALATION_MEMORY_SIZE(단위: 바이트)#

데이터 타입#

Unsigned Integer

기본값#

100M

속성#

변경 가능, 단일 값

값의 범위#

[0, 1000MB]

설명#

메모리 테이블에 대해 다량의 변경(UPDATE) 배치 작업을 할 때, 버전(versioning)으로 인해 메모리 사용량이 크게 증가하는 것을 방지하기 위한 프로퍼티이다. 어떤 DML에 의해 생성되는 로그의 크기가 이 프로퍼티에 설정된 값보다 커지면 버전을 만들지 않고 "inplace update⁶"를 하여 메모리 사용량이 증가하는 것을 막는다.

[⁶] inplace update란 변경 대상이 되는 원래 레코드에 대해 버전(version)을 만들지 않고 해당 칼럼의 값이 바로 수정되는 것을 의미한다.

변경시 버전 기법을 사용하면, 레코드 레벨의 X 잠금(lock)을 획득하고 테이블 레벨의 IX 잠금을 획득한다. 그러나 inplace update시에는 테이블 레벨에도 X 잠금 즉, 배타적 잠금을 획득한다. 따라서, 이 값을 너무 작게 설정하면 해당 테이블에 대한 확장성(scalability)이 떨어질 수 있으므로 유의해야 한다.

Altibase 운영 중 ALTER SYSTEM 문으로 이 프로퍼티의 값을 변경할 수 있다.

LOG_IO_TYPE#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

읽기 전용, 단일 값

값의 범위#

[0, 1]

설명#

로그를 기록할 때의 I/O 모드를 나타낸다.

0: buffered I/O

1: direct I/O

LOG_CREATE_METHOD#

데이터 타입#

Unsigned Integer

기본값#

0 (OS가 HP-UX, AIX 인 경우)
1 (OS가 Linux인 경우)

속성#

읽기 전용, 단일 값

값의 범위#

[0, 1]

설명#

로그 파일을 생성할 때 사용되는 시스템 콜을 선택하는 프로퍼티이다.

0 : write() 시스템 콜
1: fallocate() 시스템 콜(Linux에서만 사용 가능함)

이 프로퍼티는 역순의 인덱스 키가 다수 삽입될 때, 리프 노드의 분열이 많이 발생할 때, 데이터에 비해 인덱스 범위가 클 때 사용하면 효과적이다.

0: 메모리 인덱스의 키를 재분배하지 않는다.

1: 메모리 인덱스의 키를 재분배한다. (기본값)

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

MEM_INDEX_KEY_REDISTRIBUTION_STANDARD_RATE#

데이터 타입#

Unsigned Integer

기본값#

50

속성#

읽기 전용, 단일 값

값의 범위#

[10, 90]

설명#

메모리 인덱스의 키를 재분배하기 위해 이웃 노드의 미사용 공간 비율의 최솟값을 설정한다. 예를 들어 이 프로퍼티 값이 30이면 리프 노드의 빈 공간이 최소 30%이상이 있을 때 메모리 인덱스의 키를 재분배한다.

MEM_INDEX_KEY_REDISTRIBUTION프로퍼티가 0이면 이 프로퍼티는 동작하지 않는다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

MULTIPLEXING_CHECK_INTERVAL(단위: 마이크로초)#

데이터 타입#

Unsigned Integer

기본값#

200000

속성#

변경 가능, 단일 값

값의 범위#

[100000, 10000000]

설명#

쓰레드 매니저가 서비스 쓰레드 분산을 위해 세션을 확인하는 주기를 나타낸다. 시간 단위는 마이크로초이다.

쓰레드 매니저는 주기적으로 세션의 상태를 확인하여 세션의 통계 정보를 갱신하며, 서비스 쓰레드를 추가 또는 삭제한다.

MULTIPLEXING_MAX_THREAD_COUNT#

데이터 타입#

Unsigned Integer

기본값#

1024

속성#

변경 가능, 단일 값

값의 범위#

[1, 1024]

설명#

멀티플렉싱을 하는 쓰레드의 최대 개수다.

기존에 존재하는 쓰레드들의 부하가 증가하면 쓰레드가 자동으로 증가한다. 그러나 쓰레드들이 계속 증가하게 되면 오히려 성능이 저하될수 있으므로 적절한 값을 설정해야 한다.

단 큐(QUEUE)를 사용하는 경우에는 이 프로퍼티에서 설정한 값보다 더 많은 쓰레드가 생성될수 있다.

MULTIPLEXING_THREAD_COUNT#

데이터 타입#

Unsigned Integer

기본값#

호스트 장비의 논리 코어 수

속성#

읽기 전용, 단일 값

값의 범위#

[1, 1024]

설명#

Altibase가 유지하는 서비스 쓰레드의 최소 개수이다. 기본값은 장비의 논리 코어 수이다.

이 값은 서버가 구동된 후에는 변경할 수 없다.

NORMALFORM_MAXIMUM#

데이터 타입#

Unsigned Integer

기본값#

2048

속성#

변경 가능, 단일 값

값의 범위#

[1, 2³²-1]

설명#

조건절을 정규화할 때 정규화 형(Normal Form) 노드의 최대 개수를 지정할 수 있는 프로퍼티이다.

SELECT 질의문의 WHERE절에 존재하는 predicate들이 논리 연산자(AND, OR)로 복잡하게 연결되어 있을 때, Altibase는 테이블을 더 빠르게 탐색하기 위하여 predicate을 정규화시킨다.

정규화 방법으로 CNF(Conjunctive Normal Form)와 DNF(Disjunctive Normal Form)가 있으며, 이 프로퍼티에 명시한 노드 개수를 초과하면 해당 정규화 형으로 더 이상 정규화를 시도하지 않는다.

만약 두 가지 정규화 형이 명시한 노드 개수를 초과하면, 조건절을 정규화하지 않고 NNF(Not Normal Form)를 수행한다. NNF를 사용하면 조건절이 정규화되지 않아서 인덱스를 사용할 수 없다.

그러나 조건절을 지나치게 복잡하게 작성한 경우 NNF를 피하고자 이 프로퍼티의 값을 지나치게 크게 설정하면, 복잡한 조건절 처리를 위해 정규화 비용과 메모리 사용량이 증가한다.

따라서 조건절 작성시에 논리연산자를 지나친 사용을 자제하고 정규화 형태로 조건절을 작성하는 것이 중요하다.

이 규칙은 ON 조건 조인의 ON predicate에도 동일하게 적용된다.

OPTIMIZER_AUTO_STATS#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 10]

설명#

옵티마이저가 사용할 수 있는 통계 정보가 없을 때 자동으로 통계 정보를 수집하는 프로퍼티이다. 수집할 수 있는 Page개수는 1\~10까지의 값에 따라 아래의 표와 같다. 0으로 설정하면 통계 정보를 자동으로 수집할 수 없다.

Altibase 운영 중 ALTER SESSION, SYSTEM 문을 이용하여 변경할 수 있다.

값	PAGE 개수	통계 정보 수집 여부
0(기본값)	0	OFF
1	32	ON
2	64	ON
3	128	ON
4	256	ON
5	512	ON
6	1024	ON
7	4096 (32M)	ON
8	16384 (128M)	ON
9	65536 (512M)	ON
10	ALL	ON

OPTIMIZER_DELAYED_EXECUTION#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

실행 계획의 그래프를 기준으로 hierarchy, sorting, windowing, grouping, set, distinction의 실행(execute)을 패치(fetch)에서 수행시킨다. 사용자는 실행 계획에서 상위 PROJECTION 아래에 DELAY 플랜이 추가된 것을 확인할 수 있다.

이 프로퍼티는 쿼리 수행 시 실행(execute)을 지연시켜 첫 번째 패치(fetch)에서 수행하도록 하여, 실행 시간을 줄이고 첫 번째 패치 시간을 늘린다. 첫 번째 패치 이 후의 수행 시간은 동일하다. 관련된 수행 시간은 v\$statement 성능 뷰로 확인 가능하다.

0 : disable (비활성화, 기본값)

1 : enable (활성화)

Altibase 운영 중 ALTER SESSION문을 이용하여 변경할 수 있다.

OPTIMIZER_FEATURE_ENABLE#

데이터 타입#

String

기본값#

Altibase 서버 버전

속성#

변경 가능, 단일 값

값의 범위#

[6.1.1.0.6 | 6.1.1.0.7 | 6.3.1.0.1 | 6.5.1.0.0| 7.1.0.0.0]

설명#

쿼리 옵티마이저와 관련된 프로퍼티들을 일괄적으로 제어하는 프로퍼티이다.

이 프로퍼티는 값의 범위에 속하는 버전에 한해 ALTER SYSTEM문으로 변경할 수 있다.

e.g) ALTER SYSTEM SET optimizer_feature_enable = '6.1.1.0.6';

아래는 이 프로퍼티의 설정에 따라 쿼리 옵티마이저와 관련된 프로퍼티들이 어떤 값으로 설정되는지를 나타낸 표이다.

OPTIMIZER_FEATURE_ENABLE	6.3.1.0.1	6.5.1.0.0	7.1.0.0.0
QUERY_REWRITE_ENABLE	0 (off)	0 (off)	0 (off)
OPTIMIZER_UNNEST_SUBQUERY	1 (on)	1 (on)	1 (on)
OPTIMIZER_UNNEST_COMPLEX_SUBQUERY	1 (on)	1 (on)	1 (on)
OPTIMIZER_UNNEST_AGGREGATION_SUBQUERY	0 (off)	1 (on)	1 (on)
RESULT_CACHE_ENABLE	0 (off)	0 (off)	0 (off)
TOP_RESULT_CACHE_MODE	0 (off)	0 (off)	0 (off)
OPTIMIZER_AUTO_STATS	0 (off)	0 (off)	0 (off)
OPTIMIZER_PERFORMANCE_VIEW	0 (off)	0 (off)	1 (on)

OPTIMIZER_MODE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

이 프로퍼티 값이 0으로 설정되면 질의문을 최적화하기 위하여 비용 기반 최적화(cost-based optimization)가 사용되고, 1이면 규칙 기반 최적화(rule-based optimization)가 사용된다.

Altibase 운영 중 ALTER SYSTEM 문 또는 ALTER SESSION 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

OPTIMIZER_PERFORMANCE_VIEW#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

읽기 전용, 단일 값

값의 범위#

[0, 1]

설명#

성능 뷰를 최적화하기 위하여 메모리 제약 여부를 설정하는 프로퍼티이다. Altibase 시스템 정보를 모니터링 할 때 내부적인 효율성 향상을 기대할 수 있다.

0: 적용 안함 - 메모리 제약이 없다.

1: 적용(기본값) - 메모리 제약이 있다. EXECUTE_STMT_MEMORY_MAXIMUM 프로퍼티의 값을 초과하면 쿼리 실행이 실패한다.

OPTIMIZER_UNNEST_AGGREGATION_SUBQUERY#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

설명#

최적화된 쿼리의 실행 계획이 수행되도록, 사용자가 직접 ANSI/ISO SQL 표준 기법으로 Outer Join 연산을 수행하도록 설정할 수 있다.

[0, 1]

설명#

Altibase 서버에서 쿼리 변환 시에 함수 기반 인덱스를 적용할지 여부를 지정하는 프로퍼티이다.

0: disable (미적용)

1: enable (적용)

REFINE_PAGE_COUNT#

데이터 타입#

Unsigned Integer

기본값#

50

속성#

읽기 전용, 단일 값

값의 범위#

[0, 2³²-1]

설명#

Altibase 서버 가동 시 수행하는 단계 중 데이터베이스 정제(database refining) 단계가 있다. Altibase 서버가 이전 종료할 당시, 트랜잭션들이 생성한 버전 레코드(versioning record)들이 가비지 콜렉터에 의해 처리되지 못해서 불필요한 레코드들이 데이터베이스에 존재하고 있을 수 있으며 또한 서버 가동시의 회복 과정에서 생성된 버전 레코드들이 존재할 수 있다. 이들 레코드들을 재사용 가능하도록 처리하는 것이 데이터베이스 정제 단계이다.

데이터베이스 정제 대상이 되는 레코드들이 많을 경우 시간을 많이 소모할 수 있기 때문에 이 작업을 여러 쓰레드에 의해 병렬로 수행할 수 있다. 이 때 각 쓰레드가 처리하는 페이지 양을 지정한다.

RESULT_CACHE_ENABLE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

Result Cache를 사용하여 중간 결과의 실행계획을 저장할 지 여부를 설정한다.

0: Disabled (기본값) – 캐시기능을 사용하지 않는다.

1: Enabled – 캐시기능을 사용한다.

Altibase 운영 중 ALTER SYSTEM 또는 ALTER SESSION 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

RESULT_CACHE_MEMORY_MAXIMUM (단위:바이트)#

데이터 타입#

Unsigned Long

기본값#

10M

속성#

변경 가능, 단일 값

값의 범위#

[4096, ULONG MAX]

설명#

Result Cache및 Top Result Cache를 사용할 때, 저장하는 메모리 크기를 제한한다. 만약 이 크기를 넘으면 메모리에 저장되지 않고 해제된다. 이 프로퍼티는 쿼리 1개에 대한 제약이며 시스템 전체에 대한 제약은 제공하지 않는다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

SECONDARY_BUFFER_ENABLE#

데이터 타입#

Unsigned Integer

데이터 타입#

Unsigned Integer

기본값#

2

속성#

읽기 전용, 단일 값

값의 범위#

[0, 2]

설명#

보조 버퍼에 저장할 데이터 페이지의 타입을 지정한다. 아래의 값 중 하나를 지정할 수 있다.

0: 모든 타입의 페이지

1: Dirty 페이지

2: Clean 페이지

보조 버퍼 기능에 대한 설명은 SECONDARY_BUFFER_ENABLE 프로퍼티의 설명을 참고하도록 한다.

SORT_AREA_SIZE(단위: 바이트)#

데이터 타입#

Unsigned long

기본값#

1048576

속성#

변경 가능, 단일 값

값의 범위#

[512, 2⁶⁴-1]

설명#

서버가 정렬 작업을 위해 사용하는 임시 테이블 하나의 메모리 크기를 지정한다.

시스템 운영 중에는 ALTER SYSTEM 문을 이용해 프로퍼티의 값을 변경할 수 있다.

SQL_PLAN_CACHE_BUCKET_CNT#

데이터 타입#

Unsigned Integer

기본값#

127

속성#

읽기 전용, 단일 값

값의 범위#

[5, 4096]

설명#

SQL 플랜 캐시에서 해쉬 테이블의 버킷 개수를 나타낸다.

SQL_PLAN_CACHE_HOT_REGION_LRU_RATIO(단위: 백분율)#

데이터 타입#

Unsigned Integer

기본값#

50

속성#

변경 가능, 단일 값

값의 범위#

[10, 100]

설명#

SQL 플랜 캐시에 있는 LRU 리스트의 HOT 영역 비율을 나타낸다. HOT 영역 LRU 리스트는 SQL 플랜 캐시에 있는 LRU 리스트에서 빈번하게 참조되는 플랜들을 별도의 HOT 영역으로 저장한 것이다.

시스템 운영 중 ALTER SYSTEM 문을 이용해 프로퍼티의 값을 변경할 수 있다.

SQL_PLAN_CACHE_PREPARED_EXECUTION_CONTEXT_CNT#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

변경 가능, 단일 값

값의 범위#

[0, 1024]

설명#

설명#

테이블 페이지에 유지될 TTS(Touched Transaction Slots)의 초기 개수를 나타낸다.

TABLE_LOCK_ENABLE#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

잠금(Lock) 수준을 제어하는 프로퍼티이다.

0: 테이블 잠금을 지원하지 않으며 레코드 잠금을 지원한다. 단순 DML 사용시에 성능이 향상된다.

1: 테이블 잠금과 레코드 잠금을 지원한다.

이 프로퍼티 값을 0으로 설정하면 다음과 같은 제약이 따른다.

DDL문을 수행할 수 없다.
CREATE DATABASE질의문을 수행할 수 없다.
이중화로 사용할 시에병렬 동기화 (parallel SYNC)를 사용할 수 없다.

이 프로퍼티는 ALTER SYSTEM 문으로 변경이 가능하다.

TABLE_LOCK_MODE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

읽기 전용, 단일 값

값의 범위#

[0, 1]

설명#

테이블 파티션의 잠금(Lock) 수준을 설정하는 프로퍼티이다. TABLE_LOCK_ENABLE프로퍼티가 1인 경우에만 이 프로퍼티를 사용할 수 있다.

0: 테이블 파티션 단위의 잠금을 지원한다. 파티션 단위의 잠금을 사용하므로 ALTER TABLE…TRUNCATE PARTITION와 같이 파티션 단위로 수행되는 질의문 사용 시에 동시성이 향상된다.

1: 테이블 파티션의 잠금을 지원하지 않으며 파티션드 테이블의 논 파티션드 테이블 잠금과 동일하다. 잠금 횟수가 줄어들어 DML 성능이 향상된다.

TABLE_MAXTRANS#

데이터 타입#

Unsigned Integer

기본값#

120

속성#

읽기 전용, 단일 값

값의 범위#

[0, 120]

설명#

테이블 페이지에 유지될 수 있는 TTS(Touched Transaction Slots)의 최대 개수를 나타낸다.

TABLESPACE_LOCK_ENABLE#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

테이블스페이스 잠금(lock) 레벨을 지정하는 프로퍼티이다.

1: 테이블스페이스 잠금을 지원한다.

0: 테이블스페이스 잠금을 지원하지 않는다. 이 경우 단순 DML 수행 시 처리 속도 향상의 이점이 있지만, 다음과 같은 제약이 있다.

DDL문을 수행할 수 없다.
CREATE DATABASE 구문을 수행할 수 없다.
이중화 시 병렬 동기화(Parallel Synchronization)를 허용하지 않는다.

Altibase 운영 중 ALTER SYSTEM 또는 ALTER SESSION문을 이용하여 이 프로퍼티의 값을 변경할 수 있다. 단, 활성화된 트랜잭션이 없을 경우에만 변경할 수 있다.

TEMP_STATS_WATCH_TIME#

데이터 타입#

Unsigned Int

기본값#

10

속성#

변경 가능, 단일 값

값의 범위#

[0, 2³²-1]

설명#

통계 정보에 등록되는 기준 시간을 지정한다. 임시 테이블을 사용하는 연산 중 이 프로퍼티의 설정된 시간보다 오래 걸리는 연산은 통계정보로 등록된다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

THREAD_CPU_AFFINITY#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

읽기 전용, 단일 값

값의 범위#

[0, 1]

설명#

서비스 쓰레드를 CPU와 연계할지 여부를 설정하는 프로퍼티이다. CPU 연계 기능을 활성화하면 하나의 서비스 쓰레드는 동일한 CPU 코어에만 할당될 것이다. 또한, 한 CPU 코어에서 다른 CPU 코어로 쓰레드 정보를 이동하는 비용이 줄어들 것이다.

0: CPU 연계 기능을 사용하지 않는다.
1: CPU 연계 기능을 사용한다.

하지만 HP-UX IA64 플랫폼에서는 CPU 연계 기능을 사용하는 경우에 로깅 병목이 발생할 수 있다. 따라서 HP-UX IA64 플랫폼에서는 이 프로퍼티의 값을 1로 설정(altibase.properties 파일에서)하여도 Altibase 서버는 CPU 연계 기능을 활성화하지 않는다.

THREAD_REUSE_ENABLE#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

읽기 전용, 단일 값

값의 범위#

[0, 1]

설명#

Altibase 내부에서 사용하는 쓰레드를 재사용할 것인지 여부를 설정한다.

0: 쓰레드 재사용 불가

1: 쓰레드 재사용 가능(기본값)

쓰레드를 재사용하면, 메모리에 대기중인 쓰레드를 사용할 수 있어 쓰레드를 생성하는 비용을 줄일 수 있다.

TIMED_STATISTICS#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

Wait 발생시 대기 시간과 SQL 연산의 소요 시간을 측정할 것인지 여부를 설정한다. 이 프로퍼티를 측정하는 것으로 설정할 경우 성능이 떨어질 수 있다.

0: 측정하지 않음

1: 측정함

TIMER_RUNNING_LEVEL#

데이터 타입#

Unsigned Integer

기본값#

플랫폼 별로 기본값이 아래와 같이 상이하다.

1 : 하위에 기술되지 않은 모든 플랫폼
2 : IBM-AIX
3 : x86-linux, Amd64-linux

속성#

읽기 전용, 단일 값

값의 범위#

[1, 3]

설명#

Wait event를 대기하는 시간과 SQL 연산에 소요되는 시간을 측정하는 방법을 설정한다.

1: 시간을 측정하는 쓰레드가 TIMER_THREAD_RESOLUTION에서 지정한 규칙적인 간격으로 시간을 측정한다.

2: 플랫폼 별로 지원하는 라이브러리 함수를 이용하여 측정한다.

3: 1번과 비슷하지만 시스템 시계(clock)를 이용하여 측정한다. 따라서 다른 방법에 비해 성능 저하가 낮다.

LINUX, PA-RISC-HP-64 이외의 장비에서 이 값을 3으로 설정할 경우, 시간을 제대로 측정하지 못하여 Altibase 서버가 기동이 안 될 수도 있다. 이 경우 Altibase는 altibase_boot.log에 경고 메시지를 남기고, 자동으로 이 프로퍼티의 값을 기본값으로 변경한 후 기동한다. 기본값이 1인 장비에서는 아래와 같은 메시지가 altibase_boot.log에 기록될 것이다.

[Warning] Because a TIMER_RUNNING_LEVEL of 3 is not supported on this platform, it has been set to the default(=1) for this platform.

TIMER_THREAD_RESOLUTION (단위: 마이크로초)#

데이터 타입#

Unsigned Integer

기본값#

1000

속성#

변경 가능, 단일 값

값의 범위#

[50, 10000000]

설명#

TIMER_RUNNING_LEVEL을 1로 설정한 경우 이 프로퍼티는 시간을 측정하는 주기를 의미한다.

TOP_RESULT_CACHE_MODE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 3]

설명#

Top Result Cache를 사용하여 최종 결과의 실행계획을 저장할 지 여부를 설정한다.

0: Disabled (기본값) – Top Result Cache기능을 사용하지 않는다.

1: MEMORY - 메모리 테이블만 사용한 쿼리의 최종결과를 캐시한다

2: DISK – 디스크 테이블만 사용한 쿼리의 최종결과를 캐시한다

3: ALL – 테이블 타입과 상관없이 최종 결과를 캐시한다.

Altibase 운영 중 ALTER SYSTEM 또는 ALTER SESSION 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

TOTAL_WA_SIZE (단위: 바이트)#

데이터 타입#

Unsigned Long

기본값#

128MB

속성#

변경 가능, 단일 값

값의 범위#

[0, 2⁶⁴-1]

설명#

정렬 또는 해싱 작업을 위해 할당할 수 있는 메모리의 최대 크기를 지정한다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

INIT_TOTAL_WA_SIZE (단위: 바이트)#

데이터 타입#

Unsigned Long

기본값#

2⁶⁴-1

속성#

변경 가능, 단일 값

값의 범위#

[0, 2⁶⁴-1]

설명#

설명#

하나의 DML에 의해 생성되는 로그의 누적 크기가 이 프로퍼티에 설정된 값보다 커지면 해당 트랜잭션을 중단하고 오류를 반환한다.

사용자의 부주의로 대용량 배치 작업이 실행되어 시스템에 부하가 발생하는 것을 방지하기 위해 사용하는 프로퍼티이다.

해당 프로퍼티의 값을 0으로 설정하면 로그 크기에 대한 제한이 없어지기 때문에, 트랜잭션을 갱신할 때 발생하는 로그를 무한대로 사용할 수 있다.

Altibase 운영 중 ALTER SYSTEM 문 또는 ALTER SESSION 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

SERIAL_EXECUTE_MODE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

이 프로퍼티는 SCAN PLAN내 FILTER를 최적하화여 FILTER 수행 성능을 향상시킨다. 이때 단순한 FILTER에 한하여 최적화하며, 최적화 여부는 PLAN TREE에서 확인할 수 있다.

0: 최적화지 않음

1: 최적화함

세션 관련 프로퍼티#

Altibase는 클라이언트-서버 구조로 사용 가능하며 세션 연결 프로퍼티는 클라이언트와 서버의 통신에 관한 프로퍼티를 규정하는 것이다. 다음과 같은 프로퍼티들이 있다.

CM_DISCONN_DETECT_TIME (단위: 초)#

데이터 타입#

Unsigned Integer

기본값#

3

속성#

읽기 전용, 단일 값

값의 범위#

[1, 2³²-1]

설명#

데이터 타입#

String

기본값#

\$ALTIBASE_HOME/trc/cm-ipc

속성#

읽기 전용, 단일 값

값의 범위#

없음

설명#

Altibase 서버가 유닉스 환경에서 IPC 방식으로 클라이언트와 연결하기 위해 생성하는 소켓 파일이다.

서버를 구동하면 \$ALTIBASE_HOME/trc 디렉토리 아래에 cm-ipc로 소켓 파일이 생성되며, 이 파일은 삭제되지 않도록 주의해야 한다.

IPC_SEM_KEY#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

읽기 전용, 단일 값

값의 범위#

[0, 4294967294]

설명#

IPC 채널을 생성하는 데 필요한 세마포어 키(key)를 사용자가 정의한 값으로 설정하는 프로퍼티이다.

기본값은 0으로 Altibase 서버 프로세스의 프로세스 식별자(PID)를 기준으로 세마포어 키를 자동으로 생성한다. 0이 아닌 값을 설정하면 IPC_SEM_KEY 값을 기준으로 IPC_SEM_KEY부터 IPC_SEM_KEY + (IPC_CHANNEL_COUNT + 1)만큼의 연속된 세마포어 키를 사용하여 IPC 채널을 생성한다. +1은 SYS 사용자가 관리자 모드(sysdba)로 접속하기 위해 예약된 IPC 채널이다. 예를 들어 IPC_SEM_KEY 값이 10000이고 IPC_CHANNEL_COUNT 값이 1000이면 세마포어 키로 10000부터 11000까지 사용한다.

IPC 채널은 Altibase 서버 구동 시 생성되는데, 세마포어 키가 사용 중이거나 다른 이유로 세마포어를 생성하지 못하면 Altibase 서버 구동은 실패한다. 이 경우 Altibase 서버 트레이스 로그 altibase_boot.log에서 시스템 에러(errno)를 확인하고 그에 따른 적절한 처리를 해야 한다.

IPC_SHM_KEY#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

읽기 전용, 단일 값

값의 범위#

[0, 4294967294]

설명#

설명#

IPCDA 채널을 생성하는 데 필요한 세마포어 키(key)를 사용자가 정의한 값으로 설정하는 프로퍼티이다.

기본값은 0으로 Altibase 서버 프로세스의 프로세스 식별자(PID)를 기준으로 세마포어 키를 자동으로 생성한다. 0이 아닌 값을 설정하면 IPCDA_SEM_KEY 값을 기준으로 IPCDA_SEM_KEY부터 IPCDA_SEM_KEY + IPC_CHANNEL_COUNT만큼의 연속된 세마포어 키를 사용하여 IPCDA 채널을 생성한다. 예를 들어 IPCDA_SEM_KEY 값이 10000이고 IPC_CHANNEL_COUNT 값이 1000이면 세마포어 키로 10000부터 10999까지 사용한다.

IPCDA 채널은 Altibase 서버 구동 시 생성되는데, 세마포어 키가 사용 중이거나 다른 이유로 세마포어를 생성하지 못하면 Altibase 서버 구동은 실패한다. 이 경우 Altibase 서버 트레이스 로그 altibase_boot.log에서 시스템 에러(errno)를 확인하고 그에 따른 적절한 처리를 해야 한다.

IPCDA_SHM_KEY#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

읽기 전용, 단일 값

값의 범위#

[0, 4294967294]

설명#

IPCDA 채널을 생성하는 데 필요한 공유 메모리 키(key)를 사용자가 정의한 값으로 설정하는 프로퍼티이다.

기본값은 0으로 Altibase 서버 프로세스의 프로세스 식별자(PID)를 기준으로 공유 메모리 키를 자동으로 생성한다. 0이 아닌 값을 설정하면 IPCDA_SHM_KEY 값을 기준으로 연속된 키 2개를 공유 메모리 키로 사용한다. 예를 들어 IPCDA_SHM_KEY=10000이면 10000, 10001을 공유 메모리 키 값으로 사용한다.

IPCDA 채널은 Altibase 서버 구동 시 생성되는데, 공유 메모리 키가 사용 중이거나 다른 이유로 공유 메모리를 생성하지 못하면 Altibase 서버 구동은 실패한다. 이 경우 Altibase 서버 트레이스 로그 altibase_boot.log에서 시스템 에러(errno)를 확인하고 그에 따른 적절한 처리를 해야 한다.

MAX_LISTEN#

데이터 타입#

Unsigned Integer

기본값#

128

속성#

읽기 전용, 단일 값

값의 범위#

[0, 16384]

설명#

클라이언트와 Altibase 간의 통신 시 TCP/IP 또는 UNIX DOMAIN 소켓을 사용하는 경우 대기 큐(listen queue)의 크기를 지정하는 값이다.

MAX_STATEMENTS_PER_SESSION#

데이터 타입#

Unsigned Integer

기본값#

1024

속성#

변경 가능, 단일 값

값의 범위#

[1, 65535]

설명#

한 세션에서 실행 가능한 statement의 최대 개수를 지정한다.

Altibase 운영 중 ALTER SYSTEM 또는 ALTER SESSION 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

NET_CONN_IP_STACK#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

읽기 전용, 단일 값

값의 범위#

[0, 1, 2]

설명#

클라이언트 서버간의 TCP/IP통신을 위해서 서버 측에 소켓을 생성할 때 사용하는 인터넷 프로토콜 스택을 지정한다.

0: IPv4만을 지원하는 인터넷 프로토콜 스택을 사용하게 된다.

1: 듀얼 스택 (IPv4와 IPv6 모두 지원하는 인터넷 프로토콜 스택)이 사용된다.

2: IPv6만을 지원하는 인터넷 프로토콜 스택을 사용하게 된다.

NLS_COMP#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

읽기 전용, 단일 값

값의 범위#

[0, 1]

설명#

데이터베이스 생성시 지정된 캐릭터셋(character set)의 캐릭터들의 순서는 해당 국가에서 사용되는 사전과 그 이진 값의 순서가 동일하다고 보장할 수 없다.

이 프로퍼티의 값이 1로 설정되면, 각 캐릭터셋을 해당 언어의 사전 순서대로 비교한다. 현재 한국어에 대해서만 지원하기 때문에, 데이터베이스 캐릭터셋이 한글(KSC5601 완성형 또는 MS확장 완성형)로 설정됐을 때에만 지원한다.

NLS_CURRENCY#

데이터 타입#

String

기본값#

NLS_TERRITORY의 값을 따른다.

속성#

변경 가능, 단일 값

값의 범위#

최대 10바이트 길이의 문자

설명#

지역 통화 기호를 지정하는 프로퍼티이다. 숫자형 데이터 형식 L을 통해 지역 통화 기호를 표시할 때 이 프로퍼티의 값이 사용된다. 이 프로퍼티의 값은 +, -, \<, > 기호로 시작할 수 없다.

Altibase 운영 중 아래와 같이 ALTER SESSION문을 이용하여 이 프로퍼티의 값을 변경할 수 있다:

ALTER SESSION SET NLS_CURRENCY = '$';

주의: 아랍권의 통화 기호가 정확히 표시되려면 클라이언트 응용 프로그램(또는 쉘이나 에디터)이 아랍 문자의 표시를 지원해야 한다.

NLS_ISO_CURRENCY#

데이터 타입#

String

기본값#

NLS_TERRITORY의 값을 따른다.

속성#

변경 가능, 단일 값

값의 범위#

V\$NLS_TERRITORY 성능 뷰에 존재하는 값

설명#

ISO 통화 기호를 지정하는 프로퍼티이다. 숫자형 데이터 형식 C를 통해 국제 통화 기호를 표시할 때 이 프로퍼티의 값이 사용된다. 이 프로퍼티에 지정할 수 있는 값은 V\$NLS_TERRITORY 성능 뷰에 존재하는 값(지역)에 한정된다.

Altibase 운영 중 아래와 같이 ALTER SESSION문을 이용하여 이 프로퍼티의 값을 변경할 수 있다:

ALTER SESSION SET NLS_ISO_CURRENCY = America;

NLS_NCHAR_CONV_EXCP#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

NCHAR 데이터 타입의 데이터를 다른 캐릭터셋으로 변환 시, 데이터 손실이 발생할 수 있다. 이 때 에러를 발생시킬 것인지 아니면 데이터 손실이 발생한 채로 변환을 할 것인지를 결정하는 프로퍼티이다.

이 프로퍼티는 서버에서 NCHAR타입 데이터를 다른 캐릭터셋으로 변환할 때에만 에러를 발생시킨다.

Altibase 운영 중 ALTER SESSION 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

0: FALSE (에러를 발생시키지 않는다.)

1: TRUE

NLS_NCHAR_LITERAL_REPLACE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

기본적으로 클라이언트는 쿼리 문 전체를 데이터베이스 문자 셋으로 변환하여 전송한다. 그러나, 특정 리터럴에 대해 이런 동작을 막으려면, 이 프로퍼티의 값을 1로 설정하고 그 리터럴 앞에 "N" 문자를 덧붙이면 된다. 즉, NCHAR 리터럴로 만드는 것이다.

이 프로퍼티의 값이 1일 때, 클라이언트는 쿼리 문 내의 모든 리터럴 앞에 "N" 문자가 있는지 찾는다. 만약 찾게 되면 클라이언트는 그 리터럴을 데이터베이스 문자 셋으로 변환하지 않고 그대로 전송하며 서버가 직접 내셔널 문자 셋으로 변환한다. 이것은 데이터베이스 문자 셋과는 다른 인코딩이 필요한 NCHAR 타입 데이터를 사용하고자 할 때 유용하다.

Altibase 운영 중 ALTER SESSION 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

0: "N" 문자가 있는지 검사하지 않고 쿼리 문 전체를 데이터베이스 문자 셋으로 변환한다.

1: "N" 문자가 붙어있는 NCHAR 리터럴은 데이터베이스 문자 셋으로 변환하지 않는다.

주의: 이 값을 1로 설정하는 것은 클라이언트의 비용이 크게 발생하므로, 사용시 주의가 필요하다.

NLS_NUMERIC_CHARACTERS#

데이터 타입#

String

기본값#

NLS_TERRITORY의 값을 따른다.

속성#

변경 가능, 단일 값

값의 범위#

없음

설명#

소수점 문자와 그룹 구분자를 지정하는 프로퍼티이다. 그룹 구분자는 숫자에서 천단위로 구분해서 표기할 때 사용되며 일반적으로 쉼표(,)가 사용된다. 소수점 문자는 일반적으로 마침표(.)가 사용된다. 이 프로퍼티는 +, -, \<, > 기호로 시작할 수 없다.

이 프로퍼티에 지정한 문자열에서 처음 두 개의 문자만 각각 소수점 문자와 그룹 구분자로 설정되고 나머지 문자는 무시된다.

Altibase 운영 중 아래와 같이 ALTER SESSION문을 이용하여 이 프로퍼티의 값을 변경할 수 있다:

ALTER SESSION SET NLS_NUMERIC_CHARACTERS='.,';

NLS_TERRITORY#

데이터 타입#

String

기본값#

KOREA

속성#

변경 가능, 단일 값

값의 범위#

V\$NLS_TERRITORY 성능 뷰에 존재하는 값

설명#

지역의 이름을 지정하는 프로퍼티이다. 이 프로퍼티에 지정한 지역에 따라 NLS_NUMERIC_CHARACTER, NLS_CURRENCY, 및 NLS_ISO_CURRENCY 프로퍼티의 값이 자동으로 변경된다. V\$NLS_TERRITORY 성능 뷰를 조회해서 이 프로퍼티에 지정 가능한 지역의 이름을 확인할 수 있다.

Altibase 운영 중 아래와 같이 ALTER SESSION문을 이용하여 이 프로퍼티의 값을 변경할 수 있다. 지역의 이름은 대소문자를 구분하지 않으며, 작은 따옴표(')를 사용할 수 있다.

ALTER SESSION SET NLS_TERRITORY = America;
or
ALTER SESSION SET NLS_TERRITORY = 'America';

Altibase 운영 중 ALTER SESSION 문을 이용하여 해당 세션의 타임 존을 변경할 수 있다.

UNIXDOMAIN_FILEPATH#

데이터 타입#

String

기본값#

\$ALTIBASE_HOME/trc/cm-unix

속성#

읽기 전용, 단일 값

값의 범위#

없음

설명#

Altibase 서버가 유닉스 도메인 방식으로 클라이언트와 연결하기 위해 생성하는 소켓 파일이다.

서버를 구동하면 \$ALTIBASE_HOME/trc 디렉토리 아래에 cm-unix로 기본 소켓 파일이 생성되며, 이 파일은 삭제되지 않도록 주의해야 한다.

USE_MEMORY_POOL#

데이터 타입#

Unsigned Integer

데이터 타입#

Unsigned Integer

기본값#

0

속성#

읽기 전용, 단일 값

값의 범위#

[0, 2]

설명#

PREPARE 상태(IN_DOUBT 상태)인 전역 트랜잭션을 일정 시간이 지나면 임의로 종료시킬 수 있는 프로퍼티이다. 이 때 COMMIT으로 종료시킬 것인지, ROLLBACK으로 종료시킬 것인지를 선택할 수 있으며, 트랜잭션을 종료시킬 때 명령을 기다리는 시간은 XA_INDOUBT_TX_TIMEOUT 프로퍼티에 정의된 값을 사용한다.

0: 종료하지 않음.

1: 트랜잭션 커밋

2: 트랜잭션 롤백

분산 트랜잭션 환경에서는 2 단계 커밋 프로토콜(2 Phase Commit Protocol, XA)을 사용하여 트랜잭션을 수행한다. 트랜잭션을 수행중에 전역(global) 트랜잭션 관리자(Coordinator)로부터 PREPARE 명령을 받은 후 COMMIT이나 ROLLBACK 명령을 받지 못한 상태가 오래 지속될 경우, 데이터베이스 성능에 영향을 줄 수 있다.

타임아웃 관련 프로퍼티#

BLOCK_ALL_TX_TIME_OUT (단위: 초)#

데이터 타입#

Unsigned Integer

기본값#

3

속성#

변경 가능, 단일 값

값의 범위#

[0, 2³²-1]

설명#

Altibase 운영 중 ALTER SYSTEM 문 또는 ALTER SESSION 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

IDLE_TIMEOUT (단위: 초)#

데이터 타입#

Unsigned Integer

데이터 타입#

Unsigned Integer

기본값#

600

속성#

변경 가능, 단일 값

값의 범위#

[0, 2³²-1]

설명#

특정 질의들(정렬 혹은 긴 조인 등)의 수행 시간이 길어짐에 따라 데이터베이스 메모리가 비정상적으로 증가하는 것을 막기 위하여 이 값을 설정한다. 질의 수행 시간이 프로퍼티 파일에 설정된 값보다 커지면 현재 트랜잭션 연산을 부분 철회한다.

Altibase 운영 중 ALTER SYSTEM 문 또는 ALTER SESSION 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

SERVICE_THREAD_RECV_TIMEOUT(단위: 초)#

데이터 타입#

Unsigned Integer

기본값#

60

속성#

읽기 전용, 단일 값

값의 범위#

[0, 3600]

이 프로퍼티는 2n 크기만큼 값을 증감시켜야 하며, 감소시킬 때에는 반드시 데이터베이스를 다시 생성해야 한다.

백업 및 복구 관련 프로퍼티#

데이터베이스가 변경될 때 변경 로그를 유지하는데, 이에 관한 처리를 어떻게 할 것인지를 정하는 프로퍼티들이 있다.

ARCHIVE_DIR#

데이터 타입#

String

기본값#

\$ALTIBASE_HOME/arch_logs

속성#

읽기 전용, 다중 값

값의 범위#

없음

설명#

데이터베이스를 아카이브 로그(Archivelog) 모드로 운영하는 경우 아카이브 로그파일들이 백업될 디렉토리를 설정하는 프로퍼티이다. 사용자가 명시적으로 이 값을 지정하지 않으면 기본으로 Altibase가 설치된 디렉토리 밑의 arch_logs 디렉토리에 아카이브 로그파일들이 백업된다. 이 프로퍼티의 개수는 LOG_DIR 프로퍼티 개수와 정확히 일치해야 한다.

사용자가 이 값을 명시적으로 지정할 수 있으나 지정된 디렉토리는 미리 생성되어 있어야 하며, 그렇지 않은 경우 오류 메시지를 출력함과 동시에 Altibase 서버가 구동되지 않는다.

ARCHIVE_FULL_ACTION#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 2]

설명#

ARCHIVE_DIR에 설정된 디렉토리가 속한 파일 시스템에 충분한 디스크 공간이 없는 경우 아카이브 로그 백업(archive log backup)을 수행하는 아카이브로그 쓰레드의 동작을 제어하는 프로퍼티이다.

디스크 공간 부족으로 로그 파일 백업이 실패하는 경우 설정값에 따른 아카이브로그 쓰레드의 동작 차이는 아래와 같다.

0 : 트레이스 로그(altibase_sm.log)에 에러 메시지를 출력하고 다음 로그 파일의 백업을 시도한다. 로그 파일마다 차례로 이 과정을 거치므로 디스크 공간 부족이 발생한 시점부터 여유 공간이 생길 때까지 아카이브 로그 파일 경로에 백업하지 못한 로그 파일이 있을 수 있다. 이때 체크포인트가 발생하면 백업이 실패한 로그 파일도 불필요한 로그 파일로 판단하고 삭제하기 때문에 데이터베이스 복구가 불가능할 수 있으므로 0으로 설정하고 운영할 경우 주의가 필요하다.

1 : 충분한 디스크 공간이 확보되어 아카이브 로그파일을 백업할 수 있을 때까지 기다린다. 이 기간 동안은 체크포인트가 발생하더라도 아카이브 로그파일을 백업할 수 없기 때문에 로그 파일들은 삭제되지 않는다.

2 : 디스크 공간 부족을 포함한 백업 실패 상황이 발생하는 경우 트레이스 로그(altibase_sm.log)에 에러 메시지를 출력하고 다음 로그 파일의 백업을 시도한다. 로그 파일마다 차례로 이 과정을 거치므로 로그 파일 백업 실패 현상이 발생한 시점부터 백업 실패 상황이 해소될 때까지 아카이브 로그 파일 경로에 백업하지 못한 로그 파일이 있을 수 있다. 이때 체크포인트가 발생하면 백업이 실패한 로그 파일도 불필요한 로그 파일로 판단하고 삭제하기 때문에 데이터베이스 복구가 불가능할 수 있으므로 2로 설정하고 운영할 경우 주의가 필요하다.

ARCHIVE_MULTIPLEX_COUNT#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

읽기 전용, 단일 값

값의 범위#

[0, 10]

설명#

Altibase 서버가 아카이브 로그 파일의 복사본⁹을 몇 개 유지할 것인지를 지정한다. 프로퍼티 설정 이후에 새로이 아카이브 되는 로그 파일부터 복사본이 유지된다.

[⁹] 아카이브 로그 파일 다중화(Multiplexing Archive Logfiles): 아카이브 로그 파일을 별도의 디스크에 복사해 두어, 아카이브 로그 파일 원본의 손상에 대비하는 기능이다.

ARCHIVE_MULTIPLEX_COUNT와 ARCHIVE_MULTIPLEX_DIR 프로퍼티는 서버가 중지(shutdown)된 상태에서 설정할 수 있다.

ARCHIVE_MULTIPLEX_DIR#

데이터 타입#

String

기본값#

""

속성#

읽기 전용, 다중 값

값의 범위#

없음

설명#

아카이브 로그 파일의 복사본이 위치할 경로를 지정한다. ARCHIVE_MULTIPLEX_DIR 프로퍼티는 ARCHIVE_MULTIPLEX_COUNT에 명시한 아카이브 로그 파일의 개수만큼 설정해야 한다. 이 때 각각의 경로는 서로 다른 디스크에 둘 것을 권장한다.

ARCHIVE_THREAD_AUTOSTART#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

읽기 전용, 단일 값

값의 범위#

[0, 1]

설명#

아카이브 로그파일을 주기적으로 백업하는 쓰레드인 아카이브로그 쓰레드를 Altibase 구동시 자동으로 활성화시킬 것인지를 지정하는 프로퍼티이다. 이 값을 1로 하는 경우 아카이브 쓰레드가 자동으로 활성화된다.

이 프로퍼티는 디렉토리에 아카이브 로그파일 백업을 위한 충분한 디스크 공간이 없어서 아카이브로그 쓰레드가 비활성화되면, 이후에 디스크 공간을 확보하여 아카이브로그 쓰레드를 다시 활성화하고자 할 때 사용할 수 있다.

CHECKPOINT_ENABLED#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

읽기 전용, 단일 값

값의 범위#

[0, 1]

설명#

체크포인트를 ON 또는 OFF 시키는 프로퍼티이다.

0: OFF

1: ON

이 값을 0(OFF)으로 지정하면 체크포인트 쓰레드가 동작하지 않으며, CHECKPOINT_INTERVAL_IN_SEC와 CHECKPOINT_INTERVAL_IN_LOG 프로퍼티에서 지정한 주기로 동작할 수 없다. 그러나 사용자가 명시적으로 체크포인트를 수행하면 수행할 수 있다.

CHECKPOINT_INTERVAL_IN_LOG#

데이터 타입#

Unsigned Integer

기본값#

100

속성#

변경 가능, 단일 값

값의 범위#

[1, 2³²-1]

설명#

체크포인트 주기를 설정하는 프로퍼티이다. 즉, 이 프로퍼티에 설정된 값만큼 로그 파일이 생성되면, 다음 체크포인트가 발생한다.

그러나 이 프로퍼티 값에 의해 체크포인트 수행이 요구될 때, 이미 체크포인트가 진행 중이거나 기타 다른 이유로 인하여 체크포인트가 수행되지 못하는 경우가 발생할 수 있다. 이 경우 이미 진행 중인 체크포인트가 끝난 후 바로 체크포인트를 수행하는 것이 아니라 현재의 체크포인트 요구는 바로 취소된다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

CHECKPOINT_INTERVAL_IN_SEC(단위: 초)#

데이터 타입#

Unsigned Integer

기본값#

6000

속성#

변경 가능, 단일 값

값의 범위#

[3, 2592000]

설명#

체크포인트의 주기를 초 단위 시간으로 정하는 것이다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

COMMIT_WRITE_WAIT_MODE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

트랜잭션을 커밋할 때 로그가 로그 파일에 반영될 때까지 기다릴 것인지 여부를 설정하는 프로퍼티이다. Altibase는 기본으로 성능을 위해 기다리지 않는 값으로 설정된다.

로그 버퍼 타입을 결정하는 프로퍼티이다.

0: 운영체제 커널의 로그 버퍼를 사용

1: 프로세스 메모리의 로그 버퍼를 사용

이 프로퍼티는 시스템 운영 중에 변경할 수 없다.

LOG_MULTIPLEX_COUNT#

데이터 타입#

Unsigned Integer

데이터 타입#

Unsigned Integer

기본값#

80

속성#

변경 가능, 단일 값

값의 범위#

[0, 100]

설명#

1: 허용한다.

REPLICATION_BEFORE_IMAGE_LOG_ENABLE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

이중화 수신자의 "이전 이미지(before image)"가 송신자로부터 받은 XLog의 이전 이미지와 다르면 데이터 충돌이 발생할 수 있다.

사용자가 충돌이 발생한 데이터를 확인할 수 있도록, 이 프로퍼티를 설정하여 트레이스 로그에 이중화 수신자의 이전 이미지를 기록할 수 있다.

0: 기록하지 않음

1: 기록함

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REPLICATION_COMMIT_WRITE_WAIT_MODE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

이중화 대상 테이블에 DDL 구문을 허용할 것인지를 나타낸다. 1로 설정한 경우 이중화 대상 테이블에 DDL을 실행할 수 있다.

DDL을 수행하기 전에 현재 세션에서 수행하는 트랜잭션의 이중화 프로퍼티를 NONE 이외의 값으로 설정해야 송신 쓰레드에서 DDL 실행을 알 수 있다. 이중화에서 허용하는 DDL 목록과 제약사항은 Replication Manual을 참조한다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REPLICATION_DDL_ENABLE_LEVEL#

기본값#

'논리 코어 수/2'와 '512' 중 작은 값

속성#

읽기 전용, 단일 값

값의 범위#

[2, 512]

설명#

EAGER 모드로 이중화 수행시 여러 개의 송신 쓰레드가 병렬로 작업을 하게 된다. 이 프로퍼티는 병렬 작업할 송신 쓰레드의 개수를 지정한다. 이중화 송신 쓰레드의 개수를 늘리면 이중화 성능이 향상될 수 있다.

그러나, 이 프로퍼티를 사용하여 송신 쓰레드 개수를 늘릴 경우, 송신 쓰레드가 보내는 트랜잭션의 순서가 보장되지 않는다는 점을 주의해야 한다. 이에 대한 자세한 내용은 Replication Manual을 참고한다.

이 프로퍼티를 설정하지 않으면 기본값은 논리 코어 수와 512 중 더 작은 값이 된다.

REPLICATION_EAGER_RECEIVER_MAX_ERROR_COUNT#

데이터 타입#

Unsigned Integer

기본값#

5

속성#

변경 가능, 단일 값

값의 범위#

[0, 2³²-1]

설명#

Eager 모드로 이중화를 진행할 때, 이중화 수신자가 데이터 복제를 재시도하는 횟수를 설정할 수 있는 프로퍼티이다.

갭 해소 옵션이 설정된 이중화 송신자는 이 프로퍼티에 설정한 시간만큼 이중화 격차(Replication Gap)를 허용한다. 이중화 송신자는 이 프로퍼티에 설정된 시간 안에 이중화 격차를 해소할 수 없다고 판단하면 서비스 트랜잭션의 커밋을 지연시키는 기능이 동작한다.

예를 들어 이 프로퍼티가 5이고, 송신자가 초당 처리하는 로그가 1,000건이라면 이중화 격차를 허용할 수 있는 로그의 개수는 5,000건이다. 만약 현재의 이중화 격차가 10,000건이라면, 허용하는 로그의 개수보다 5,000건을 초과하였으므로, 이중화 격차가 허용하는 로그 개수에 만족하기 위해서 트랜잭션이 5초간 지연되어야 한다는 것을 의미한다.

이 값이 0이면 이중화 격차를 허용하지 않는다는 의미이므로, 트랜잭션이 커밋되기 전에 이중화 격차를 해소시키고 커밋을 수행한다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REPLICATION_GAPLESS_MAX_WAIT_TIME (단위: 마이크로초)#

데이터 타입#

Unsigned Integer

기본값#

10,000,000

속성#

변경 가능, 단일 값

값의 범위#

[0, 2³²-1]

설명#

설명#

연결(Connection) 응답을 하지 않는 경우 몇 회 이후에 장애로 판단할 것인지 결정한다. 따라서, 임의의 호스트의 장애를 판단하는 최대 시간은 REPLICATION_HBT_DETECT_TIME * REPLICATION_HBT_DETECT_HIGHWATER_MARK 이다.

즉, HeartBeat 쓰레드는 기본값인 30초 (5회 시도* 6초) 동안 연결이 되지 않을 경우 장애로 판단한다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REPLICATION_HBT_DETECT_TIME(단위: 초)#

데이터 타입#

Unsigned Integer

기본값#

6

속성#

변경 가능, 단일 값

값의 범위#

[0, 2592000]

설명#

설명#

송신 쓰레드가 패킷을 전송하지 않고 (REPLICATION_SENDER_SLEEP_TIME * REPLICATION_KEEP_ALIVE_CNT) 시간 동안 Sleep하면, KEEP_ALIVE신호를 전송한다.

REPLICATION_LOCK_TIMEOUT (단위: 초)#

데이터 타입#

Unsigned Integer

기본값#

5

속성#

변경 가능, 단일 값

값의 범위#

[0, 3600]

설명#

이중화 데드락이 발생하는 경우 수신 쓰레드 쪽에서는 무한정 잠금을 기다리게 되어 서비스가 중단될 수 있다. 이러한 경우를 방지하기 위해 수신 쓰레드는 해당 작업의 수행에 대해 잠금을 요구할 때, 최대 이 프로퍼티에 설정된 시간만큼만 잠금을 획득하기 위해 기다린다.

명시된 시간 내에 잠금을 획득하지 못하는 경우 해당 작업은 철회된다.

REPLICATION_LOG_BUFFER_SIZE (단위: 메가바이트)#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

읽기 전용, 단일 값

값의 범위#

[0, 2¹²-1]

설명#

이중화 전용 로그 버퍼를 사용함으로써 이중화 성능을 개선하는 프로퍼티이다. 이중화 전용 로그 버퍼에는 이중화에 필요한 로그만 필터링하여 저장하기 때문에 더 많은 로그가 버퍼에 존재한다.

송신 쓰레드는 로그를 읽기 위해서 로그 버퍼 또는 디스크에서 로그를 읽는다. 그러나 디스크에서 로그를 읽는 경우 송신 쓰레드의 처리 속도가 현저히 떨어질 수 있다. 더욱이 이중화를 실행하면 필요하지 않은 로그까지 읽어야 하는 부담이 발생한다. 이중화 전용 로그 버퍼는 이러한 부담을 완화시켜준다.

다수의 이중화 송신 쓰레드가 수행중일 때는 이중화 성능과 서비스 성능이 저하될 수 있다. 이중화 로그 버퍼가 하나이므로 다수의 송신 쓰레드가 접근한다면 동기화 오버헤드가 발생할 확률이 높아지기 때문이다.

이중화 로그 버퍼에서 읽은 로그는 REPLICATION_SYNC_LOG 값을 1로 하여도 디스크에 기록되지 않은 상태에서 수신 쓰레드로 전송될 수 있다.

REPLICATION_LOG_BUFFER_SIZE를 너무 작게 설정하면, 사용하지 않는 것(0)보다 더 좋지 못한 성능을 낼 수 있다.

REPLICATION_MAX_COUNT (단위: 개수)#

데이터 타입#

Unsigned Integer

기본값#

32

속성#

읽기 전용, 단일 값

값의 범위#

[0, 10240]

설명#

Altibase에 생성할 수 있는 이중화 객체의 최대 개수를 지정한다.

기본값은 32이며, 한 서버에서 최대 32개의 원격 서버와 이중화로 연결할 수 있음을 의미한다.

REPLICATION_MAX_LISTEN#

데이터 타입#

Unsigned Integer

기본값#

32

속성#

읽기 전용, 단일 값

값의 범위#

[0, 512]

설명#

이중화 송신 쓰레드와 수신 쓰레드를 관리하는 Altibase 서버간의 통신 시 TCP/IP 소켓을 사용하는 경우 대기 큐(listen queue)의 크기를 지정하는 값이다.

REPLICATION_MAX_LOGFILE#

데이터 타입#

Unsigned Integer

설명#

송신 쓰레드와 수신 쓰레드에서 공통적으로 사용하는 프로퍼티로 송신/수신 쓰레드로부터 어떤 메시지를 기다리는 최대 시간을 지정하는 프로퍼티이다.

송신 쓰레드에서는 상대편 수신 쓰레드로부터 응답을 기다리는 최대 시간이며 명시된 시간이 경과하게 되면 REPLICATION_SENDER_SLEEP_TIMEOUT에서 지정된 시간만큼 sleep한 후 다시 상대편 수신 쓰레드와의 접속을 시도한다. 이 경우 기존 사용하던 소켓은 닫고 새로운 소켓을 생성하여 재연결을 시도한다.

수신 쓰레드에서는 상대편 송신 쓰레드로부터 어떤 메시지를 기다리는 최대 시간이다. 명시된 시간이 경과하게 되면 수신 쓰레드는 자동 종료되며 이후 상대편 송신 쓰레드가 어떤 메시지를 다시 보내게 되는 경우 다시 생성된다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REPLICATION_RECEIVER_APPLIER_ASSIGN_MODE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

이중화 수신자가 적용자(Applier)에게 XLog를 할당할 때 어떤 모드로 적용자에게 분배할 것인지를 선택하는 프로퍼티이다.

0: Transaction Count Mode

1: XLog Count Mode

이 값이 0이면 수신자는 할당된 트랜잭션이 가장 적은 적용자에게 XLog를 할당한다. 1인 경우에는 XLog 개수가 가장 적게 할당된 적용자에게 XLog를 할당한다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REPLICATION_RECEIVER_APPLIER_QUEUE_SIZE#

데이터 타입#

Unsigned Integer

기본값#

20

속성#

변경 가능, 단일 값

값의 범위#

[2, 2³²-1]

설명#

수신자가 적용자 쓰레드들의 대기 큐에 전달할 수 있는 최대 XLog의 개수이다.

이 값이 클수록 적용자(Applier)에 전달하는 XLog의 개수가 많아질 수 있으나, 대기 큐에 XLog 들이 쌓이므로 메모리를 보다 많이 사용하게 된다. 이 값은 적용자 숫자의 2배 가량으로 설정하는 것을 권고한다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REPLICATION_RECEIVER_APPLIER_YIELD_COUNT#

데이터 타입#

Unsigned Integer

기본값#

20000

속성#

변경 가능, 단일 값

값의 범위#

[0, 2³²-1]

설명#

Applier 가 다른 Applier 의 Transaction 반영 대기시 시스템 함수인 yield 를 이용하여 대기 하는 횟수.

yield 함수를 사용시 CPU 사용을 하기 때문에 이 횟수 이상 호출 이후에는 CPU 자원을 사용안하는 timed_wait 함수를 호출 한다.

REPLICATION_RECOVERY_MAX_LOGFILE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 2³²–1]

설명#

이중화를 이용한 데이터 복구를 위하여 재시작 리두 시점(Restart Redo Point)을 기준으로 삭제하지 않을 최대 로그 파일의 개수를 의미한다.

이중화를 이용한 데이터 복구를 하기 위하여 원격 서버에서 디스크에 반영(flush)되지 않은 로그에 해당하는 지역 서버의 로그를 삭제하지 않고 유지한다. 이 때 체크포인트가 발생해도 로그 파일을 삭제할 수 없어 지역 서버의 로그파일 개수가 계속 증가하게 되면 결국 디스크 풀이 발생할 수 있다.

따라서 체크포인트가 발생하였을 때 복구 옵션을 위한 로그 파일 개수의 최대 값을 넘는 경우, 이중화를 이용한 복구를 포기하고, 로그 파일들을 삭제한다. 그리고 이중화를 다시 시작한다.

0으로 설정한 경우, 이 기능을 적용하지 않는다.

체크포인트를 수행할 때 로그 파일을 지우기 때문에, CHECKPOINT_INTERVAL_IN_SEC와 CHECKPOINT_IN_LOG의 값을 함께 고려해야 한다.

REPLICATION_RECOVERY_MAX_TIME (단위: 초)#

데이터 타입#

Unsigned Integer

기본값#

2³²–1

속성#

읽기 전용, 단일 값

값의 범위#

[0, 2³²–1]

설명#

이중화 모듈이 복구를 진행하는 중에 최대 시간이 지나면, 복구를 중단하고 지금까지 복구된 상태로 서비스를 진행할 수 있도록 한다.

이 값을 0으로 설정하는 경우, 이중화를 이용한 복구 과정을 진행하지 않는다.

Altibase는 이중화를 이용한 데이터 복구가 완료하기 전에 서비스 단계로 진행할 수 없어, 서비스 지연을 가져올 수 있다.

REPLICATION_SENDER_AUTO_START#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

읽기 전용, 단일 값

값의 범위#

[0, 1]

설명#

Altibase가 서버 종료시 stop 시키지 않은 이중화 객체가 있었다면, 서버 재구동 시 이러한 이중화 객체들이 자동으로 시작되는 것이 기본 동작이다. 이 값을 0으로 설정하면, 서버 구동 시 이중화 객체가 자동으로 시작되는 것을 막을 수 있다.

REPLICATION_SENDER_COMPRESS_XLOG#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

이 프로퍼티는 이중화를 위해 데이터가 네트워크 상에서 전송될 때, 전송하는 패킷의 압축 여부를 지정한다.

0: 전송할 데이터를 압축하지 않음

1: 전송할 데이터를 압축함

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REPLICATION_SENDER_ENCRYPT_XLOG#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

이 프로퍼티는 이중화를 수행할 때 송신 쓰레드의 로그를 암호화하여 전송할 것인지 여부를 지정할 수 있다.

0: 전송 로그를 비암호화

1: 전송 로그를 암호화

REPLICATION_SENDER_IP#

데이터 타입#

String

기본값#

ANY

속성#

읽기 전용, 다중 값

값의 범위#

없음

설명#

이중화 송신자의 IP 주소를 설정하는 프로퍼티이다. 값으로 ANY나 IP 주소를 입력할 수 있다.

기본값 ANY는 이중화 객체를 생성하는 지역 서버의 모든 IP 주소가 이중화 통신에 사용될 수 있으며 OS에서 할당한 IP 주소가 송신자 IP 주소로 사용된다. IP 주소를 값으로 설정하면 원격 서버(수신자)와 통신할 때 설정한 IP 주소만 사용된다. REPLICATION_SENDER_IP = value를 추가하여 여러 개의 IP 주소를 설정할 수 있으며 순서대로 송신자 IP 주소로 사용된다. IP 주소는 IPv4, IPv6, IPv6 확장 주소 형태로 입력할 수 있다.

설정 예시

REPLICATION_SENDER_IP = 10.0.0.1
REPLICATION_SENDER_IP = 0000:0000:0000:0000:0000:ffff:1400:0001

자세한 내용은 Replication Manual에서 송신자 IP 주소 설정 설명을 참고한다.

REPLICATION_SENDER_SEND_TIMEOUT (단위: 초)#

데이터 타입#

Unsigned Integer

기본값#

7200

속성#

변경 가능, 단일 값

값의 범위#

[0, 2³²-1]

설명#

송신 쓰레드가 원격 서버로 패킷을 전송할 때 대기하는 최대 시간을 지정하는 프로퍼티이다.

이 값은 REPLICATION_RECEIVE_TIMEOUT(기본값:7200초) 프로퍼티의 값과 동일한 값을 설정할 것을 권고한다. 이 값을 0으로 설정하면 송신 쓰레드가 블로킹 소켓(blocking socket)을 사용한다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REPLICATION_SENDER_SLEEP_TIME (단위: 마이크로초)#

데이터 타입#

Unsigned Integer

기본값#

10000

속성#

변경 가능, 단일 값

값의 범위#

[0, 2³²-1]

설명#

이 프로퍼티는 송신 쓰레드가 더 이상 읽을 로그가 없을 때, Sleep하는 시간을 지정한다. 특정 플랫폼에서는 짧은 시간의 Sleep이 무시되므로, 적당한 값을 지정해야 한다. REPLICATION_KEEP_ALIVE_CNT와 함께 KEEP_ALIVE를 전송하는 데 사용된다.

REPLICATION_SENDER_SLEEP_TIMEOUT(단위: 초)#

데이터 타입#

Unsigned Integer

기본값#

60

속성#

변경가능, 단일 값

값의 범위#

[0, 2592000]

설명#

이중화 송신 쓰레드가 오류 상황에서 sleep을 해야 할 때 얼마나 할 것인지를 결정한다.

Altibase 운영 중에 ALTER SYSTEM 구문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REPLICATION_SENDER_START_AFTER_GIVING_UP#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

이 프로퍼티는 재시작 리두 시점 (Restart Redo Point) 이전 로그 파일들의 개수가 REPLICATION_MAX_LOGFILE 프로퍼티로 설정된 값을 초과하여 이중화가 잠시 중단된 이후, 다시 시작하는 방식을 결정한다.

0으로 설정된 경우에는, 이중화 "재시작 SN" (즉 SYS_REPLICATIONS_ 메타 테이블의 XSN 칼럼의 값)이 -1로 초기화되며, 이중화는 중지된다. 그리고, SYS_REPLICATIONS_ 메타 테이블의 IS_STARTED 칼럼의 값이 0으로 바뀐다.

1로 설정된 경우, 이중화 "재시작 SN" 값은 현재 로그 파일의 마지막 (가장 큰) SN으로 변경되고, 이중화는 이 "재시작 SN" 부터 다시 수행된다.

REPLICATION_SERVER_FAILBACK_MAX_TIME#

데이터 타입#

Unsigned Integer

기본값#

2³²-1

속성#

읽기 전용, 단일 값

값의 범위#

[0, 2³²-1]

설명#

EAGER 모드 이중화에서, 비정상 종료된 서버가 재구동 될 때, 다른 쪽(즉, 원격) 서버의 데이터와 동기화된 후에야 서비스가 재개된다. 이 때, 다른 서버의 로그를 비정상 종료했던 서버에 반영하는 과정이 이 프로퍼티에 설정된 시간(초)보다 오래 걸린다면, 비정상 종료했던 서버는 동기화가 완료되는 것을 포기하게 된다.

REPLICATION_SQL_APPLY_ENABLE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

Lazy 모드로 이중화 수행 과정에서 Active 서버와 Standby 서버의 이중화 테이블 메타 정보가 다른 경우, 아래의 조건에 따라 XLog가 SQL 문으로 변환되어 반영된다.

0: XLog를 이용하여 이중화가 동작한다. 이때, 메타 정보가 다르면 Handshaking 에러가 발생한다.
1: 아래의 조건에서 이중화를 수행하면, XLog가 SQL 문으로 변환이 되어 이중화 테이블에 반영한다.
칼럼 정보
데이터 타입이 다를 경우
size, precision, scale 이 다를 경우
제약 조건
check 제약 조건이 다를 경우
Not Null 제약 조건이 다를 경우
다른 메타 정보 중 LOB 칼럼이 포함된 경우
인덱스
유니크 인덱스나 Function-based 인덱스가 이중화 대상 칼럼과 이중화 대상이 아닌 칼럼으로 구성되어 있을 경우
유니크 인덱스의 구성 정보가 다를 경우
Function-based 인덱스의 구성 정보가 다를 경우

REPLICATION_SYNC_APPLY_METHOD#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

이중화 수행 중에 지역 서버와 원격 서버간의 불일치한 데이터를 어떤 방식으로 동기화 할 것인지 설정한다.

0: Normal Insert
1: Direct-Path Insert

이중화 SYNC 과정에서 Direct-Path Insert 방식을 이용할 경우, 데이터 동기화 이후 Index를 재생성한다. 따라서, 이중화 SYNC 과정이 도중에 실패할 경우, Index inconsistent 가 발생할 수 있다.

Direct-Path Insert에 대한 자세한 설명은 Administrator’s Manual을 참조하기 바란다. Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REPLICATION_SYNC_LOCK_TIMEOUT (단위: 초)#

데이터 타입#

Unsigned Integer

기본값#

30

속성#

변경 가능, 단일 값

값의 범위#

[0, 2³²-1]

설명#

설명#

Active-Active 이중화 환경에서 데이터 충돌이 발생하였을 때 이 프로퍼티의 값에 따라 해결방식이 다르게 적용된다.

이 프로퍼티의 값이 1로 설정되고, 이중화 대상 테이블에 TIMESTAMP 칼럼이 있는 경우에 Timestamp-based Scheme 방식으로 충돌이 해결된다.

그러나 이중화 대상 테이블에 TIMESTAMP 칼럼이 있어도, 이 프로퍼티의 값이 0이면 이미 설정되어 있는 Conflict Resolution Scheme 방식이 사용된다.

데이터 충돌에 대한 자세한 설명은 Replication Manual을 참고한다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REPLICATION_TRANSACTION_POOL_SIZE#

데이터 타입#

Unsigned Integer

기본값#

2

속성#

변경 가능, 단일 값

값의 범위#

[0, 2³²-1]

설명#

이 프로퍼티는 트랜잭션 풀에 미리 생성해 두는 트랜잭션의 개수를 지정한다. 이중화 수신자는 데이터를 복제할 때 트랜잭션을 사용한다. 그리고 성능 향상을 위해 이중화 수신자 별로 트랜잭션 풀(pool)을 만들고, 이 곳에 트랜잭션들을 미리 생성해 두고 사용할 수 있다.

만약 풀에 존재하는 트랜잭션의 수가 부족하다면, 이중화 수신자는 새로운 트랜잭션을 생성하여 이를 사용할 것이다. 그리고 사용이 끝난 트랜잭션은 풀에 반환되는데, 이 때 존재하는 트랜잭션의 개수가 이 프로퍼티에 지정된 값보다 크면, 풀에 반환되지 않고 바로 해제된다.

이 값을 너무 크게 지정하면, 일반 트랜잭션의 개수에 제한을 줄 수 있으므로 적절한 값으로 설정해야 한다. 이 프로퍼티에 허용된 최댓값은 2³²-1이지만, 실제 최댓값은 TRANSACTION_TABLE_SIZE 프로퍼티에 지정한 값과 같다. 만약 사용자가 이 값을 TRANSACTION_TABLE_SIZE의 값보다 크게 지정하면, 내부적으로 이 프로퍼티의 값이 TRANSACTION_TABLE_SIZE의 값으로 설정된다.

Altibase 구동 중에 이 프로퍼티의 값을 변경할 수 있다. 하지만 이중화 수신 쓰레드 생성시 트랜잭션 풀이 초기화되므로, 이중화를 재시작해야 변경된 프로퍼티의 값이 적용된다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REPLICATION_UPDATE_REPLACE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

이중화 작업중 변경작업 충돌(update conflict) 시 변경된 내용의 반영을 결정한다. 값이 0 이면 충돌이 있을 경우 반영하지 않고 오류 처리하며, 1일 경우 충돌을 무시하고 반영한다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REPLICATION_META_ITEM_COUNT_DIFF_ENABLE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

Lazy 모드로 이중화 수행 과정에서 SPLIT PARTITION과 MERGE PARTITION, DROP PARTITION을 수행하여 Active 서버와 Standby 서버의 이중화 테이블 파티션 메타 아이템 개수가 다른 경우에 이중화를 START 할 수 있는 프로퍼티이다. 이 값을 1로 설정하면 이중화 테이블 파티션 메타 아이템 개수가 다른 경우에도 이중화를 START 할 수 있다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

네트워크 관련 프로퍼티#

IB_CONCHKSPIN#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

읽기 전용, 단일 값

값의 범위#

[0, 2147483]

데이터 타입#

Unsigned Integer

기본값#

1

속성#

읽기 전용, 단일 값

값의 범위#

[0, 1]

설명#

UTRANS TIMEOUT이 발생했을 때 트랩을 보낼지 여부를 결정한다.

0: 트랩을 발생시키지 않는다.

1: 트랩을 발생시킨다.

자세한 내용은 SNMP Agent Guide의 altiPropertyAlarmUtransTimeout를 참고하기 바란다.

SNMP_ALARM_SESSION_FAILURE_COUNT#

데이터 타입#

Unsigned Integer

기본값#

3

속성#

읽기 전용, 단일 값

값의 범위#

[0, 2³²-1]

설명#

세션에서 연속으로 프로퍼티에 설정한 횟수만큼 오류가 발생했을 때 트랩을 보낸다. 기본값은 3이고, 0이면 트랩을 보내지 않는다. 자세한 내용은 SNMP Agent Guide의 altiPropertyAlarmSessionFailureCount를 참고하기 바란다.

SNMP_ENABLE#

데이터 타입#

Unsigned Integer

데이터 타입#

Unsigned Integer

기본값#

1000

속성#

읽기 전용, 단일 값

값의 범위#

[1, 2³²-1]

설명#

통신을 사용하기 위한 타임아웃 값이다.

Altibase와 altisnmpd(Altibase sub agent)간에 통신을 할 때 이 프로퍼티에 설정한 값만큼 대기한다.

SNMP_SEND_TIMEOUT (단위: 밀리초)#

데이터 타입#

Unsigned Integer

기본값#

100

속성#

읽기 전용, 단일 값

값의 범위#

[1, 2³²-1]

설명#

설명#

이 프로퍼티는 Altibase가 클라이언트와 협의하여 사용할 수 있는 암호 알고리즘의 이름 후보들이다. 암호 알고리즘은 사용자의 보안 정책에 따라 하나 또는 그 이상의 암호를 사용할 수 있다. 두 개 이상의 암호를 사용할 경우 콜론(:)으로 구분한다. 사용자가 사용할 수 있는 암호 목록은 OpenSSL( http://www.openssl.org/ )에서 확인하거나 아래처럼 명령어를 사용하여 확인할 수 있다.

$ openssl ciphers

SSL_CIPHER_SUITES#

기본값#

없음

속성#

읽기 전용, 단일 값

값의 범위#

없음

설명#

Altibase 서버의 개인 키(private key)가 저장된 파일 경로를 지정한다.

예를 들어 \$ALTIBASE_HOME/cert/server-key.pem으로 지정할 수 있다.

SSL_LOAD_CONFIG#

데이터 타입#

Unsigned Integer

데이터 타입#

Unsigned Integer

기본값#

1

속성#

읽기 전용, 단일 값

값의 범위#

[0, 1]

설명#

Altibase 서버가 통신 프로토콜로 TCP/IP를 선택하여 통신할 것인지를 설정할 수 있다.

0 : TCP/IP 사용하지 않음

1: TCP/IP 사용

메시지 로그 관련 프로퍼티#

ALL_MSGLOG_FLUSH#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

이 값이 1인 경우 데이터베이스의 모든 메시지가 기록 즉시 디스크에 반영되고 0인 경우에는 일정 주기에 한 번씩 디스크에 반영된다. 과도한 로깅으로 인한 성능저하를 예방하기 위해서는 0으로 설정하는 것이 적절하고, 데이터베이스 문제 진단 시에는 1로 설정하고 작업한다.

COLLECT_DUMP_INFO#

데이터 타입#

Unsigned Integer

데이터 타입#

Unsigned Integer

기본값#

3

속성#

변경가능, 단일 값

값의 범위#

[0, 2³²-1]

설명#

설명#

설명#

설명#

LB_MSGLOG_FILE에 기록될 서비스 쓰레드 관련 메시지 항목을 지정한다.

0: 기록하지 않음

1: 서비스 쓰레드의 생성 및 해제

2: Task 이동에 대한 로그

3: 서비스 쓰레드의 생성 및 해제, Task 이동에 대한 로그

LB_MSGLOG_SIZE#

데이터 타입#

Unsigned Integer

없음

설명#

메일 모듈 처리 시에 발생하는 메시지가 기록되는 파일이다.

MM_MSGLOG_FLAG#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

변경가능, 단일 값

값의 범위#

[0, 2³²-1]

설명#

설명#

설명#

설명#

서버 내에서 수행되는 작업과 서버의 상태 정보를 파일로 기록하여 분석할 수 있도록 한다. 사용자는 값을 조합하여 원하는 정보를 기록하도록 설정할 수 있으며, 값에 따라서 기록되는 정보는 다음과 같다.

0 : 기록하지 않음
1 : SQL 문이 실행될 때마다 실행된 SQL문, 실행시간, 실행정보, 색인 및 디스크 접근 정보 출력. 단, 실행시간이 제대로 출력되게 하려면 TIMED_STATISTICS 프로퍼티를 1로 설정해야 한다.
2 : SQL 문이 실행될 때마다 BIND 파라미터 출력
4 : SQL 문이 실행될 때마다 실행계획 출력
8 : 3초마다 세션 정보 출력 (V\$SESSTAT 의 데이터)
16 : 3초마다 시스템 정보 출력 (V\$SYSSTAT 의 데이터)
32 : 3초마다 메모리 정보 출력 (V\$MEMSTAT 의 데이터)

예를 들어 프로퍼티를 1+4+32=37로 설정하면, SQL 문이 실행될 때마다 SQL 문의 실행 정보와 실행계획을 출력하고 3초마다 메모리 정보를 출력한다.

파일에 대한 분석은 altiProfile 유틸리티로 가능하며, 자세한 설명은 Utilities Manual의 유틸리티를 참조한다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

QUERY_PROF_LOG_DIR#

데이터 타입#

String

기본값#

\$ALTIBASE_HOME/trc

속성#

변경 가능, 단일 값

값의 범위#

[1, 1024 ]

설명#

설명#

이중화 충돌과 관련된 트레이스 로그의 로깅 레벨을 지정한다.

설정 가능한 값은 아래와 같다:

[0, 2³²-1]

설명#

설명#

altibase_st.log 파일에 st관련 정보를 기록한다.

0: st 정보 기록하지 않는다.
1: st 정보를 기록한다.

서버용 XA 메시지 로그의 기록 단계를 설정하는 속성으로 설정값은 다음과 같다.

0: XA 관련 최소 필수 메시지만 기록

1: XA 연산 호출을 기록

2: XID 할당, 해제 등을 기록함

3: XA 관련 모든 메시지 로그를 기록함

XA_MSGLOG_RESERVE_SIZE (단위: 바이트)#

데이터 타입#

Unsigned Integer

기본값#

10 * 1024 * 1024

속성#

읽기 전용, 단일 값

값의 범위#

[0, 2³²-1]

설명#

서버용 XA 메시지 파일의 저장을 위해 디스크에 미리 확보해 둘 공간의 크기를 지정한다.

XA_MSGLOG_SIZE#

데이터 타입#

Unsigned Integer

기본값#

10 * 1024 * 1024

속성#

읽기 전용, 단일 값

값의 범위#

[0, 2³²–1]

설명#

서버용 XA 메시지 파일의 최대 크기를 지정한다.

글로벌 트랜잭션 수행 레벨을 지정한다. 이 프로퍼티를 0으로 설정할 경우, DBLINK_REMOTE_STATEMENT_AUTOCOMMIT 프로퍼티를 원격 데이터베이스의 AUTOCOMMIT 모드와 동일하게 지정해야 한다.

0: remote statement execution level. 이 레벨에서는 하나의 글로벌 트랜잭션에 참여하는 서버들(로컬 및 원격 서버)의 각 트랜잭션이 별개의 트랜잭션으로 인식되므로, 글로벌 트랜잭션을 커밋하기 위해서는 각 서버의 트랜잭션을 별도로 commit해 주어야 한다. 즉, 이 레벨에서는 글로벌 트랜잭션이라 하더라도 로컬 서버에서 수행하는 commit이 원격 서버에 영향을 미치지 않는다.

1: simple transaction commit level. 이 레벨에서는 하나의 글로벌 트랜잭션에 참여하는 서버들(로컬 및 원격 서버)의 모든 트랜잭션이 하나의 트랜잭션으로 인식된다. 즉, 로컬 서버에서 글로벌 트랜잭션을 커밋하면 해당 트랜잭션에 참여하는 모든 트랜잭션들이 커밋된다.

2: Two-Phase Commit (2PC) Level. 이 레벨에서는 하나의 글로벌 트랜잭션에 참여하는 데이터베이스 시스템의 트랜잭션 정합성을 보장하기 위해 2PC 프로토콜을 지원한다. 글로벌 트랜잭션이 시작되면 트랜잭션이 종료할 때까지 이 프로퍼티 값을 변경 할 수 없다.

DBLINK_RECOVERY_MAX_LOGFILE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[1, 2³²-1]

설명#

이 프로퍼티는 트랜잭션 수행 중에 이기종 데이터베이스 시스템에 장애가 발생할 경우, Altibase가 분산 트랜잭션 복구를 위해 유지하는 로그 파일의 최대 개수이다. 이 프로퍼티 값이 0이면 분산 트랜잭션 복구를 위한 로그를 삭제하지 않아 정합성이 보장된다. 그러나 프로퍼티 값을 1보다 큰 값으로 설정하면, 로그 파일의 개수가 초과할 경우에 분산 트랜잭션이 완료되지 않더라도 체크포인트에 의해 로그가 삭제되므로 정합성을 보장할 수 없다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

DBLINK_REMOTE_STATEMENT_AUTOCOMMIT#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

원격 데이터베이스의 AUTOCOMMIT 모드를 지정한다.

DBLINKE_GLOBAL_TRANSACTION_LEVEL을 0으로 설정한 경우에만 이 프로퍼티가 적용된다.

0: autocommit-off

1: autocommit-on

DBLINK_REMOTE_TABLE_BUFFER_SIZE (단위: 메가바이트)#

데이터 타입#

Unsigned Integer

기본값#

50

속성#

변경 가능, 단일 값

값의 범위#

[0, 2³²-1]

설명#

REMOTE_TABLE 키워드를 사용하여 원격 서버에서 질의를 수행하면, 질의 결과를 임시로 저장할 수 있는 메모리 버퍼이다.

저장된 질의 결과는 질의 처리기에 전달된 후 삭제된다. 그러나 결과 집합중의 하나의 레코드가 이 프로퍼티에 지정한 크기보다 크면 저장할 수 없으므로, 프로퍼티의 값을 조정해야 한다.

감사 관련 프로퍼티#

AUDIT_FILE_SIZE (단위: 바이트)#

데이터 타입#

Unsigned Int

기본값#

100M

속성#

변경 가능, 단일 값

값의 범위#

[0, 2³²-1]

설명#

감사된 구문의 정보가 기록되는 바이너리 파일의 크기를 바이트 단위로 지정한다. 이 프로퍼티는 AUDIT_OUTPUT_METHOD 프로퍼티의 값이 0일 때 적용된다.

Altibase 운영 중에는 아래와 같이 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

ALTER SYSTEM SET AUDIT_FILE_SIZE=10000;

단, 서버가 auditing을 수행 중이라면 다음 생성되는 파일부터 변경된 크기가 적용된다. 만약 프로퍼티의 변경을 바로 적용하려면 ALTER SYSTEM STOP AUDIT과 ALTER SYSTEM START AUDIT 구문으로 auditing을 재시작하라.

AUDIT_LOG_DIR#

데이터 타입#

String

기본값#

\$ALTIBASE_HOME/trc

속성#

변경 가능, 다중값

값의 범위#

없음

설명#

감사된 구문 정보가 기록되는 바이너리 파일이 생성될 디렉토리를 지정한다. 이 프로퍼티는 AUDIT_OUTPUT_METHOD 프로퍼티의 값이 0일 때 적용된다.

Altibase 운영 중에는 아래와 같이 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

ALTER SYSTEM SET AUDIT_LOG_DIR='/tmp';

단, 서버가 auditing을 수행 중이라면 다음 생성되는 파일부터 변경된 디렉토리가 적용된다. 만약 프로퍼티의 변경을 바로 적용하려면 ALTER SYSTEM STOP AUDIT과 ALTER SYSTEM START AUDIT 구문으로 auditing을 재시작하라.

AUDIT_OUTPUT_METHOD#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 불가, 단일값

값의 범위#

[0, 9]

설명#

감사된 구문 정보가 기록되는 파일의 형태를 지정한다. Altibase는 감사 정보를 바이너리 또는 시스로그(syslog)로 저장할 수 있다. 단 syslog는 리눅스 운영체제에서만 지원한다.

기본값을 설정한 경우 감사된 정보가 바이너리 형태로 AUDIT_LOG_DIR 프로퍼티에서 지정한 디렉토리에 저장된다. 1\~9의 값을 설정한 경우, syslog를 사용해서 syslog.conf(또는 rsyslog.conf)에 로그가 쌓이게 된다. syslog의 순서는 syslog.conf 파일의 LOG_INFO를 사용한다.

0: 바이너리 파일로 AUDIT_LOG_DIR 프로퍼티에서 지정한 디렉토리에 저장

1: user 퍼실리티를 /var/log/messages에 저장. 파일명은 시스템 설정시 변경 가능.

2: 사용자 정의에 따라 local0 facility에 저장

3: 사용자 정의에 따라 local1 facility에 저장

4: 사용자 정의에 따라 local2 facility에 저장

5: 사용자 정의에 따라 local3 facility에 저장

6: 사용자 정의에 따라 local4 facility에 저장

7: 사용자 정의에 따라 local5 facility에 저장

8: 사용자 정의에 따라 local6 facility에 저장

9: 사용자 정의에 따라 local7 facility에 저장

AUDIT_TAG_NAME_IN_SYSLOG#

Unsigned Integer

기본값#

1

속성#

변경 가능, 단일 값

값의 범위#

[1, 10]

설명#

사용자가 외부 프로시저를 호출할 때, Altibase가 외부 프로시저용 에이전트 연결을 재시도하는 횟수를 설정한다.

Altibase는 에이전트 프로세스에 외부 에이전트가 있는지 확인한 후 사용할 수 있다. 그러나 사용하려는 외부 에이전트가 EXTPROC_AGENT_CONNECT_TIMEOUT 프로퍼티 값에 의해 타임아웃 되어 종료될 수 있다. 그러면 이 프로퍼티에서 설정한 횟수만큼 외부 에이전트에 연결을 재시도한다.

Altibase 운영 중에 ALTER SYSTEM 구문으로 이 프로퍼티 값을 변경할 수 있다.

EXTPROC_AGENT_IDLE_TIMEOUT#

데이터 타입#

Unsigned Integer

기본값#

300 초

속성#

읽기 전용, 단일 값

값의 범위#

[5, 2³²-1]

설명#

외부 프로시저용 에이전트 프로세스가 idle 상태로 대기하는 최대 시간을 초 단위로 설정한다. 사용자가 외부 프로시저를 호출했을 때 에이전트 프로세스가 idle 상태로 대기 중이라면, 에이전트 프로세스로의 연결 과정 없이 프로시저를 수행할 수 있어 응답 시간이 적게 걸릴 것이다. 그러나, 사용자의 외부 프로시저 호출이 없는데도 에이전트 프로세스가 종료하지 않고 대기하는 것은 자원 낭비가 될 수 있으므로 외부 프로시저의 호출 빈도가 높은 경우에만 대기 시간을 늘릴 것을 권장한다.

EXTPROC_AGENT_SOCKET_FILEPATH#

데이터 타입#

String

기본값#

\$ALTIBASE_HOME/trc

속성#

읽기 전용, 단일 값

값의 범위#

없음

설명#

Altibase 서버가 외부 프로시저 에이전트(external procedure agent)와 통신하기 위해 생성하는 소켓 파일의 경로이다.

외부 프로시저를 사용하면, 세션이 외부 프로시저 에이전트를 생성하면서 socket_sessionID로 소켓 파일을 생성한다. 임의로 이 파일을 삭제하지 않도록 주의해야 한다.

생성된 소켓 파일은 세션이 정상적으로 종료할 때 자동으로 삭제된다.

사용자 계정 보안 관련 프로퍼티#

CASE_SENSITIVE_PASSWORD#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

데이터베이스에서 사용자 암호의 대소문자를 구분할지 여부를 결정한다. 기본값은 대소문자를 구분하지 않는 0이며, 데이터베이스 내에서 사용자 암호가 대문자로 다뤄진다.

0: 대소문자 구분을 하지 않는다.
1: 대소문자 구분을 한다. 단, 사용자 생성 구문에서 암호를 큰따옴표(")로 묶은 경우에만 대소문자가 구분된다. 큰따옴표를 쓰지않은 암호는 대문자로 인식된다.

패스워드를 검증할 사용자 정의 콜백 함수(CALLBACK function)를 지정한다.

기타 프로퍼티#

ACCESS_LIST#

형식#

ACCESS_LIST = operation, address, mask, [limit]

값의 범위#

operation ::= [PERMIT|DENY]
검사 규칙과 일치하는 IP 패킷의 접근을 허용할 것인지 제한할 것인지 기술한다.
address
검사할 패킷의 IP 주소를 기술한다.
mask
명시한 주소값이 IPv4 주소 형식이면, 이것은 서브넷 마스크로, 패킷의 IP 주소 중, 특정 부분만 검사하도록 설정한다.
명시한 주소값이 IPv6 주소 형식이면, 이것은 등록된 IPv6 주소들과 비교할 prefix비트의 길이를 나타낸다. 즉, 등록된 주소의 마스크 비트 길이에 해당하는 값이 접근하는 패킷의 IP 주소의 마스크 비트 길이에 해당하는 값과 일치한다면 접근이 허용된다.
limit

선택 입력 항목으로 ACCESS_LIST에 명시된 접속 가능한 IP 주소 영역에서 허용되는 최대 접속 세션 개수를 지정한다.

limit 값을 입력하면 모든 접속 요청에 대해 limit 조건 검사를 수행한다. 따라서, 허용된 IP의 접속 요청도 limit 개수를 초과하면 접속을 허용하지 않는다. 값을 입력하지 않으면 limit 조건을 검사하지 않는다.

운영 중 RELOAD ACCESS LIST로 ACCESS_LIST를 추가하면, 기존에 연결된 세션은 영향을 받지 않으며, 변경 이후 새로운 연결 요청에 대해서만 ACCESS_LIST 조건이 적용된다. 예를 들어 ACCESS_LIST에 limit값을 설정 후 RELOAD ACCESS LIST 수행하면, 적용 이후 새로운 연결에 대해서만 limit 값이 적용된다. 이런 경우, V$ACCESS_LIST 조회시 Limit 값보다 CONNECTED 값이 더 클 수도 있다.

검사 규칙#

IF 
BITXOR(BITAND(IP_패킷,mask), BITAND(address,mask)) = 0
THEN  일치
ELSE  불일치

설명#

Altibase에 접근하고자 하는 IP 패킷을 주소에 따라 접근을 제한하거나 허용할 수 있다. IP 패킷의 주소를 검사 규칙에 따라 검사하여, 일치하면 operation에 기술된 대로 허용 또는 제한하며 불일치하면 무시하고 다음 리스트를 검사한다.

IP 패킷의 주소를 여러 개가 지정될 경우 기술된 순서대로 검사한다. 일치하는 조건이 없을 경우, 접근이 허용된다.

만약 ACCESS_LIST_FILE 프로퍼티에 값을 기술하면 ACCESS_LIST 프로퍼티에 정의된 목록 대신 외부 파일의 목록을 사용할 수 있다. 외부 파일은 최대 1024개의 항목까지 사용할 수 있으며, 'ACCESS_LIST='는 생략하고 내용만 작성해야 한다.

예제#

IP 주소가 192.168.1.55인 패킷만 접근을 제한하고 나머지는 허용한다.

ACCESS_LIST = deny, 192.168.1.55, 255.255.255.255

192.168.3.*과 219.211.253.* 주소들은 접근을 허용하고 나머지는 모두 제한한다.

ACCESS_LIST = permit, 192.168.3.0, 255.255.255.0
ACCESS_LIST = permit, 219.211.253.0, 255.255.255.0
ACCESS_LIST = deny ,0.0.0.0, 0.0.0.0

로컬 호스트를 제외한 모든 IPv4, IPv6 주소들의 접근을 제한한다.

ACCESS_LIST = deny, 0.0.0.0, 0.0.0.0
ACCESS_LIST = deny, ::1, 1
ACCESS_LIST = deny, fe80::, 1

외부 파일에 검사할 IP 주소를 기술한다. 192.168.3.*과 fe80으로 시작하는 IPv6 주소를 제외한 모든 IP 주소의 접근을 제한한다.

permit, 192.168.3.0, 255.255.255.0
permit, fe80::, 16
deny, 0.0.0.0, 0.0.0.0
deny, ::1, 1
deny, fe80::, 1

192.168.3.17 주소의 세션 접근 허용 개수를 5개로 제한한다.

ACCESS_LIST = permit, 192.168.3.17, 255.255.255.255, 5

ACCESS_LIST_FILE#

데이터 타입#

String

기본값#

없음

속성#

읽기 전용, 단일 값

값의 범위#

없음

설명#

ACCESS_LIST가 외부 파일 경로를 참조할 때 설정한다. 파일명과 경로를 정확히 설정하지 않은 경우 서버를 구동할 수 없다. 외부 파일 경로는 절대경로를 지정해야 한다. 파일에 ACCESS_LIST를 기술할 때의 형식은 ACCESS_LIST 프로퍼티의 설명을 참조한다.

이 프로퍼티를 사용하지 않을 때에는 ACCESS_LIST 프로퍼티에 기술된 목록을 사용한다.

ADMIN_MODE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

이 프로퍼티는 관리자 모드로 접근하는 것만 허용한다.

0: OFF

1: ON

이 값을 1로 설정하면 관리자 모드로 활성화되어 SYS 또는 SYSTEM_ 사용자가 SYSDBA 옵션으로 서버와 연결을 맺어 작업을 할 수 있고 그 외 일반 사용자들은 연결 자체가 실패한다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

ARITHMETIC_OPERATION_MODE#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

Altibase 서버의 산술 연산 모드를 설정하는 프로퍼티이다.

0: 서버가 정밀도 우선 산술 연산 모드로 동작한다. 이 모드에서는 서버가 FLOAT 또는 NUMERIC 타입을 주로 사용하여 산술 연산의 오차를 줄인다. 단, "성능 우선 산술 연산 모드"에 비해 처리 속도가 떨어질 수 있다.

1: 서버가 성능 우선 산술 연산 모드로 동작한다. 이 모드에서는 서버가 산술 연산 시 DOUBLE 타입을 주로 사용하여 성능을 높이지만, 상대적으로 오차가 발생할 수 있다.

CHECK_MUTEX_DURATION_TIME_ENABLE#

데이터 타입#

Unsigned Integer

기본 값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

MUTEX_DURATION_TIME을 확인할 것인지 여부를 설정한다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

0: check disable

1: check enable

COERCE_HOST_VAR_IN_SELECT_LIST_TO_VARCHAR#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

읽기 전용, 단일 값

값의 범위#

[0, 32000]

설명#

이 프로퍼티는 select target list 절에 CAST 연산자 없이 호스트 변수를 사용할 수 있도록 해 준다.

이 프로퍼티를 1 이상의 값으로 설정하면, CAST 연산자 없이 사용된 호스트 변수에 대해서 Altibase 서버가 임의로 VARCHAR 타입으로 처리한다. 또한 설정된 값이 VARCHAR 타입의 크기(precision)가 된다.

이 프로퍼티의 값을 0으로 설정하면, CAST 연산자 없이 호스트 변수를 사용할 경우 에러가 발생한다.

DEFAULT_DATE_FORMAT#

데이터 타입#

String

기본값#

DD-MON-RRRR

속성#

읽기 전용, 단일 값

값의 범위#

없음

설명#

테이블의 칼럼 도메인 중 DATE 타입 데이터의 기본 형식을 지정한다. 이 타입은 날짜, 시간을 저장할 수 있는 형식으로 제공되어야 한다. 형식은 “DD MON RRRR” 과 같이 따옴표 내에 공백도 사용할 수 있다.

DEFAULT_DATE_FORMAT = YYYY/MM/DD
iSQL> select sysdate from dual;
SYSDATE
--------------
2008/06/16
1 row selected.

EXEC_DDL_DISABLE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

일반적으로 초기 데이터베이스를 구축한 이후에는 DML구문을 훨씬 더 빈번하게 수행하며 DDL 구문의 수행은 기존 데이터베이스 스키마를 변경시키는 작업이므로 상당한 주의를 요한다.

따라서 Altibase 운영 중 DDL구문을 수행하지 못하도록 운영자가 설정할 수 있으며 이 프로퍼티의 값을 1로 설정하면 Altibase 운영 중 DDL구문을 수행할 수 없으며 0인 경우 DDL구문을 수행할 수 있다.

Altibase 운영 중 ALTER SYSTEM 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

GROUP_CONCAT_PRECISION#

데이터 타입#

Unsigned Integer

기본값#

4000

속성#

변경 가능, 단일 값

값의 범위#

[0, 32000]

설명#

이 프로퍼티는 GROUP_CONCAT 함수가 반환하는 VARCHAR 타입의 크기를 지정한다.

Altibase 운영 중에 ALTER SYSTEM 구문으로 이 프로퍼티의 값을 변경할 수 있다.

JOB_SCHEDULER_ENABLE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

작업 스케줄러의 동작을 제어한다. 이 프로퍼티의 값을 1로 설정하여도 JOB_THREAD_COUNT 프로퍼티가 0이면 작업 스케줄러가 동작하지 않는다.

읽기 전용, 단일 값

값의 범위#

[1, 65534]

설명#

아래와 같은 경우에 CHAR 타입의 크기를 명시하지 않으면 Altibase는 PSM_CHAR_DEFAULT_PRECISION 프로퍼티에 설정된 값을 CHAR크기로 결정한다.

저장 프로시저 생성시 데이터 타입이 CHAR인 파라미터의 크기를 명시하지 않을 때
저장 함수 생성시 데이터 타입이 CHAR인 파라미터 또는 반환 값의 크기를 명시하지 않을 때

PSM_IGNORE_NO_DATA_FOUND_ERROR#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

Altibase의 PSM에서 제공하는 시스템-정의 예외 중 NO_DATA_FOUND가 있다. 이 예외는 PSM(저장 프로시저 및 함수, 트리거) 내에 포함된 "SELECT \~ INTO" 구문이 실행될 때 결과 집합이 없으면 발생한다. PSM_IGNORE_NO_DATA_FOUND_ERROR 프로퍼티를 사용하면 저장 함수에 대해서는 NO_DATA_FOUND 예외가 발생하지 않도록 할 수 있다.

0: 결과 집합이 없는 경우에 NO_DATA_FOUND 예외가 발생한다.
1: 결과 집합이 없는 경우에 NO_DATA_FOUND 예외가 발생하지 않는다.

Altibase 운영 중에 ALTER SYSTEM 구문으로 이 프로퍼티의 값을 변경할 수 있다.

PSM_MAX_DDL_REFERENCE_DEPTH#

데이터 타입#

Unsigned Integer

기본값#

128

속성#

변경 가능, 단일 값

값의 범위#

[64, 2³²-1]

설명#

파라미터 또는 반환 값의 타입이 CHAR, NCHAR, NVARCHAR, VARCHAR 이고 이 프로퍼티의 값이 1이면, 데이터 타입의 크기는 아래의 프로퍼티에 설정한 값으로 결정된다. 그러나 이 값이 0으로 설정하면 데이터 타입의 크기는 1이다.

PSM_CHAR_DEFAULT_PRECISION
PSM_NCHAR_UTF8_DEFAULT_PRECISION
PSM_NCHAR_UTF16_DEFAULT_PRECISION
PSM_NVARCHAR_UTF8_DEFAULT_PRECISION
PSM_NVARCHAR_UTF16_DEFAULT_PRECISION
PSM_PARAM_AND_RETURN_WITHOUT_PRECISION_ENABLE
PSM_VARCHAR_DEFAULT_PRECISION

PSM_VARCHAR_DEFAULT_PRECISION#

데이터 타입#

Unsigned Integer

기본값#

32000

속성#

읽기 전용, 단일 값

값의 범위#

[1, 65534]

설명#

아래와 같은 경우에 VARCHAR 타입의 크기를 명시하지 않으면 Altibase는 PSM_VARCHAR_DEFAULT_PRECISION 프로퍼티에 설정된 값을 VARCHAR의 크기로 결정한다.

저장 프로시저 생성시 데이터 타입이 VARCHAR인 파라미터의 크기를 명시하지 않을 때
저장 함수 생성시 데이터 타입이 VARCHAR인 파라미터 또는 반환 값의 크기를 명시하지 않을 때

QUERY_STACK_SIZE (단위: 개수)#

데이터 타입#

Unsigned Integer

기본값#

1024

속성#

변경 가능, 단일 값

값의 범위#

[8, 65536]

설명#

질의 수행 시 연산 및 비교 등의 연산자를 처리하기 위해 시스템 내부적으로 사용하는 스택의 크기를 설정하는 시스템 프로퍼티이다.

복잡한 연산식 또는 저장프로시저와 같이 많은 구문이 사용될 경우 stack overflow 오류가 날 수 있고 이 때 프로퍼티 값을 큰 값으로 변경해야 한다. 응용 프로그램 환경에 따라 적절한 값을 설정해야 하며 필요 이상 큰 값으로 설정할 경우 불필요한 메모리 공간 낭비가 될 수 있으므로 유의해야 한다.

이 프로퍼티는 altibase.properties 파일내에 명시할 수 있으며 ALTER SYSTEM 또는 ALTER SESSION 명령문으로 변경할 수 있다.

ALTER SESSION문으로 변경하는 경우 다음과 같이 값을 변경할 수 있다.

ALTER SESSION SET STACK SIZE = n;

RECURSION_LEVEL_MAXIMUM#

데이터 타입#

Unsigned Integer

기본값#

1000

속성#

변경 가능, 단일 값

값의 범위#

[5, 2³²-1]

설명#

이 프로퍼티에 설정한 횟수(level) 만큼 재귀 질의를 반복하여 수행한다.

Altibase 운영 중 ALTER SESSION 문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.

REGEXP_MODE#

데이터 타입#

Unsigned Integer

기본값#

0

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

정규 표현식 모드를 설정하는 프로퍼티로, 설정값의 의미는 아래와 같다.

0

Altibase 정규 표현식 모드.

POSIX Basic Regular Expression (BRE)과 Extended Regular Expression(ERE)을 일부 지원한다.

1

PCRE2 호환 모드.

펄 호환 정규 표현식 (Perl Compatible Regular Expressions, PCRE2) 라이브러리의 정규 표현식 문법을 지원한다.

이 모드는 Altibase 서버 캐릭터셋이 US7ASCII 또는 UTF-8일 때 사용할 수 있으며 Altibase 정규 표현식 모드와 문법 차이가 있다. 관련 설명은 SQL Reference-A.부록: 정규 표현식 매뉴얼을 참고한다.

REMOTE_SYSDBA_ENABLE#

데이터 타입#

Unsigned Integer

기본값#

1

속성#

변경 가능, 단일 값

값의 범위#

[0, 1]

설명#

설명#

VARRAY 변수 하나 당 사용할 수 있는 메모리의 양을 제한하기 위한 프로퍼티이다.

VARRAY 변수를 확장할 때 메모리 사용량이 증가할 수 있으며, 확장 도중 메모리 사용량을 초과하면 오류가 발생한다.

Altibase 운영 중 ALTER SYSTEM문을 이용하여 이 프로퍼티의 값을 변경할 수 있다.