cubrid 유틸리티

cubrid 유틸리티의 사용법(구문)은 다음과 같다.

cubrid utility_name
utility_name :
    createdb [option] <database_name> <locale_name> --- 데이터베이스 생성
    deletedb [option] <database_name>   --- 데이터베이스 삭제
    installdb [option] <database-name>   --- 데이터베이스 설치
    renamedb [option] <source-database-name> <target-database-name>  --- 데이터베이스 이름 변경
    copydb [option] <source-database-name> <target-database-name>  --- 데이터베이스 복사
    backupdb [option] <database-name>  --- 데이터베이스 백업
    restoredb [option] <database-name>  --- 데이터베이스 복구
    addvoldb [option] <database-name>  --- 데이터베이스 볼륨 파일 추가
    spacedb [option] <database-name>  --- 데이터베이스 공간 정보 출력
    lockdb [option] <database-name>  --- 데이터베이스의 lock 정보 출력
    tranlist [option] <database-name>  --- 트랜잭션 확인
    killtran [option] <database-name>  --- 트랜잭션 제거
    optimizedb [option] <database-name>  --- 데이터베이스 통계 정보 갱신
    statdump [option] <database-name>  --- 데이터베이스 서버 실행 통계 정보 출력
    compactdb [option] <database-name>  --- 사용되지 않는 영역을 해제, 공간 최적화
    diagdb [option] <database-name>  --- 내부 정보 출력
    checkdb [option] <database-name>  --- 데이터베이스 일관성 검사
    alterdbhost [option] <database-name>  --- 데이터베이스 호스트 변경
    plandump [option] <database-name>  --- 쿼리 플랜 캐시 정보 출력
    loaddb [option] <database-name>  --- 데이터  스키마 가져오기(로드)
    unloaddb [option] <database-name>  --- 데이터  스키마 내보내기(언로드)
    paramdump [option] <database-name>  --- 데이터베이스의 설정된 파라미터  확인
    changemode [option] <database-name>  --- 서버의 HA 모드 출력 또는 변경
    applyinfo [option] <database-name>   --- HA 환경에서 트랜잭션 로그 반영 정보를 확인하는 도구
    synccolldb [option] <database-name>  --- DB 콜레이션을 시스템 콜레이션에 맞게 변경하는 도구
    genlocale [option] <database-name>  --- 사용하고자 하는 로캘 정보를 컴파일하는 도구
    dumplocale [option] <database-name>   --- 컴파일된 바이너리 로캘 정보를 사람이 읽을  있는 텍스트로 출력하는 도구
    gen_tz [option] [<database-name>]  --- 공유 라이브러리로 컴파일할  있는 타임존 데이터가 포함된 C 소스 파일 생성
    dump_tz [option]  --- 타임존 관련 정보 출력
    tde <operation> [option] <database_name> --- TDE 암호화 관리 도구
    flashback [option] <database-name> <owner_name.class_name> --- 커밋된 특정 트랜잭션을 되돌릴  있도록 SQL 구문을 제공하는 도구

cubrid 유틸리티 로깅

CUBRID는 cubrid 유틸리티의 수행 결과에 대한 로깅 기능을 제공하며, 자세한 내용은 cubrid 유틸리티 로깅 을 참고한다.

createdb

cubrid createdb 유틸리티는 CUBRID 시스템에서 사용할 데이터베이스를 생성하고 미리 만들어진 CUBRID 시스템 테이블을 초기화한다. 데이터베이스에 권한이 주어진 초기 사용자를 정의할 수도 있다. 일반적으로 데이터베이스 관리자만이 cubrid createdb 유틸리티를 사용한다. 로그와 데이터베이스의 위치도 지정할 수 있다.

Warning

데이터베이스를 생성할 때 데이터베이스 이름 뒤에 로캘 이름과 문자셋(예: ko_KR.utf8)을 반드시 지정해야 한다. 문자셋에 따라 문자열 타입의 크기, 문자열 비교 연산 등에 영향을 끼친다. 데이터베이스 생성 시 지정된 문자셋은 변경할 수 없으므로 지정에 주의해야 한다.

문자셋, 로캘 및 콜레이션 설정과 관련된 자세한 내용은 다국어 개요 을 참고한다.

cubrid createdb [options] database_name locale_name.charset
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • createdb: 새로운 데이터베이스를 생성하기 위한 명령이다.

  • database_name: 데이터베이스가 생성될 디렉터리 경로명을 포함하지 않고, 생성하고자 하는 데이터베이스의 이름을 고유하게 부여한다. 이 때, 지정한 데이터베이스 이름이 이미 존재하는 데이터베이스 이름과 중복되는 경우, CUBRID는 기존 파일을 보호하기 위하여 데이터베이스 생성을 더 이상 진행하지 않는다.

  • locale_name: 데이터베이스에서 사용할 로캘 이름을 입력한다. CUBRID에서 사용 가능한 로캘 이름은 1단계: 로캘 선택 을 참고한다.

  • charset: 데이터베이스에서 사용할 문자셋을 입력한다. CUBRID에서 사용 가능한 문자셋은 iso88591, euckr, utf8이다.

    • locale_name 이 en_US이고 charset 을 생략하면 문자셋은 iso88591이 된다.

    • locale_name 이 ko_KR이고 charset 을 생략하면 문자셋은 utf8이 된다.

    • 나머지 locale_namecharset 을 생략할 수 없으며, utf8만 지정 가능하다.

데이터베이스 이름의 최대 길이는 영문 17자이다.

다음은 cubrid createdb 에 대한 [options]이다.

--db-volume-size=SIZE

생성될 데이터베이스 볼륨의 크기를 지정한다. 기본값은 시스템 파라미터 db_volume_size 에 지정된 값이다. 단위는 K, M, G 및 T로 설정할 수 있으며, 각각 킬로바이트(KB), 메가바이트(MB), 기가바이트(GB) 및 테라바이트(TB)를 나타낸다. 단위를 생략하면 바이트 단위가 적용된다. 데이터베이스의 크기는 항상 64개 디스크 섹터의 배수로 올림된다. 이 값은 페이지의 크기에 따라 달라질 수 있으며, 페이지 크기가 각각 4k, 8k 및 16k인 경우 16M, 32M 또는 64M이 될 수 있다.

다음은 첫 번째로 생성되는 testdb의 볼륨 크기를 512MB로 지정하는 구문이다.

cubrid createdb --db-volume-size=512M testdb en_US
--db-page-size=SIZE

데이터베이스 페이지 크기를 지정하는 옵션으로서, 최소값은 4K, 최대값은 16K(기본값)이다. K는 KB(kilobytes)를 의미한다. 데이터베이스 페이지 크기는 4K, 8K, 16K 중 하나의 값이 된다. 4K와 16K 사이의 값을 지정할 경우 지정한 값의 올림값으로 설정되며, 4K보다 작으면 4K로 설정되고 16K보다 크면 16K로 설정된다.

다음은 testdb를 생성하고, testdb의 데이터베이스 페이지 크기를 16K로 지정하는 구문이다.

cubrid createdb --db-page-size=16K testdb en_US
--log-volume-size=SIZE

데이터베이스 로그 볼륨의 크기를 지정한다. 기본값은 데이터베이스 볼륨 크기와 같으며, 최소값은 20M이다. 단위는 K, M, G 및 T로 설정할 수 있으며, 각각 킬로바이트(KB), 메가바이트(MB), 기가바이트(GB) 및 테라바이트(TB)를 나타낸다. 단위를 생략하면 바이트 단위가 적용된다.

다음은 testdb 를 생성하고, testdb 의 로그 볼륨 크기를 256M로 지정하는 구문이다.

cubrid createdb --log-volume-size=256M testdb en_US
--log-page-size=SIZE

생성되는 데이터베이스의 로그 볼륨 페이지 크기를 지정하는 옵션으로, 기본값은 데이터 페이지 크기와 같다. 최소값은 4K, 최대값은 16K이다. K는 KB(kilobytes)를 의미한다. 데이터베이스 페이지 크기는 4K, 8K, 16K 중 하나의 값이 된다. 4K와 16K 사이의 값을 지정할 경우 지정한 값의 올림값으로 설정되며, 4K보다 작으면 4K로 설정되고 16K보다 크면 16K로 설정된다.

다음은 testdb 를 생성하고, testdb 의 로그 볼륨 페이지 크기를 8kbyte로 지정하는 구문이다.

cubrid createdb -log-page-size=8K testdb en_US
--comment=COMMENT

데이터베이스의 볼륨 헤더에 지정된 주석을 포함하는 옵션으로, 문자열에 공백이 포함되면 큰 따옴표로 감싸주어야 한다.

다음은 testdb 를 생성하고, 데이터베이스 볼륨에 이에 대한 주석을 추가하는 구문이다.

cubrid createdb --comment "a new database for study" testdb en_US
-F, --file-path=PATH

새로운 데이터베이스가 생성되는 디렉터리의 절대 경로를 지정하는 옵션으로, -F 옵션을 지정하지 않으면 현재 작업 디렉터리에 새로운 데이터베이스가 생성된다.

다음은 testdb 라는 이름의 데이터베이스를 /dbtemp/new_db라는 디렉터리에 생성하는 구문이다.

cubrid createdb -F "/dbtemp/new_db/" testdb en_US
-L, --log-path=PATH

데이터베이스의 로그 파일이 생성되는 디렉터리의 절대 경로를 지정하는 옵션으로, -L 옵션을 지정하지 않으면 -F 옵션에서 지정한 디렉터리에 생성된다. -F 옵션과 -L 옵션을 둘 다 지정하지 않으면 데이터베이스와 로그 파일이 현재 작업 디렉터리에 생성된다.

다음은 testdb 라는 이름의 데이터베이스를 /dbtemp/newdb라는 디렉터리에 생성하고, 로그 파일을 /dbtemp/db_log 디렉터리에 생성하는 구문이다.

cubrid createdb -F "/dbtemp/new_db/" -L "/dbtemp/db_log/" testdb en_US
-B, --lob-base-path=PATH

BLOB/CLOB 데이터를 사용하는 경우 LOB 데이터 파일이 저장되는 디렉터리의 경로를 지정하는 옵션으로, 이 옵션을 지정하지 않으면 <데이터베이스 볼륨이 생성되는 디렉터리> /lob 디렉터리에 LOB 데이터 파일이 저장된다.

다음은 testdb 를 현재 작업 디렉터리에 생성하고, LOB 데이터 파일이 저장될 디렉터리를 로컬 파일 시스템의 “/home/data1”으로 지정하는 구문이다.

cubrid createdb --lob-base-path "file:/home1/data1" testdb en_US
--server-name=HOST

CUBRID의 클라이언트/서버 버전을 사용할 때 특정 데이터베이스에 대한 서버가 지정한 호스트 상에 구동되도록 하는 옵션이다. 이 옵션으로 지정된 서버 호스트의 정보는 데이터베이스 위치 정보 파일( databases.txt )에 기록된다. 이 옵션이 지정되지 않으면 기본값은 현재 로컬 호스트이다.

다음은 testdbaa_host 호스트 상에 생성 및 등록하는 구문이다.

cubrid createdb --server-name aa_host testdb en_US
-r, --replace

-r 은 지정된 데이터베이스 이름이 이미 존재하는 데이터베이스 이름과 중복되더라도 새로운 데이터베이스를 생성하고, 기존의 데이터베이스를 덮어쓰도록 하는 옵션이다.

다음은 testdb 라는 이름의 데이터베이스가 이미 존재하더라도 기존의 testdb 를 덮어쓰고 새로운 testdb 를 생성하는 구문이다.

cubrid createdb -r testdb en_US
--more-volume-file=FILE

데이터베이스가 생성되는 디렉터리에 추가 볼륨을 생성하는 옵션으로 지정된 파일에 저장된 명세에 따라 추가 볼륨을 생성한다. 이 옵션을 이용하지 않더라도, cubrid addvoldb 유틸리티를 이용하여 볼륨을 추가할 수 있다.

다음은 testdb 를 생성함과 동시에 vol_info.txt에 저장된 명세를 기반으로 볼륨을 추가 생성하는 구문이다.

cubrid createdb --more-volume-file vol_info.txt testdb en_US

다음은 위 구문으로 vol_info.txt에 저장된 추가 볼륨에 관한 명세이다. 각 볼륨에 관한 명세는 라인 단위로 작성되어야 한다.

#xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# NAME volname COMMENTS volcmnts PURPOSE volpurp NPAGES volnpgs
NAME data_v1 COMMENTS "data information volume" PURPOSE data NPAGES 1000
NAME data_v2 COMMENTS "data information volume" NPAGES 1000
NAME temp_v1 COMMENTS "temporary information volume" PURPOSE temp NPAGES 500
#xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

예제 파일에서와 같이 각 볼륨에 관한 명세는 다음과 같이 구성된다.

[NAME volname] [COMMENTS volcmnts] [PURPOSE volpurp] NPAGES volnpgs
  • volname: 추가 생성될 볼륨의 이름으로 Unix 파일 이름 규약을 따라야 하고, 디렉터리 경로를 포함하지 않는 단순한 이름이어야 한다. 볼륨명에 관한 명세는 생략할 수 있으며, 이 경우 시스템에 의해 “생성될 데이터베이스 이름_볼륨 식별자”로 볼륨명이 생성된다.

  • volcmnts: 볼륨 헤더에 기록되는 주석 문장으로, 추가 생성되는 볼륨에 관한 정보를 임의로 부여할 수 있다. 볼륨 주석에 관한 명세 역시 생략할 수 있다.

  • volpurp: :볼륨이 사용되는 용도를 나타낸다. 영구적 데이터(기본 옵션) 볼륨 또는 일시적 데이터 볼륨 중에 하나를 사용할 수 있다.

Note

이전 버전과의 호환성을 위해 data, index, temp 또는 generic 등 기존의 모든 키워드를 사용할 수 있다. temp 는 일시적 데이터 볼륨이고, 나머지는 영구적 데이터 볼륨을 나타낸다.

  • volnpgs: 생성될 추가 볼륨의 페이지 수를 나타낸다. 볼륨의 페이지 수 지정은 생략할 수 없으며, 반드시 지정해야 한다. 실제 볼륨 크기는 64 sectors 의 배수로 올림된다.

--user-definition-file=FILE

생성하고자 하는 데이터베이스에 대해 권한이 있는 사용자를 추가하는 옵션으로, 파라미터로 지정된 사용자 정보 파일에 저장된 명세에 따라 사용자를 추가한다. --user-definition-file 옵션을 이용하지 않더라도 CREATE/ALTER/DROP USER 구문을 이용하여 사용자를 추가할 수 있다.

다음은 testdb 를 생성함과 동시에 user_info.txt에 정의된 사용자 정보를 기반으로 testdb 에 대한 사용자를 추가하는 구문이다.

cubrid createdb --user-definition-file=user_info.txt testdb en_US

사용자 정보 파일의 구문은 아래와 같다.

USER user_name [ <groups_clause> | <members_clause> ]

<groups_clause>:
    [ GROUPS <group_name> [ { <group_name> }... ] ]

<members_clause>:
    [ MEMBERS <member_name> [ { <member_name> }... ] ]
  • user_name: 데이터베이스에 대해 권한을 가지는 사용자 이름이며, 공백이 포함되지 않아야 한다.

  • GROUPS 절: 옵션이며, <group_name>은 지정된 <user_name>을 포함하는 상위 그룹의 이름이다. 이 때, <group_name>은 하나 이상이 지정될 수 있으며, USER 로 미리 정의되어야 한다.

  • MEMBERS 절: 옵션이며, <member_name> 은 지정된 <user_name>에 포함되는 하위 멤버의 이름이다. 이 때, <member_name>은 하나 이상이 지정될 수 있으며, USER 로 미리 정의되어야 한다.

사용자 정보 파일에서는 주석을 사용할 수 있으며, 주석 라인은 연속된 하이픈(--)으로 시작된다. 공백 라인은 무시된다.

다음 예제는 그룹 sedangrandeursonata 가, 그룹 suvtuscan 이, 그룹 hatchbacki30 가 포함되는 것을 정의하는 사용자 정보 파일이다. 사용자 정보 파일명은 user_info.txt로 예시한다.

--
--  사용자 정보 파일의  1
--
USER sedan
USER suv
USER hatchback
USER grandeur GROUPS sedan
USER sonata GROUPS sedan
USER tuscan GROUPS suv
USER i30 GROUPS hatchback

위 예제와 동일한 사용자 관계를 정의하는 파일이다. 다만, 아래 예제에서는 MEMBERS 절을 이용하였다.

--
-- 사용자 정보 파일의  2
--
USER grandeur
USER sonata
USER tuscan
USER i30
USER sedan MEMBERS sonata grandeur
USER suv MEMBERS tuscan
USER hatchback MEMBERS i30
--csql-initialization-file=FILE

생성하고자 하는 데이터베이스에 대해 CSQL 인터프리터에서 구문을 실행하는 옵션으로, 파라미터로 지정된 파일에 저장된 SQL 구문에 따라 스키마를 생성할 수 있다.

다음은 testdb 를 생성함과 동시에 table_schema.sql에 정의된 SQL 구문을 CSQL 인터프리터에서 실행시키는 구문이다.

cubrid createdb --csql-initialization-file table_schema.sql testdb en_US
-o, --output-file=FILE

데이터베이스 생성에 관한 메시지를 파라미터로 지정된 파일에 저장하는 옵션이며, 파일은 데이터베이스와 동일한 디렉터리에 생성된다. -o 옵션이 지정되지 않으면 메시지는 콘솔 화면에 출력된다. -o 옵션은 데이터베이스가 생성되는 중에 출력되는 메시지를 지정된 파일에 저장함으로써 특정 데이터베이스의 생성 과정에 관한 정보를 활용할 수 있게 한다.

다음은 testdb 를 생성하면서 이에 관한 유틸리티의 출력을 콘솔 화면이 아닌 db_output 파일에 저장하는 구문이다.

cubrid createdb -o db_output testdb en_US
-v, --verbose

데이터베이스 생성 연산에 관한 모든 정보를 화면에 출력하는 옵션으로서, -o 옵션과 마찬가지로 특정 데이터베이스 생성 과정에 관한 정보를 확인하는데 유용하다. 따라서, -v 옵션과 -o 옵션을 함께 지정하면, -o 옵션의 파라미터로 지정된 출력 파일에 cubrid createdb 유틸리티의 연산 정보와 생성 과정에 관한 출력 메시지를 저장할 수 있다.

다음은 testdb 를 생성하면서 이에 관한 상세한 연산 정보를 화면에 출력하는 구문이다.

cubrid createdb -v testdb en_US

Note

  • temp_file_max_size_in_pages 는 복잡한 질의문이나 정렬 수행에 사용되는 일시적 볼륨을 디스크에 저장하는 데에 할당되는 최대 페이지 개수를 설정하는 파라미터이다. 기본값은 -1 로, temp_volume_path 파라미터가 지정한 디스크의 여유 공간까지 일시적 볼륨이 커질 수 있다. 0이면 일시적 볼륨이 생성되지 않으므로 cubrid addvoldb 유틸리티를 이용하여 영구적 임시 볼륨을 충분히 추가해야 한다. 볼륨을 효율적으로 관리하기 위해서는 후자의 방법을 사용할 것을 권장한다.

  • cubrid spacedb 유틸리티를 사용하면 각 볼륨의 남은 공간을 확인할 수 있다. cubrid addvoldb 유틸리티를 사용하면 데이터베이스를 관리하면서 필요에 따라 볼륨을 더 추가할 수 있다. 시스템 부하가 적을 때 볼륨을 추가하는 것이 좋다. 사전 할당된 볼륨이 모두 사용 중이면 데이터베이스 시스템에서는 자동으로 새 볼륨을 생성한다.

다음 예제에서는 영구적 임시 볼륨을 포함한 여러 볼륨을 추가하는 데이터베이스 생성 방법을 보여준다.

cubrid createdb --db-volume-size=512M --log-volume-size=256M cubriddb en_US
cubrid addvoldb -S -n cubriddb_DATA01 --db-volume-size=512M cubriddb
cubrid addvoldb -S -p temp -n cubriddb_TEMP01 --db-volume-size=512M cubriddb

Note

기존 키 파일을 사용하는 데이터베이스 생성

데이터베이스가 생성될 때 기본적으로 키 파일이 함께 생성된다. 만약 데이터베이스 생성 시 기존 키 파일을 사용하고 싶다면, 먼저 키 파일을 <database-name>_keys 이름으로 복사해 둔다. 이후 복사한 키 파일의 디렉토리를 tde_keys_file_path 시스템 파라미터에 지정하고 createdb 유틸리티를 통해 데이터베이스를 생성한다. TDE 키 파일에 관한 자세한 내용은 파일 기반의 마스터 키 관리 를 참고한다.

addvoldb

CUBRID 볼륨을 세부적으로 관리하려면 addvoldb 를 사용하면 된다. 각 볼륨 파일명, 경로, 용도 및 크기를 세분해서 관리할 수 있다. 데이터베이스 시스템은 모든 볼륨을 직접 관리할 수 있으나, 옵션을 생략하면 각각의 새 볼륨을 구성할 때는 기본값을 사용한다

데이터베이스 볼륨을 수동으로 추가하기 위한 명령은 다음과 같다.

cubrid addvoldb [options] database_name
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • addvoldb: 지정된 데이터베이스에 지정된 페이지 수만큼 새로운 볼륨을 추가하기 위한 명령이다.

  • database_name: 데이터베이스가 생성될 디렉터리 경로명을 포함하지 않고, 볼륨을 추가하고자 하는 데이터베이스의 이름을 지정한다.

다음은 데이터베이스를 생성하고 볼륨 용도를 구분하여 데이터(data), 인덱스(index), 임시(temp) 볼륨을 추가하는 예이다.

cubrid createdb --db-volume-size=512M --log-volume-size=256M cubriddb en_US
cubrid addvoldb -S -n cubriddb_DATA01 --db-volume-size=512M cubriddb
cubrid addvoldb -S -p temp -n cubriddb_TEMP01 --db-volume-size=512M cubriddb

다음은 cubrid addvoldb 에 대한 [options]이다.

--db-volume-size=SIZE

--db-volume-size 지정한 데이터베이스에 추가될 볼륨 크기를 지정하는 옵션이다. --db-volume-size 옵션을 생략하면 시스템 파라미터 db_volume_size 의 값이 기본값으로 사용된다. 단위는 K, M, G 및 T로 설정할 수 있으며, 각각 킬로바이트(KB), 메가바이트(MB), 기가바이트(GB) 및 테라바이트(TB)를 나타낸다. 단위를 생략하면 바이트 단위가 적용된다. 데이터베이스의 크기는 항상 64개 디스크 섹터의 배수로 올림된다. 이 값은 페이지의 크기에 따라 달라질 수 있으며, 페이지 크기가 각각 4k, 8k 및 16k인 경우 16M, 32M 또는 64M이 될 수 있다

다음은 testdb 에 데이터 볼륨을 추가하며 볼륨 크기를 256MB로 지정하는 구문이다.

cubrid addvoldb --db-volume-size=256M testdb
-n, --volume-name=NAME

지정된 데이터베이스에 대하여 추가될 볼륨의 이름을 지정하는 옵션이다. 볼륨명은 운영체제의 파일 이름 규약을 따라야 하고, 디렉터리 경로나 공백을 포함하지 않는 단순한 이름이어야 한다. -n 옵션을 생략하면 추가되는 볼륨의 이름은 시스템에 의해 “데이터베이스 이름_볼륨 식별자”로 자동 부여된다. 예를 들어, 데이터베이스 이름이 testdb 이면 자동 부여된 볼륨명은 testdb_x001 이 된다.

다음은 testdb라는 데이터베이스에 볼륨을 추가하는 예이며, 추가되는 볼륨명은 testdb_v1 이 된다.

cubrid addvoldb -n testdb_v1  testdb
-F, --file-path=PATH

지정된 데이터베이스에 대하여 추가될 볼륨이 저장되는 디렉터리 경로를 지정하는 옵션이다. -F 옵션을 생략하면, 시스템 파라미터인 volume_extension_path 의 값이 기본값으로 사용된다.

다음은 testdb라는 데이터베이스에 볼륨을 추가하는 구문이며, 추가 볼륨은 /dbtemp/addvol 디렉터리에 생성된다. 볼륨명에 관한 -n 옵션을 지정하지 않았으므로, 볼륨명은 testdb_x001 으로 만들어진다.

cubrid addvoldb -F /dbtemp/addvol/ testdb
--comment=COMMENT

추가된 볼륨에 관한 정보 검색을 쉽게 하기 위하여 볼륨에 관한 정보를 주석으로 처리하는 옵션이다. 이때 주석의 내용은 볼륨을 추가하는 DBA 의 이름이나 볼륨 추가의 목적을 포함하는 것이 바람직하며, 큰따옴표로 감싸야 한다.

다음은 볼륨을 추가하고 추가 정보로 주석을 삽입하는 구문이다.

cubrid addvoldb --comment "Data volume added by cheolsoo kim because permanent data space was almost depleted." testdb
-p, --purpose=PURPOSE

추가될 볼륨의 용도를 지정한다. 지정된 용도는 추가된 볼륨의 파일 타입들을 정의한다.

  • PERMANENT DATA : 테이블 행, 인덱스 및 시스템 파일 저장.

  • TEMPORARY DATA : 질의 처리 및 정렬을 수행할 때 중간 결과와 최종 결과 저장.

이 옵션이 지정되지 않은 경우 해당 볼륨의 용도는 기본적으로 PERMANENT DATA 로 간주한다. 다음은 임시 데이터 용도로 볼륨을 추가하는 구문이다.

cubrid addvoldb -p temp testdb

Note

예전 버전에는 PERMANENT DATA 볼륨이 generic, data 및 index로 구분되었으나, 이번 버전부터는 볼륨 구조에 대한 설계가 변경되어 볼륨의 구분이 없어졌다. 그러나 기존에 사용하던 스크립트의 오류를 방지하기 위해 예전에 사용하였던 keyword(generic, data, index)는 유지하였고, 기존 버전의 temp는 동일한 용도로 유지하였다.

각 용도에 대한 자세한 내용은 데이터베이스 볼륨 구조 를 참고한다.

-S, --SA-mode

서버 프로세스를 구동하지 않고 데이터베이스에 접근하는 독립 모드(standalone)로 작업하기 위해 지정되며, 인수는 없다. -S 옵션을 지정하지 않으면, 시스템은 클라이언트/서버 모드로 인식한다.

cubrid addvoldb -S --db-volume-size=256M testdb
-C, --CS-mode

서버 프로세스와 클라이언트 프로세스를 각각 구동하여 데이터베이스에 접근하는 클라이언트/서버 모드로 작업하기 위한 옵션이며, 인수는 없다. -C 옵션을 지정하지 않더라도 시스템은 기본적으로 클라이언트/서버 모드로 인식한다.

cubrid addvoldb -C --db-volume-size=256M testdb
--max-writesize-in-sec=SIZE

데이터베이스에 볼륨을 추가할 때 디스크 출력량을 제한하여 시스템 운영 영향을 줄이도록 하는 옵션이다. 이 옵션을 통해 1초당 쓸 수 있는 최대 크기를 지정할 수 있으며, 단위는 K(kilobytes), M(megabytes)이다. 최소값은 160K이며, 이보다 작게 값을 설정하면 160K로 바뀐다. 단, 클라이언트/서버 모드(-C)에서만 사용 가능하다.

다음은 2GB 볼륨을 초당 1MB씩 쓰도록 하는 예이다. 소요 시간은 35분( = (2048MB / 1MB) / 60초 ) 정도가 예상된다.

cubrid addvoldb -C --db-volume-size=2G --max-writesize-in-sec=1M testdb

deletedb

cubrid deletedb 는 데이터베이스를 삭제하는 유틸리티이다. 데이터베이스가 몇 개의 상호 의존적 파일들로 만들어지기 때문에, 데이터베이스를 제거하기 위해 운영체제 파일 삭제 명령이 아닌 cubrid deletedb 유틸리티를 사용해야 한다.

cubrid deletedb 유틸리티는 데이터베이스 위치 파일( databases.txt )에 지정된 데이터베이스에 대한 정보도 같이 삭제한다. cubrid deletedb 유틸리티는 오프라인 상에서 즉, 아무도 데이터베이스를 사용하지 않는 상태에서 독립 모드로 사용해야 한다.

cubrid deletedb [options] database_name
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • deletedb: 데이터베이스 및 관련 데이터, 로그, 백업 파일을 전부 삭제하기 위한 명령으로, 데이터베이스 서버가 구동 정지 상태인 경우에만 정상적으로 수행된다.

  • database_name: 디렉터리 경로명을 포함하지 않고, 삭제하고자 하는 데이터베이스의 이름을 지정한다

다음은 cubrid deletedb 에 대한 [options]이다.

-o, --output-file=FILE

데이터베이스를 삭제하면서 출력되는 메시지를 인자로 지정한 파일에 기록하는 명령이다. cubrid deletedb 유틸리티를 사용하면 데이터베이스 위치 정보 파일( databases.txt )에 기록된 데이터베이스 정보가 함께 삭제된다.

cubrid deletedb -o deleted_db.out testdb

만약, 존재하지 않는 데이터베이스를 삭제하는 명령을 입력하면 다음과 같은 메시지가 출력된다.

cubrid deletedb testdb
Database "testdb" is unknown, or the file "databases.txt" cannot be accessed.
-d, --delete-backup

데이터베이스를 삭제하면서 백업 볼륨 및 백업 정보 파일도 함께 삭제할 수 있다. -d 옵션을 지정하지 않으면 백업 볼륨 및 백업 정보 파일은 삭제되지 않는다.

cubrid deletedb -d testdb

renamedb

cubrid renamedb 유틸리티는 존재하는 데이터베이스의 현재 이름을 변경한다. 정보 볼륨, 로그 볼륨, 제어 파일들이 새로운 이름과 일치되게 이름을 변경한다.

이에 비해 cubrid alterdbhost 유틸리티는 지정된 데이터베이스의 호스트 이름을 설정하거나 변경한다. 즉, databases.txt 에 있는 호스트 이름을 변경한다.

cubrid renamedb [options] src_database_name dest_database_name
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • renamedb: 현재 존재하는 데이터베이스의 이름을 새로운 이름으로 변경하기 위한 명령으로, 데이터베이스가 구동 정지 상태인 경우에만 정상적으로 수행된다. 관련된 정보 볼륨, 로그 볼륨, 제어 파일도 함께 새로 지정된 이름으로 변경된다.

  • src_database_name: 이름을 바꾸고자 하는 현재 존재하는 데이터베이스의 이름이며, 데이터베이스가 생성될 디렉터리 경로명을 포함하지 않는다.

  • dest_database_name: 새로 부여하고자 하는 데이터베이스의 이름이며, 현재 존재하는 데이터베이스 이름과 중복되어서는 안 된다. 이 역시, 데이터베이스가 생성될 디렉터리 경로명을 포함하지 않는다.

다음은 cubrid renamedb 에 대한 [options]이다.

-E, --extented-volume-path=PATH

확장 볼륨의 이름을 변경한 후 새 디렉터리 경로로 이동하는 명령으로서, -E 옵션을 이용하여 변경된 이름을 가지는 확장 볼륨을 이동시킬 새로운 디렉터리 경로(예: /dbtemp/newaddvols/)를 지정한다.

-E 옵션을 주지 않으면, 확장 볼륨은 기존 위치에서 이름만 변경된다. 이때, 기존 데이터베이스 볼륨의 디스크 파티션 외부에 있는 디렉터리 경로 또는 유효하지 않은 디렉터리 경로가 지정되는 경우 데이터베이스 이름 변경 작업은 수행되지 않으며, -i 옵션과 병행될 수 없다.

cubrid renamedb -E /dbtemp/newaddvols/ testdb testdb_1
-i, --control-file FILE

각 볼륨 또는 파일에 대하여 일괄적으로 데이터베이스 이름을 변경하면서 디렉터리 경로를 상이하게 지정하기 위해 디렉터리 정보가 저장된 입력 파일을 지정하는 명령으로서, -i 옵션을 이용한다. 이때, -i 옵션은 -E 옵션과 병행될 수 없다.

cubrid renamedb -i rename_path testdb testdb_1

다음은 개별적 볼륨들의 이름과 현재 디렉터리 경로, 그리고 변경된 이름의 볼륨들이 저장될 디렉터리 경로를 포함하는 파일의 구문 및 예시이다.

volid   source_fullvolname   dest_fullvolname
  • volid: 각 볼륨을 식별하기 위한 정수이며, 데이터베이스 볼륨 정보 제어 파일(database_name_vinf)를 통해 확인할 수 있다.

  • source_fullvolname: 각 볼륨에 대한 현재 디렉터리 경로이다.

  • dest_fullvolname: 이름이 변경된 새로운 볼륨이 이동될 목적지 디렉터리 경로이다. 만약, 목적지 디렉터리가 유효하지 않은 경우 데이터베이스 이름 변경 작업은 수행되지 않는다.

-5  /home1/user/testdb_vinf    /home1/CUBRID/databases/testdb_1_vinf
-4  /home1/user/testdb_lginf   /home1/CUBRID/databases/testdb_1_lginf
-3  /home1/user/testdb_bkvinf   /home1/CUBRID/databases/testdb_1_bkvinf
-2  /home1/user/testdb_lgat   /home1/CUBRID/databases/testdb_1_lgat
 0  /home1/user/testdb   /home1/CUBRID/databases/testdb_1
 1  /home1/user/backup/testdb_x001   /home1/CUBRID/databases/backup/testdb_1_x001
-d, --delete-backup

데이터베이스의 이름을 변경하면서 데이터베이스와 와 동일 위치에 있는 모든 백업 볼륨 및 백업 정보 파일을 함께 강제 삭제하는 명령이다. 일단, 데이터베이스 이름이 변경되면 이보다 앞선 이름의 백업 파일은 이용할 수 없으므로 주의해야 한다. 만약, -d 옵션을 지정하지 않으면 백업 볼륨 및 백업 정보 파일은 삭제되지 않는다.

cubrid renamedb -d testdb testdb_1

alterdbhost

cubrid alterdbhost 유틸리티는 지정된 데이터베이스의 호스트 이름을 설정하거나 변경한다. 즉, databases.txt 에 있는 호스트 이름을 변경한다.

cubrid alterdbhost [<option>] database_name

  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • alterdbhost: 현 데이터베이스의 호스트 이름을 새로운 이름으로 변경하기 위한 명령이다.

cubrid alterdbhost 에서 사용하는 옵션은 다음과 같다.

-h, --host=HOST

뒤에 변경할 호스트 이름을 지정하며, 옵션을 생략하면 호스트 이름으로 localhost를 지정한다.

copydb

cubrid copydb 유틸리티는 데이터베이스를 한 위치에서 다른 곳으로 복사 또는 이동하며, 인자로 원본 데이터베이스 이름과 새로운 데이터베이스 이름이 지정되어야 한다. 이때, 새로운 데이터베이스 이름은 원본 데이터베이스 이름과 다른 이름으로 지정되어야 하고, 새로운 데이터베이스에 대한 위치 정보는 databases.txt 에 등록된다.

cubrid copydb 유틸리티는 원본 데이터베이스가 정지 상태일 때(오프라인)에만 실행할 수 있다.

cubrid copydb [<options>] src-database-name dest-database-name
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • copydb: 원본 데이터베이스를 새로운 위치로 이동 또는 복사하는 명령이다.

  • src-database-name: 복사 또는 이동하고자 하는 원본 데이터베이스 이름이다.

  • dest-database-name: 새로운 데이터베이스 이름이다.

[options]를 생략하면 원본 데이터베이스를 현재 작업 디렉터리에 복사한다.

cubrid copydb 에 대한 [options]는 다음과 같다.

--server-name=HOST

새로운 데이터베이스의 서버 호스트 이름을 명시하며, 이는 databases.txtdb-host 항목에 등록된다. 이 옵션을 생략하면, 로컬 호스트가 등록된다.

cubrid copydb --server-name=cub_server1 demodb new_demodb
-F, --file-path=PATH

새로운 데이터베이스 볼륨이 저장되는 특정 디렉터리 경로를 지정할 수 있다. 절대 경로로 지정해야 하며, 존재하지 않는 디렉터리를 지정하면 에러를 출력한다. 이 옵션을 생략하면 현재 작업 디렉터리에 새로운 데이터베이스의 볼륨이 생성된다. 이 경로는 databases.txtvol-path 항목에 등록된다.

cubrid copydb -F /home/usr/CUBRID/databases demodb new_demodb
-L, --log-path=PATH

새로운 데이터베이스 로그 볼륨이 저장되는 특정 디렉터리 경로를 지정할 수 있다. 절대 경로로 지정해야 하며, 존재하지 않는 디렉터리를 지정하면 에러를 출력한다. 이 옵션을 생략하면 새로운 데이터베이스 볼륨이 저장되는 경로에 로그 볼륨도 함께 생성된다. 이 경로는 databases.txtlog-path 항목에 등록된다.

cubrid copydb -L /home/usr/CUBRID/databases/logs demodb new_demodb
-E, --extended-volume-path=PATH

새로운 데이터베이스의 확장 정보 볼륨이 저장되는 특정 디렉터리 경로를 지정할 수 있다. 이 옵션을 생략하면 새로운 데이터베이스 볼륨이 저장되는 경로 또는 제어 파일에 등록된 경로에 확장 정보 볼륨이 저장된다. -i 옵션과 병행될 수 없다.

cubrid copydb -E home/usr/CUBRID/databases/extvols demodb new_demodb
-i, --control-file=FILE

대상 데이터베이스에 대한 복수 개의 볼륨들을 각각 다른 디렉터리에 복사 또는 이동하기 위해서, 원본 볼륨의 경로 및 새로운 디렉터리 경로 정보를 포함하는 입력 파일을 지정할 수 있다. 이때, -i 옵션은 -E 옵션과 병행될 수 없다. 아래 예제에서는 copy_path라는 입력 파일을 예로 사용했다.

cubrid copydb -i copy_path demodb new_demodb

다음은 각 볼륨들의 이름과 현재 디렉터리 경로, 그리고 새로 복사할 디렉터리 및 새로운 볼륨 이름을 포함하는 입력 파일의 예시이다.

# volid   source_fullvolname   dest_fullvolname
0 /usr/databases/demodb        /drive1/usr/databases/new_demodb
1 /usr/databases/demodb_data1  /drive1/usr/databases/new_demodb_data1
2 /usr/databases/ext/demodb_ext1 /drive2//usr/databases/new_demodb_ext1
3 /usr/databases/ext/demodb_ext2  /drive2/usr/databases/new_demodb_ext2
  • volid : 각 볼륨을 식별하기 위한 정수이며, 데이터베이스 볼륨 정보 제어 파일( database_name_vinf )를 통해 확인할 수 있다.

  • source_fullvolname : 원본 데이터베이스의 각 볼륨이 존재하는 현재 디렉터리 경로이다.

  • dest_fullvolname : 새로운 데이터베이스의 각 볼륨이 저장될 디렉터리 경로이며, 유효한 디렉터리를 지정해야 한다.

-r, --replace

새로운 데이터베이스 이름이 기존 데이터베이스 이름과 중복되더라도 에러를 출력하지 않고 덮어쓴다.

cubrid copydb -r -F /home/usr/CUBRID/databases demodb new_demodb
-d, --delete-source

새로운 데이터베이스로 복사한 후, 원본 데이터베이스를 제거한다. 이 옵션이 주어지면 데이터베이스 복사 후 cubrid deletedb 를 수행하는 것과 동일하다. 단, 원본 데이터베이스에 LOB 데이터를 포함하는 경우, 원본 데이터베이스 대한 LOB 파일 디렉터리 경로가 새로운 데이터베이스로 복사되어 databases.txtlob-base-path 항목에 등록된다.

cubrid copydb -d -F /home/usr/CUBRID/databases demodb new_demodb
--copy-lob-path=PATH

원본 데이터베이스에 대한 LOB 파일 디렉터리 경로를 새로운 데이터베이스의 LOB 파일 경로로 복사하고, 원본 데이터베이스를 복사한다. 이 옵션을 생략하면, LOB 파일 디렉터리 경로를 복사하지 않으므로, databases.txt 파일의 lob-base-path 항목을 별도로 수정해야 한다. 이 옵션은 -B 옵션과 병행할 수 없다.

cubrid copydb --copy-lob-path=/home/usr/CUBRID/databases/new_demodb/lob demodb new_demodb
-B, --lob-base-path=PATH

-B 옵션을 사용하여 특정 디렉터리를 새로운 데이터베이스에 대한 LOB 파일 디렉터리 경로를 지정한다. 원본 데이터베이스에 있던 LOB 파일들은 사용자가 직접 이 디렉터리에 복사해야 한다. 이 옵션은 --copy-lob-path 옵션과 병행할 수 없다.

cubrid copydb -B /home/usr/CUBRID/databases/new_lob demodb new_demodb

installdb

cubrid installdb 유틸리티는 데이터베이스 위치 정보를 저장하는 databases.txt 에 새로 설치된 데이터베이스 정보를 등록한다. 이 유틸리티의 실행은 등록 대상 데이터베이스의 동작에 영향을 끼치지 않는다.

cubrid installdb [<options>] database_name
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • installdb: 이동 또는 복사된 데이터베이스의 정보를 databases.txt 에 등록하는 명령이다.

  • database_name: databases.txt 에 등록하고자 하는 데이터베이스의 이름이다.

[options]를 생략하는 경우, 해당 데이터베이스가 존재하는 디렉터리에서 명령을 수행해야 한다.

cubrid installdb 에 대한 [options]는 다음과 같다.

--server-name=HOST

대상 데이터베이스의 서버 호스트 정보를 지정된 호스트 명으로 databases.txt 에 등록한다. 이 옵션을 생략하면, 현재의 호스트 정보가 등록된다.

cubrid installdb --server-name=cub_server1 testdb
-L, --log-path=PATH

대상 데이터베이스 로그 볼륨 디렉터리의 절대 경로를 databases.txt 에 등록한다. 이 옵션을 생략하면 데이터베이스 볼륨의 디렉터리 경로가 등록된다.

cubrid installdb -L /home/cubrid/CUBRID/databases/logs/testdb testdb

backupdb

데이터베이스 백업은 CUBRID 데이터베이스 볼륨, 제어 파일, 로그 파일을 저장하는 작업으로 cubrid backupdb 유틸리티 또는 CUBRID 매니저를 이용하여 수행된다. DBA 는 저장 매체의 오류 또는 파일 오류 등의 장애에 대비하여 데이터베이스를 정상적으로 복구할 수 있도록 주기적으로 데이터베이스를 백업해야 한다. 이 때 복구 환경은 백업 환경과 동일한 운영체제 및 동일한 버전의 CUBRID가 설치된 환경이어야 한다. 이러한 이유로 데이터베이스를 새로운 버전으로 마이그레이션한 후에는 즉시 새로운 버전의 환경에서 백업을 수행해야 한다.

cubrid backupdb 유틸리티는 모든 데이터베이스 페이지들, 제어 파일들, 데이터베이스를 백업 시와 일치된 상태로 복구하기 위해 필요한 로그 레코드들을 복사한다.

cubrid backupdb [options] database_name[@hostname]
  • @hostname: 독립(Standalone) 모드 DB를 백업하는 경우 생략되며, HA 환경에서 백업하는 경우 데이터베이스 이름 뒤에 “@hostname”을 지정한다. hostname은 $CUBRID_DATABASES/databases.txt에 지정된 이름이다. 로컬 서버를 설정하려면 “@localhost”를 지정하면 된다.

다음은 cubrid backupdb 유틸리티와 결합할 수 있는 옵션이다. 대소문자가 구분됨을 주의한다.

-D, --destination-path=PATH

지정된 디렉터리에 백업 파일이 저장되도록 하며, 현재 존재하는 디렉터리가 지정되어야 한다. 그렇지 않으면 지정한 이름의 백업 파일이 생성된다. -D 옵션이 지정되지 않으면 백업 파일은 해당 데이터베이스의 위치 정보를 저장하는 파일인 databases.txt 에 명시된 로그 디렉터리에 생성된다.

cubrid backupdb -D /home/cubrid/backup demodb

-D 옵션을 이용하여 현재 디렉터리에 백업 파일이 저장되도록 한다. -D 옵션의 인수로 “.”을 입력하면 현재 디렉터리가 지정된다.

cubrid backupdb -D . demodb
-r, --remove-archive

활성 로그(active log)가 꽉 차면 활성 로그를 새로운 보관 로그 파일에 기록한다. 이때 백업을 수행하여 백업 볼륨이 생성되면, 백업 시점보다 앞의 보관 로그는 추후 복구 작업에 불필요하다. -r 옵션은 백업을 수행한 후에, 추후 복구 작업에 더 이상 사용되지 않을 보관 로그 파일을 제거하는 옵션이다. -r 옵션은 백업 시점 이전의 불필요한 보관 로그만 제거하므로 복구 작업에는 영향을 끼치지 않지만, 관리자가 백업 시점 이후의 보관 로그까지 제거하는 경우 전체 복구가 불가능할 수도 있다. 따라서 보관 로그를 제거할 때에는 추후 복구 작업에 필요한 것인지 반드시 검토해야 한다.

-r 옵션을 사용하여 증분 백업(백업 수준 1 또는 2)을 수행하는 경우, 추후 데이터베이스의 정상 복구가 불가능할 수도 있으므로 -r 옵션은 전체 백업 수행 시에만 사용하는 것을 권장한다.

cubrid backupdb -r demodb
-l, --level=LEVEL

지정된 백업 수준으로 증분 백업을 수행한다. -l 옵션이 지정되지 않으면 전체 백업이 수행된다. 백업 수준에 대한 자세한 내용은 증분 백업 을 참조한다.

cubrid backupdb -l 1 demodb
-o, --output-file=FILE

대상 데이터베이스의 백업에 관한 진행 정보를 info_backup이라는 파일에 기록한다.

cubrid backupdb -o info_backup demodb

다음은 info_backup 파일 내용의 예시로서, 스레드 개수, 압축 방법, 백업 시작 시간, 영구 볼륨의 개수, 백업 진행 정보, 백업 완료 시간 등의 정보를 확인할 수 있다.

[ Database(demodb) Full Backup start ]
- num-threads: 1
- compression method: NONE
- backup start time: Mon Jul 21 16:51:51 2008
- number of permanent volumes: 1
- backup progress status
-----------------------------------------------------------------------------
 volume name                  | # of pages | backup progress status    | done
-----------------------------------------------------------------------------
 demodb_keys                  |          1 | ######################### | done
 demodb_vinf                  |          1 | ######################### | done
 demodb                       |      25000 | ######################### | done
 demodb_lginf                 |          1 | ######################### | done
 demodb_lgat                  |      25000 | ######################### | done
-----------------------------------------------------------------------------
# backup end time: Mon Jul 21 16:51:53 2008
[Database(demodb) Full Backup end]
-S, --SA-mode

독립 모드, 즉 오프라인으로 백업을 수행한다. -S 옵션이 생략되면 클라이언트/서버 모드에서 백업이 수행된다.

cubrid backupdb -S demodb
-C, --CS-mode

클라이언트/서버 모드에서 백업을 수행하며, demodb를 온라인 백업한다. -C 옵션이 생략되면 클라이언트/서버 모드에서 백업이 수행된다.

cubrid backupdb -C demodb
--no-check

대상 데이터베이스의 일관성을 체크하지 않고 백업을 수행한다.

cubrid backupdb --no-check demodb
-t, --thread-count=COUNT

관리자가 임의로 스레드의 개수를 지정함으로써 병렬 백업을 수행한다. -t 옵션의 인수를 지정하지 않더라도 시스템의 CPU 개수만큼 스레드를 자동 부여하여 병렬 백업을 수행한다.

cubrid backupdb -t 4 demodb
--no-compress

기본적으로 큐브리드는 백업 볼륨의 크기를 줄이기 위해서, 대상 데이터베이스를 압축한 뒤 저장한다. 백업 파일 압축 실행 시 발생하는 CPU 사용량을 없애고 싶다면, --no-compress 옵션을 통해 백업 볼륨을 압축하지 않을 수 있다.

cubrid backupdb --no-compress demodb
--sleep-msecs=NUMBER

대상 데이터베이스를 백업하는 도중 쉬는 시간을 설정한다. 단위는 밀리초이며, 기본값은 0 이다. 1MB의 파일을 읽을 때마다 설정한 시간만큼 쉰다. 백업 작업이 과도한 디스크 I/O를 유발하기 때문에, 운영 중인 서비스에 백업 작업으로 인한 영향을 줄이고자 할 때 이 옵션이 사용된다.

cubrid backupdb --sleep-msecs=5 demodb
-k, --separate-keys

백업 볼륨에 키 파일을 포함하지 않는다. 포함되지 않은 키는 <database_name>_bk<backup_level>_keys 라는 이름을 가진 별도의 파일로 분리된다. 옵션을 주지 않을 경우 기본적으로 키 파일은 백업 볼륨에 포함된다. 키 파일 분리에 대한 자세한 설명은 백업 볼륨 암호화 을 참고한다.

cubrid backupdb --seprate-keys demodb

백업 정책 및 방식

백업을 진행할 때 고려해야 할 사항은 다음과 같다.

  • 백업할 대상 데이터 선별

    • 보존 가치가 있는 유효한 데이터인지 판단한다.

    • 데이터베이스 전체를 백업할 것인지, 일부만 백업할 것인지 결정한다.

    • 데이터베이스와 함께 백업해야 할 다른 파일이 있는지 확인한다.

  • 백업 방식 결정

    • 증분 백업, 온라인 백업 방식을 결정한다. 부가적으로 압축 백업, 병렬 백업 모드 사용 여부를 결정한다.

    • 사용 가능한 백업 도구 및 백업 장비를 준비한다.

  • 백업 시기 판단

    • 데이터베이스 사용이 가장 적은 시간을 파악한다.

    • 보관 로그의 양을 파악한다.

    • 백업할 데이터베이스를 이용하는 클라이언트 수를 파악한다.

온라인 백업

온라인 백업(또는 핫 백업)은 운영 중인 데이터베이스에 대해 백업을 수행하는 방식으로, 특정 시점의 데이터베이스 이미지의 스냅샷을 제공한다. 운영 중인 데이터베이스를 대상으로 백업을 수행하기 때문에 커밋되지 않은 데이터가 저장될 우려가 있고, 다른 데이터베이스 운영에도 영향을 줄 수 있다.

온라인 백업을 하려면 cubrid backupdb -C 명령어를 사용한다.

오프라인 백업

오프라인 백업(또는 콜드 백업)은 정지 상태인 데이터베이스에 대해 백업을 수행하는 방식으로 특정 시점의 데이터베이스 이미지의 스냅샷을 제공한다.

오프라인 백업을 하려면 cubrid backupdb -S 명령어를 사용한다.

증분 백업

증분 백업(incremental backup)은 전체 백업에 종속적으로 수행되는 백업으로 먼저 수행된 백업 이후의 변경된 사항만을 선택적으로 백업하는 방식이다. 이는 전체 백업보다 백업 볼륨이 적고, 백업 소요 시간이 짧다는 장점이 있다. CUBRID는 0, 1, 2의 백업 수준을 제공하며, 낮은 백업 수준으로 백업을 수행한 이후에만 순차적으로 다음 수준의 백업을 수행할 수 있다.

증분 백업을 하려면 cubrid backupdb -l LEVEL 명령어를 사용한다.

다음은 증분 백업에 관한 예시로서, 이를 참조하여 백업 수준에 관해 상세하게 살펴보기로 한다.

../_images/image11.png
  • 전체 백업(백업 수준 0): 백업 수준 0은 모든 데이터베이스 페이지를 포함하는 전체 백업이다.

    데이터베이스에 최초 시도되는 백업 수준은 당연히 수준 0이 된다. DBA 는 복구 상황을 대비하여 정기적으로 전체 백업을 수행해야 하며, 예시에서는 12월 31일과 1월 5일에 전체 백업을 수행하였다.

  • 1차 증분 백업(백업 수준 1): 백업 수준 1은 수준 0의 전체 백업 이후의 변경 사항만 저장하는 증분 백업으로서, 이를 “1차 증분 백업”이라 한다.

    주의할 점은 예시의 <1-1>, <1-2>, <1-3>과 같이 1차 증분 백업이 연속적으로 시도되더라도 언제나 수준 0의 전체 백업을 기본으로 증분 백업을 수행한다는 점이다.

    만약, 동일 디렉터리에서 백업 파일이 생성된다고 할 때, 1월 1일에 이미 1차 증분 백업 <1-1>이 수행되고, 1월 2일에 또다시 1차 증분 백업 <1-2>가 시도되면, <1-1>에서 생성된 증분 백업 파일을 덮어쓰게 된다. 1월 3일에 1차 증분 백업이 다시 수행되었으므로, 최종 증분 파일은 이 때 생성된다.

    그러나, 1월 1일이나 1월 2일의 상태로 데이터베이스를 복구해야 하는 상황이 발생될 수 있으므로, DBA 는 최종 증분 파일로 덮어쓰기 전에 <1-1>과 <1-2> 각각의 증분 백업 파일을 저장 매체에 별도로 보관하는 것이 좋다.

  • 2차 증분 백업(백업 수준 2): 백업 수준 2는 1차 증분 백업 이후의 변경 사항만 저장하는 증분 백업으로 이를 “2차 증분 백업”이라 한다.

    1차 증분 백업이 선행되어야만 2차 증분 백업을 수행할 수 있으므로, 1월 4일에 시도한 2차 증분 백업 시도는 성공할 것이고, 1월 6일에 시도한 2차 증분 백업 시도는 당연히 허용되지 않을 것이다.

    이러한 백업 수준 0, 1, 2로 생성된 백업 파일들은 모두 데이터베이스를 복구할 때 필요하므로, 2차 증분 백업이 완료된 1월 4일의 상태로 데이터베이스를 복구하기 위해서는 <2-1>에서 생성된 2차 증분 백업 파일, <1-3>에서 생성된 1차 증분 백업 파일, <0-1>에서 생성된 전체 백업 파일이 모두 필요하다. 즉, 완전한 복구를 위해서는 직전에 생성된 증분 백업 파일보다 앞서서 최종으로 생성된 전체 백업 파일이 요구된다.

압축 백업 모드

압축 백업(compress backup)은 데이터베이스를 압축하여 백업을 수행하기 때문에 백업 볼륨의 크기가 줄어들어 디스크 I/O 비용을 감소시킬 수 있고, 디스크 공간을 절약할 수 있다.

큐브리드 11.2버전부터는 압축 백업 모드가 기본값으로 설정되어 있다.

병렬 백업 모드

병렬 백업 또는 다중 백업(multi-thread backup)은 지정된 스레드 개수만큼 동시 백업을 수행하기 때문에 백업 시간을 크게 단축시켜 준다. 기본적으로 시스템의 CPU 수만큼 스레드를 부여하게 된다.

병렬 백업을 하려면 cubrid backupdb -t | --thread-count 명령어를 사용한다.

백업 파일 관리

백업 대상 데이터베이스의 크기에 따라 하나 이상의 백업 파일이 연속적으로 생성될 수 있으며, 각각의 백업 파일의 확장자에는 생성 순서에 따라 000, 001~0xx와 같은 유닛 번호가 순차적으로 부여된다.

백업 작업 중 디스크 용량 관리

백업 작업 도중, 백업 파일이 저장되는 디스크 용량에 여유가 없는 경우 백업 작업을 진행할 수 없다는 안내 메시지가 화면에 나타난다. 안내 메시지에는 백업 대상이 되는 데이터베이스의 이름과 경로명, 백업 파일명, 백업 파일의 유닛 번호, 백업 수준이 표시된다. 백업 작업을 계속 진행하려는 관리자는 다음과 같이 옵션을 선택할 수 있다.

  • 옵션 0: 백업 작업을 더 이상 진행하지 않을 경우, 0을 입력한다.

  • 옵션 1: 백업 작업을 진행하기 위해 관리자는 현재 장치에 새로운 디스크를 삽입한 후 1을 입력한다.

  • 옵션 2: 백업 작업을 진행하기 위해 관리자는 장치를 변경하거나 백업 파일이 저장되는 디렉터리 경로를 변경한 후 2를 입력한다.

******************************************************************
Backup destination is full, a new destination is required to continue:
Database Name: /local1/testing/demodb
     Volume Name: /dev/rst1
        Unit Num: 1
    Backup Level: 0 (FULL LEVEL)
Enter one of the following options:
Type
   -  0 to quit.
   -  1 to continue after the volume is mounted/loaded. (retry)
   -  2 to continue after changing the volume's directory or device.
******************************************************************

보관 로그 관리

운영체제의 파일 삭제 명령(rm, del)을 사용하여 보관 로그(archive log)를 임의로 삭제해서는 안 되며, 시스템의 설정, cubrid backupdb 유틸리티 또는 서버 프로세스에 의해 보관 로그가 삭제되어야 한다. 보관 로그가 삭제될 수 있는 경우는 다음의 3가지이다.

  • HA 환경이 아닌 경우(ha_mode=off)

    force_remove_log_archives 를 yes(기본값)로 설정하면, 최대 log_max_archives 개수만큼만 보관 로그가 유지되고 나머지는 자동으로 삭제된다. 단, 가장 오래된 보관 로그 파일에 액티브한 트랜잭션이 있다면 이 트랜잭션이 종료될 때까지 해당 로그 파일이 삭제되지 않는다.

  • HA 환경인 경우(ha_mode=on)

    force_remove_log_archives를 no로 설정하고, log_max_archives 개수를 지정하면 복제 반영 후 자동으로 삭제된다.

    Note

    ha_mode=on일 때 force_remove_log_archives를 yes로 설정하면 복제 반영이 안 된 보관 로그가 삭제될 수 있으므로, 이를 권장하지는 않는다. 다만, 복제 재구축을 감수하더라도 마스터 노드의 디스크 여유 공간을 확보하는 것이 우선된다면 force_remove_log_archives를 yes로 설정하고, log_max_archives를 적당한 값으로 설정한다.

  • cubrid backupdb -r 옵션을 사용하여 명령을 실행하면 삭제된다. 하지만 HA 환경에서는 -r 옵션을 사용하면 안 된다.

즉, 데이터베이스 운영 중에 보관 로그 볼륨을 가급적 남기고 싶지 않다면 cubrid.conflog_max_archives 값을 작은 값 또는 0으로 설정하되, force_remove_log_archives의 값은 HA 환경이면 가급적 no로 설정한다.

restoredb

데이터베이스 복구는 동일 버전의 CUBRID 환경에서 수행된 백업 작업에 의해 생성된 백업 파일, 활성 로그 및 보관 로그를 이용하여 특정 시점의 데이터베이스로 복구하는 작업이다. 데이터베이스 복구를 진행하려면 cubrid restoredb 유틸리티 또는 CUBRID 매니저를 사용한다.

cubrid restoredb 유틸리티는 최종 백업을 수행한 이후 모든 활성 로그와 보관 로그의 정보를 이용해 데이터베이스 백업본으로부터 데이터베이스를 복구한다.

cubrid restoredb [options] database_name

어떠한 옵션도 지정되지 않은 경우 기본적으로 마지막 커밋 시점까지 데이터베이스가 복구된다. 만약, 마지막 커밋 시점까지 복구하기 위해 필요한 활성 로그/보관 로그 파일이 없다면 마지막 백업 시점까지만 부분 복구된다.

cubrid restoredb demodb

다음은 cubrid restoredb 유틸리티와 결합할 수 있는 옵션을 정리한 표이다. 대소문자가 구분됨을 주의한다.

-d, --up-to-date=DATE

-d 옵션으로 지정된 날짜-시간까지 데이터베이스를 복구한다. 사용자는 dd-mm-yyyy:hh:mi:ss(예: 14-10-2008:14:10:00)의 형식으로 복구 시점을 직접 지정할 수 있다. 만약 지정한 복구 시점까지 복구하기 위해 필요한 활성 로그/보관 로그 파일이 없다면 마지막 백업 시점까지만 부분 복구된다.

cubrid restoredb -d 14-10-2008:14:10:00 demodb

backuptime 이라는 키워드를 복구 시점으로 지정하면 데이터베이스를 마지막 백업이 수행된 시점까지 복구한다.

cubrid restoredb -d backuptime demodb
--list

대상 데이터베이스의 백업 파일에 관한 정보를 화면에 출력하며 복구는 수행하지 않는다. 이 옵션은 CUBRID 9.3부터 데이터베이스가 운영 중인 경우에도 수행 가능하다.

cubrid restoredb --list demodb

다음은 --list 옵션에 의해 출력되는 백업 정보의 예로서, 복구 작업을 수행하기 전에 대상 데이터베이스의 백업 파일이 최초 저장된 경로와 백업 수준을 검증할 수 있다.

*** BACKUP HEADER INFORMATION ***
Database Name: /local1/testing/demodb
 DB Creation Time: Mon Oct 1 17:27:40 2008
         Pagesize: 4096
Backup Level: 1 (INCREMENTAL LEVEL 1)
        Start_lsa: 513|3688
         Last_lsa: 513|3688
Backup Time: Mon Oct 1 17:32:50 2008
 Backup Unit Num: 0
Release: 8.1.0
     Disk Version: 8
Backup Pagesize: 4096
Zip Method: 0 (NONE)
        Zip Level: 0 (NONE)
Previous Backup level: 0 Time: Mon Oct 1 17:31:40 2008
(start_lsa was -1|-1)
Database Volume name: /local1/testing/demodb_keys
     Volume Identifier: -6, Size: 65 bytes (1 pages)
Database Volume name: /local1/testing/demodb_vinf
     Volume Identifier: -5, Size: 308 bytes (1 pages)
Database Volume name: /local1/testing/demodb
     Volume Identifier: 0, Size: 2048000 bytes (500 pages)
Database Volume name: /local1/testing/demodb_lginf
     Volume Identifier: -4, Size: 165 bytes (1 pages)
Database Volume name: /local1/testing/demodb_bkvinf
     Volume Identifier: -3, Size: 132 bytes (1 pages)

--list 옵션을 이용하여 출력된 백업 정보를 확인하면, 백업 파일이 백업 수준 1로 생성되었고, 앞의 백업 수준 0의 전체 백업이 수행된 시점을 확인할 수 있다. 따라서, 예시된 데이터베이스의 복구를 위해서는 백업 수준 0인 백업 파일과 백업 수준 1인 백업 파일이 준비되어야 한다.

-B, --backup-file-path=PATH

백업 파일이 위치하는 디렉터리를 지정할 수 있다. 만약, 이 옵션이 지정되지 않으면 시스템은 데이터베이스 위치 정보 파일인 databases.txt 에 지정된 log-path 디렉터리에서 대상 데이터베이스를 백업했을 때 생성된 백업 정보 파일(dbname _bkvinf)을 검색하고, 백업 정보 파일에 지정된 디렉터리 경로에서 백업 파일을 찾는다. 그러나, 백업 정보 파일이 손상되거나 백업 파일의 위치 정보가 삭제된 경우라면 시스템이 백업 파일을 찾을 수 없으므로, 관리자가 -B 옵션을 이용하여 백업 파일이 위치하는 디렉터리 경로를 직접 지정해야 한다.

cubrid restoredb -B /home/cubrid/backup demodb

데이터베이스의 백업 파일이 현재 디렉터리에 있는 경우, 관리자는 -B 옵션을 이용하여 백업 파일이 위치하는 디렉터리를 지정할 수 있다.

cubrid restoredb -B . demodb
-l, --level=LEVEL

대상 데이터베이스의 백업 수준(0, 1, 2)을 지정하여 복구를 수행한다. 백업 수준에 대한 자세한 내용은 증분 백업 을 참조한다.

cubrid restoredb -l 1 demodb
-p, --partial-recovery

사용자 응답을 요청하지 않고 부분 복구를 수행하라는 명령이다. 백업 시점 이후에 기록된 활성 로그나 보관 로그가 완전하지 않을 때 기본적으로 시스템은 로그 파일이 필요하다는 것을 알리면서 실행 옵션을 입력하라는 요청 메시지를 출력하는데, -p 옵션을 이용하면 이러한 요청 메시지의 출력 없이 직접 부분 복구를 수행할 수 있다. 따라서, -p 옵션을 이용하여 복구를 수행하면 언제나 마지막 백업 시점까지 데이터가 복구된다.

cubrid restoredb -p demodb

-p 옵션이 지정되지 않은 경우, 사용자에게 실행 옵션을 선택하라는 요청 메시지는 다음과 같다.

***********************************************************
Log Archive /home/cubrid/test/log/demodb_lgar002
 is needed to continue normal execution.
   Type
   -  0 to quit.
   -  1 to continue without present archive. (Partial recovery)
   -  2 to continue after the archive is mounted/loaded.
   -  3 to continue after changing location/name of archive.
***********************************************************
  • 옵션 0: 복구 작업을 더 이상 진행하지 않을 경우, 0을 입력한다.

  • 옵션 1: 로그 파일 없이 부분 복구를 진행하려면, 1을 입력한다.

  • 옵션 2: 복구 작업을 진행하기 위해 관리자는 현재 장치에 보관 로그를 위치시킨 후 2를 입력한다.

  • 옵션 3: 복구 작업을 계속하기 위해 관리자는 로그 위치를 변경한 후 3을 입력한다.

-o, --output-file=FILE

대상 데이터베이스의 복구에 관한 진행 정보를 info_restore라는 파일에 기록하는 명령이다.

cubrid restoredb -o info_restore demodb
-u, --use-database-location-path

데이터베이스 위치 정보 파일(databases.txt)에 지정된 경로에서 대상 데이터베이스를 복구하는 구문이다. -u 옵션은 A 서버에서 백업을 수행하고 B 서버에서 백업 파일을 복구하고자 할 때 사용할 수 있는 유용한 옵션이다.

cubrid restoredb -u demodb
-k, --keys-file-path=PATH

대상 데이터베이스 복구 시 필요한 키 파일을 지정한다. 올바른 키 파일이 주어지지 않았을 경우 복구에 실패한다. 옵션을 지정해주지 않을 경우 적절한 키 파일을 탐색하여 사용한다. 이에 대한 자세한 내용은 백업 볼륨 암호화 을 참고한다.

cubrid restoredb -k /home/cubrid/backup_keys/demodb_bk1_keys demodb

데이터베이스 서버 시작이나 백업 볼륨 복구 시 서버 에러 로그 또는 restoredb 에러 로그 파일에 로그 회복(log recovery) 시작 시간과 종료 시간에 대한 NOTIFICATION 메시지를 출력하여, 해당 작업의 소요 시간을 확인할 수 있다. 해당 메시지에는 적용(redo)해야할 로그의 개수와 로그 페이지 개수가 함께 기록된다.

Time: 06/14/13 21:29:04.059 - NOTIFICATION *** file ../../src/transaction/log_recovery.c, line 748 CODE = -1128 Tran = -1, EID = 1
Log recovery is started. The number of log records to be applied: 96916. Log page: 343 ~ 5104.
.....
Time: 06/14/13 21:29:05.170 - NOTIFICATION *** file ../../src/transaction/log_recovery.c, line 843 CODE = -1129 Tran = -1, EID = 4
Log recovery is finished.

복구 정책과 절차

데이터베이스를 복구할 때 고려해야 할 사항은 다음과 같다.

  • 백업 파일 준비

    • 백업 파일 및 로그 파일이 저장된 디렉터리를 파악한다.

    • 증분 백업으로 대상 데이터베이스가 백업된 경우, 각 백업 수준에 따른 백업 파일이 존재하는지를 파악한다.

    • 백업이 수행된 CUBRID 데이터베이스의 버전과 복구가 이루어질 CUBRID 데이터베이스 버전이 동일한지를 파악한다.

  • 복구 방식 결정

    • 부분 복구인지 전체 복구인지를 결정한다.

    • 증분 백업 파일을 이용한 복구인지를 결정한다.

    • 사용 가능한 복구 도구 및 복구 장비를 준비한다.

  • 복구 시점 판단

    • 데이터베이스 서버가 종료된 시점을 파악한다.

    • 장애 발생 전에 이루어진 마지막 백업 시점을 파악한다.

    • 장애 발생 전에 이루어진 마지막 커밋 시점을 파악한다.

데이터베이스 복구 절차

다음은 백업 및 복구 작업의 절차를 시간별로 예시한 것이다.

  1. 2008/8/14 04:30분에 운영이 중단된 demodb 를 전체 백업을 수행한다.

  2. 2008/8/14 10:00분에 운영 중인 demodb 를 1차 증분 백업 수행한다.

  3. 2008/8/14 15:00분에 운영 중인 demodb 를 1차 증분 백업을 수행한다. 2번의 1차 증분 백업 파일을 덮어쓴다.

  4. 2008/8/14 15:30분에 시스템 장애가 발생하였고, 관리자는 demodb 의 복구 작업을 준비한다. 장애 발생 전의 마지막 커밋 시점이 15:25분이므로 이를 복구 시점으로 지정한다.

  5. 관리자는 1.에서 생성된 전체 백업 파일 및 3.에서 생성된 1차 증분 백업 파일, 활성 로그 및 보관 로그를 준비하여 마지막 커밋 시점인 15:25 시점까지 demodb 를 복구한다.

Time

Command

설명

2008/8/14 04:25

cubrid server stop demodb

demodb 운영을 중단한다.

2008/8/14 04:30

cubrid backupdb -S -D /home/backup -l 0 demodb

오프라인에서 demodb 를 전체 백업하여 지정된 디렉터리에 백업 파일을 생성한다.

2008/8/14 05:00

cubrid server start demodb

demodb 운영을 시작한다.

2008/8/14 10:00

cubrid backupdb -C -D /home/backup -l 1 demodb

온라인에서 demodb 를 1차 증분 백업하여 지정된 디렉터리에 백업 파일을 생성한다.

2008/8/14 15:00

cubrid backupdb -C -D /home/backup -l 1 demodb

온라인에서 demodb 를 1차 증분 백업하여 지정된 디렉터리에 백업 파일을 생성한다. 10:00에 생성된 1차 증분 백업파일을 덮어쓴다.

2008/8/14 15:30

시스템 장애가 발생한 시각이다.

2008/8/14 15:40

cubrid restoredb -l 1 -d 08/14/2008:15:25:00 demodb

전체 백업 파일, 1차 증분 백업 파일, 활성 로그 및 보관 로그를 기반으로 demodb 를 복구한다. 전체 백업 파일, 1차 증분된 백업 파일, 활성 로그 및 보관 로그에 의해 15:25 시점까지 복구된다.

다른 서버로의 데이터베이스 복구

다음은 A 서버에서 demodb 를 백업하고, 백업된 파일을 기반으로 B 서버에서 demodb 를 복구하는 방법이다.

백업 환경과 복구 환경

A 서버의 /home/cubrid/db/demodb 디렉터리에서 demodb 를 백업하고, B 서버의 /home/cubrid/data/demodb 디렉터리에 demodb 를 복구하는 것으로 가정한다.

../_images/image12.png
  1. A 서버에서 백업

    A 서버에서 demodb 를 백업한다. 이보다 먼저 백업을 수행하였다면 이후 변경된 부분만 증분 백업을 수행할 수 있다. 백업 파일이 생성되는 디렉터리는 -D 옵션에 의해 지정하지 않으면, 기본적으로 로그 볼륨이 저장되는 위치에 생성된다. 다음은 권장되는 옵션을 사용한 백업 명령이며, 옵션에 관한 보다 자세한 내용은 backupdb를 참고한다.

    cubrid backupdb -z demodb
    
  2. B 서버에서 데이터베이스 위치 정보 파일 편집

    동일한 서버에서 백업 및 복구 작업이 이루어지는 일반적인 시나리오와는 달리, 타 서버 환경에서 백업 파일을 복구하는 시나리오에서는 B 서버의 데이터베이스 위치 정보 파일(databases.txt)에서 데이터베이스를 복구할 위치 정보를 추가해야 한다. 위 그림에서는 B 서버(호스트명은 pmlinux)의 /home/cubrid/data/demodb 디렉터리에 demodb 를 복구하는 것을 가정하였으므로, 이에 따라 데이터베이스 위치 정보 파일을 편집하고, 해당 디렉터리를 B 서버에서 생성한다.

    데이터베이스 위치 정보는 한 라인으로 작성하고, 각 항목은 공백으로 구분한다. 한 라인은 [데이터베이스명] [데이터볼륨경로] [호스트명] [로그볼륨경로]의 형식으로 작성한다. 따라서 다음과 같이 demodb 의 위치 정보를 작성한다.

    demodb /home/cubrid/data/demodb pmlinux /home/cubrid/data/demodb
    
  3. B 서버로 백업 파일 전송

    복구를 위해서는 대상 데이터베이스의 백업 파일이 필수적으로 준비되어야 한다. 따라서, A 서버에서 생성된 백업 파일(예: demodb_bk0v000)을 B 서버에 전송한다. 즉, B 서버의 임의 디렉터리(예: /home/cubrid/temp)에는 백업 파일이 위치해야 한다.

    Note

    백업 이후에 현재 시점까지 모두 복구하려면 백업 이후의 로그, 즉 활성 로그(예: demodb_lgat)와 보관 로그(예: demodb_lgar000)까지 모두 추가적으로 복사해야 된다. 활성 로그와 보관 로그는 복구될 데이터베이스의 로그 디렉터리, 즉 $CUBRID/databases/databases.txt 파일에서 명시한 로그 파일의 디렉터리(예: $CUBRID/databases/demodb/log)에 위치해야 한다. 하지만 백업 파일의 위치는 -D 옵션으로 명시할 수 있기 때문에 다른 위치에 있어도 된다.

    또한, 백업 이후 추가된 로그를 반영하려면 보관 로그 파일이 삭제되기 전에 복사해야 하는데, 보관 로그의 삭제 관련 시스템 파라미터인 log_max_archives의 기본값이 0으로 설정되어 있으므로 백업 이후 보관 로그 파일이 삭제될 수 있다. 이러한 상황을 방지하기 위해, log_max_archives의 값을 적당히 크게 설정하여야 한다. log_max_archives를 참고한다.

  4. B 서버에서 복구

    B 서버로 전송한 백업 파일이 있는 디렉터리에서 cubrid restoredb 유틸리티를 호출하여 데이터베이스 복구 작업을 수행한다. -u 옵션에 의해 databases.txt 에 지정된 디렉터리 경로에 demodb 가 복구된다.

    cubrid restoredb -u demodb
    

    다른 위치에서 cubrid restoredb 유틸리티를 호출하려면, 다음과 같이 -B 옵션을 이용하여 백업 파일이 위치하는 디렉터리 경로를 지정해야 한다.

    cubrid restoredb -u -B /home/cubrid/temp demodb
    

unloaddb

데이터베이스를 언로드/로드하는 목적은 다음과 같다.

  • 데이터베이스 볼륨을 재구성하여 데이터베이스 재구축

  • 시스템이 다른 환경에서 마이그레이션 수행

  • 버전이 다른 DBMS에서 마이그레이션 수행

cubrid unloaddb [options] database_name

cubrid unloaddb가 생성하는 파일은 다음과 같다.

  • 스키마 파일(database-name_schema): 해당 데이터베이스에 정의된 스키마 정보를 포함하는 파일이다.

  • 객체 파일(database-name_objects): 해당 데이터베이스에 포함된 인스턴스 정보를 포함하는 파일이다.

  • 인덱스 파일(database-name_indexes): 해당 데이터베이스에 정의된 인덱스 정보를 포함하는 파일이다.

  • 트리거 파일(database-name_trigger): 해당 데이터베이스에 정의된 트리거 정보를 포함하는 파일이다. 만약 데이터를 로딩하는 동안 트리거가 구동되는 것을 원치 않는다면, 데이터 로딩을 완료한 후에 트리거 정의를 로딩하면 된다.

이러한 스키마, 객체, 인덱스, 트리거 파일은 같은 디렉터리에 생성된다.

다음은 cubrid unloaddb 에서 사용하는 [options]이다.

-u, --user=ID

언로딩할 데이터베이스의 사용자 계정을 지정한다. 옵션을 지정하지 않으면 기본값은 DBA가 된다.

cubrid unloaddb -u dba -i table_list.txt demodb
-p, --password=PASS

언로딩할 데이터베이스의 사용자 암호를 지정한다. 옵션을 지정하지 않으면 빈 문자열을 입력한 것으로 간주한다.

cubrid unloaddb -u dba -p dba_pwd -i table_list.txt demodb
-i, --input-class-file=FILE

모든 테이블의 스키마와 인덱스를 언로드하되, 파일에 명시된 테이블의 데이터만 언로드한다. 언로딩할 사용자의 스키마와(-u 옵션 참고) 테이블의 스키마가 다른 경우 테이블 이름은 스키마 이름을 접두어로 사용해야 한다.

cubrid unloaddb -i table_list.txt demodb

다음은 입력 파일 table_list.txt의 예이다.

table_1
table_2
..
table_n

-i 옵션이 --input-class-only 와 결합되면, -i 옵션의 입력 파일에서 지정된 테이블의 스키마, 인덱스, 데이터 파일만 언로드한다.

cubrid unloaddb --input-class-only -i table_list.txt demodb

-i 옵션이 --include-reference 와 결합되면, 참조되는 테이블도 함께 언로드된다.

cubrid unloaddb --include-reference -i table_list.txt demodb
--include-reference

-i 옵션과 함께 사용되며, 참조되는 테이블도 함께 언로드된다.

--input-class-only

-i 옵션과 함께 사용되며, -i 옵션의 입력 파일에서 지정된 테이블의 스키마 파일만 생성한다.

--estimated-size=NUMBER

언로드할 데이터베이스의 레코드 저장을 위한 해시 메모리를 사용자 임의로 할당하기 위한 옵션이다. 만약 --estimated-size 옵션이 지정되지 않으면 최근의 통계 정보를 기반으로 데이터베이스의 레코드 수를 결정하게 되는데, 만약 최근 통계 정보가 갱신되지 않았거나 해시 메모리를 크게 할당하고 싶은 경우 이 옵션을 이용할 수 있다. 따라서, 옵션의 인수로 너무 적은 레코드 개수를 정의한다면 해시 충돌로 인해 언로드 성능이 저하된다.

cubrid unloaddb --estimated-size=1000 demodb
--cached-pages=NUMBER

메모리에 캐시되는 테이블의 페이지 수를 지정하기 위한 옵션이다. 각 페이지는 4,096 바이트이며, 관리자는 메모리의 크기와 속도를 고려하여 캐시되는 페이지 수를 지정할 수 있다. 만약, 이 옵션이 지정되지 않으면 기본값은 100페이지가 된다.

cubrid unloaddb --cached-pages 500 demodb
-O, --output-path=PATH

스키마와 객체 파일이 생성될 디렉터리를 지정한다. 옵션이 지정되지 않으면 현재 디렉터리에 생성된다.

cubrid unloaddb -O ./CUBRID/Databases/demodb demodb

지정된 디렉터리가 존재하지 않는 경우 다음과 같은 에러 메시지가 출력된다.

unloaddb: No such file or directory.
-s, --schema-only

언로드 작업을 통해 생성되는 출력 파일 중 스키마 파일만 생성되도록 지정하는 옵션이다.

cubrid unloaddb -s demodb
-d, --data-only

언로드 작업을 통해 생성되는 출력 파일 중 데이터 파일만 생성되도록 지정하는 옵션이다.

cubrid unloaddb -d demodb
--output-prefix=PREFIX

언로드 작업에 의해 생성되는 스키마 파일과 객체 파일의 이름 앞에 붙는 prefix를 지정하기 위한 옵션이다. 예제를 수행하면 스키마 파일명은 abcd_schema 가 되고, 객체 파일명은 abcd_objects 가 된다. 만약, --output-prefix 옵션을 지정하지 않으면 언로드할 데이터베이스 이름이 prefix로 사용된다.

cubrid unloaddb --output-prefix abcd demodb
--hash-file=FILE

해시 파일의 이름을 지정한다.

--latest-image

인스턴스들을 언로드할 때 현재 데이터 볼륨의 가장 마지막 이미지에서 언로드한다. 커밋되지 않은 데이터나 삭제되었지만 배큠되지 않은 데이터가 포함될 수 있다. 이 옵션을 지정하면 MVCC 버전은 무시되며 로그 볼륨을 참조하지 않는다.

-v, --verbose

언로드 작업이 진행되는 동안 언로드되는 데이터베이스의 테이블 및 인스턴스에 관한 상세 정보를 화면에 출력하는 옵션이다.

cubrid unloaddb -v demodb
--use-delimiter

식별자의 시작과 끝에 겹따옴표(“)를 기록한다. 기본 설정은 식별자의 시작과 끝에 겹따옴표를 기록하지 않는다.

-S, --SA-mode

독립 모드에서 데이터베이스를 언로드한다.

cubrid unloaddb -S demodb
-C, --CS-mode

클라이언트/서버 모드에서 데이터베이스를 언로드한다.

cubrid unloaddb -C demodb
--datafile-per-class

언로드 작업으로 생성되는 데이터 파일을 각 테이블별로 생성되도록 지정하는 옵션이다. 파일 이름은 <데이터베이스 이름>_<테이블 이름>_objects 로 생성된다. 단, 객체 타입의 칼럼 값은 모두 NULL 로 언로드되며, 언로드된 파일에는 %id class_name class_id 부분이 작성되지 않는다. 자세한 내용은 가져오기용 파일 작성 방법 을 참고한다.

cubrid unloaddb --datafile-per-class demodb

Note

언로드 시간을 단축하기 위해서 서로 다른 테이블에 대한 언로드는 동시에 실행 가능하며 unloaddb.sh 스크립트를 이용하면 이러한 과정을 쉽게 할 수 있다 (unloaddb.sh 스크립트 참고).

loaddb

데이터베이스 로드는 다음과 같은 경우에 cubrid loaddb 유틸리티를 이용하여 수행된다.

  • 예전 버전의 CUBRID 데이터베이스를 새로운 버전의 데이터베이스로 마이그레이션하는 경우

  • 타 DBMS의 데이터베이스를 CUBRID 데이터베이스로 마이그레이션하는 경우

  • INSERT 구문 실행보다 빠른 성능으로 대용량 데이터를 입력하는 경우

일반적으로 cubrid loaddb 유틸리티는 cubrid unloaddb 유틸리티가 생성한 파일(스키마 정의 파일, 객체 입력 파일, 인덱스 정의 파일)을 사용한다.

cubrid loaddb [options] database_name

입력 파일

  • 스키마 파일(database-name_schema): 언로드 작업에 의해 생성된 파일로서, 데이터베이스에 정의된 스키마 정보를 포함하는 파일이다.

  • 객체 파일(database-name_objects): 언로드 작업에 의해 생성된 파일로서, 데이터베이스에 포함된 레코드 정보를 포함하는 파일이다.

  • 인덱스 파일(database-name_indexes): 언로드 작업에 의해 생성된 파일로서, 데이터베이스에 정의된 인덱스 정보를 포함하는 파일이다.

  • 트리거 파일(database-name_trigger): 언로드 작업에 의해 생성된 파일로서, 데이터베이스에 정의된 트리거 정보를 포함하는 파일이다.

  • 사용자 정의 객체 파일(user_defined_object_file) : 대용량 데이터 입력을 위해 사용자가 테이블 형식으로 작성한 입력 파일이다(가져오기용 파일 작성 방법 참고).

입력 파일 처리 순서

cubrid loaddb 유틸리티는 아래와 같이 특정 순서 따라서 파싱을 하며 입력 파일을 처리한다. 이것은 loaddb의 정확성과 일관성을 보장한다.

  1. 스키마 파일 로드 (기본키 포함)

  2. 오브젝트 파일 로드

  3. 인덱스 파일 로드 (보조키와 외래키)

  4. 트리거 파일 로드

로딩 모드

cubrid loaddb 유틸리티는 데이터를 데이터베이스에 로드하기 위해서 두가지 모드를 제공한다.

  • Stand-alone 모드에서는 단일 스레드 환경에서 오프라인으로 데이터를 로드한다. CUBRID 10.1과 그 이하의 버전에서는 이 모드 만이 제공된다.

  • Client-server 모드에서는 데이터베이스 서버에 접속하여 온라인으로 데이터를 로드하며 병렬로 처리된다. Client-server 모드는 stand-alone 모드보다 훨씬 빠르지만 오브젝트의 참조와 클래스/공유 속성은 지원하지 않는다.

다음은 cubrid loaddb 에서 사용하는 [options]이다.

-u, --user=ID

레코드를 로딩할 데이터베이스의 사용자 계정을 지정한다. 옵션을 지정하지 않으면 기본값은 PUBLIC 이 된다.

cubrid loaddb -u admin -d demodb_objects newdb
-p, --password=PASS

레코드를 로딩할 데이터베이스의 사용자 암호를 지정한다. 옵션을 지정하지 않으면 암호 입력을 요청하는 프롬프트가 출력된다.

cubrid loaddb -u dba -p pass -d demodb_objects newdb
-S, --SA-MODE

데이터를 stand-alone 모드로 데이터베이스에 로드한다. 이것은 loaddb 의 기본 로드 모드이며 CUBRID 10.1 이하의 버전과 완벽히 호환된다.

cubrid loaddb -S -u dba -d demodb_objects newdb
-C, --CS-MODE

이 옵션에서는 loaddb 가 가동중인 데이터베이스 서버 프로세스에 접속한다. stand-alone 모드와 다르게 client-server 모드에서는 여러 개의 스레드를 사용하여 데이터를 로드할 수있다. 이 모드에서는 동시에 여러 개의 loaddb 세션을 연결하며, 대용량의 데이터를 로드할 때 특히 우수한 성능을 발휘한다. 이 모드에서는 오브젝트 참조나 클래스/공유 속성은 제공하지 않는다.

cubrid loaddb -C -u dba -d demodb_objects newdb
--data-file-check-only

demodb_objects에 포함된 데이터의 구문이 정상인지 확인만 하며 데이터를 데이터베이스에 로딩하지 않는다.

cubrid loaddb --data-file-check-only -d demodb_objects newdb
-l, --load-only

Stand-alone 모드는 기본적으로 데이터베이스에 로드하기 전에 전체 데이터에 대해 사전 구문 검사가 실행된다. 오류가 발생하면 데이터의 로드는 실행되지 않고 오류가 보고된다.

-l 옵션을 이용하면 로드 전에 전체 데이타에 대해 사전 구문 검사 실행이 생략되어 속도가 빠르다. 그러나, 각 레코드를 데이터베이스에 로드하기 전에 구문 검사가 진행된다. 이 과정에서 구문 오류가 발생하는 경우 로드는 중지되며, 결과적으로 데이터의 일부분만 로드되는 경우가 발생할 수도 있다.

cubrid loaddb -l -d demodb_objects newdb
--estimated-size=NUMBER

언로드할 레코드의 수가 기본값인 5,000개보다 많은 경우 로딩 성능 향상을 위해 사용할 수 있다. 이 옵션을 통해 레코드 저장을 위한 해시 메모리를 크게 할당함으로써 로드 성능을 향상시킬 수 있다.

cubrid loaddb --estimated-size 8000 -d demodb_objects newdb
-v, --verbose

데이터베이스 로딩 작업이 진행되는 동안, 로딩되는 데이터베이스의 테이블 및 레코드에 관한 상세 정보를 화면에 출력한다. 진행 단계, 로딩되는 클래스, 입력된 레코드의 개수와 같은 상세 정보를 확인할 수 있다.

cubrid loaddb -v -d demodb_objects newdb
-c, --periodic-commit=COUNT

지정된 개수의 레코드가 데이터베이스에 입력될 때마다 주기적으로 커밋을 실행한다. -c 옵션이 지정되지 않은 경우, 데이터 파일에 포함된 모든 레코드가 데이터베이스로 로드된 후에 트랜잭션이 커밋된다. 또한, -c 옵션이 -s 옵션이나 -i 옵션과 함께 사용하는 경우에는 100개의 DDL문이 로드될 때마다 주기적으로 커밋을 실행한다.

권장되는 커밋 주기는 로딩되는 데이터에 따라 다른데, 스키마 로딩의 경우에는 -c의 인수를 50으로, 인덱스 로딩의 경우는 인수를 1로 설정하는 것이 권고된다. 레코드 로딩의 경우는 10,240이 권고되며 기본값이다.

CUBRID 10.1 또는 그 이하의 버전에서 --periodic-commit 의 기본값은 없으며 따라서 전체 데이터를 로드한 후에 트랜잭션 커밋을 수행할 것이다. 현재 상태에서, 이전과 같이 동작하기를 원한다면 --periodic-commit 을 매우 큰 값으로 설정하라. 그러면 모든 데이터가 로드된 후에 커밋이 실행될 것이다.

cubrid loaddb -c 100 -d demodb_objects newdb
--no-oid

demodb_objects에 포함된 OID를 무시하고 레코드를 newdb로 로딩하는 명령이다.

cubrid loaddb --no-oid -d demodb_objects newdb
--no-statistics

demodb_objects를 로딩한 후 newdb의 통계 정보를 갱신하지 않는 명령이다. 특히, 대상 데이터베이스의 데이터 용량에 비해 매우 적은 데이터만 로딩할 경우 이 옵션을 이용하여 로드 성능을 향상시킬 수 있다.

cubrid loaddb --no-statistics -d demodb_objects newdb
-s, --schema-file=FILE[:LINE]

스키마 파일 또는 트리거 파일의 LINE번째부터 정의된 스키마 정보 또는 트리거 정보를 새로 생성한 newdb에 로딩하는 구문이다. -s 옵션을 이용하여 스키마 정보를 먼저 로딩한 후, 실제 레코드를 로딩할 수 있다.

다음 예제에서 demodb_schema 파일은 언로드 작업에 의해 생성된 파일이며 언로드된 데이터베이스의 스키마 정보를 포함한다.

cubrid loaddb -u dba -s demodb_schema newdb

Start schema loading.
Total       86 statements executed.
Schema loading from demodb_schema finished.
Statistics for Catalog classes have been updated.

다음은 demodb에 정의된 트리거 정보를 새로 생성한 newdb에 로딩하는 구문이다. demodb_trigger 파일은 언로드 작업에 의해 생성된 파일이며, 언로드된 데이터베이스의 트리거 정보를 포함한다. 레코드를 모두 로딩한 후, -s 옵션을 이용하여 트리거를 생성할 것을 권장한다.

cubrid loaddb -u dba -s demodb_trigger newdb
-i, --index-file=FILE[:LINE]

인덱스 파일의 LINE번째부터 정의된 인덱스 정보를 데이터베이스에 로딩하는 명령이다. 다음 예제에서, demo_indexes 파일은 언로드 작업에 의해 생성된 파일이며 언로드된 데이터베이스의 인덱스 정보를 포함한다. -d 옵션을 이용하여 레코드를 로딩한 후, -i 옵션을 이용하여 인덱스를 생성할 수 있다.

cubrid loaddb -c 100 -d demodb_objects newdb
cubrid loaddb -u dba -i demodb_indexes newdb
-d, --data-file=FILE

-d 옵션을 이용하여 데이터 파일 또는 사용자 정의 객체 파일을 지정함으로써 레코드 정보를 newdb로 로딩하는 명령이다. demodb_objects 파일은 언로드 작업에 의해 생성된 객체 파일이거나, 사용자가 대량의 데이터 로딩을 위하여 작성한 사용자 정의 객체 파일 중 하나이다.

cubrid loaddb -u dba -d demodb_objects newdb
-t, --table=TABLE

로딩할 데이터 파일에 테이블 이름 헤더가 생략되어 있는 경우, 이 옵션 뒤에 테이블 이름을 지정한다. 테이블 이름은 스키마 이름을 접두사로 사용해야 한다.

cubrid loaddb -u dba -d demodb_objects -t tbl_name newdb
--error-control-file=FILE

데이터베이스 로드 작업 중에 발생하는 에러 중 특정 에러를 처리하는 방식에 관해 명세한 파일을 지정하는 옵션이다.

cubrid loaddb --error-control-file=error_test -d demodb_objects newdb

서버 에러 코드 이름은 $CUBRID/include/dbi.h 파일을 참고하도록 한다.

에러 코드(에러 번호) 별 에러 메시지는 $CUBRID/msg/<문자셋 이름>/cubrid.msg 파일의 $set 5 MSGCAT_SET_ERROR 이하에 있는 번호들을 참고하도록 한다.

vi $CUBRID/msg/en_US/cubrid.msg

$set 5 MSGCAT_SET_ERROR
1 Missing message for error code %1$d.
2 Internal system failure: no more specific information is available.
3 Out of virtual memory: unable to allocate %1$ld memory bytes.
4 Has been interrupted.
...
670 Operation would have caused one or more unique constraint violations.
...

특정 에러 명세 파일의 형식은 다음과 같다.

  • -<에러 코드> : <에러 코드>에 해당하는 에러를 무시하도록 설정 (loaddb 수행 중 해당 에러가 발생해도 계속 수행)

  • +<에러 코드> : <에러 코드>에 해당하는 에러를 무시하지 않도록 설정 (loaddb 수행 중 해당 에러가 발생하면 작업을 종료함)

  • +DEFAULT : 24번부터 33번까지의 에러를 무시하지 않도록 설정

--error-control-file 옵션으로 에러 명세 파일을 설정하지 않을 경우, loaddb 유틸리티는 기본적으로 24번부터 33번까지의 에러를 무시하도록 설정되어 있다. 이들은 데이터베이스 볼륨의 여유 공간이 얼마 남지 않았다는 경고성 에러로서, 이후 할당된 데이터베이스 볼륨의 여유 공간이 없어지면 자동으로 범용 볼륨(generic volume)을 생성하게 된다.

다음은 에러 명세 파일을 작성한 예이다.

  • +DEFAULT를 설정하여, 24번부터 33번까지의 DB 볼륨 여유 공간 경고성 에러는 무시되지 않는다.

  • 앞에서 -2를 설정했으나, 뒤에서 +2를 설정했기 때문에 2번 에러 코드는 무시되지 않는다.

  • -670을 설정하여, 670번 에러인 고유성 위반 에러(unique violation error)는 무시된다.

  • #-115는 앞에 #이 있어 커멘트 처리되었다.

    vi error_file
    
    +DEFAULT
    -2
    -670
    #-115 --> comment
    +2
    
--ignore-class-file=FILE

로딩 작업 중 무시할 클래스 목록을 명세한 파일을 지정한다. 지정된 파일에 포함된 클래스를 제외한 나머지 클래스의 레코드만 로딩된다.

cubrid loaddb --ignore-class-file=skip_class_list -d demodb_objects newdb
--trigger-file=FILE

데이터베이스에 로드할 트리거가 포함된 파일을 지정할 수있다.

cubrid loaddb --trigger-file=demodb_triggers -d demodb_objects newdb
--no-user-specified-name

11.2 이전 버전에서 언로드된 파일은 --no-user-specified-name 옵션을 사용하는 경우에만 11.2 버전에서 로드할 수 있다.

이 옵션은 -u 옵션과 함께 데이터베이스의 사용자 계정이 DBA로 지정된 경우에만 동작한다.

cubrid loaddb -u dba -s demodb_schema -d demodb_objects --no-user-specified-name demodb

Warning

--no-user-specified-name 옵션은 11.2버전 또는 11.2 이후 버전에서 언로드된 파일을 로드할 때 사용하면 안 된다.

Warning

--no-logging 옵션을 사용하면 loaddb 를 수행하면서 트랜잭션 로그를 저장하지 않으므로 데이터 파일을 빠르게 로드할 수 있다. 그러나 로드 도중 파일 형식이 잘못되거나 시스템이 다운되는 등의 문제가 발생했을 때 데이터를 복구할 수 없으므로 데이터베이스를 새로 구축해야 한다. 즉, 데이터를 복구할 필요가 없는 새로운 데이터베이스를 구축하는 경우를 제외하고는 사용하지 않도록 주의한다. 이 옵션을 사용하면 고유 위반 등의 오류를 검사하지 않아 기본 키에 값이 중복되는 경우 등이 발생할 수 있으므로, 사용 시 이러한 문제를 반드시 감안해야 한다.

가져오기용 파일 작성 방법

cubrid loaddb 유틸리티에서 사용되는 객체 입력 파일을 직접 작성하여 사용하면 데이터베이스에 대량의 데이터를 보다 신속하게 추가할 수 있다. 객체 입력 파일은 간단한 테이블 모양의 형식으로 구성되며 주석, 명령 라인, 데이터 라인으로 이루어진 텍스트 파일이다.

주석

CUBRID에서는 주석은 두 개의 연속된 하이픈(--)을 이용하여 처리한다.

-- This is a comment!

명령 라인

명령 라인은 퍼센트(%) 문자로 시작하며, 명령어로는 클래스를 정의하는 %class 명령어와, 클래스 식별을 위해 사용하는 별칭(alias)이나 식별자(identifier)를 정의하는 %id 명령어가 있다.

  • 클래스에 식별자 부여

    %id 를 이용하여 참조 관계에 있는 클래스에 식별자를 부여할 수 있다.

    %id [schema_name.]class_name class_id
    schema_name:
        identifier
    class_name:
        identifier
    class_id:
        integer
    

    %id 명령어에 의해 명시된 class_name은 해당 데이터베이스에 정의된 클래스 이름이다. class_nameschema_name을 접두사로 사용하며, schema_name은 클래스가 정의된 스키마 이름이다. schema_name은 생략할 수 있으며, schema_name을 생략하면 -u 옵션과 함께 지정된 데이터베이스의 사용자 이름이 스키마 이름으로 사용된다.

    %id [employee] 21
    %id [office] 22
    %id [project] 23
    %id [phone] 24
    

    schema_nameclass_name은 대괄호([ ])로 묶어야 한다. schema_nameclass_name의 각각을 대괄호로 묶거나, 함께 대괄호로 묶을 수 있다.

    %id [public].[employee] 21
    %id [public].[office] 22
    %id [public].[project] 23
    %id [public].[phone] 24
    
    %id [public.employee] 21
    %id [public.office] 22
    %id [public.project] 23
    %id [public.phone] 24
    
  • 클래스 및 속성 명시

    %class 명령어를 이용하여 데이터가 로딩될 클래스(테이블) 및 속성(칼럼)을 명시하며, 명시된 속성의 순서에 따라 데이터 라인이 작성되어야 한다. cubrid loaddb 유틸리티를 실행할 때 -t 옵션으로 클래스 이름을 제공하는 경우에는 데이터 파일에 클래스 및 속성을 명시하지 않아도 된다. 단, 데이터가 작성되는 순서는 클래스 생성 시의 속성 순서를 따라야 한다.

    %class [schema_name.]class_name (attr_name [attr_name...])
    schema_name:
        identifier
    class_name:
        identifier
    attr_name:
        identifier
    

    데이터를 로딩하고자 하는 데이터베이스에는 클래스가 이미 정의되어 있어야 한다.

    %class 명령어에 의해 명시된 class_name은 해당 데이터베이스에 정의된 클래스 이름이며, schema_name은 클래스가 정의된 스키마 이름이다. attr_name는 정의된 속성 이름을 의미한다. schema_nameclass_name의 작성 방법은 위와 동일하다.

    다음은 employee라는 클래스에 데이터를 입력하기 위하여 %class 명령으로 클래스 및 3개의 속성을 명시한 예제이다. %class 명령 다음에 나오는 데이터 라인에서는 3개의 데이터가 입력되어야 하며, 이는 참조 관계 설정을 참조한다.

    %class [public].[employee] (name age department)
    

데이터 라인

데이터 라인은 %class 명령 라인 다음에 위치하며, 입력되는 데이터는 %class 명령에 의해 명시된 클래스 속성과 타입이 일치해야 한다. 만약, 명시된 속성과 타입이 일치하지 않으면 데이터 로드 작업은 중지된다.

또한, 각각의 속성에 대응되는 데이터는 적어도 하나의 공백에 의해 분리되어야 하며, 한 라인에 작성되는 것이 원칙이다. 다만, 입력되는 데이터가 많은 경우에는 첫 번째 데이터 라인의 맨 마지막 데이터 다음에 플러스 기호(+)를 명시하여 다음 라인에 데이터를 연속적으로 입력할 수 있다. 이 때, 맨 마지막 데이터와 플러스 기호 사이에는 공백이 허용되지 않음을 유의한다.

  • 인스턴스 입력

    다음과 같이 명시된 클래스 속성과 타입이 일치하는 인스턴스를 입력할 수 있다. 각각의 데이터는 적어도 하나의 공백에 의해 구분된다.

    %class [public].[employee] (name)
    'jordan'
    'james'
    'garnett'
    'malone'
    
  • 인스턴스 번호 부여

    데이터 라인의 처음에 ‘번호:’의 형식으로 해당 인스턴스에 대한 번호를 부여할 수 있다. 인스턴스 번호는 명시된 클래스 내에서 유일한 양수이며, 번호와 콜론(:) 사이에는 공백이 허용되지 않는다. 이와 같이 인스턴스 번호를 부여하는 이유는 추후 객체 참조 관계를 설정하기 위함이다.

    %class [public].[employee] (name)
    1: 'jordan'
    2: 'james'
    3: 'garnett'
    4: 'malone'
    
  • 참조 관계 설정

    @ 다음에 참조하는 클래스를 명시하고, 수직바(|) 다음에 참조하는 인스턴스의 번호를 명시하여 객체 참조 관계를 설정할 수 있다.

    @class_ref | instance_no
    class_ref:
         class_name
         class_id
    

    @ 다음에는 클래스명 또는 클래스 id를 명시하고, 수직바(|) 다음에는 인스턴스 번호를 명시한다. 수직바(|)의 양쪽에는 공백을 허용하지 않는다. class_ref의 작성 방법은 명령 라인schema_nameclass_name의 작성 방법과 동일하다. 하지만 schema_nameclass_name 각각을 대괄호([ ])로 묶는 것은 허용하지 않는다.

    다음은 paycheck 클래스에 인스턴스를 입력하는 예제이며, name 속성은 employee 클래스의 인스턴스를 참조한다. 마지막 라인과 같이 앞에서 정의되지 아니한 인스턴스 번호를 이용하여 참조 관계를 설정하는 경우 해당 데이터는 NULL 로 입력된다.

    %class [public].[paycheck] (name department salary)
    @[public.employee]|1   'planning'   8000000
    @[public.employee]|2   'planning'   6000000
    @[public.employee]|3   'sales'   5000000
    @[public.employee]|4   'development'   4000000
    @[public.employee]|5   'development'   5000000
    

    클래스에 식별자 부여에서 %id 명령어로 employee 클래스에 21이라는 식별자를 부여했으므로, 위의 예를 다음과 같이 작성할 수 있다.

    %class [public].[paycheck] (name department salary)
    @21|1   'planning'   8000000
    @21|2   'planning'   6000000
    @21|3   'sales'   5000000
    @21|4   'development'   4000000
    @21|5   'development'   5000000
    

데이터베이스 마이그레이션

신규 버전의 CUBRID 데이터베이스를 사용하기 위해서는 기존 버전의 CUBRID 데이터베이스를 신규 버전의 CUBRID 데이터베이스로 이전하는 작업을 진행해야 할 경우가 있다. 이때 CUBRID에서 제공하는 텍스트 파일로 내보내기와 텍스트 파일에서 가져오기 기능을 활용할 수 있다.

cubrid unloaddbcubrid loaddb 유틸리티를 이용하는 마이그레이션 절차를 설명한다.

권장 시나리오 및 절차

기존 버전의 CUBRID가 운영 중인 상태에서 적용할 수 있는 마이그레이션 시나리오를 설명한다. 데이터베이스 마이그레이션을 위해서는 cubrid unloaddbcubrid loaddb 유틸리티를 사용한다. 자세한 내용은 unloaddbloaddb 를 참조한다.

  1. 기존 CUBRID 서비스 종료

    cubrid service stop 을 실행하여 기존 CUBRID로 운영되는 모든 서비스 프로세스를 종료한 후, CUBRID 관련 프로세스들이 모두 정상 종료되었는지 확인한다.

    CUBRID 관련 프로세스들이 모두 정상 종료되었는지 확인하려면, Linux에서는 ps -ef|grep cub_를 실행한다. cub_로 시작하는 프로세스가 없으면 정상적으로 종료된 것이다. Windows에서는 <Ctrl + Alt + Delete> 키를 누른 후 [작업 관리자 시작]을 선택한다. [프로세스] 탭에 cub_로 시작하는 프로세스가 없으면 정상적으로 종료된 것이다. CUBRID 서비스 종료 후에도 관련 프로세스가 존재하면 Linux에서는 kill 명령으로 강제 종료한 후 ipcs -m 명령으로 CUBRID 브로커가 사용 중이던 공유 메모리를 확인하고 삭제한다. Windows에서는 작업 관리자의 [프로세스] 탭에서 해당 이미지 이름을 마우스 오른쪽 버튼으로 클릭하고 [프로세스 끝내기]를 선택하여 강제 종료한다.

  2. 기존 데이터베이스 백업

    cubrid backupdb 유틸리티를 이용하여 기존 버전의 데이터베이스 백업을 수행한다. 그 이유는 데이터베이스 언로드/로드 작업 중 발생 가능한 장애에 대비하기 위함이다. 데이터베이스 백업에 관한 자세한 내용은 backupdb를 참조한다.

  3. 기존 데이터베이스 언로드

    cubrid unloaddb 유틸리티를 이용하여 기존 버전의 CUBRID에서 생성된 데이터베이스를 언로드한다. 데이터베이스 언로드에 관한 자세한 내용은 unloaddb 를 참조한다.

  4. 기존 CUBRID의 환경 설정 파일 보관

    CUBRID/conf 디렉터리 아래의 cubrid.conf, cubrid_broker.conf, cm.conf 등의 환경 설정 파일을 보관한다. 이는 기존 CUBRID 데이터베이스 환경에 적용된 파라미터 설정값을 신규 CUBRID 데이터베이스 환경에서 편리하게 적용할 수 있기 때문이다.

  5. 신규 버전의 CUBRID 설치

    기존 버전의 CUBRID에서 생성된 데이터의 백업 및 언로드 작업이 완료되었으므로, 기존 버전의 CUBRID 및 데이터베이스를 삭제하고 신규 버전의 CUBRID를 설치한다. CUBRID 설치에 대한 자세한 내용은 시작하기을 참조한다.

  6. 신규 CUBRID의 환경 설정

    기존 CUBRID의 환경 설정 파일 보관하기 에서 보관한 기존 데이터베이스의 환경 설정 파일을 참고하여 신규 버전의 CUBRID 환경을 설정할 수 있다. 환경 설정에 대한 자세한 내용은 “CUBRID 시작”의 설치와 실행을 참조한다.

  7. 신규 데이터베이스 로드

    cubrid createdb 유틸리티를 이용하여 데이터베이스를 생성하고, cubrid loaddb 유틸리티를 이용하여 언로드한 데이터를 해당 데이터베이스에 로드한다. 데이터베이스 생성에 대한 자세한 내용은 “관리자 안내서”의 createdb 을 참조하고, 데이터베이스 로드에 대한 자세한 내용은 loaddb를 참조한다.

  8. 신규 데이터베이스 백업

    신규 데이터베이스에 데이터 로딩이 완료되면, cubrid backupdb 유틸리티를 이용하여 신규 버전의 CUBRID 환경에서 생성된 데이터베이스를 백업한다. 그 이유는 기존 버전의 CUBRID 환경에서 백업한 데이터를 신규 버전의 CUBRID 환경에서 복구할 수 없기 때문이다. 데이터베이스 백업에 대한 자세한 내용은 backupdb를 참고한다.

Warning

같은 버전이라 하더라도 백업 및 복구 시 32비트 데이터베이스 볼륨과 64비트 데이터베이스 볼륨 간에는 상호 호환을 보장하지 않는다. 따라서 32비트 CUBRID에서 백업한 데이터베이스를 64비트 CUBRID에서 복구하거나, 이와 반대로 작업하는 것을 권장하지 않는다.

Warning

CUBRID 11버전에서 TDE 기능을 사용할 경우 하위호환성을 제공하지 않아, 언로드된 파일로 더 낮은 버전에서 로드할 수 없다.

spacedb

cubrid spacedb 유틸리티는 사용 중인 데이터베이스 볼륨의 공간을 확인하기 위해서 사용된다. 이 도구에서는 옵션에 따라 데이터베이스 공간 사용에 대한 간략한 집계 정보나 사용 중인 모든 볼륨 및 파일에 대한 자세한 설명을 볼 수 있다. cubrid spacedb 유틸리티에서 반환되는 정보는 볼륨의 ID, 각 볼륨의 이름, 용도, 저장 공간의 총 합계 및 남은 저장 공간 등이다.

cubrid spacedb [options] database_name
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • spacedb: 대상 데이터베이스에 대한 공간을 확인하는 명령으로 데이터베이스 서버가 구동 정지 상태인 경우에만 정상적으로 수행된다.

  • database_name: 공간을 확인하고자 하는 데이터베이스의 이름이며, 데이터베이스가 생성될 디렉터리 경로명을 포함하지 않는다.

다음은 cubrid spacedb 에 대한 [options]이다.

-o FILE

데이터베이스의 공간 정보에 대한 결과를 지정한 파일에 저장한다.

cubrid spacedb -o db_output testdb
-S, --SA-mode

서버 프로세스를 구동하지 않고 데이터베이스에 접근하는 독립 모드(standalone)로 작업하기 위해 지정되며, 인수는 없다. -S 옵션을 지정하지 않으면, 시스템은 클라이언트/서버 모드로 인식한다.

cubrid spacedb --SA-mode testdb
-C, --CS-mode

-C 옵션은 서버 프로세스와 클라이언트 프로세스를 각각 구동하여 데이터베이스에 접근하는 클라이언트/서버 모드로 작업하기 위한 옵션이며, 인수는 없다. -C 옵션을 지정하지 않더라도 시스템은 기본적으로 클라이언트/서버 모드로 인식한다.

cubrid spacedb --CS-mode testdb
--size-unit={PAGE|M|G|T|H}

데이터베이스 볼륨의 공간을 지정한 크기 단위로 출력하기 위한 옵션이며, 기본값은 H 이다. 값을 H로 설정할 경우 단위는 다음과 같이 자동으로 지정된다. DB size < 1024 MB 보다 작을 경우 M는 MB 으로 , DB size < 1024 GB 보다 작을 경우 G는 GB 로 지정된다.

$ cubrid spacedb --size-unit=H testdb

Space description for database 'testdb' with pagesize 16.0K. (log pagesize: 16.0K)

type                purpose            volume_count        used_size           free_size            total_size
PERMANENT           PERMANENT DATA                2            61.0 M             963.0 M                1.0 G
PERMANENT           TEMPORARY DATA                1            12.0 M             500.0 M              512.0 M
TEMPORARY           TEMPORARY DATA                1            40.0 M              88.0 M              128.0 M
-                   -                             4           113.0 M               1.5 G                1.6 G

Space description for all volumes:
volid               type                purpose             used_size          free_size           total_size         volume_name
    0               PERMANENT           PERMANENT DATA         60.0 M             452.0 M              512.0 M         /home1/cubrid/testdb
    1               PERMANENT           PERMANENT DATA          1.0 M             511.0 M              512.0 M         /home1/cubrid/testdb_x001
    2               PERMANENT           TEMPORARY DATA         12.0 M             500.0 M              512.0 M         /home1/cubrid/testdb_x002
32766               TEMPORARY           TEMPORARY DATA         40.0 M              88.0 M              128.0 M         /home1/cubrid/testdb_t32766

LOB space description file:/home1/cubrid/lob
-s, --summarize

볼륨 타입 및 용도별로 볼륨 수, 사용된 크기, 남은 저장 공간 크기 및 총 저장 공간 크기를 집계한다. 볼륨에는 영구적 데이터를 사용하는 영구적 볼륨, 일시적 데이터를 사용하는 영구적 볼륨과 일시적 데이터를 사용하는 일시적 볼륨, 이 세 가지 종류가 있으며 영구적 데이터를 사용하는 일시적 볼륨은 없다. 마지막 행은 모든 볼륨 타입의 총 공간 값을 출력한다.

$ cubrid spacedb -s testdb

Space description for database 'testdb' with pagesize 16.0K. (log pagesize: 16.0K)

type                purpose            volume_count         used_size           free_size           total_size
PERMANENT           PERMANENT DATA                2            61.0 M             963.0 M                1.0 G
PERMANENT           TEMPORARY DATA                1            12.0 M             500.0 M              512.0 M
TEMPORARY           TEMPORARY DATA                1            40.0 M              88.0 M              128.0 M
-                   -                             4           113.0 M               1.5 G                1.6 G
-p, --purpose

저장된 데이터의 용도에 대한 자세한 정보를 출력한다. 이 정보에는 파일 수, 사용된 크기, 파일 테이블 크기, 예약된 섹터 크기 및 총 크기가 포함된다.

Space description for database 'testdb' with pagesize 16.0K. (log pagesize: 16.0K)

Detailed space description for files:
data_type           file_count           used_size          file_table_size     reserved_size       total_size
INDEX                       17               0.3 M                    0.3 M            16.5 M           17.0 M
HEAP                        28               7.6 M                    0.4 M            26.0 M           34.0 M
SYSTEM                       8               0.4 M                    0.1 M             7.5 M            8.0 M
TEMP                        10               0.0 M                    0.2 M            49.8 M           50.0 M
-                           63               8.2 M                    1.0 M            99.8 M          109.0 M

compactdb

cubrid compactdb 유틸리티는 데이터베이스 볼륨 중에 사용되지 않는 공간을 확보하기 위해서 사용된다. 데이터베이스 서버가 정지된 경우(offline)에는 독립 모드(stand-alone mode)로, 데이터베이스가 구동 중인 경우(online)에는 클라이언트 서버 모드(client-server mode)로 공간 정리 작업을 수행할 수 있다.

Note

cubrid compactdb 유틸리티는 삭제된 객체들의 OID와 클래스 변경에 의해 점유되고 있는 공간을 확보한다. 객체를 삭제하면 삭제된 객체를 참조하는 다른 객체가 있을 수 있기 때문에 삭제된 객체에 대한 OID는 바로 사용 가능한 빈 공간이 될 수 없다.

따라서 OID 재사용을 위해 테이블 생성 시에는 아래 예와 같이 REUSE_OID 옵션을 사용할 것을 권장한다.

CREATE TABLE tbl REUSE_OID
(
    id INT PRIMARY KEY,
    b VARCHAR
);

단, REUSE_OID 옵션을 사용한 테이블은 다른 테이블이 참조할 수 없다. 즉, 다른 테이블의 타입으로 사용될 수 없다.

CREATE TABLE reuse_tbl (a INT PRIMARY KEY) REUSE_OID;
CREATE TABLE tbl_1 ( a reuse_tbl);
ERROR: The class 'reuse_tbl' is marked as REUSE_OID and is non-referable. Non-referable classes can't be the domain of an attribute and their instances' OIDs cannot be returned.

REUSE_OID에 대한 자세한 설명은 REUSE_OID 를 참고한다.

cubrid compactdb 유틸리티를 수행하면 삭제된 객체에 대한 참조를 NULL 로 표시하는데, 이렇게 NULL 로 표시된 공간은 OID가 재사용할 수 있는 공간임을 의미한다.

cubrid compactdb [options] database_name [schema_name.class_name [{, schema_name.class_name}]]
  • cubrid: 큐브리드 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • compactdb: 대상 데이터베이스에 대하여 삭제된 데이터에 할당되었던 OID가 재사용될 수 있도록 공간을 정리하는 명령입니다.

  • database_name: 공간을 정리할 데이터베이스의 이름이며, 데이터베이스가 생성될 디렉터리 경로명을 포함하지 않는다.

  • class_name_list: 공간을 정리할 테이블 이름 리스트를 데이터베이스 이름 뒤에 직접 명시할 수 있으며, -i 옵션과 함께 사용할 수 없다. 테이블 이름에는 스키마 이름이 접두사로 붙어야 한다. 클라이언트/서버 모드에서 사용한 경우 catalog, delete files 그리고 tracker와 같은 객체에 대한 정리 작업을 수행하지 않는다.

클라이언트/서버 모드에서만 -I, -c, -d, -p 옵션을 사용할 수 있다.

다음은 cubrid compactdb에 대한 [options]이다.

-v, --verbose

어느 클래스가 현재 정리되고 있는지, 얼마나 많은 인스턴스가 그 클래스를 위하여 처리되었는지를 알리는 메시지를 화면에 출력할 수 있다.

cubrid compactdb -v testdb
-S, --SA-mode

데이터베이스 서버가 구동 중단된 상태에서 독립 모드(standalone)로 공간 정리 작업을 수행하기 위해 지정되며, 인수는 없다. -S 옵션을 지정하지 않으면, 시스템은 클라이언트/서버 모드로 인식한다.

cubrid compactdb --SA-mode testdb
-C, --CS-mode

-C 옵션은 데이터베이스 서버가 구동 중인 상태에서 클라이언트/서버 모드로 공간 정리 작업을 수행하기 위해 지정되며, 인수는 없다. -C 옵션이 생략되더라도 시스템은 기본적으로 클라이언트/서버 모드로 인식한다.

-i, --input-class-file=FILE

대상 테이블 이름을 포함하는 입력 파일 이름을 지정할 수 있다. 라인 당 하나의 테이블 이름을 명시하며, 유효하지 않은 테이블 이름은 무시된다. 테이블 이름에는 스키마 이름이 접두사로 붙어야 한다. 이 옵션을 지정하는 경우, 데이터베이스 이름 뒤에 대상 테이블 이름 리스트를 직접 명시할 수 없으므로 주의한다. 클라이언트/서버 모드에서 사용한 경우 catalog, delete files 그리고 tracker와 같은 객체에 대한 정리 작업을 수행하지 않는다.

다음은 클라이언트/서버 모드에서만 사용할 수 있는 옵션이다.

-p, --pages-commited-once=NUMBER

한 번에 커밋할 수 있는 최대 페이지 수를 지정한다. 기본값은 10 이며, 최소 값은 1, 최대 값은 10이다. 옵션 값이 작으면 클래스/인스턴스에 대한 잠금 비용이 작으므로 동시성은 향상될 수 있으나 작업 속도는 저하될 수 있고, 옵션 값이 크면 동시성은 저하되나 작업 속도는 향상될 수 있다.

cubrid compactdb --CS-mode -p 10 testdb public.tbl1, public.tbl2, public.tbl5
-d, --delete-old-repr

카탈로그에서 과거 테이블 표현(스키마 구조)을 삭제할 수 있다. ALTER 문에 의해 칼럼이 추가되거나 삭제되는 경우 기존의 레코드에 대해 과거의 스키마를 참조하고 있는 상태로 두면, 스키마를 업데이트하는 비용을 들이지 않기 때문에 평소에는 과거의 테이블 표현을 유지하는 것이 좋다.

-I, --Instance-lock-timeout=NUMBER

인스턴스 잠금 타임아웃 값을 지정할 수 있다. 기본값은 2 (초)이며, 최소 값은 1, 최대 값은 10이다. 설정된 시간동안 잠금 인스턴스를 대기하므로, 옵션 값이 작을수록 작업 속도는 향상될 수 있으나 처리 가능한 인스턴스 개수가 적어진다. 반면, 옵션 값이 클수록 작업 속도는 저하되나 더 많은 인스턴스에 대해 작업을 수행할 수 있다.

-c, --class-lock-timeout=NUMBER

클래스 잠금 타임아웃 값을 지정할 수 있다. 기본값은 10 (초)이며, 최소값은 1, 최대 값은 10이다. 설정된 시간동안 잠금 테이블을 대기하므로, 옵션 값이 작을수록 작업 속도는 향상될 수 있으나 처리 가능한 테이블 개수가 적어진다. 반면, 옵션 값이 클수록 작업 속도는 저하되나 더 많은 테이블에 대해 작업을 수행할 수 있다.

optimizedb

CUBRID의 질의 최적화기가 사용하는 테이블에 있는 객체들의 수, 접근하는 페이지들의 수, 속성 값들의 분산 같은 통계 정보를 갱신한다.

cubrid optimizedb [<option>] database_name
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • optimizedb: 대상 데이터베이스에 대하여 비용 기반 질의 최적화에 사용되는 통계 정보를 업데이트한다. 옵션을 지정하는 경우, 지정한 클래스에 대해서만 업데이트한다.

  • database_name: 비용기반 질의 최적화용 통계 자료를 업데이트하려는 데이터베이스 이름이다.

다음은 cubrid optimizedb에 대한 <option>이다.

-n, --class-name

-n 옵션을 이용하여 해당 클래스의 질의 통계 정보를 업데이트하는 명령이다. 테이블 이름에는 스키마 이름이 접두사로 붙어야 한다.

cubrid optimizedb -n public.event_table testdb

다음은 대상 데이터베이스의 전체 클래스의 질의 통계 정보를 업데이트하는 명령이다.

cubrid optimizedb testdb

plandump

cubrid plandump 유틸리티를 사용해서 서버에 저장(캐시)되어 있는 질의 수행 계획들의 정보를 출력할 수 있다.

cubrid plandump [options] database_name
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • plandump: 대상 데이터베이스에 대하여 현재 캐시에 저장되어 있는 질의 수행 계획을 출력하는 명령이다.

  • database_name: 데이터베이스 서버 캐시로부터 질의 수행 계획을 확인 또는 제거하고자 하는 데이터베이스 이름이다

옵션 없이 사용하면 캐시에 저장된 질의 수행 계획을 확인한다.

cubrid plandump testdb

다음은 cubrid plandump 에 대한 [options]이다.

-d, --drop

캐시에 저장된 질의 수행 계획을 제거한다.

cubrid plandump -d testdb
-o, --output-file=FILE

캐시에 저장된 질의 수행 계획 결과 파일에 저장

cubrid plandump -o output.txt testdb

statdump

cubrid statdump 유틸리티를 이용해 CUBRID 데이터베이스 서버가 실행한 통계 정보를 확인할 수 있으며, 통계 정보 항목은 크게 File I/O 관련, 페이지 버퍼 관련, 로그 관련, 트랜잭션 관련, 동시성 관련, 인덱스 관련, 쿼리 수행 관련, 네트워크 요청 관련으로 구분된다.

CSQL의 해당 연결에 대해서만 통계 정보를 확인하려면 CSQL의 세션 명령어를 이용할 수 있으며 CSQL 실행 통계 정보 출력 를 참고한다.

cubrid statdump [options] database_name
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • statdump: 데이터베이스 서버 수행 시 통계 정보를 출력하는 명령어이다.

  • database_name: 통계 자료를 확인하고자 하는 대상 데이터베이스 이름이다.

다음은 cubrid statdump 에 대한 [options]이다.

-i, --interval=SECOND

지정한 초 단위로 주기적으로 출력한다. -i 옵션이 주어질 때만 정보가 갱신된다.

다음은 1초마다 누적된 정보 값을 출력한다.

cubrid statdump -i 1 -c demodb

다음은 1초 마다 0으로 리셋하고 1초 동안 누적된 값을 출력한다.

cubrid statdump -i 1 demodb

다음은 -i 옵션으로 가장 마지막에 실행한 값을 출력한다.

cubrid statdump demodb

다음은 위와 같은 결과를 출력한다. -c 옵션은 -i 옵션과 같이 쓰이지 않으면 옵션을 설정하지 않은 것과 동일하다.

cubrid statdump -c demodb

다음은 5초마다 결과를 출력한다.

$ cubrid statdump -i 5 -c testdb

Mon November 11 23:44:36 KST 2019

 *** SERVER EXECUTION STATISTICS ***
Num_file_creates              =          0
Num_file_removes              =          0
Num_file_ioreads              =          0
Num_file_iowrites             =          3
Num_file_iosynches            =          3
The timer values for file_iosync_all are:
Num_file_iosync_all           =          0
Total_time_file_iosync_all    =          0
Max_time_file_iosync_all      =          0
Avg_time_file_iosync_all      =          0
Num_file_page_allocs          =          0
Num_file_page_deallocs        =          0
Num_data_page_fetches         =          0
Num_data_page_dirties         =          0
Num_data_page_ioreads         =          0
Num_data_page_iowrites        =          0
Num_data_page_flushed         =          0
Num_data_page_private_quota   =      11327
Num_data_page_private_count   =          0
Num_data_page_fixed           =          1
Num_data_page_dirty           =          0
Num_data_page_lru1            =         18
Num_data_page_lru2            =         10
Num_data_page_lru3            =          0
Num_data_page_victim_candidate =          0
Num_log_page_fetches          =          0
Num_log_page_ioreads          =          0
Num_log_page_iowrites         =          6
Num_log_append_records        =          9
Num_log_archives              =          0
Num_log_start_checkpoints     =          0
Num_log_end_checkpoints       =          0
Num_log_wals                  =          0
Num_log_page_iowrites_for_replacement =          0
Num_log_page_replacements     =          0
Num_page_locks_acquired       =          0
Num_object_locks_acquired     =          0
Num_page_locks_converted      =          0
Num_object_locks_converted    =          0
Num_page_locks_re-requested   =          0
Num_object_locks_re-requested =          0
Num_page_locks_waits          =          0
Num_object_locks_waits        =          0
Num_object_locks_time_waited_usec =          0
Num_tran_commits              =          0
Num_tran_rollbacks            =          0
Num_tran_savepoints           =          0
Num_tran_start_topops         =          0
Num_tran_end_topops           =          0
Num_tran_interrupts           =          0
Num_btree_inserts             =          0
Num_btree_deletes             =          0
Num_btree_updates             =          0
Num_btree_covered             =          0
Num_btree_noncovered          =          0
Num_btree_resumes             =          0
Num_btree_multirange_optimization =          0
Num_btree_splits              =          0
Num_btree_merges              =          0
Num_btree_get_stats           =          0
Num_btree_online_inserts      =          0
Num_btree_online_inserts_same_page_hold =          0
Num_btree_online_inserts_reject_no_more_keys =          0
Num_btree_online_inserts_reject_max_key_len =          0
Num_btree_online_inserts_reject_no_space =          0
Num_btree_online_release_latch =          0
Num_btree_online_inserts_reject_key_not_in_range1 =          0
Num_btree_online_inserts_reject_key_not_in_range2 =          0
Num_btree_online_inserts_reject_key_not_in_range3 =          0
Num_btree_online_inserts_reject_key_not_in_range4 =          0
Num_btree_online_inserts_reject_key_false_failed_range1 =          0
Num_btree_online_inserts_reject_key_false_failed_range2 =          0
The timer values for btree_online are:
Num_btree_online              =          0
Total_time_btree_online       =          0
Max_time_btree_online         =          0
Avg_time_btree_online         =          0
The timer values for btree_online_insert_task are:
Num_btree_online_insert_task  =          0
Total_time_btree_online_insert_task =          0
Max_time_btree_online_insert_task =          0
Avg_time_btree_online_insert_task =          0
The timer values for btree_online_prepare_task are:
Num_btree_online_prepare_task =          0
Total_time_btree_online_prepare_task =          0
Max_time_btree_online_prepare_task =          0
Avg_time_btree_online_prepare_task =          0
The timer values for btree_online_insert_same_leaf are:
Num_btree_online_insert_same_leaf =          0
Total_time_btree_online_insert_same_leaf =          0
Max_time_btree_online_insert_same_leaf =          0
Avg_time_btree_online_insert_same_leaf =          0
Num_query_selects             =          0
Num_query_inserts             =          0
Num_query_deletes             =          0
Num_query_updates             =          0
Num_query_sscans              =          0
Num_query_iscans              =          0
Num_query_lscans              =          0
Num_query_setscans            =          0
Num_query_methscans           =          0
Num_query_nljoins             =          0
Num_query_mjoins              =          0
Num_query_objfetches          =          0
Num_query_holdable_cursors    =          0
Num_sort_io_pages             =          0
Num_sort_data_pages           =          0
Num_network_requests          =          3
Num_adaptive_flush_pages      =          0
Num_adaptive_flush_log_pages  =          0
Num_adaptive_flush_max_pages  =      14464
Num_prior_lsa_list_size       =          0
Num_prior_lsa_list_maxed      =          0
Num_prior_lsa_list_removed    =          3
Time_ha_replication_delay     =          0
Num_plan_cache_add            =          0
Num_plan_cache_lookup         =          0
Num_plan_cache_hit            =          0
Num_plan_cache_miss           =          0
Num_plan_cache_full           =          0
Num_plan_cache_delete         =          0
Num_plan_cache_invalid_xasl_id =          0
Num_plan_cache_entries        =          0
Num_vacuum_log_pages_vacuumed =          0
Num_vacuum_log_pages_to_vacuum =          0
Num_vacuum_prefetch_requests_log_pages =          0
Num_vacuum_prefetch_hits_log_pages =          0
Num_heap_home_inserts         =          0
Num_heap_big_inserts          =          0
Num_heap_assign_inserts       =          0
Num_heap_home_deletes         =          0
Num_heap_home_mvcc_deletes    =          0
Num_heap_home_to_rel_deletes  =          0
Num_heap_home_to_big_deletes  =          0
Num_heap_rel_deletes          =          0
Num_heap_rel_mvcc_deletes     =          0
Num_heap_rel_to_home_deletes  =          0
Num_heap_rel_to_big_deletes   =          0
Num_heap_rel_to_rel_deletes   =          0
Num_heap_big_deletes          =          0
Num_heap_big_mvcc_deletes     =          0
Num_heap_home_updates         =          0
Num_heap_home_to_rel_updates  =          0
Num_heap_home_to_big_updates  =          0
Num_heap_rel_updates          =          0
Num_heap_rel_to_home_updates  =          0
Num_heap_rel_to_rel_updates   =          0
Num_heap_rel_to_big_updates   =          0
Num_heap_big_updates          =          0
Num_heap_home_vacuums         =          0
Num_heap_big_vacuums          =          0
Num_heap_rel_vacuums          =          0
Num_heap_insid_vacuums        =          0
Num_heap_remove_vacuums       =          0
The timer values for heap_insert_prepare are:
Num_heap_insert_prepare       =          0
Total_time_heap_insert_prepare =          0
Max_time_heap_insert_prepare  =          0
Avg_time_heap_insert_prepare  =          0
The timer values for heap_insert_execute are:
Num_heap_insert_execute       =          0
Total_time_heap_insert_execute =          0
Max_time_heap_insert_execute  =          0
Avg_time_heap_insert_execute  =          0
The timer values for heap_insert_log are:
Num_heap_insert_log           =          0
Total_time_heap_insert_log    =          0
Max_time_heap_insert_log      =          0
Avg_time_heap_insert_log      =          0
The timer values for heap_delete_prepare are:
Num_heap_delete_prepare       =          0
Total_time_heap_delete_prepare =          0
Max_time_heap_delete_prepare  =          0
Avg_time_heap_delete_prepare  =          0
The timer values for heap_delete_execute are:
Num_heap_delete_execute       =          0
Total_time_heap_delete_execute =          0
Max_time_heap_delete_execute  =          0
Avg_time_heap_delete_execute  =          0
The timer values for heap_delete_log are:
Num_heap_delete_log           =          0
Total_time_heap_delete_log    =          0
Max_time_heap_delete_log      =          0
Avg_time_heap_delete_log      =          0
The timer values for heap_update_prepare are:
Num_heap_update_prepare       =          0
Total_time_heap_update_prepare =          0
Max_time_heap_update_prepare  =          0
Avg_time_heap_update_prepare  =          0
The timer values for heap_update_execute are:
Num_heap_update_execute       =          0
Total_time_heap_update_execute =          0
Max_time_heap_update_execute  =          0
Avg_time_heap_update_execute  =          0
The timer values for heap_update_log are:
Num_heap_update_log           =          0
Total_time_heap_update_log    =          0
Max_time_heap_update_log      =          0
Avg_time_heap_update_log      =          0
The timer values for heap_vacuum_prepare are:
Num_heap_vacuum_prepare       =          0
Total_time_heap_vacuum_prepare =          0
Max_time_heap_vacuum_prepare  =          0
Avg_time_heap_vacuum_prepare  =          0
The timer values for heap_vacuum_execute are:
Num_heap_vacuum_execute       =          0
Total_time_heap_vacuum_execute =          0
Max_time_heap_vacuum_execute  =          0
Avg_time_heap_vacuum_execute  =          0
The timer values for heap_vacuum_log are:
Num_heap_vacuum_log           =          0
Total_time_heap_vacuum_log    =          0
Max_time_heap_vacuum_log      =          0
Avg_time_heap_vacuum_log      =          0
The timer values for heap_stats_sync_bestspace are:
Num_heap_stats_sync_bestspace =          0
Total_time_heap_stats_sync_bestspace =          0
Max_time_heap_stats_sync_bestspace =          0
Avg_time_heap_stats_sync_bestspace =          0
Num_heap_stats_bestspace_entries =          0
Num_heap_stats_bestspace_maxed =          0
The timer values for bestspace_add are:
Num_bestspace_add             =          0
Total_time_bestspace_add      =          0
Max_time_bestspace_add        =          0
Avg_time_bestspace_add        =          0
The timer values for bestspace_del are:
Num_bestspace_del             =          0
Total_time_bestspace_del      =          0
Max_time_bestspace_del        =          0
Avg_time_bestspace_del        =          0
The timer values for bestspace_find are:
Num_bestspace_find            =          0
Total_time_bestspace_find     =          0
Max_time_bestspace_find       =          0
Avg_time_bestspace_find       =          0
The timer values for heap_find_page_bestspace are:
Num_heap_find_page_bestspace  =          0
Total_time_heap_find_page_bestspace =          0
Max_time_heap_find_page_bestspace =          0
Avg_time_heap_find_page_bestspace =          0
The timer values for heap_find_best_page are:
Num_heap_find_best_page       =          0
Total_time_heap_find_best_page =          0
Max_time_heap_find_best_page  =          0
Avg_time_heap_find_best_page  =          0
The timer values for bt_fix_ovf_oids are:
Num_bt_fix_ovf_oids           =          0
Total_time_bt_fix_ovf_oids    =          0
Max_time_bt_fix_ovf_oids      =          0
Avg_time_bt_fix_ovf_oids      =          0
The timer values for bt_unique_rlocks are:
Num_bt_unique_rlocks          =          0
Total_time_bt_unique_rlocks   =          0
Max_time_bt_unique_rlocks     =          0
Avg_time_bt_unique_rlocks     =          0
The timer values for bt_unique_wlocks are:
Num_bt_unique_wlocks          =          0
Total_time_bt_unique_wlocks   =          0
Max_time_bt_unique_wlocks     =          0
Avg_time_bt_unique_wlocks     =          0
The timer values for bt_leaf are:
Num_bt_leaf                   =          0
Total_time_bt_leaf            =          0
Max_time_bt_leaf              =          0
Avg_time_bt_leaf              =          0
The timer values for bt_traverse are:
Num_bt_traverse               =          0
Total_time_bt_traverse        =          0
Max_time_bt_traverse          =          0
Avg_time_bt_traverse          =          0
The timer values for bt_find_unique are:
Num_bt_find_unique            =          0
Total_time_bt_find_unique     =          0
Max_time_bt_find_unique       =          0
Avg_time_bt_find_unique       =          0
The timer values for bt_find_unique_traverse are:
Num_bt_find_unique_traverse   =          0
Total_time_bt_find_unique_traverse =          0
Max_time_bt_find_unique_traverse =          0
Avg_time_bt_find_unique_traverse =          0
The timer values for bt_range_search are:
Num_bt_range_search           =          0
Total_time_bt_range_search    =          0
Max_time_bt_range_search      =          0
Avg_time_bt_range_search      =          0
The timer values for bt_range_search_traverse are:
Num_bt_range_search_traverse  =          0
Total_time_bt_range_search_traverse =          0
Max_time_bt_range_search_traverse =          0
Avg_time_bt_range_search_traverse =          0
The timer values for bt_insert are:
Num_bt_insert                 =          0
Total_time_bt_insert          =          0
Max_time_bt_insert            =          0
Avg_time_bt_insert            =          0
The timer values for bt_insert_traverse are:
Num_bt_insert_traverse        =          0
Total_time_bt_insert_traverse =          0
Max_time_bt_insert_traverse   =          0
Avg_time_bt_insert_traverse   =          0
The timer values for bt_delete_obj are:
Num_bt_delete_obj             =          0
Total_time_bt_delete_obj      =          0
Max_time_bt_delete_obj        =          0
Avg_time_bt_delete_obj        =          0
The timer values for bt_delete_obj_traverse are:
Num_bt_delete_obj_traverse    =          0
Total_time_bt_delete_obj_traverse =          0
Max_time_bt_delete_obj_traverse =          0
Avg_time_bt_delete_obj_traverse =          0
The timer values for bt_mvcc_delete are:
Num_bt_mvcc_delete            =          0
Total_time_bt_mvcc_delete     =          0
Max_time_bt_mvcc_delete       =          0
Avg_time_bt_mvcc_delete       =          0
The timer values for bt_mvcc_delete_traverse are:
Num_bt_mvcc_delete_traverse   =          0
Total_time_bt_mvcc_delete_traverse =          0
Max_time_bt_mvcc_delete_traverse =          0
Avg_time_bt_mvcc_delete_traverse =          0
The timer values for bt_mark_delete are:
Num_bt_mark_delete            =          0
Total_time_bt_mark_delete     =          0
Max_time_bt_mark_delete       =          0
Avg_time_bt_mark_delete       =          0
The timer values for bt_mark_delete_traverse are:
Num_bt_mark_delete_traverse   =          0
Total_time_bt_mark_delete_traverse =          0
Max_time_bt_mark_delete_traverse =          0
Avg_time_bt_mark_delete_traverse =          0
The timer values for bt_undo_insert are:
Num_bt_undo_insert            =          0
Total_time_bt_undo_insert     =          0
Max_time_bt_undo_insert       =          0
Avg_time_bt_undo_insert       =          0
The timer values for bt_undo_insert_traverse are:
Num_bt_undo_insert_traverse   =          0
Total_time_bt_undo_insert_traverse =          0
Max_time_bt_undo_insert_traverse =          0
Avg_time_bt_undo_insert_traverse =          0
The timer values for bt_undo_delete are:
Num_bt_undo_delete            =          0
Total_time_bt_undo_delete     =          0
Max_time_bt_undo_delete       =          0
Avg_time_bt_undo_delete       =          0
The timer values for bt_undo_delete_traverse are:
Num_bt_undo_delete_traverse   =          0
Total_time_bt_undo_delete_traverse =          0
Max_time_bt_undo_delete_traverse =          0
Avg_time_bt_undo_delete_traverse =          0
The timer values for bt_undo_mvcc_delete are:
Num_bt_undo_mvcc_delete       =          0
Total_time_bt_undo_mvcc_delete =          0
Max_time_bt_undo_mvcc_delete  =          0
Avg_time_bt_undo_mvcc_delete  =          0
The timer values for bt_undo_mvcc_delete_traverse are:
Num_bt_undo_mvcc_delete_traverse =          0
Total_time_bt_undo_mvcc_delete_traverse =          0
Max_time_bt_undo_mvcc_delete_traverse =          0
Avg_time_bt_undo_mvcc_delete_traverse =          0
The timer values for bt_vacuum are:
Num_bt_vacuum                 =          0
Total_time_bt_vacuum          =          0
Max_time_bt_vacuum            =          0
Avg_time_bt_vacuum            =          0
The timer values for bt_vacuum_traverse are:
Num_bt_vacuum_traverse        =          0
Total_time_bt_vacuum_traverse =          0
Max_time_bt_vacuum_traverse   =          0
Avg_time_bt_vacuum_traverse   =          0
The timer values for bt_vacuum_insid are:
Num_bt_vacuum_insid           =          0
Total_time_bt_vacuum_insid    =          0
Max_time_bt_vacuum_insid      =          0
Avg_time_bt_vacuum_insid      =          0
The timer values for bt_vacuum_insid_traverse are:
Num_bt_vacuum_insid_traverse  =          0
Total_time_bt_vacuum_insid_traverse =          0
Max_time_bt_vacuum_insid_traverse =          0
Avg_time_bt_vacuum_insid_traverse =          0
The timer values for vacuum_master are:
Num_vacuum_master             =        561
Total_time_vacuum_master      =       1259
Max_time_vacuum_master        =          6
Avg_time_vacuum_master        =          2
The timer values for vacuum_job are:
Num_vacuum_job                =          0
Total_time_vacuum_job         =          0
Max_time_vacuum_job           =          0
Avg_time_vacuum_job           =          0
The timer values for vacuum_worker_process_log are:
Num_vacuum_worker_process_log =          0
Total_time_vacuum_worker_process_log =          0
Max_time_vacuum_worker_process_log =          0
Avg_time_vacuum_worker_process_log =          0
The timer values for vacuum_worker_execute are:
Num_vacuum_worker_execute     =          0
Total_time_vacuum_worker_execute =          0
Max_time_vacuum_worker_execute =          0
Avg_time_vacuum_worker_execute =          0
Time_get_snapshot_acquire_time =          0
Count_get_snapshot_retry      =          0
Time_tran_complete_time       =          0
The timer values for compute_oldest_visible are:
Num_compute_oldest_visible    =        561
Total_time_compute_oldest_visible =        569
Max_time_compute_oldest_visible =          4
Avg_time_compute_oldest_visible =          1
Count_get_oldest_mvcc_retry   =          0
Data_page_buffer_hit_ratio    =       0.00
Log_page_buffer_hit_ratio     =       0.00
Vacuum_data_page_buffer_hit_ratio =       0.00
Vacuum_page_efficiency_ratio  =       0.00
Vacuum_page_fetch_ratio       =       0.00
Data_page_fix_lock_acquire_time_msec =       0.00
Data_page_fix_hold_acquire_time_msec =       0.00
Data_page_fix_acquire_time_msec =       0.00
Data_page_allocate_time_ratio =       0.00
Data_page_total_promote_success =       0.00
Data_page_total_promote_fail  =       0.00
Data_page_total_promote_time_msec =       0.00
Num_unfix_void_to_private_top =          0
Num_unfix_void_to_private_mid =          0
Num_unfix_void_to_shared_mid  =          0
Num_unfix_lru1_private_to_shared_mid =          0
Num_unfix_lru2_private_to_shared_mid =          0
Num_unfix_lru3_private_to_shared_mid =          0
Num_unfix_lru2_private_keep   =          0
Num_unfix_lru2_shared_keep    =          0
Num_unfix_lru2_private_to_top =          0
Num_unfix_lru2_shared_to_top  =          0
Num_unfix_lru3_private_to_top =          0
Num_unfix_lru3_shared_to_top  =          0
Num_unfix_lru1_private_keep   =          0
Num_unfix_lru1_shared_keep    =          0
Num_unfix_void_to_private_mid_vacuum =          0
Num_unfix_lru1_any_keep_vacuum =          0
Num_unfix_lru2_any_keep_vacuum =          0
Num_unfix_lru3_any_keep_vacuum =          0
Num_unfix_void_aout_found     =          0
Num_unfix_void_aout_not_found =          0
Num_unfix_void_aout_found_vacuum =          0
Num_unfix_void_aout_not_found_vacuum =          0
Num_data_page_hash_anchor_waits =          0
Time_data_page_hash_anchor_wait =          0
The timer values for flush_collect are:
Num_flush_collect             =          0
Total_time_flush_collect      =          0
Max_time_flush_collect        =          0
Avg_time_flush_collect        =          0
The timer values for flush_flush are:
Num_flush_flush               =          0
Total_time_flush_flush        =          0
Max_time_flush_flush          =          0
Avg_time_flush_flush          =          0
The timer values for flush_sleep are:
Num_flush_sleep               =          4
Total_time_flush_sleep        =    4000307
Max_time_flush_sleep          =    1000077
Avg_time_flush_sleep          =    1000076
The timer values for flush_collect_per_page are:
Num_flush_collect_per_page    =          0
Total_time_flush_collect_per_page =          0
Max_time_flush_collect_per_page =          0
Avg_time_flush_collect_per_page =          0
The timer values for flush_flush_per_page are:
Num_flush_flush_per_page      =          0
Total_time_flush_flush_per_page =          0
Max_time_flush_flush_per_page =          0
Avg_time_flush_flush_per_page =          0
Num_data_page_writes          =          0
Num_data_page_dirty_to_post_flush =          0
Num_data_page_skipped_flush   =          0
Num_data_page_skipped_flush_need_wal =          0
Num_data_page_skipped_flush_already_flushed =          0
Num_data_page_skipped_flush_fixed_or_hot =          0
The timer values for compensate_flush are:
Num_compensate_flush          =          0
Total_time_compensate_flush   =          0
Max_time_compensate_flush     =          0
Avg_time_compensate_flush     =          0
The timer values for assign_direct_bcb are:
Num_assign_direct_bcb         =          0
Total_time_assign_direct_bcb  =          0
Max_time_assign_direct_bcb    =          0
Avg_time_assign_direct_bcb    =          0
The timer values for wake_flush_waiter are:
Num_wake_flush_waiter         =          0
Total_time_wake_flush_waiter  =          0
Max_time_wake_flush_waiter    =          0
Avg_time_wake_flush_waiter    =          0
The timer values for alloc_bcb are:
Num_alloc_bcb                 =          0
Total_time_alloc_bcb          =          0
Max_time_alloc_bcb            =          0
Avg_time_alloc_bcb            =          0
The timer values for alloc_bcb_search_victim are:
Num_alloc_bcb_search_victim   =          0
Total_time_alloc_bcb_search_victim =          0
Max_time_alloc_bcb_search_victim =          0
Avg_time_alloc_bcb_search_victim =          0
The timer values for alloc_bcb_cond_wait_high_prio are:
Num_alloc_bcb_cond_wait_high_prio =          0
Total_time_alloc_bcb_cond_wait_high_prio =          0
Max_time_alloc_bcb_cond_wait_high_prio =          0
Avg_time_alloc_bcb_cond_wait_high_prio =          0
The timer values for alloc_bcb_cond_wait_low_prio are:
Num_alloc_bcb_cond_wait_low_prio =          0
Total_time_alloc_bcb_cond_wait_low_prio =          0
Max_time_alloc_bcb_cond_wait_low_prio =          0
Avg_time_alloc_bcb_cond_wait_low_prio =          0
Num_alloc_bcb_prioritize_vacuum =          0
Num_victim_use_invalid_bcb    =          0
The timer values for alloc_bcb_get_victim_search_own_private_list are:
Num_alloc_bcb_get_victim_search_own_private_list =          0
Total_time_alloc_bcb_get_victim_search_own_private_list =          0
Max_time_alloc_bcb_get_victim_search_own_private_list =          0
Avg_time_alloc_bcb_get_victim_search_own_private_list =          0
The timer values for alloc_bcb_get_victim_search_others_private_list are:
Num_alloc_bcb_get_victim_search_others_private_list =          0
Total_time_alloc_bcb_get_victim_search_others_private_list =          0
Max_time_alloc_bcb_get_victim_search_others_private_list =          0
Avg_time_alloc_bcb_get_victim_search_others_private_list =          0
The timer values for alloc_bcb_get_victim_search_shared_list are:
Num_alloc_bcb_get_victim_search_shared_list =          0
Total_time_alloc_bcb_get_victim_search_shared_list =          0
Max_time_alloc_bcb_get_victim_search_shared_list =          0
Avg_time_alloc_bcb_get_victim_search_shared_list =          0
Num_victim_assign_direct_vacuum_void =          0
Num_victim_assign_direct_vacuum_lru =          0
Num_victim_assign_direct_flush =          0
Num_victim_assign_direct_panic =          0
Num_victim_assign_direct_adjust_lru =          0
Num_victim_assign_direct_adjust_lru_to_vacuum =          0
Num_victim_assign_direct_search_for_flush =          0
Num_victim_shared_lru_success =          0
Num_victim_own_private_lru_success =          0
Num_victim_other_private_lru_success =          0
Num_victim_shared_lru_fail    =          0
Num_victim_own_private_lru_fail =          0
Num_victim_other_private_lru_fail =          0
Num_victim_all_lru_fail       =          0
Num_victim_get_from_lru       =          0
Num_victim_get_from_lru_was_empty =          0
Num_victim_get_from_lru_fail  =          0
Num_victim_get_from_lru_bad_hint =          0
Num_lfcq_prv_get_total_calls  =          0
Num_lfcq_prv_get_empty        =          0
Num_lfcq_prv_get_big          =          0
Num_lfcq_shr_get_total_calls  =          0
Num_lfcq_shr_get_empty        =          0
The timer values for Time_DWB_flush_block_time are:
Num_Time_DWB_flush_block_time =          0
Total_time_Time_DWB_flush_block_time =          0
Max_time_Time_DWB_flush_block_time =          0
Avg_time_Time_DWB_flush_block_time =          0
The timer values for Time_DWB_flush_block_helper_time are:
Num_Time_DWB_flush_block_helper_time =          0
Total_time_Time_DWB_flush_block_helper_time =          0
Max_time_Time_DWB_flush_block_helper_time =          0
Avg_time_Time_DWB_flush_block_helper_time =          0
The timer values for Time_DWB_flush_block_cond_wait_time are:
Num_Time_DWB_flush_block_cond_wait_time =       5352
Total_time_Time_DWB_flush_block_cond_wait_time =    5629578
Max_time_Time_DWB_flush_block_cond_wait_time =       1059
Avg_time_Time_DWB_flush_block_cond_wait_time =       1051
The timer values for Time_DWB_flush_block_sort_time are:
Num_Time_DWB_flush_block_sort_time =          0
Total_time_Time_DWB_flush_block_sort_time =          0
Max_time_Time_DWB_flush_block_sort_time =          0
Avg_time_Time_DWB_flush_block_sort_time =          0
The timer values for Time_DWB_flush_remove_hash_entries are:
Num_Time_DWB_flush_remove_hash_entries =          0
Total_time_Time_DWB_flush_remove_hash_entries =          0
Max_time_Time_DWB_flush_remove_hash_entries =          0
Avg_time_Time_DWB_flush_remove_hash_entries =          0
The timer values for Time_DWB_checksum_time are:
Num_Time_DWB_checksum_time    =          0
Total_time_Time_DWB_checksum_time =          0
Max_time_Time_DWB_checksum_time =          0
Avg_time_Time_DWB_checksum_time =          0
The timer values for Time_DWB_wait_flush_block_time are:
Num_Time_DWB_wait_flush_block_time =          0
Total_time_Time_DWB_wait_flush_block_time =          0
Max_time_Time_DWB_wait_flush_block_time =          0
Avg_time_Time_DWB_wait_flush_block_time =          0
The timer values for Time_DWB_wait_flush_block_helper_time are:
Num_Time_DWB_wait_flush_block_helper_time =          0
Total_time_Time_DWB_wait_flush_block_helper_time =          0
Max_time_Time_DWB_wait_flush_block_helper_time =          0
Avg_time_Time_DWB_wait_flush_block_helper_time =          0
The timer values for Time_DWB_flush_force_time are:
Num_Time_DWB_flush_force_time =          0
Total_time_Time_DWB_flush_force_time =          0
Max_time_Time_DWB_flush_force_time =          0
Avg_time_Time_DWB_flush_force_time =          0
Num_alloc_bcb_wait_threads_high_priority =          0
Num_alloc_bcb_wait_threads_low_priority =          0
Num_flushed_bcbs_wait_for_direct_victim =          0
Num_lfcq_big_private_lists    =          0
Num_lfcq_private_lists        =          0
Num_lfcq_shared_lists         =          0
Num_data_page_avoid_dealloc   =          0
Num_data_page_avoid_victim    =          0
Num_data_page_fix_ext:
Num_data_page_promote_ext:
Num_data_page_promote_time_ext:
Num_data_page_unfix_ext:
Time_data_page_lock_acquire_time:
Time_data_page_hold_acquire_time:
Time_data_page_fix_acquire_time:
Num_mvcc_snapshot_ext:
Time_obj_lock_acquire_time:
Thread_stats_counters_timers:
Thread_pgbuf_daemon_stats_counters_timers:
Num_dwb_flushed_block_volumes:
Thread_loaddb_stats_counters_timers:

다음은 위의 통계 정보에 대한 설명이다. 통계 카테고리 (데이터베이스 모듈), 이름, 통계 유형 및 각 통계에 대한 간략한 설명을 볼 수 있다.

수집 방법에 따라 몇 가지 통계 유형이 있다. :

  • Accumulator: 트래킹이 발생할 때마다 통계치가 누적된다.

  • Counter/timer: 동작(action)별 횟수와 지속 시간에 대한 통계 뿐만 아니라 최대 및 평균 지속 시간에 대한 통계치를 산출한다.

  • Snapshot: 통계는 데이터베이스의 내부 정보이다.

  • Complex: 통계는 다양한 속성별로 산출된 복합 통계치이다.

대부분 통계치는 누적이 되는 Accumulator 유형이다. 이 외에도 동작 횟수와 동작 지속 시간이 반영된 Counter/timer 유형, 데이터베이스에서 수집된 Snapshot 유형 및 다른 값을 기반으로 계산된 Computed 유형과 일부 동작에 대한 자세한 정보를 반영하는 복합(Complex) 유형이다.

File I/O

항목

통계 타입

설명

Num_file_removes

Accumulator

삭제한 파일 개수

Num_file_creates

Accumulator

생성한 파일 개수

Num_file_ioreads

Accumulator

디스크로부터 읽을 횟수

Num_file_iowrites

Accumulator

디스크로 저장한 횟수

Num_file_iosynches

Accumulator

디스크와 동기화를 수행한 횟수

..file_iosync_all

Counter/timer

모든 파일을 동기화한 횟수와 시간

Num_file_page_allocs

Accumulator

할당한 페이지 개수

Num_file_page_deallocs

Accumulator

반환한 페이지 개수

페이지 버퍼

항목

통계 타입

설명

Num_data_page_fetches

Accumulator

가져오기(fetch)한 페이지 개수

Num_data_page_dirties

Accumulator

더티 페이지 개수

Num_data_page_ioreads

Accumulator

디스크에서 읽은 페이지 수
(이 값이 클수록 덜 효율적이며,히트율이 낮은 것과 상관됨)

Num_data_page_iowrites

Accumulator

디스크에 기록한 페이지 수 (이 값이 클수록 덜 효율적임)

Num_data_page_private_quota

Snapshot

전용 LRU 리스트의 대상 페이지 개수

Num_data_page_private_count

Snapshot

전용 LRU 리스트에 대한 실제 페이지 개수

Num_data_page_fixed

Snapshot

데이터 버퍼의 고정 페이지 개수

Num_data_page_dirty

Snapshot

데이터 버퍼의 더티 페이지 개수

Num_data_page_lru1

Snapshot

데이터 버퍼의 LRU1 존의 페이지 개수

Num_data_page_lru2

Snapshot

데이터 버퍼의 LRU2 존의 페이지 개수

Num_data_page_lru3

Snapshot

데이터 버퍼의 LRU3 존의 페이지 개수

Num_data_page_victim_candidate

Snapshot

데이터 버퍼의 희생(victim) 후보 페이지 개수

로그

항목

통계 타입

설명

Num_log_page_fetches

Accumulator

가져오기(fetch)한 로그 페이지의 개수

Num_log_page_ioreads

Accumulator

읽은 로그 페이지의 개수

Num_log_page_iowrites

Accumulator

저장한 로그 페이지의 개수

Num_log_append_records

Accumulator

추가(append)한 로그 레코드의 개수

Num_log_archives

Accumulator

보관 로그의 개수

Num_log_start_checkpoints

Accumulator

체크포인트 시작 횟수

Num_log_end_checkpoints

Accumulator

체크포인트 종료 횟수

Num_log_wals

Accumulator

데이터 페이지를 쓰기 위해 요청된 로그 플러시 횟수

Num_log_page_iowrites_for_replacement

Accumulator

페이지 교체로 인해 디스크에 기록된 로그 데이터 페이지 수 (0 이 되어야 함)

Num_log_page_replacements

Accumulator

페이지 교체로 인해 버려지는 로그 데이터 페이지 수

Num_prior_lsa_list_size

Accumulator

이전 LSA (Log Sequence Address) 목록의 현재 크기
CUBRID는 로그 버퍼에서 디스크로 쓰기 작업을 하기 전에
이전 LSA 목록에 쓰기 순서를 쓴다.
이 목록은 디스크에 기록하는 트랜잭션 대기시간을 줄임으로써 동시성을
높이는데 사용된다.

Num_prior_lsa_list_maxed

Accumulator

최대 크기에 도달한 이전 LSA 목록의 횟수
이전 LSA 목록의 최대 크기는 log_buffer_size * 2 이다.
이 값이 크면 로그 작성 작업이 동시에 많이 발생한다고 가정할 수 있다.

Num_prior_lsa_list_removed

Accumulator

이전 LSA 목록에서 로그 버퍼로 이동한 횟수
이 값과 비슷한 횟수로 커밋이 발생했다고 가정 할 수 있다.

Log_page_buffer_hit_ratio

Computed

로그 페이지 버퍼의 히트률
(Num_log_page_fetches - Num_log_page_fetch_ioreads)*100
/ Num_log_page_fetches

동시성/잠금

항목

통계 타입

설명

Num_page_locks_acquired

Accumulator

페이지 잠금을 획득한 횟수

Num_object_locks_acquired

Accumulator

오브젝트 잠금을 획득한 횟수

Num_page_locks_converted

Accumulator

페이지 잠금 타입을 변환한 횟수

Num_object_locks_converted

Accumulator

오브젝트 잠금 타입을 변환한 횟수

Num_page_locks_re-requested

Accumulator

페이지 잠금을 재요청한 횟수

Num_object_locks_re-requested

Accumulator

오브젝트 잠금을 재요청한 횟수

Num_page_locks_waits

Accumulator

잠금을 대기하는 페이지 개수

Num_object_locks_waits

Accumulator

잠금을 대기하는 오브젝트 개수

Num_object_locks_time_waited_usec

Accumulator

모든 오브젝트를 잠금하는 데 소요된 시간 (microseconds)

Time_obj_lock_acquire_time

Complex

잠금 모드별로 객체를 잠그는 데 소요되는 시간

트랜잭션

항목

통계 타입

설명

Num_tran_commits

Accumulator

커밋한 횟수

Num_tran_rollbacks

Accumulator

롤백한 횟수

Num_tran_savepoints

Accumulator

세이브포인트 횟수

Num_tran_start_topops

Accumulator

시작한 top operation의 개수

Num_tran_end_topops

Accumulator

종료한 top operation의 개수

Num_tran_interrupts

Accumulator

인터럽트 횟수

Num_tran_postpone_cache_hits

Accumulator

트랜잭션 지연 (postpone)연산들을 실행할 때 캐시에서 찾은 (hit) 횟수

Num_tran_postpone_cache_miss

Accumulator

트랜잭션 지연 (postpone)연산들을 실행할 때 캐시에서 찾지 못한 (miss)
횟수. 캐시 미스 (cache miss)는 트랙잭션 커밋의 성능을 저하시킬 수
있고, 전체 로그 연산들에 영향을 끼칠 수 있다.

Num_tran_topop_postpone_cache_hits

Accumulator

top operation 지연 (postpone)연산들을 실행할 때 캐시에서 찾은 (hit)
횟수.

Num_tran_topop_postpone_cache_miss

Accumulator

top operation 지연 (postpone)연산들을 실행할 때 캐시에서 찾지 못한
(miss) 횟수. 캐시 미스 (cache miss)는 top operation 커밋의 성능을
저하시킬 수 있고, 전체 로그 연산들에 영향을 끼칠 수 있다.

인덱스

항목

통계 타입

설명

Num_btree_inserts

Accumulator

삽입된 항목의 개수

Num_btree_deletes

Accumulator

삭제된 항목의 개수

Num_btree_updates

Accumulator

갱신된 항목의 개수

Num_btree_covered

Accumulator

질의 시 인덱스가 데이터를 모두 포함한 경우의 개수

Num_btree_noncovered

Accumulator

질의 시 인덱스가 데이터를 일부분만 포함하거나,
전혀 포함하지 않은 경우의 개수

Num_btree_resumes

Accumulator

많은 결과에 의한 지정된 인덱스 스캔 횟수를 초과한 개수

Num_btree_multirange_optimization

Accumulator

WHERE … IN … LIMIT 조건 질의문에 대해
다중 범위 최적화(multi-range optimization)를 수행한 횟수

Num_btree_splits

Accumulator

B-tree 노드의 분할 연산 횟수

Num_btree_merges

Accumulator

B-tree 노드의 합병 연산 횟수

Num_btree_get_stats

Accumulator

B-tree 노드의 통계 호출 횟수

..bt_leaf

Counter/timer

B-tree 단말들에서 모든 연산 시간과 횟수

..bt_find_unique

Counter/timer

B-tree의 ‘find unique’ 연산 시간과 횟수

..btrange_search

Counter/timer

B-tree의 ‘range search’ 연산 시간과 횟수

..bt_insert_obj

Counter/timer

B-tree의 ‘insert object’ 연산 시간과 횟수

..bt_delete_obj

Counter/timer

B-tree의 ‘physical delete object’ 연산 시간과 횟수

..bt_mvcc_delete

Counter/timer

B-tree의 ‘mvcc delete’ 연산 시간과 횟수

..bt_mark_delete

Counter/timer

B-tree의 ‘mark delete’ 연산 시간과 횟수

..bt_undo_insert

Counter/timer

B-tree의 ‘undo physical insert’ 연산 시간과 횟수

..bt_undo_delete

Counter/timer

B-tree의 ‘undo physical delete’ 연산 시간과 횟수

..bt_undo_mvcc_delete

Counter/timer

B-tree의 ‘undo mvcc delete’ 연산 시간과 횟수

..bt_vacuum

Counter/timer

B-tree의 ‘vacuum deleted object’ 연산 시간과 횟수

..bt_vacuum_insid

Counter/timer

B-tree의 ‘vacuum insert id’ 연산 시간과 횟수

..bt_fix_ovf_oids

Counter/timer

B-tree의 ‘overflow page’ 고정 시간과 횟수

..bt_unique_rlocks

Counter/timer

고유 인덱스에서 읽기 잠금이 차단된 시간과 횟수

..bt_unique_wlocks

Counter/timer

고유 인덱스에서 쓰기 잠금이 차단된 시간과 횟수

..bt_traverse

Counter/timer

B-tree 순회 시간과 횟수

..bt_find_unique_traverse

Counter/timer

B-tree의 ‘find unique’ 연산을 위한 B-tree 순회 시간과 횟수

..bt_range_search_traverse

Counter/timer

B-tree의 ‘range search’ 연산을 위한 B-tree 순회 시간과 횟수

..bt_insert_traverse

Counter/timer

B-tree의 ‘insert’ 연산을 위한 B-tree 순회 시간과 횟수

..bt_delete_traverse

Counter/timer

B-tree의 ‘physical delete’ 연산을 위한 B-tree 순회 시간과 횟수

..bt_mvcc_delete_traverse

Counter/timer

B-tree의 ‘mvcc delete’ 연산을 위한 B-tree 순회 시간과 횟수

..bt_mark_delete_traverse

Counter/timer

B-tree의 ‘mark delete’ 연산을 위한 B-tree 순회 시간과 횟수

..bt_undo_insert_traverse

Counter/timer

B-tree의 ‘undo physical insert’ 연산을 위한 B-tree 순회 시간과 횟수

..bt_undo_delete_traverse

Counter/timer

B-tree의 ‘undo physical delete’ 연산을 위한 B-tree 순회 시간과 횟수

..bt_undo_mvcc_delete_traverse

Counter/timer

B-tree의 ‘undo mvcc delete’ 연산을 위한 B-tree 순회 시간과 횟수

..bt_vacuum_traverse

Counter/timer

B-tree의 ‘vacuum deleted object’ 연산을 위한 B-tree 순회 시간과 횟수

..bt_vacuum_insid_traverse

Counter/timer

B-tree의 ‘vacuum insert id’ 연산을 위한 B-tree 순회 시간과 횟수

온라인 인덱스 로드

항목

통계 타입

설명

..btree_online_load

Counter/timer

B-tree 온라인 인덱스를 로딩하는 구문의 수와 시간

..btree_online_insert_task

Counter/timer

인덱스 로더가 수행한 배치 삽입 작업의 수와 시간

..btree_online_prepare_task

Counter/timer

인덱스 로더 작업을 준비(정렬)한 수와 시간

..btree_online_insert_leaf

Counter/timer

인덱스 로더가 처리한 리프 페이지의 수와 시간
(리프 페이지를 처리하는 동안 여러 키가 삽입될 수 있음)

Num_btree_online_inserts

Accumulator

인덱스 로더가 키를 삽입한 수

Num_btree_online_inserts_same_page_hold

Accumulator

동일한 리프 페이지에 인덱스 로더가 연속적으로 삽입한 수
(값비싼 인덱스 순회를 피하기 위한 로더 최적화)

Num_btree_online_inserts_retry

Accumulator

연속적인 키가 동일한 리프에 속하지 않거나 공간이 부족하여 재시작된
삽입 수

Num_btree_online_inserts_retry_nice

Accumulator

다른 요청이 리프 페이지에 액세스 할 수 있도록 재시작된 삽입 수

쿼리

항목

통계 타입

설명

Num_query_selects

Accumulator

SELECT 쿼리의 수행 횟수

Num_query_inserts

Accumulator

INSERT 쿼리의 수행 횟수

Num_query_deletes

Accumulator

DELETE 쿼리의 수행 횟수

Num_query_updates

Accumulator

UPDATE 쿼리의 수행 횟수

Num_query_sscans

Accumulator

순차 스캔(full scan) 횟수

Num_query_iscans

Accumulator

인덱스 스캔 횟수

Num_query_lscans

Accumulator

LIST 스캔 횟수

Num_query_setscans

Accumulator

SET 스캔 횟수

Num_query_methscans

Accumulator

METHOD 스캔 횟수

Num_query_nljoins

Accumulator

중첩 루프 조인 (nested loop joins) 횟수

Num_query_mjoins

Accumulator

병합 조인 횟수

Num_query_objfetches

Accumulator

객체를 가져오기(fetch) 한 횟수

Num_query_holdable_cursors

Snapshot

서버에서 유지 커서(holdable cursor)의 개수

정렬

항목

통계 타입

설명

Num_sort_io_pages

Accumulator

정렬하는 동안 디스크에서 가져온(fetch) 페이지 개수
(이 값이 클수록 덜 효율적임)

Num_sort_data_pages

Accumulator

정렬하는 동안 페이지 버퍼에서 발견된 페이지 개수
(이 값이 클수록 덜 효율적임)

네트워크

항목

통계 타입

설명

Num_network_requests

Accumulator

네트워크 요청 횟수

항목

통계 타입

설명

Num_heap_stats_sync_bestspace

Accumulator

“Best page” 목록의 갱신 횟수.
“Best page”는 여러 INSERT 및 DELETE 환경에서 여유 공간이 30% 이상인
페이지를 의미한다.
“Best page” 목록에는 이 페이지의 일부 정보만 저장된다.
“Best page” 목록에는 백만 페이지의 정보가 한 번에 저장된다.
이 목록은 레코드를 INSERT 할 때 검색되며 해당 페이지의 여유 공간이
없을 때 “Best page” 목록은 갱신된다.
이 목록이 여러번 갱신되어도 더 이상 저장할 공간이 없는 경우 레코드는
새로운 페이지에 저장된다.

Num_heap_home_inserts

Accumulator

HOME 타입의 레코드 삽입 횟수

Num_heap_big_inserts

Accumulator

BIG 타입의 레코드 삽입 횟수

Num_heap_assign_inserts

Accumulator

ASSIGN 타입의 레코드 삽입 횟수

Num_heap_home_deletes

Accumulator

non-MVCC 모드에서 HOME 타입 레코드의 삭제 횟수

Num_heap_home_mvcc_deletes

Accumulator

MVCC 모드에서 HOME 타입 레코드의 삭제 횟수

Num_heap_home_to_rel_deletes

Accumulator

MVCC 모드에서 HOME 타입으로부터 RELOCATION 타입으로 변경된 레코드의
삭제 횟수

Num_heap_home_to_big_deletes

Accumulator

MVCC 모드에서 HOME 타입으로부터 BIG 타입으로 변경된 레코드의 삭제 횟수

Num_heap_rel_deletes

Accumulator

non-MVCC 모드에서 RELOCATION 타입 레코드의 삭제 횟수

Num_heap_rel_mvcc_deletes

Accumulator

MVCC 모드에서 RELOCATION 타입 레코드의 삭제 횟수

Num_heap_rel_to_home_deletes

Accumulator

MVCC 모드에서 RELOCATION 타입으로부터 HOME 타입으로 변경된 레코드의
삭제 횟수

Num_heap_rel_to_big_deletes

Accumulator

MVCC 모드에서 RELOCATION 타입으로부터 BIG 타입으로 변경된 레코드의
삭제 횟수

Num_heap_rel_to_rel_deletes

Accumulator

MVCC 모드에서 RELOCATION 타입으로부터 RELOCATION 타입으로 변경된
레코드의 삭제 횟수

Num_heap_big_deletes

Accumulator

non-MVCC 모드에서 BIG 타입 레코드의 삭제 횟수

Num_heap_big_mvcc_deletes

Accumulator

MVCC 모드에서 BIG 타입 레코드의 삭제 횟수

Num_heap_home_updates

Accumulator

non-MVCC 모드에서 HOME 타입 레코드의 갱신 횟수(*)

Num_heap_home_to_rel_updates

Accumulator

non-MVCC 모드에서 HOME 타입으로부터 RELOCATION 타입으로 갱신된
레코드의 횟수(*)

Num_heap_home_to_big_updates

Accumulator

non-MVCC 모드에서 HOME 타입으로부터 BIG 타입으로 갱신된 레코드의
횟수(*)

Num_heap_rel_updates

Accumulator

non-MVCC 모드에서 RELOCATION 레코드의 갱신 횟수(*)

Num_heap_rel_to_home_updates

Accumulator

non-MVCC 모드(*)에서 RELOCATION 타입으로부터 HOME 타입으로 갱신된
레코드의 횟수(*)

Num_heap_rel_to_rel_updates

Accumulator

non-MVCC 모드에서 RELOCATION 타입으로부터 RELOCATION 타입으로 갱신된
레코드의 횟수(*)

Num_heap_rel_to_big_updates

Accumulator

non-MVCC 모드에서 BIG 타입으로부터 RELOCATION 타입으로 갱신된
횟수(*)

Num_heap_big_updates

Accumulator

non-MVCC 모드에서 BIG 타입으로 갱신된 레코드의 횟수(*)

Num_heap_home_vacuums

Accumulator

HOME 타입 레코드의 회수된 횟수

Num_heap_big_vacuums

Accumulator

BIG 타입 레코드의 회수된 횟수

Num_heap_rel_vacuums

Accumulator

RELOCATION 타입 레코드의 회수된 횟수

Num_heap_insid_vacuums

Accumulator

새로 삽입된 레코드의 회수된 횟수

Num_heap_remove_vacuums

Accumulator

삭제된 레코드의 회수된 횟수

..heap_insert_prepare

Counter/timer

heap insert 연산에 대한 준비 횟수 및 시간

..heap_insert_execute

Counter/timer

heap insert 연산에 대한 실행 횟수 및 시간

..heap_insert_log

Counter/timer

heap insert 연산에 대한 로깅 횟수 및 시간

..heap_delete_prepare

Counter/timer

heap delete 연산에 대한 준비 횟수 및 시간

..heap_delete_execute

Counter/timer

heap delete 연산에 대한 실행 횟수 및 시간

..heap_delete_log

Counter/timer

heap delete 연산에 대한 로깅 횟수 및 시간

..heap_update_prepare

Counter/timer

heap update 연산에 대한 준비 횟수 및 시간

..heap_update_execute

Counter/timer

heap update 연산에 대한 실행 횟수 및 시간

..heap_update_log

Counter/timer

heap update 연산에 대한 로깅 횟수 및 시간

..heap_vacuum_prepare

Counter/timer

heap vacuum 연산에 대한 준비 횟수 및 시간

..heap_vacuum_execute

Counter/timer

heap vacuum 연산에 대한 실행 횟수 및 시간

..heap_vacuum_log

Counter/timer

heap vacuum 연산에 대한 로깅 횟수 및 시간

질의 계획 캐시

항목

통계 타입

설명

Num_plan_cache_add

Accumulator

쿼리 캐시 엔트리가 새로 추가된 횟수

Num_plan_cache_lookup

Accumulator

특정 키를 사용하여 쿼리 캐시 룩업(Lookup)을 시도한 횟수

Num_plan_cache_hit

Accumulator

질의 문자열 해시 테이블에서 엔트리를 찾은(hit) 횟수

Num_plan_cache_miss

Accumulator

질의 문자열 해시 테이블에서 엔트리를 찾지 못한(miss) 횟수

Num_plan_cache_full

Accumulator

캐시 엔트리의 개수가 최대 개수를 넘어 희생자(victim)탐색을 시도한 횟수

Num_plan_cache_delete

Accumulator

캐시 엔트리가 삭제된(victimized) 횟수

Num_plan_cache_invalid_xasl_id

Accumulator

xasl_id 해시 테이블에서 엔트리를 찾지 못한(miss) 횟수.
서버에서 특정 엔트리가 제거(victimized)되었는데, 해당 엔트리를
클라이언트에서 요청했을 때 발생하는 에러 횟수

Num_plan_cache_entries

Snapshot

쿼리 캐시 엔트리의 현재 개수

HA

항목

통계 타입

설명

Time_ha_replication_delay

Accumulator

복제 지연 시간(초)

Vacuuming

항목

통계 타입

설명

Num_vacuum_log_pages_vacuumed

Accumulator

vacuum 워커에 의해 처리된 로그 데이터 페이지 개수

Num_vacuum_log_pages_to_vacuum

Accumulator

vacuum 워커에 의해 처리될 로그 데이터 페이지 개수
(이 값이 Num_vacuum_log_pages_vacuumed 보다 훨씬 큰 경우
이는 vacuum 시스템이 느리다는 것을 의미한다.)

Num_vacuum_prefetch_requests_log_pages

Accumulator

로그 페이지를 버퍼로 프리패치하는 요청 수

Num_vacuum_prefetch_hits_log_pages

Accumulator

로그 페이지를 버퍼로 프리패치하는 히트 수

..vacuum_master

Counter/timer

vacuum 마스터 작업 횟수와 시간

..vacuum_job

Counter/timer

vacuum 작업 횟수와 시간

..vacuum_worker_process_log

Counter/timer

vacumm 워커의 로그 작업 수행 횟수와 시간

..vacuum_worker_execute

Counter/timer

vacuum 워커의 회수 작업 수행 횟수와 시간

Vacuum_data_page_buffer_hit_ratio

Computed

데이터 페이지 버퍼의 회수 히트율

Vacuum_page_efficiency_ratio

Computed

더티 플래그가있는 vacuum의 page unfix 수와 전체 vacuum의 page unfix
수의 비율. 이상적으로는 vacuum프로세스는 사용되지 않는 모든 레코드를
회수하므로 쓰기 작업만 수행한다.
최적화된 회수 작업이라도 100% 효율은 가능하지 않다.

Vacuum_page_fetch_ratio

Computed

vacuum 모듈에서 page unfix와 총 페이지의 비율 (백분율)

Num_data_page_avoid_dealloc

Snapshot

vacuum에 의해 반환 될 수 없는 데이터 페이지 수

힙 Bestspace

통계 이름

통계 타입

설명

..heap_stats_sync_bestspace

Counter/timer

bestspace 동기화 수행 횟수와 시간

Num_heap_stats_bestspace_entries

Accumulator

“best page” 목록에 저장된 “best page” 개수

Num_heap_stats_bestspace_maxed

Accumulator

“best page” 목록에 저장할 수 있는 “best page” 최대값

..bestspace_add

Counter/timer

bestspace cache에 엔트리를 추가한 횟수와 시간

..bestspace_del

Counter/timer

bestspace cache에서 엔트리를 삭제한 횟수와 시간

..bestspace_find

Counter/timer

bestspace cache 엔트리를 찾은 횟수와 시간

..heap_find_page_bestspace

Counter/timer

bestspace cache에서 힙 페이지를 찾은 횟수와 시간

..heap_find_best_page

Counter/timer

힙에 삽입하기 위해 페이지를 찾거나 (찾지 못했을 경우)생성한
횟수와 시간

페이지 버퍼 fix

항목

통계 타입

설명

Data_page_fix_lock_acquire_time_msec

Computed

페이지를 로드하기 위해 다른 트랜잭션을 기다리는 시간

Data_page_fix_hold_acquire_time_msec

Computed

페이지 래치를 획득하는 시간

Data_page_fix_acquire_time_msec

Computed

페이지를 고정하는 총 시간

Data_page_allocate_time_ratio

Computed

디스크에서 페이지를 로딩하는 데 필요한 시간과 페이지를 고정하는
총 시간의 비율

Data_page_total_promote_success

Computed

공유에서 상호배제로의 성공한 페이지 래치 프로모션 수

Data_page_total_promote_fail

Computed

실패한 페이지 래치 프로모션 수

Data_page_total_promote_time_msec

Computed

페이지 래치 프로모션한 시간

Num_data_page_hash_anchor_waits

Accumulator

페이지 버퍼 해시 버킷의 대기 수

Time_data_page_hash_anchor_wait

Accumulator

페이지 버퍼 해시 버킷의 총 대기 시간

Num_data_page_fix_ext

Complex

다음으로 분류 된 데이터 페이지 고정 수
- 모듈(system, worker, vacuum)
- 페이지 타입
- 페이지 페치/탐색 모드
- 페이지 래치 모드
- 페이지 래치 조건

Time_data_page_lock_acquire_time

Complex

데이터 페이지를 로드 할 때까지 다른 쓰레드를 기다리는 시간
- 모듈 (system, worker, vacuum)
- 페이지 타입
- 페이지 페치/탐색 모드
- 페이지 래치 모드
- 페이지 래치 조건

Time_data_page_hold_acquire_time

Complex

데이터 페이지 래치 대기 시간:
- 모듈(system, worker, vacuum)
- 페이지 타입
- 페이지 페치/탐색 모드
- 페이지 래치 모드

Time_data_page_fix_acquire_time

Complex

데이터 페이지 고정 시간:
- 모듈(system, worker, vacuum)
- 페이지 타입
- 페이지 페치/탐색 모드
- 페이지 래치 모드
- 페이지 래치 조건

Num_data_page_promote_ext

Complex

다음으로 분류 된 데이터 페이지 프로모션 수:
- 모듈(system, worker, vacuum)
- 페이지 타입
- 프로모션 래치 조건
- 홀더 래치 모드
- 성공/실패 프로모션

Num_data_page_promote_time_ext

Complex

다음으로 분류 된 데이터 페이지 대기 시간:
- 모듈(system, worker, vacuum)
- 페이지 타입
- 프로모션 래치 조건
- 홀더 래치 모드
- 성공/실패 프로모션

페이지 버퍼 unfix

항목

통계 타입

설명

Num_unfix_void_to_private_top

Accumulator

새로 로드된 데이터 페이지를 고정하지 않고 전용 LRU 상단에 추가한 수

Num_unfix_void_to_private_mid

Accumulator

새로 로드된 데이터 페이지를 고정하지 않고 전용 LRU 중간에 추가한 수

Num_unfix_void_to_shared_mid

Accumulator

새로 로드된 데이터 페이지를 고정하지 않고 공유 LRU 중간에 추가한 수

Num_unfix_lru1_private_to_shared_mid

Accumulator

데이터 페이지를 고정하지 않고 전용 LRU 영역1에서 공유 LRU 중간으로 이동한 수

Num_unfix_lru2_private_to_shared_mid

Accumulator

데이터 페이지를 고정하지 않고 전용 LRU 영역2에서 공유 LRU 중간으로 이동한 수

Num_unfix_lru3_private_to_shared_mid

Accumulator

데이터 페이지를 고정하지 않고 전용 LRU 영역3에서 공유 LRU 중간으로 이동한 수

Num_unfix_lru2_private_keep

Accumulator

데이터 페이지를 고정하지 않고 전용 LRU 영역2에 보관한 수

Num_unfix_lru2_shared_keep

Accumulator

데이터 페이지를 고정하지 않고 공유 LRU 영역2에 보관한 수

Num_unfix_lru2_private_to_top

Accumulator

데이터 페이지를 고정하지 않고 전용 LRU 영역2에서 상단으로 올린 수

Num_unfix_lru2_shared_to_top

Accumulator

데이터 페이지를 고정하지 않고 공유 LRU 영역2에서 상단으로 올린 수

Num_unfix_lru3_private_to_top

Accumulator

데이터 페이지를 고정하지 않고 전용 LRU 영역3에서 상단으로 올린 수

Num_unfix_lru3_shared_to_top

Accumulator

데이터 페이지를 고정하지 않고 공유 LRU 영역3에서 상단으로 올린 수

Num_unfix_lru1_private_keep

Accumulator

데이터 페이지를 고정하지 않고 전용 LRU 영역1에 보관한 수

Num_unfix_lru2_shared_keep

Accumulator

데이터 페이지를 고정하지 않고 공유 LRU 영역2에 보관한 수

Num_unfix_void_to_private_mid_vacuum

Accumulator

새로 로드된 데이터 페이지를 고정하지 않고 전용 LRU 목록 중간에
추가한 수 (vacuum 쓰레드)

Num_unfix_lru1_any_keep_vacuum

Accumulator

새로 로드된 데이터 페이지를 고정하지 않고 전용/공유 LRU 영역 1에
보관한 수 (vacuum 쓰레드)

Num_unfix_lru2_any_keep_vacuum

Accumulator

새로 로드된 데이터 페이지를 고정하지 않고 전용/공유 LRU 영역 2에
보관한 수 (vacuum 쓰레드)

Num_unfix_lru3_any_keep_vacuum

Accumulator

새로 로드된 데이터 페이지를 고정하지 않고 전용/공유 LRU 영역 3에
보관한 수 (vacuum 쓰레드)

Num_unfix_void_aout_found

Accumulator

새로 로드 된 데이터 페이지가 AOUT 에서 발견된 수

Num_unfix_void_aout_not_found

Accumulator

새로 로드 된 데이터 페이지가 AOUT 에서 발견되지 않은 수

Num_unfix_void_aout_found_vacuum

Accumulator

새로 로드 된 데이터 페이지가 AOUT 에서 발견된 수(vacuum 쓰레드)

Num_unfix_void_aout_not_found_vacuum

Accumulator

새로 로드 된 데이터 페이지가 AOUT 에서 발견되지 않은 수(vacuum 쓰레드)

Num_data_page_unfix_ext

Complex

다음으로 분류 된 데이터 페이지 비 고정 수
- 모듈(system, worker, vacuum)
- 페이지 타입
- 더티이거나 아닌 경우
- 홀더에 의한 더티이거나 아닌 경우
- 홀더 래치 모드

페이지 버퍼 I/O

항목

통계 타입

설명

Data_page_buffer_hit_ratio

Computed

데이터 페이지 버퍼의 히트율
(Num_data_page_fetches - Num_data_page_ioreads)*100
/ Num_data_page_fetches

Num_adaptive_flush_pages

Accumulator

적응형 플러시 컨트롤러에서 요청한 데이터 페이지 수

Num_adaptive_flush_log_pages

Accumulator

적응형 플러시 컨트롤러에서 요청한 로그 데이터 페이지 수

Num_adaptive_flush_max_pages

Accumulator

적응형 플러시 컨트롤러에 의해 할당된 토큰 페이지 총 수

..compensate_flush

Counter/timer

적응형 플러시 컨트롤러에 의한 플러시 보정의 횟수와 시간

..assign_direct_bcb

Counter/timer

대기자 (waiter)들에게 직접적으로 bcb를 할당한 횟수와 시간

..wake_flush_waiter

Counter/timer

BCB를 기다리는 쓰레드를 깨우기 위한 횟수와 시간

..flush_collect

Counter/timer

BCB 세트를 수집하는 플러시 쓰레드의 수와 시간

..flush_flush

Counter/timer

BCB 세트를 플러싱하는 플러시 쓰레드의 수와 시간

..flush_sleep

Counter/timer

플러시 쓰레드 일시 정지 수와 시간

..flush_collect_per_page

Counter/timer

한 개의 BCB 를 수집하는 플러시 쓰레드의 수와 시간

..flush_flush_per_page

Counter/timer

한 개의 BCB 를 플러싱하는 플러시 쓰레드의 수와 시간

Num_data_page_writes

Accumulator

디스크로 내려쓰기된 데이터 페이지의 총 수

Num_data_page_dirty_to_post_flush

Accumulator

포스트 플러시 쓰레드로 보내진 플러시 된 페이지 수

Num_data_page_skipped_flush

Accumulator

플러시 쓰레드가 생략한 BCB의 총 수

Num_data_page_skipped_flush_need_wal

Accumulator

로그 데이터 페이지를 먼저 플러시해야하기 때문에
플러시 쓰레드가 생략한 BCB 수
Num_data_page_skipped
_flush_already_flushed

Accumulator

이미 플러시 되어서 쓰레드가 생략한 BCB 수

Num_data_page_skipped_flush_fixed_or_hot

Accumulator

BCB가 고정되었거나 수집 된 후 고정되었기 때문에
플러시 쓰레드가 생략한 BCB의 수

페이지 버퍼 victimization

항목

통계 타입

설명

..alloc_bcb

Counter/timer

새로운 데이터 페이지를 저장하기위한 BCB 할당의 수와 시간.
데이터베이스가 시작되면 페이지 버퍼는 사용가능한 BCB가 있다.
그러나 페이지 버퍼가 모두 사용되면 모든 BCB가 사용 중이므로
페이지 버퍼 중 하나는 희생되어야 한다. 여기서 추적되는 시간은
BCB 희생 및 디스크 로딩을 포함한다.

..alloc_bcb_search_victim

Counter/timer

희생자(Victim)에 대한 모든 LRU 을 통한 검색 횟수 및 시간

..alloc_bcb_cond_wait_high_prio

Counter/timer

우선 순위가 높은 대기열에서 직접적인 희생자(Victim) 대기의 수와 시간

..alloc_bcb_cond_wait_low_prio

Counter/timer

우선 순위가 낮은 대기열에서 직접적인 희생자(Victim) 대기의 수와 시간

Num_alloc_bcb_prioritize_vacuum

Accumulator

우선 순위가 높은 대기열에서 직접적인 희생자(Victim) 회수의 대기 수

Num_alloc_bcb_wait_threads_high_priority

Snapshot

우선 순위가 높은 대기열에서 직접적인 희생(Victim) 대기자의 현재 수

Num_alloc_bcb_wait_threads_low_priority

Snapshot

우선 순위가 낮은 대기열에서 직접적인 희생(Victim) 대기자의 현재 수

Num_flushed_bcbs_wait_for_direct_victim

Snapshot

희생자를 처리하여 즉시 할당하는 post-flush 쓰레드를 기다리는 BCB의
현재 수

Num_victim_use_invalid_bcb

Accumulator

유효하지 않은 목록에서 할당 된 BCB의 수

..alloc_bcb_get_victim_search_own_private_list

Counter/timer

자체 전용 리스트에서 희생자(Victim)을 가져오는 횟수 및 시간

..alloc_bcb_get_victim_search_others_private_list

Counter/timer

다른 전용 리스트에서 희생자(Victim)을 가져오는 횟수 및 시간

..alloc_bcb_get_victim_searchshared_list

Counter/timer

공유 리스트에서 희생자(Victim)을 가져오는 횟수 및 시간

Num_data_page_avoid_victim

Accumulator

디스크로 내려써지는 중이라 희생에서 제외되는 BCB의 수

Num_victim_assign_direct_vacuum_void

Accumulator

vacuum 워커가 빈(void) 영역에서 할당한 직접 희생자의 수

Num_victim_assign_direct_vacuum_lru

Accumulator

vacuum 워커가 LRU 영역 3에서 할당한 직접 희생자 수

Num_victim_assign_direct_flush

Accumulator

플러시 쓰레드가 지정한 직접적인 희생자 수

Num_victim_assign_direct_panic

Accumulator

패닉 LRU 검색에 의해 할당 된 직접적인 희생자의 수
희생자를 찾기 위한 대기자가 많으면 LRU 목록을 검색하는 동안 다른
희생자를 찾는 쓰레드가 직접 할당하려고 시도한다.
페이지 버퍼 유지 쓰레드 할당도 여기에 포함된다.

Num_victim_assign_direct_adjust_lru

Accumulator

BCB가 LRU 영역 3으로 이동할 때 할당된 직접적인 희생자 수

Num_victim_assign_direct_adjust_lru_to_vacuum

Accumulator

vacuum 쓰레드가 액세스할 것으로 예상되어 LRU 영역 3으로 이동할 때
직접적인 희생자로 할당되지 않은 BCB의 수

Num_victim_assign_direct_search_for_flush

Accumulator

플러시를 위해 BCB셋(Set)을 수집하는 동안 플러시 쓰레드에 의해 할당된
직접적인 희생자 수

Num_victim_shared_lru_success

Accumulator

공유 LRU 에서 성공한 희생자 검색 수

Num_victim_own_private_lru_success

Accumulator

자체 전용 LRU 에서 성공한 희생자 검색 수

Num_victim_other_private_lru_success

Accumulator

다른 전용 LRU 에서 성공한 희생자 검색 수

Num_victim_shared_lru_fail

Accumulator

공유 LRU 에서 실패한 희생자 검색 수

Num_victim_own_private_lru_fail

Accumulator

자체 전용 LRU에서 실패한 희생자 검색 수

Num_victim_other_private_lru_fail

Accumulator

다른 전용 LRU에서 실패한 희생자 검색 수

Num_victim_all_lru_fail

Accumulator

아래의 순서에서 희생자를 찾을 때 좋지 않은 경우의 수:
1. 자체 전용 LRU (쿼터가 초과될 경우)
2. 다른 전용 LRU (자체 전용 쿼터가 초과될 경우)
3. 공유 LRU
(자세한 설명은 다음을 참고한다. pgbuf_get_victim 함수)

Num_victim_get_from_lru

Accumulator

모든 LRU 에서 희생자 검색 총 수

Num_victim_get_from_lru_was_empty

Accumulator

후보 수가 0이기 때문에 모든 LRU에서 희생자 검색이 즉시 중지된 수

Num_victim_get_from_lru_fail

Accumulator

후보 수가 0이 아니더라도 모든 LRU 에서 희생자 검색이 실패된 수

Num_victim_get_from_lru_bad_hint

Accumulator

희생자가 잘못되어 모든 LRU 에서 희생자 검색이 실패된 수

Num_lfcq_prv_get_total_calls

Accumulator

후보 수가 0이 아닌 전용 LRU 큐에서 희생자 검색 수

Num_lfcq_prv_get_empty

Accumulator

후보수가 0이 아닌 전용 LRUs 큐가 비어있는 횟수

Num_lfcq_prv_get_big

Accumulator

후보 수가 매우 큰 전용 LRU 큐의 희생자 검색 수
( 매우 큰 것의 의미는 할당량을 초과하는 경우을 나타냄)

Num_lfcq_shr_get_total_calls

Accumulator

후보수가 0이 아닌 공유 LRU 큐에서 희생자 검색 수

Num_lfcq_shr_get_empty

Accumulator

후보수가 0이 아닌 공유 LRU 큐가 비어있는 횟수

Num_lfcq_big_private_lists

Snapshot

후보자가 매우 큰 전용 LRU 의 현재 수

Num_lfcq_private_lists

Snapshot

후보자가 0이 아닌 전용 LRU 의 현재 수

Num_lfcq_shared_lists

Snapshot

후보자가 0이 아닌 공유 LRU 의 현재 수

이중 쓰기 버퍼 (Double write buffer)

항 목

통계 타입

설명

..DWB_flush_block

Counter/timer

플러시 (flush)되는 블록 (block)의 갯수와 전체 쓰기 시간

..DWB_file_sync_helper

Counter/timer

DWB helper에 의해 동기화된 파일의 갯수와 시간

..DWB_flush_block_cond_wait

Counter/timer

DWB 쓰레드들이 기다리는 횟수와 시간

..DWB_flush_block_sort

Counter/timer

플러시 (flush)하기 위하여 정렬된 페이지의 갯수와 시간

..DWB_decache_pages_after_write

Counter/timer

플러시 (flush) 이후 DWB 캐시에서 제거되는 페이지들의 갯수와 시간

..DWB_wait_flush_block

Counter/timer

페이지를 추가하기 위하여 블록이 플러시 (flush)되기를 기다리는
횟수와 시간

..DWB_wait_file_sync_helper

Counter/timer

DWB helper가 파일을 동기화하는 것을 기다리는 횟수와 시간

..DWB_flush_force

Counter/timer

강제로 DWB를 완전히 플러시 (flush)한 횟수와 시간

Num_dwb_flushed_block_volumes

Complex

각각의 블록 플러시 (block flush)에 의해 동기화된 파일들 갯수의
히스토그램 (마지막 값은 10 혹은 그 이상의 파일들)

MVCC 스냅샷

항목

통계 타입

설명

Time_get_snapshot_acquire_time:

Accumulator

스냅샷을 획득하기 위해 모든 트랜잭션이 수행된 총 시간

Count_get_snapshot_retry:

Accumulator

MVCC 스냅샷을 획득하기 위한 재시도 횟수

Time_tran_complete_time:

Accumulator

커밋 / 롤백시 스냅샷 및 MVCCID를 무효화하는 데 수행된 시간

Time_get_oldest_mvcc_acquire_time:

Accumulator

“가장 오래된 전역 MVCC ID” 를 획득하기 위해 수행된 시간

Count_get_oldest_mvcc_retry:

Accumulator

“가장 오래된 전역 MVCC ID” 를 획득하기 위한 재시도 횟수

Num_mvcc_snapshot_ext

Complex

다음과 같이 분류된 데이터 페이지 수정 수
- 스냅샷 타입
- 삽입/삭제 MVCCID의 상태
- 가시성/비가시성

워커 스레드

워커 스레드 풀에서 수집한 통계 정보:

항목

통계 타입

설명

..start_thread

Counter/timer

새 스레드를 시작한 횟수와 시간

..create_context

Counter/timer

스레드 컨텍스트를 생성한 횟수와 시간

..execute_task

Counter/timer

실행한 작업의 수와 시간

..retire_task

Counter/timer

폐기한 작업 객체의 수와 시간

..found_task_in_queue

Counter/timer

대기열에서 발견한 작업의 수와 이전 작업을 완료한 후 대기열에 요청한 시간

..wakeup_with_task

Counter/timer

대기 중인 스레드에 할당한 작업의 수와 스레드를 깨우기 위해 사용한 시간

..recycle_context

Counter/timer

작업 실행 간 재활용한 스레드 컨텍스트의 수와 시간

..retire_context

Counter/timer

폐기한 스레드 컨텍스트의 수와 시간

두개의 워커 풀에서 수집한 통계 정보:

  • Thread_stats_counters_timers: 클라이언트 요청을 처리하는 워커에 대한 통계 정보

  • Thread_loaddb_stats_counters_timers: loaddb 명령 사용시 데이터베이스에 데이터를 로딩하는 워커에 대한 통계 정보 이 통계 정보를 보려면 최소한 하나의 로드 세션이 활성화되어 있어야 한다.

데몬 스레드:

백그라운드 데몬 스레드가 수집한 통계 정보:

항목

통계 타입

설명

..daemon_loop_count

Accumulator

데몬 스레드가 실행한 반복 횟수

..daemon_execute_time

Accumulator

데몬 스레드가 실행 시 사용한 총 시간

..daemon_pause_time

Accumulator

데몬 스레드가 실행 간 소비한 총 시간

..looper_sleep_count

Accumulator

스레드 반복자가 정지 상태가 된 횟수

..looper_sleep_time

Accumulator

스레드 반복자가 정지 상태에서 소비한 총 시간

..looper_reset_count

Accumulator

증분 반복자가 깨어나며 재설정되는 횟수

..waiter_wakeup_count

Accumulator

데몬 스레드에 깨우기 요청한 횟수

..waiter_lock_wakeup_count

Accumulator

잠금 요청한 데몬 스레드 깨우기 요청 횟수

..waiter_sleep_count

Accumulator

데몬 스레드가 정지 상태가 된 횟수

..waiter_timeout_count

Accumulator

데몬 스레드가 시간 초과로 종료한 대기 횟수

..waiter_no_sleep_count

Accumulator

데몬 스레드가 대기하지 않고 반복한 횟수

..waiter_awake_count

Accumulator

다른 스레드의 요청으로 데몬 스레드를 깨운 횟수

..waiter_wakeup_delay_time

Accumulator

데몬 스레드를 깨우는데 사용한 총 시간

다음 데몬 스레드에 대해 수집된 통계 정보:

데몬 이름

설명

Page_flush_daemon_thread

디스크에 데이터 페이지를 내보내는 백그라운드 스레드

Page_post_flush_daemon_thread

데이터 페이지를 내보내기 위해 사용한 메모리 공간을 회수하는 백그라운드 스레드

Page_flush_control_daemon_thread

데이터 내보내기 비율을 조정하는 백그라운드 스레드

Page_maintenance_daemon_thread

개인 LRU 리스트의 할당량을 재계산하는 백그라운드 스레드

Deadlock_detect_daemon_thread

교착 상태를 찾고 시스템 정지를 막기 위해 희생자(victim)를 선택하는 백그라운드 스레드

Log_flush_daemon_thread

디스크에 로그 데이터를 내보내는 백그라운드 스레드

Note

(*) : 통계치는 내부에서 수행되는 비 MVCC 연산 또는 MVCC 연산에 대한 측정 자료이다 (내부적으로 결정됨)

-o, --output-file=FILE

-o 옵션을 이용하여 대상 데이터베이스 서버의 실행 통계 정보를 지정된 파일에 저장한다.

cubrid statdump -o statdump.log testdb
-c, --cumulative

-c 옵션을 이용하여 대상 데이터베이스 서버의 누적된 실행 통계 정보를 출력할 수 있다.

Num_data_page_fix_ext, Num_data_page_unfix_ext, Time_data_page_hold_acquire_time, Time_data_page_fix_acquire_time 정보는 이 옵션을 켜야만 출력되는데, 해당 정보들은 CUBRID 엔진 개발자를 위한 정보이므로 설명을 생략한다.

-i 옵션과 결합하면, 지정된 시간 간격(interval)마다 실행 통계 정보를 확인할 수 있다.

cubrid statdump -i 5 -c testdb
-s, --substr=STRING

-s 옵션 뒤에 문자열을 지정하면, 항목 이름 내에 해당 문자열을 포함하는 통계 정보만 출력할 수 있다.

다음 예는 항목 이름 내에 “data”를 포함하는 통계 정보만 출력한다.

cubrid statdump -s data testdb

*** SERVER EXECUTION STATISTICS ***
Num_data_page_fetches         =          0
Num_data_page_dirties         =          0
Num_data_page_ioreads         =          0
Num_data_page_iowrites        =          0
Num_data_page_flushed         =          0
Num_data_page_private_quota   =        327
Num_data_page_private_count   =        898
Num_data_page_fixed           =          1
Num_data_page_dirty           =          3
Num_data_page_lru1            =        857
Num_data_page_lru2            =        873
Num_data_page_lru3            =        898
Num_data_page_victim_candidate =        898
Num_sort_data_pages           =          0
Vacuum_data_page_buffer_hit_ratio =       0.00
Num_data_page_hash_anchor_waits =          0
Time_data_page_hash_anchor_wait =          0
Num_data_page_writes          =          0
Num_data_page_dirty_to_post_flush =          0
Num_data_page_skipped_flush   =          0
Num_data_page_skipped_flush_need_wal =          0
Num_data_page_skipped_flush_already_flushed =          0
Num_data_page_skipped_flush_fixed_or_hot =          0
Num_data_page_avoid_dealloc   =          0
Num_data_page_avoid_victim    =          0
Num_data_page_fix_ext:
Num_data_page_promote_ext:
Num_data_page_promote_time_ext:
Num_data_page_unfix_ext:
Time_data_page_lock_acquire_time:
Time_data_page_hold_acquire_time:
Time_data_page_fix_acquire_time:

Note

각 상태 정보는 64비트 INTEGER 로 구성되어 있으며, 누적된 값이 한도를 넘으면 해당 실행 통계 정보가 유실될 수 있다.

Note

아래는 활성화/비활성화 할 수 있는 성능 통계 세트 목록이다. 각 세트의 값은 2의 제곱으로 표현된다. 이 세트들은 extended_statistics_activation 시스템 매개 변수 값에 의해 활성화/비활성화되며, 이 변수 값은 2진수 형식으로 설정한다

이름

활성 기본값

설명

1

Detailed b-tree pages

Yes

B- 트리 페이지를 3 가지 카테고리로 분류한다.: 루트, 비단말,단말
관련 통계수치:
- Num_data_page_fix_ext
- Time_data_page_lock_acquire_time
- Time_data_page_hold_acquire_time
- Time_data_page_fix_acquire_time
- Num_data_page_promote_ext
- Num_data_page_promote_time_ext
- Num_data_page_unfix_ext

2

MVCC Snapshot

Yes

MVCC 스냅샷에 대한 통계 수집 :
- Num_mvcc_snapshot_ext

4

Time locks

Yes

타이밍 잠금 대기에 대한 통계 수집 :
- Num_object_locks_time_waited_usec

8

Hash anchor waits

Yes

해시 앵커 대기에 대한 통계 수집 :
- Num_data_page_hash_anchor_waits
- Time_data_page_hash_anchor_wait

16

Extended victimization

No

확장 페이지 버퍼 I/O 및 victim 대한
통계 수집 :
- Num_data_page_writes
- flush_collect_per_page
- flush_flush_per_page
- Num_data_page_skipped_flush_already_flushed
- Num_data_page_skipped_flush_need_wal
- Num_data_page_skipped_flush_fixed_or_hot
- Num_data_page_dirty_to_post_flush
- Num_alloc_bcb_prioritize_vacuum
- Num_victim_assign_direct_vacuum_void
- Num_victim_assign_direct_vacuum_lru
- Num_victim_assign_direct_flush
- Num_victim_assign_direct_panic
- Num_victim_assign_direct_adjust_lru
- Num_victim_assign_direct_adjust_lru_to_vacuum
- Num_victim_assign_direct_search_for_flush
- Num_victim_shared_lru_success
- Num_victim_own_private_lru_success
- Num_victim_other_private_lru_success
- Num_victim_shared_lru_fail
- Num_victim_own_private_lru_fail
- Num_victim_other_private_lru_fail
- Num_victim_get_from_lru
- Num_victim_get_from_lru_was_empty
- Num_victim_get_from_lru_fail
- Num_victim_get_from_lru_bad_hint
- Num_lfcq_prv_get_total_calls
- Num_lfcq_prv_get_empty
- Num_lfcq_prv_get_big
- Num_lfcq_shr_get_total_calls
- Num_lfcq_shr_get_empty

32

Thread workers

No

스레드 워커 풀에 대한 통계 수집 :
- Thread_stats_counters_timers
- Thread_loaddb_stats_counters_timers

64

Thread daemons

No

데몬 스레드에 대한 통계 수집 :
- Thread_pgbuf_daemon_stats_counters_timers

128

Extended DWB

No

이중 쓰기 버퍼에 대한 통계 수집 :
- Num_dwb_flushed_block_volumes

MAX

All statistics

No

모든 통계 수집

lockdb

cubrid lockdb 는 대상 데이터베이스에 대하여 현재 트랜잭션에서 사용되고 있는 잠금 정보를 확인하는 유틸리티이다.

cubrid lockdb [<option>] database_name
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • lockdb: 대상 데이터베이스에 대하여 현재 트랜잭션에서 사용되고 있는 잠금 정보를 확인하는 명령이다.

  • database_name: 현재 트랜잭션의 잠금 정보를 확인하는 데이터베이스 이름이다.

다음 예는 옵션 없이 testdb 데이터베이스의 잠금 정보를 화면에 출력한다.

cubrid lockdb testdb

다음은 cubrid lockdb 에 대한 [option]이다.

-o, --output-file=FILE

데이터베이스의 잠금 정보를 output.txt로 출력한다.

cubrid lockdb -o output.txt testdb

출력 내용

cubrid lockdb 의 출력 내용은 논리적으로 3개의 섹션으로 나뉘어져 있다.

  • 서버에 대한 잠금 설정

  • 현재 데이터베이스에 접속한 클라이언트들

  • 객체 잠금 테이블의 내용

서버에 대한 잠금 설정

cubrid lockdb 출력 내용의 첫 번째 섹션은 데이터베이스 서버에 대한 잠금 설정이다.

*** Lock Table Dump ***
 Lock Escalation at = 100000, Run Deadlock interval = 0

위에서 잠금 에스컬레이션 레벨은 100000레코드로, 교착 상태 탐지 간격은 0초로 설정되어 있다.

관련 시스템 파라미터인 lock_escalationdeadlock_detection_interval 에 대한 설명은 동시성/잠금 파라미터 를 참고한다.

현재 데이터베이스에 접속한 클라이언트들

cubrid lockdb 출력 내용의 두 번째 섹션은 데이터베이스에 연결된 모든 클라이언트의 정보를 포함한다. 이 정보에는 각각의 클라이언트에 대한 트랜잭션 인덱스, 프로그램 이름, 사용자 ID, 호스트 이름, 프로세스 ID, 격리 수준, 그리고 잠금 타임아웃 설정이 포함된다.

Transaction (index 1, csql, dba@cubriddb|12854)
Isolation COMMITTED READ
Timeout_period : Infinite wait

위에서 트랜잭션 인덱스는 1이고, 프로그램 이름은 csql, 사용자 id은 dba, 호스트 이름은 cubriddb, 클라이언트 프로세스 id는 12854, 격리 수준은 COMMITTED READ, 그리고 잠금 타임아웃은 무제한이다.

트랜잭션 인덱스가 0인 클라이언트는 내부적인 시스템 트랜잭션이다. 이것은 데이터베이스의 체크포인트 수행과 같이 특정한 시간에 잠금을 획득할 수 있지만 대부분의 경우 이 트랜잭션은 어떤 잠금도 획득하지 않을 것이다.

cubrid lockdb 유틸리티는 잠금 정보를 가져오기 위해 데이터베이스에 접속하기 때문에 cubrid lockdb 자체가 하나의 클라이언트이고 따라서 클라이언트의 하나로 출력된다.

객체 잠금 테이블

cubrid lockdb 출력 내용의 세 번째 섹션은 객체 잠금 테이블의 내용을 포함한다. 이것은 어떤 객체에 대해서 어떤 클라이언트가 어떤 모드로 잠금을 가지고 있는지, 어떤 객체에 대해서 어떤 클라이언트가 어떤 모드로 기다리고 있는지를 보여준다. 객체 잠금 테이블 결과물의 첫 부분에는 얼마나 많은 객체가 잠금되었는지가 출력된다.

Object lock Table:
    Current number of ojbects which are locked = 2001

cubrid lockdb는 잠금을 획득한 각 객체의 OID, 객체 타입 및 테이블명을 출력한다. 또한 객체에 대한 잠금을 보유한 트랜잭션 수(Num holders), 잠금을 보유하지만 잠금을 상위 잠금으로 변환(예: SCH_S_LOCK에서 SCH_M_LOCK으로의 변환)할 수 없어 차단된 트랜잭션 수(Num blocked-holders) 및 객체의 잠금을 기다리는 다른 트랜잭션의 수(Num waiters)를 출력한다. 잠금을 보유한 클라이언트 트랜잭션, 차단된 클라이언트 트랜잭션 및 대기 중인 클라이언트 트랜잭션의 목록도 출력한다. 객체 타입이 클래스가 아닌 행에서는 MVCC 정보도 표시된다.

다음 예제는 OID(0|62|5)인 클래스 타입의 객체를 나타내며,트랜잭션 1은 IX_LOCK을 보유하고 트랜잭션 2는 SCH_S_LOCK을 보유한 상태에서 SCH_M_LOCK으로 변환할 수 없어 차단된 상태를 보여준다. 또한 트랜잭션 3은**SCH_S_LOCK**을 기다리지만 트랜잭션 2가 SCH_M_LOCK을 기다리기 때문에 차단된 상태를 보여준다.

OID = 0| 62| 5
Object type: Class = athlete.
Num holders = 1, Num blocked-holders= 1, Num waiters = 1
LOCK HOLDERS :
    Tran_index = 1, Granted_mode = IX_LOCK, Count = 1, Nsubgranules = 1
BLOCKED LOCK HOLDERS :
    Tran_index = 2, Granted_mode = SCH_S_LOCK, Count = 1, Nsubgranules = 0
    Blocked_mode = SCH_M_LOCK
                    Start_waiting_at = Wed Feb 3 14:44:31 2016
                    Wait_for_secs = -1
LOCK WAITERS :
    Tran_index = 3, Blocked_mode = SCH_S_LOCK
                    Start_waiting_at = Wed Feb 3 14:45:14 2016
                    Wait_for_secs = -1

다음 예는 X_LOCK 을 보유한 트랜잭션 1에 의해서 삽입된 OID가 ( 2 | 50 | 1)인 클래스의 인스턴스를 보여준다. 트랜잭션1이 삽입한 인스턴스를 수정하기 위해 트랜잭션2가 X_LOCK 을 기다리는 것을 보여준다.

OID = 2| 50| 1
Object type: instance of class ( 0| 62| 5) = athlete.
MVCC info: insert ID = 6, delete ID = missing.
Num holders = 1, Num blocked-holders= 1, Num waiters = 1
LOCK HOLDERS :
    Tran_index =   1, Granted_mode =   X_LOCK, Count =   1
LOCK WAITERS :
    Tran_index =   2, Blocked_mode = X_LOCK
                      Start_waiting_at = Wed Feb 3 14:45:14 2016
                      Wait_for_secs = -1

Granted_mode 는 습득한 잠금의 모드를 나타내며, Blocked_mode 는 차단된 잠금의 모드를 나타낸다. Starting_waiting_at 은 잠금이 요청된 시간을 나타내며, Wait_for_secs 는 잠금의 대기 시간을 나타낸다. Wait_for_secs 값은 시스템 파라미터인 lock_timeout 에 의해 결정된다.

객체 타입이 클래스(테이블)인 경우 테이블의 특정 트랜잭션에서 획득한 레코드 잠금과 키 잠금의 합계를 나타내는 Nsubgranules 가 표시된다.

OID = 0| 62| 5
Object type: Class = athlete
Num holders = 2, Num blocked-holders= 0, Num waiters= 0
LOCK HOLDERS:
Tran_index = 3, Granted_mode = IS_LOCK, Count = 2, Nsubgranules = 0
Tran_index = 1, Granted_mode = IX_LOCK, Count = 3, Nsubgranules = 1
Tran_index = 2, Granted_mode = IS_LOCK, Count = 2, Nsubgranules = 1

tranlist

cubrid tranlist 는 대상 데이터베이스의 트랜잭션 정보를 확인하는 유틸리티이다.

cubrid tranlist [options] database_name

옵션을 생략하면 각 트랜잭션에 대한 전체 정보를 출력한다.

“cubrid tranlist demodb”는 “cubrid killtran -q demodb”와 비슷한 결과를 출력하나, 후자에 비해 “User name”과 “Host name”을 더 출력한다. “cubrid tranlist -s demodb”는 “cubrid killtran -d demodb”와 동일한 결과를 출력한다.

다음은 tranlist 출력 결과의 예이다.

$ cubrid tranlist demodb

Tran index          User name      Host name      Process id    Program name              Query time    Tran time       Wait for lock holder      SQL_ID       SQL Text
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------
   1(ACTIVE)           public     test-server           1681    broker1_cub_cas_1               0.00         0.00                       -1     *** empty ***
   2(ACTIVE)           public     test-server           1682    broker1_cub_cas_2               0.00         0.00                       -1     *** empty ***
   3(ACTIVE)           public     test-server           1683    broker1_cub_cas_3               0.00         0.00                       -1     *** empty ***
   4(ACTIVE)           public     test-server           1684    broker1_cub_cas_4               1.80         1.80                  3, 2, 1     e5899a1b76253   update ta set a = 5 where a > 0
   5(ACTIVE)           public     test-server           1685    broker1_cub_cas_5               0.00         0.00                       -1     *** empty ***
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------

SQL_ID: e5899a1b76253
Tran index : 4
update ta set a = 5 where a > 0

위의 예는 3개의 트랜잭션이 각각 INSERT문을 실행 중일 때 또 다른 트랜잭션에서 UPDATE문의 실행을 시도한다. 위에서 Tran index가 4인 update문은 3,2,1(Wait for lock holder)번의 트랜잭션이 종료되기를 대기하고 있다.

화면에 출력되는 질의문(SQL Text)은 질의 계획 캐시에 저장되어 있는 것을 보여준다. 질의 수행이 완료되면 empty 로 표시된다.

각 칼럼의 의미는 다음과 같다.

  • Tran index: 트랜잭션 인덱스

  • User name: 데이터베이스 사용자 이름

  • Host name: 해당 트랜잭션이 수행되는 CAS의 호스트 이름

  • Process id: 클라이언트 프로세스 ID

  • Program name: 클라이언트 프로그램 이름

  • Query time: 수행중인 질의의 총 수행 시간(단위: 초)

  • Tran time: 현재 트랜잭션의 총 수행 시간(단위: 초)

  • Wait for lock holder: 현재 트랜잭션이 락 대기중이면 해당 락을 소유하고 있는 트랜잭션의 리스트

  • SQL_ID: SQL Text에 대한 ID. cubrid killtran 명령의 --kill-sql-id 옵션에서 사용될 수 있다.

  • SQL Text: 수행중인 질의문(최대 30자)

“Tran index”에 보여지는 transaction 상태 메시지는 다음과 같다.

  • ACTIVE : 활성

  • RECOVERY : 복구중인 트랜잭션

  • COMMITTED : 커밋완료되어 종료될 트랜잭션

  • COMMITTING : 커밋중인 트랜잭션

  • ABORTED : 롤백되어 종료될 트랜잭션

  • KILLED : 서버에 의해 강제 종료 중인 트랜잭션

다음은 cubrid tranlist 에 대한 [options]이다.

-s, --summary

요약 정보만 출력한다(질의 수행 정보 또는 잠금 관련 정보를 생략).

$ cubrid tranlist -s demodb

Tran index          User name      Host name      Process id      Program name
-------------------------------------------------------------------------------
   1(ACTIVE)           public     test-server           1681 broker1_cub_cas_1
   2(ACTIVE)           public     test-server           1682 broker1_cub_cas_2
   3(ACTIVE)           public     test-server           1683 broker1_cub_cas_3
   4(ACTIVE)           public     test-server           1684 broker1_cub_cas_4
   5(ACTIVE)           public     test-server           1685 broker1_cub_cas_5
-------------------------------------------------------------------------------
--sort-key=NUMBER

해당 NUMBER 위치의 칼럼에 대해 오름차순으로 정렬된 값을 출력한다. 칼럼의 타입이 숫자인 경우는 숫자로 정렬되고, 그렇지 않은 경우 문자열로 정렬된다. 생략되면 “Tran index”에 대한 정렬값을 보여준다.

다음은 네번째 칼럼인 “Process id”를 지정하여 정렬한 정보를 출력하는 예이다.

$ cubrid tranlist --sort-key=4 demodb

Tran index          User name      Host name      Process id    Program name              Query time    Tran time       Wait for lock holder      SQL_ID       SQL Text
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------
   1(ACTIVE)           public     test-server           1681    broker1_cub_cas_1               0.00         0.00                       -1     *** empty ***
   2(ACTIVE)           public     test-server           1682    broker1_cub_cas_2               0.00         0.00                       -1     *** empty ***
   3(ACTIVE)           public     test-server           1683    broker1_cub_cas_3               0.00         0.00                       -1     *** empty ***
   4(ACTIVE)           public     test-server           1684    broker1_cub_cas_4               1.80         1.80                  3, 1, 2     e5899a1b76253   update ta set a = 5 where a > 0
   5(ACTIVE)           public     test-server           1685    broker1_cub_cas_5               0.00         0.00                       -1     *** empty ***
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------

SQL_ID: e5899a1b76253
Tran index : 4
update ta set a = 5 where a > 0
--reverse

역순으로 정렬된 값을 출력한다.

다음은 “Tran index”의 역순으로 정렬한 정보를 출력하는 예이다.

Tran index          User name      Host name      Process id    Program name              Query time    Tran time     Wait for lock holder      SQL_ID       SQL Text
------------------------------------------------------------------------------------------------------------------------------------------------------------------------
   5(ACTIVE)           public     test-server           1685    broker1_cub_cas_5               0.00         0.00                     -1     *** empty ***
   4(ACTIVE)           public     test-server           1684    broker1_cub_cas_4               1.80         1.80                3, 2, 1     e5899a1b76253   update ta set a = 5 where a > 0
   3(ACTIVE)           public     test-server           1683    broker1_cub_cas_3               0.00         0.00                     -1     *** empty ***
   2(ACTIVE)           public     test-server           1682    broker1_cub_cas_2               0.00         0.00                     -1     *** empty ***
   1(ACTIVE)           public     test-server           1681    broker1_cub_cas_1               0.00         0.00                     -1     *** empty ***
------------------------------------------------------------------------------------------------------------------------------------------------------------------------

SQL_ID: e5899a1b76253
Tran index : 4
update ta set a = 5 where a > 0

killtran

cubrid killtran 은 대상 데이터베이스의 트랜잭션을 확인하거나 특정 트랜잭션을 강제 종료하는 유틸리티로서, DBA 사용자만 트랜잭션을 제거할 수 있다.

cubrid killtran [options] database_name
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • killtran: 지정된 데이터베이스에 대해 트랜잭션을 관리하는 명령어이다.

  • database_name: 대상 데이터베이스의 이름이다.

[options]에 따라 특정 트랜잭션을 지정하여 제거하거나, 현재 활성화된 트랜잭션을 화면 출력할 수 있다. 옵션이 지정되지 않으면, -d 옵션이 기본으로 적용되어 모든 트랜잭션을 화면 출력하며, cubrid tranlist 명령에 -s 옵션을 준 것과 동일하다.

$ cubrid killtran demodb

Tran index      User name   Host name      Process id      Program name
-------------------------------------------------------------------------------
   1(ACTIVE)          dba      myhost             664           cub_cas
   2(ACTIVE)          dba      myhost            6700              csql
   3(ACTIVE)          dba      myhost            2188           cub_cas
   4(ACTIVE)          dba      myhost             696              csql
   5(ACTIVE)       public      myhost            6944              csql
-------------------------------------------------------------------------------

다음은 cubrid killtran 에 대한 [options]이다.

-i, --kill-transaction-index=ID1,ID2,ID3

지정한 인덱스에 해당하는 트랜잭션을 제거한다. 쉼표(,)로 구분하여 제거하고자 하는 트랜잭션 ID 여러 개를 지정할 수 있다. 제거할 트랜잭션 리스트에 유효하지 않은 트랜잭션 ID가 지정되면 무시된다.:

$ cubrid killtran -i 1,2 demodb
Ready to kill the following transactions:

Tran index          User name      Host name      Process id      Program name
-------------------------------------------------------------------------------
   1(ACTIVE)              DBA         myhost           15771              csql
   2(ACTIVE)              DBA         myhost            2171              csql
-------------------------------------------------------------------------------
Do you wish to proceed ? (Y/N)y
Killing transaction associated with transaction index 1
Killing transaction associated with transaction index 2
--kill-user-name=ID

지정한 OS 사용자 ID에 해당하는 트랜잭션을 제거한다.

cubrid killtran --kill-user-name=os_user_id demodb
--kill-host-name=HOST

지정한 클라이언트 호스트의 트랜잭션을 제거한다.

cubrid killtran --kill-host-name=myhost demodb
--kill-program-name=NAME

지정한 이름의 프로그램에 해당하는 트랜잭션을 제거한다.

cubrid killtran --kill-program-name=cub_cas demodb
--kill-sql-id=SQL_ID

지정한 SQL ID에 해당하는 트랜잭션을 제거한다.

cubrid killtran --kill-sql-id=5377225ebc75a demodb
-p, --dba-password=PASSWORD

-i 또는 --kill 옵션들이 사용될 경우에만 해당 옵션을 사용할 수 있다. 이 옵션 뒤에 오는 값은 DBA 의 암호이며 생략하면 프롬프트에서 입력해야 한다.

-q, --query-exec-info

cubrid tranlist 명령에서 “User name” 칼럼과 “Host name” 칼럼이 출력되지 않는다는 점만 다르다. tranlist 를 참고한다.

-d, --display-information

기본 지정되는 옵션으로 트랜잭션의 요약 정보를 출력한다. cubrid tranlist 명령의 -s 옵션을 지정하여 실행한 것과 동일한 결과를 출력한다. tranlist -s 를 참고한다.

-f, --force

중지할 트랜잭션을 확인하는 프롬프트를 생략한다.

cubrid killtran -f -i 1 demodb

checkdb

cubrid checkdb 유틸리티는 데이터베이스를 확인하기 위해 사용된다. cubrid checkdb 유틸리티를 사용하면 인덱스와 다른 데이터 구조를 확인하기 위해 데이터와 로그 볼륨의 내부적인 물리적 일치를 확인할 수 있다. 만일 cubrid checkdb 유틸리티의 실행 결과가 불일치로 나온다면 --repair 옵션으로 자동 수정을 시도해 보아야 한다.

cubrid checkdb [options] database_name [schema_name.table_name [{, schema_name.table_name}]]
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티

  • checkdb: 대상 데이터베이스에 대하여 데이터의 일관성(consistency)을 확인하는 명령

  • database_name: 일관성을 확인하거나 복구하려는 데이터베이스 이름

  • schema_name: 테이블의 스키마 이름

  • table_name: 일관성을 확인하거나 복구하려는 테이블 이름을 나열한다.

다음은 cubrid checkdb에 대한 [options]이다.

-S, --SA-mode

서버 프로세스를 구동하지 않고 데이터베이스에 접근하는 독립 모드(standalone)로 작업하기 위해 지정되며, 인수는 없다. -S 옵션을 지정하지 않으면, 시스템은 클라이언트/서버 모드로 인식한다.

cubrid checkdb -S demodb
-C, --CS-mode

서버 프로세스와 클라이언트 프로세스를 각각 구동하여 데이터베이스에 접근하는 클라이언트/서버 모드로 작업하기 위한 옵션이며, 인수는 없다. -C 옵션을 지정하지 않더라도 시스템은 기본적으로 클라이언트/서버 모드로 인식한다.

cubrid checkdb -C demodb
-r, --repair

데이터베이스의 일관성에 문제가 발견되었을 때 복구를 수행한다.

cubrid checkdb -r demodb

인덱스의 앞을 가리키는 링크(previous link)에 오류가 있는지를 검사한다.

$ cubrid checkdb --check-prev-link demodb

인덱스의 앞을 가리키는 링크(previous link)에 오류가 있으면 복구한다.

$ cubrid checkdb --repair-prev-link demodb
-i, --input-class-file=FILE

-i FILE 옵션을 지정하거나, 데이터베이스 이름 뒤에 테이블의 이름을 나열하여 일관성 확인 또는 복구 대상을 한정할 수 있다. 두 가지 방법을 같이 사용할 수도 있으며, 대상을 지정하지 않으면 전체 데이터베이스를 대상으로 일관성을 확인하거나 복구를 수행한다. 특정 대상이 지정되지 않으면 전체 데이터베이스가 일관성 확인 또는 복구의 대상이 된다.

cubrid checkdb demodb public.table_1 public.table_2
cubrid checkdb -r demodb public.table_1 public.table_2
cubrid checkdb -r -i table_list.txt demodb public.table_1 public.table_2

-i 옵션으로 지정하는 테이블 목록 파일은 공백, 탭, 줄바꿈, 쉼표로 테이블 이름을 구분한다. 다음은 테이블 목록 파일의 예로, t1부터 t10까지를 모두 일관성 확인 또는 복구를 위한 테이블로 인식한다.

t1 t2 t3,t4 t5
t6, t7 t8   t9

     t10
--check-file-tracker

파일 트랙커(tracker)의 모든 파일의 페이지에 검사를 수행한다.

--check-heap

모든 힙 파일에 대해 검사를 수행한다.

--check-catalog

카탈로그 정보에 대한 일관성 검사를 수행한다.

--check-btree

모든 B-트리 인덱스에 대한 유효 검사를 수행한다.

--check-class-name

클래스 이름 해시 테이블과 힙 파일로 부터 가져온 클래스 정보(class oid)의 일치 여부 검사를 수행한다.

--check-btree-entries

모든 B-트리 영역(entry)의 일관성 검사를 수행한다.

-I, --index-name=INDEX_NAME

검사 대상 테이블에 대해 해당 옵션으로 명시한 인덱스가 유효한지 검사한다. 이 옵션을 사용하면 힙 파일에 대한 유효 검사는 하지 않는다. 이 옵션을 사용할 때는 하나의 테이블과 하나의 인덱스만을 허용하며, 테이블 이름을 입력하지 않거나 두 개 이상의 테이블 이름을 입력하면 에러를 반환한다.

diagdb

cubrid diagdb 유틸리티를 이용해 다양한 데이터베이스 내부 정보를 확인할 수 있다. cubrid diagdb 유틸리티가 제공하는 정보들은 현재 데이터베이스의 상태를 진단하거나 문제를 파악하는데 도움이 된다.

cubrid diagdb [option] database_name
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • diagdb: CUBRID에 저장되는 바이너리 형태의 파일 정보를 텍스트 형태로 출력하여 현재의 데이터베이스 저장 상태를 확인하고자 할 때 사용하는 명령어이다. 데이터베이스가 구동 정지 상태인 경우에만 정상적으로 수행된다. 전체를 확인하거나 옵션을 사용하여 파일 테이블, 파일 용량, 힙 용량, 클래스 이름, 디스크 비트맵을 선택해 확인할 수 있다.

  • database_name: 내부 정보를 확인하려는 데이터베이스 이름이다.

다음은 cubrid diagdb 에서 사용하는 [option]이다.

-d, --dump-type=TYPE

데이터베이스의 전체 파일에 대한 기록 상태를 출력할 때 출력 범위를 지정한다. 생략하면 기본값인 -1이 지정된다.

cubrid diagdb -d 1 demodb

-d 옵션에 적용되는 타입은 모두 9가지로, 그 종류는 다음과 같다.

타입

설명

-1

전체 데이터베이스 정보를 출력한다.

1

파일 테이블 정보를 출력한다.

2

파일 용량 정보를 출력한다.

3

힙 용량 정보를 출력한다.

4

인덱스 용량 정보를 출력한다.

5

클래스 이름 정보를 출력한다.

6

디스크 비트맵 정보를 출력한다.

7

카탈로그 정보를 출력한다.

8

로그 정보를 출력한다.

9

힙(heap) 정보를 출력한다.

-o, --output-file=FILE

-o 옵션은 데이터베이스의 서버/클라이언트 프로세스에서 사용되는 파라미터 정보를 지정된 파일로 저장하는 데 사용된다. 이 파일은 현재 디렉터리에 생성된다. -o 옵션을 지정하지 않으면 콘솔 화면에 메시지가 표시된다.

cubrid diagdb -d8 -o logdump_output demodb
--emergency

복구를 생략(suppression)하려면 --emergency 옵션을 사용한다. 이 옵션은 디버깅에만 사용해야 한다. 복구 이슈가 있는 경우 이 옵션을 사용하기 전에 데이터베이스를 백업할 것을 권장한다.

paramdump

cubrid paramdump 유틸리티는 서버/클라이언트 프로세스에서 사용하는 파라미터 정보를 출력한다.

cubrid paramdump [options] database_name
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.

  • paramdump: 서버/클라이언트 프로세스에서 사용하는 파라미터 정보를 출력하는 명령이다.

  • database_name: 파라미터 정보를 출력할 데이터베이스 이름이다.

다음은 cubrid paramdump 에서 사용하는 [options]이다.

-o, --output-file=FILE

데이터베이스의 서버/클라이언트 프로세스에서 사용하는 파라미터 정보를 지정된 파일에 저장하는 옵션이며, 파일은 현재 디렉터리에 생성된다. -o 옵션이 지정되지 않으면 메시지는 콘솔 화면에 출력한다.

cubrid paramdump -o db_output demodb
-b, --both

데이터베이스의 서버/클라이언트 프로세스에서 사용하는 파라미터 정보를 콘솔 화면에 출력하는 옵션이며, -b 옵션을 사용하지 않으면 서버 프로세스의 파라미터 정보만 출력한다.

cubrid paramdump -b demodb
-S, --SA-mode

독립 모드에서 서버 프로세스의 파라미터 정보를 출력한다.

cubrid paramdump -S demodb
-C, --CS-mode

클라이언트-서버 모드에서 서버 프로세스의 파라미터 정보를 출력한다.

cubrid paramdump -C demodb

tde

cubrid tde 유틸리티는 데이터베이스의 TDE 암호화를 관리하기 위하여 사용되며, DBA 사용자만 수행할 수 있다. cubrid tde 유틸리티를 사용하면 데이터베이스에 등록된 키를 변경할 수 있고, 키 파일에 새로운 키를 안정적으로 추가하고 제거할 수 있다. 또한, 지금까지 키 파일에 추가된 키들과 데이터베이스에 등록된 키가 무엇인지 조회할 수 있다. 자세한 내용은 TDE (Transparent Data Encryption) 을 참고한다.

cubrid tde <operation> [option] database_name
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티

  • tde: 대상 데이터베이스에 적용된 TDE 암호화에 대한 관리 도구

  • operation: 도구를 통한 수행할 작업을 지정한다. 키 조회, 키 추가, 키 제거, 키 변경 네 가지 종류가 있으며 하나의 작업이 주어져야 한다.

  • database_name: TDE 관리 작업을 수행하려는 데이터베이스 이름

다음은 cubrid tde 에 대한 오퍼레이션 (operation)에 대한 설명이다. 다음 중 하나의 작업이 주어져야 한다.

-s, --show-keys

데이터베이스에 등록된 키와 키 파일 (_keys)내의 키들에 대한 정보를 출력한다.

$ cubrid tde -s testdb
Key File: /home/usr/CUBRID/databases/testdb/testdb_keys

The current key set on testdb:
Key Index: 2
Created on Fri Nov 27 11:14:54 2020
Set     on Fri Nov 27 11:15:30 2020

Keys Information:
Key Index: 0 created on Fri Nov 27 11:11:27 2020
Key Index: 1 created on Fri Nov 27 11:14:47 2020
Key Index: 2 created on Fri Nov 27 11:14:54 2020
Key Index: 3 created on Fri Nov 27 11:14:55 2020

The number of keys: 4

The current key 정보는 현재 데이터베이스에 등록된 키의 정보이다. 키 파일내에서의 인덱스와 키의 생성시간, 등록된 시간을 출력해준다. 키 인덱스와 생성시간으로 등록된 키를 식별할 수 있고, 등록된 시간을 통해 키 변경 계획을 수립할 수 있다.

Keys Information 은 키 파일 내에서 생성되어 관리되고 있는 키들을 보여준다. 키 인덱스와 생성시간을 확인할 수 있다.

-n, --generate-new-key

키 파일 (_keys)에 새로운 키를 추가한다 (최대 128개). 성공할 경우 추가된 키의 인덱스를 출력해주며, 이 인덱스는 이후 키를 변경하거나 제거할 때에 키를 식별하기 위하여 사용된다. 추가된 키들의 정보는 --show-keys 를 통해 확인할 수 있다.

$ cubrid tde -n testdb
Key File: /home/usr/CUBRID/databases/testdb/testdb_keys

SUCCESS: A new key has been generated - key index: 1 created on Tue Dec  1 11:30:47 2020
-d, --delete-key=KEY_INDEX

키 파일 (_keys)에서 인덱스로 지정된 키 하나를 제거한다. 현재 데이터베이스에 등록된 키는 제거할 수 없다.

$ cubrid tde -d 1 testdb
Key File: /home/usr/CUBRID/databases/testdb/testdb_keys

SUCCESS: The key (index: 1) has been deleted
-c, --change-key=KEY_INDEX

데이터베이스에 등록된 키를 키 파일 (_keys)에 존재하는 다른 키로 변경한다. 변경 시에 이전에 등록된 키와 새로 등록하려는 키가 모두 존재해야 한다.

$ cubrid tde -c 2 testdb
Key File: /home/usr/CUBRID/databases/testdb/testdb_keys

Trying to change the key from the key (index: 0) to the key (index: 2)..
SUCCESS: The key has been changed from the key (index: 0) to the key (index: 2)

데이터베이스에 등록된 키를 변경하기 위해서는 먼저 --generate-new-key 를 통해 등록할 키를 생성해야 한다. 사용자는 키 변경을 위해 새로운 키를 생성할 수 있고, 미리 여러 키를 생성해 두고 보안 계획에 따라 키를 변경할 수 있다.

다음은 cubrid tde 에서 사용하는 [options]이다.

-p, --dba-password=PASSWORD

이 옵션 뒤에 오는 값은 DBA 의 암호이며 생략하면 프롬프트에서 입력해야 한다.

flashback

cubrid flashback 유틸리티는 커밋된 트랜잭션을 되돌릴 수 있는 SQL 구문을 제공하며, DBA 사용자만 수행할 수 있다. cubrid flashback 을 수행하기 위해서는 시스템 파라미터 supplemental_log 를 반드시 0보다 큰 값으로 설정해야 하며, supplemental_log 가 설정된 후에 실행되는 DML에 대해서만 지원한다.

cubrid flashback [options] database_name owner_name.class_name1 [owner_name.class_name2, ...]
  • cubrid: CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티

  • flashback: 커밋된 특정 트랜잭션을 되돌릴 수 있도록 SQL 구문을 제공하는 도구

  • database_name: 되돌리고자 하는 트랜잭션이 수행된 데이터베이스 이름

  • owner_name.class_name: 되돌리고자 하는 테이블명 리스트. 테이블명을 명시할 때는 해당 테이블의 소유자명도 함께 명시해야 한다.

다음 예제에서는 사용자가 “cubrid flashback demodb dba.tbl”를 수행했을 때 출력되는 결과를 보여준다.

$ csql -u dba demodb

csql> CREATE TABLE tbl (a INT);
csql> INSERT INTO tbl VALUES (10);

$ cubrid flashback demodb dba.tbl

Flashback Summary
Number of Transaction: 1
Start date - End date: 03-05-2022:10:52:56 - 03-05-2022:11:02:56
Transaction id  User name                         Start time            End time              Num_insert  Num_update  Num_delete  Table
           135  DBA                               03-05-2022:11:02:40   03-05-2022:11:02:41            1           0           0  dba.tbl
Enter transaction id (press -1 to quit): 135

delete from [dba.tbl] where [a] = 10 limit 1;

위의 예에서 cubrid flashback 을 실행하면 지정된 기간 내에 수행된 트랜잭션에 대한 정보를 표시한다. 사용자가 기간을 지정하지 않으면 현재 시각으로부터 10분 전에 수행된 트랜잭션들부터 표시된다. 사용자가 트랜잭션 식별자(Transaction ID)를 선택하면, 선택한 트랜잭션 내에서 실행된 DML에 대하여 되돌릴 수 있도록 SQL 구문을 제공한다. 사용자는 300초 이내에 트랜잭션 식별자를 입력해야하며, 해당 제한 시간은 시스템 파라미터 flashback_timeout 을 통해 조절할 수 있다.

Flashback Summary 에 표시된 각 칼럼의 의미는 다음과 같다.

  • Transaction id : 트랜잭션 식별자

  • User name : 트랜잭션을 수행한 사용자

  • Start time : 트랜잭션을 시작한 시간 (추정시간)

  • End time : 트랜잭션이 완료된 시간

  • Num_insert : 트랜잭션 내에서 수행된 삽입(insert) 연산 횟수

  • Num_update : 트랜잭션 내에서 수행된 수정(update) 연산 횟수

  • Num_delete : 트랜잭션 내에서 수행된 삭제(delete) 연산 횟수

  • Table : 트랜잭션 내에서 DML이 수행된 테이블명 리스트

Note

cubrid flashback 을 통해 되돌리려는 테이블이 트리거 이벤트 대상 일 경우, 사용자가 의도하지 않은 결과를 얻을 수 있다. cubrid flashback 을 통해 테이블에 대한 변경 사항을 되돌리기 전에 트리거를 비활성화하는 것이 좋다. 자세한 내용은 ALTER TRIGGER 을 참조한다.

다음은 cubrid flashback 에서 사용하는 [options]이다.

-o, --output-file=FILE

특정 트랜잭션을 되돌리기 위한 SQL 구문들을 지정된 파일에 저장하는 옵션이다. -o 옵션을 지정하지 않으면 콘솔 화면에 메시지가 표시된다.

cubrid flashback -o db_output demodb dba.tbl
-u, --user=ID

트랜잭션을 수행한 사용자를 지정하며, 해당 사용자가 수행한 트랜잭션에 대해서만 Flashback Summary 에 표시된다. -u 옵션을 지정하지 않으면 모든 사용자에 의해 수행된 트랜잭션들이 표시된다.

$ csql -u public demodb

csql> CREATE TABLE tbl (a int);
csql> INSERT INTO tbl VALUES (10);

csql> CALL login ('dba', '') ON CLASS db_user;

csql> INSERT INTO public.tbl VALUES (20);

$ cubrid flashback -u public demodb dba.tbl

Flashback Summary
Number of Transaction: 1
Start date - End date: 03-05-2022:10:52:56 - 03-05-2022:11:02:56
Transaction id  User name                         Start time            End time              Num_insert  Num_update  Num_delete  Table
           135  PUBLIC                            03-05-2022:11:02:40   03-05-2022:11:02:41            1           0           0  public.tbl
Enter transaction id (press -1 to quit): 135

delete from [public.tbl] where [a] = 10 limit 1;
-p, --dba-password=PASSWORD

이 옵션 뒤에 오는 값은 DBA 의 암호이며 생략하면 프롬프트에서 입력해야 한다.

-s, --start-date=DATE

dd-mm-yyyy:hh:mi:ss (e.g. 28-04-2022:14:10:00) 형식으로 시작 날짜를 지정한다. 커밋된 트랜잭션 중에서 지정된 날짜 이후에 시작했거나 진행중인 트랜잭션들을 찾기 위해 사용된다.

cubrid flashback -s 28-04-2022:14:10:00 demodb dba.tbl
-e, --end-date=DATE

dd-mm-yyyy:hh:mi:ss (e.g. 28-04-2022:14:10:00) 형식으로 종료 날짜를 지정한다. 지정된 날짜 이전에 커밋된 트랜잭션들을 찾기 위해 사용된다.

시작 날짜를 지정하지 않으면 시작 날짜는 종료 날짜로부터 10분 전 시간으로 설정된다. 또한 종료 날짜가 지정되지 않으면 종료 날짜는 시작 날짜 10분 후 시간으로 설정된다. 만약 시작 날짜 및 종료 날짜가 지정되지 않으면, 10분 전부터 현재 시각까지 수행된 트랜잭션들이 표시된다.

cubrid flashback -e 28-04-2022:14:10:00 demodb dba.tbl
--detail

트랜잭션을 되돌리기 위한 각 SQL 구문들에 대해 자세한 정보를 보여준다. 트랜잭션 식별자, 트랜잭션을 수행한 사용자, 원본 SQL을 함께 제공한다. 원본 SQL은 사용자가 실행한 정확한 구문이 아니고, 단순히 행 단위로 실행되는 삽입/수정/삭제 문으로 사용자가 수행했던 구문을 나타낸 것이다. 예를 들어, INSERT … SELECT 문은 여러 개의 삽입 문으로 표현된다. --detail 옵션을 지정하지 않으면, 트랜잭션을 되돌리기 위해 사용할 SQL 구문만 표시된다.

cubrid flashback --detail demodb dba.tbl

Flashback Summary
Number of Transaction: 1
Start date - End date: 03-05-2022:10:52:56 - 03-05-2022:11:02:56
Transaction id  User name                         Start time            End time              Num_insert  Num_update  Num_delete  Table
           135  DBA                               03-05-2022:11:02:40   03-05-2022:11:02:41            1           0           0  dba.tbl
Enter transaction id (press -1 to quit): 135

[TRANSACTION ID] 135
[USER]           DBA
[ORIGINAL]       insert into [dba.tbl] values (10);
[FLASHBACK]      delete from [dba.tbl] where [a] = 10 limit 1;
--oldest

지정된 트랜잭션 내에서 수행된 SQL 구문들을 시간 순서로 표시한다. --oldest 옵션을 지정하지 않으면, 트랜잭션 내에서 수행된 SQL 구문들을 시간 역순으로 표시한다.

cubrid flashback --oldest demodb dba.tbl

HA 명령어

cubrid changemode 유틸리티는 서버의 HA 모드 출력 또는 변경하는 유틸리티이다.

cubrid applyinfo 유틸리티는 HA 환경에서 트랜잭션 로그 반영 정보를 확인하는 유틸리티이다.

자세한 사용법은 cubrid service에 HA 등록 을 참고한다.

로캘 명령어

cubrid genlocale 유틸리티는 사용하고자 하는 로캘(locale) 정보를 컴파일하는 유틸리티이다. 이 유틸리티는 make_locale.sh (Windows는 .bat) 스크립트 내에서 실행된다.

cubrid dumplocale 유틸리티는 컴파일된 바이너리 로캘(CUBRID 로케일 라이브러리) 파일을 사용자가 읽을 수 있는 형식으로 콘솔에 출력한다. 출력 정보는 리다이렉션(redirection)을 사용해서 저장해 두는 것이 좋다.

cubrid synccolldb 유틸리티는 데이터베이스와 로캘 라이브러리 사이의 콜레이션 불일치 여부를 체크하고, 불일치하는 경우 동기화한다.

자세한 사용법은 로캘 설정 을 참고한다.

타임존 명령어

cubrid gen_tz 유틸리티는 다음과 같이 두 가지 모드가 있다.:

  • new 모드는 tzdata 폴더에 저장된 IANA 타임존 데이터를 C 소스 코드 파일로 컴파일할 때 사용한다. 이후 이 파일은 make_tz.sh (Linux) / make_tz.bat (Windows) 스크립트를 통해 Linux용 .so 공유 라이브러리나 Windows용 .dll 라이브러리로 변환된다.

  • extend 모드는 new 모드와 비슷하지만 타임존 데이터를 다른 버전으로 갱신하고 기존 데이터와의 호환성을 유지하려고 할 때 사용하며, 항상 데이터베이스명 인자와 함께 사용한다. 단순히 두 가지 버전의 타임존 데이터를 병합하여 이전 데이터와의 호환성을 유지할 수 없는 경우에는 데이터베이스 테이블의 데이터를 갱신하기 위해 이 모드를 사용한다. Linux에서는 make_tz.sh -g extend 를 사용하고 Windows에서는 make_tz.bat /extend 를 사용한다.

cubrid dump_tz 유틸리티는 컴파일된 CUBRID 타임존 라이브러리 파일을 콘솔에서 사용자가 읽을 수 있는 형식으로 출력한다. 출력 정보는 리다이렉션(redirection)을 사용해서 저장해 두는 것이 좋다.