Open Source RDBMS - Seamless, Scalable, Stable and Free

한국어 | Login |Register

Versions available for this page: CUBRID 8.3.0 |  CUBRID 8.3.1 |  CUBRID 8.4.0 |  CUBRID 8.4.1 |  CUBRID 8.4.3 |  CUBRID 9.0.0 | 

데이터베이스 볼륨 추가

설명

데이터베이스 볼륨을 추가한다.

구문

cubrid addvoldb options database_name

options :

[--db-volume-size=size] [{-n |--volume_name=}name] [{-F |--file-path=}path] [--comment=comment] [-p|--purpose] [-S|--SA-mode|-C|--CS-mode]

  • cubrid  :  CUBRID 서비스 및 데이터베이스 관리를 위한 통합 유틸리티이다.
  • addvoldb : 지정된 데이터베이스에 지정된 페이지 수만큼 새로운 볼륨을 추가하기 위한 명령이다.
  • options  :  단축 옵션은 -와 함께 지정해야 하고, 전체 옵션은 --와 함께 지정해야 한다.
  • database_name : 데이터베이스가 생성될 디렉터리 경로명을 포함하지 않고, 볼륨을 추가하고자 하는 데이터베이스의 이름을 지정한다.
옵션

다음은 cubrid addvoldb유틸리티와 함께 사용할 수 있는 옵션을 정리한 표이다.

옵션

설명

--db-volume-size

추가되는 데이터베이스 볼륨의 크기를 바이트 단위로 지정한다.
기본값 : 시스템 파라미터 db_volume_size의 값

-n
--volume-name

추가되는 데이터베이스 볼륨의 이름을 지정한다.
기본값 :  시스템에 의해 dbname_number의 형식으로 부여

-F
--file-path

추가되는 데이터베이스 볼륨이 생성될 디렉터리 경로를 지정한다.
기본값 : 시스템 파라미터인 volume_extension_path의 설정 값

--comment

추가되는 데이터베이스 볼륨에 관한 주석을 입력한다.

-p
--purpose

추가되는 데이터베이스 볼륨의 용도를 지정한다.
기본값 : 범용(generic) 볼륨

-S
--SA-mode

독립 모드에서 데이터베이스 볼륨 추가 작업을 실행한다.

-C
--CS-mode

클라이언트/서버 모드(client/server)에서 데이터베이스 볼륨 추가 작업을 실행한다.

추가되는 데이터베이스 볼륨 크기(--db-volume-size)

--db-volume-size 옵션은 추가되는 데이터베이스 볼륨의 크기를 지정하는 옵션으로, 기본값은 cubrid.conf에 지정된 시스템 파라미터 db_volume_size의 값이다. K, M, G, T로 단위를 설정할 수 있으며, 각각 KB(kilobytes), MB(megabytes), GB(gigabytes), TB(terabytes)를 의미한다. 단위를 생략하면 바이트 단위가 적용된다.

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

cubrid addvoldb -p data --db-volume-size=256M testdb

확장 볼륨 이름(-n)

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

다음은 독립모드(standalone) 상태에서 testdb라는 데이터베이스에 256MB 볼륨을 추가하는 구문이며, 생성되는 볼륨명은 testdb_v1이 된다.

cubrid addvoldb -S -n testdb_v1 --db-volume-size=256M testdb

볼륨 확장 경로(-F)

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

다음은 독립모드(standalone) 상태에서 testdb라는 데이터베이스에 256MB 볼륨을 추가하는 구문이며, 추가 볼륨은 /dbtemp/addvol 디렉터리에 생성된다. 볼륨명에 관한 -n 옵션을 지정하지 않았으므로, 생성되는 볼륨명은 testdb_x001이 된다.

cubrid addvoldb -S -F /dbtemp/addvol/ --db-volume-size=256M testdb

추가 볼륨에 관한 주석(--comment)

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

다음은 독립모드(standalone) 상태에서 testdb라는 데이터베이스에 256MB 볼륨을 추가하는 구문이며, 해당 볼륨에 관한 정보를 주석으로 남긴다.

cubrid addvoldb -S --comment "데이터 볼륨 추가_김철수" --db-volume-size=256M testdb

볼륨 용도(-p)

-p 옵션은 추가할 볼륨의 사용 목적에 따라 볼륨의 종류를 지정하는 옵션이다. 이처럼 볼륨의 사용 목적에 맞는 볼륨을 지정해야 볼륨 종류별로 디스크 드라이브에 분리 저장할 수 있어 I/O 성능을 높일 수 있다. -p 옵션의 파라미터로 가능한 값은 data, index, temp, generic 중 하나이며, 기본값은 generic이다. 각 볼륨 용도에 관해서는 데이터베이스 볼륨 구조를 참조한다.

다음은 독립모드(standalone) 상태에서 testdb라는 데이터베이스에 256MB 인덱스 볼륨을 추가하는 구문이다.

cubrid addvoldb -S -p index --db-volume-size=256M testdb

독립 모드(-S)

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

cubrid addvoldb -S --db-volume-size=256M testdb

클라이언트/서버 모드(-C)

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

cubrid addvoldb -C --db-volume-size=256M testdb

예제

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

cubrid createdb --db-volume-size=512M --log-volume-size=256M cubriddb

cubrid addvoldb -p data -n cubriddb_DATA01 --db-volume-size=512M cubriddb

cubrid addvoldb -p data -n cubriddb_DATA02 --db-volume-size=512M cubriddb

cubrid addvoldb -p index -n cubriddb_INDEX01 cubriddb --db-volume-size=512M cubriddb

cubrid addvoldb -p temp -n cubriddb_TEMP01 cubriddb --db-volume-size=512M cubriddb