오픈소스 RDBMS 큐브리드(CUBRID) 사용하기 - 데이터베이스 생성, CSQL 사용법, User 생성 및 변경 조작

지난시간에는 국산 오픈소스 RDBMS인 큐브리드를 설치해보았습니다. 오늘은 큐브리드를 사용하여 간단하게 DB를 만들고 테스트하는 방법을 알아보겠습니다.

Table Of Contents

• CUBRID DB 생성하기
• CUBRID 데이터베이스 시작
• CUBRID 대화형 작업 도구를 통한 기본 명령 수행
  • 테이블 조회, 생성, 삭제
• admin 접속 및 User 생성
  • admin(관리자, DBA) 모드
  • 사용자 생성

큐브리드 설치하는 법 보러 가기

 

우분투에서 CUBRID를 처음 사용하는데 참고할 수 있는 간략한 사용법을 알아보기 위해서, 큐브리드 매뉴얼의 "CUBRID 서비스 시작하기" 항목을 참고하여 테스트 해보겠습니다.

해당 페이지는 아래의 링크를 참고하시면 됩니다.

 

시작하기 — CUBRID 11.3.0 documentation

 

CUBRID DB 생성하기

CUBRID의 createdb 유틸리티는 CUBRID 시스템에서 데이터베이스를 생성하고 미리 정의된 CUBRID 시스템 테이블을 초기화합니다. 또한, 초기 사용자에 대한 권한을 설정할 수도 있습니다. 이 유틸리티는 일반적으로 데이터베이스 관리자만이 사용합니다.

데이터베이스를 생성할 때는 데이터베이스 이름 뒤에 로케일 이름과 문자셋(예: ko_KR.utf8)을 꼭 지정해야 합니다. 이는 문자셋에 따라 문자열 타입의 크기나 문자열 비교 연산 등에 영향을 미칩니다. 또한, 데이터베이스 생성 시 한 번 지정된 문자셋은 변경할 수 없으므로 주의하여 지정해야 합니다.

 

cubrid createdb 명령은 새로운 데이터베이스를 생성하는 데 사용됩니다. 데이터베이스 이름을 입력하실 때는 디렉터리 경로를 포함하지 않고 고유한 이름을 선택해주세요. 이미 존재하는 이름을 선택하시면 데이터베이스 생성이 중지됩니다.

로케일 이름과 문자셋을 입력해야 하는데요. 사용 가능한 로케일 이름은 en_US와 ko_KR 등이 있으며, 문자셋은 iso88591, euckr, utf8 중 선택하실 수 있어요. 기본값은 iso88591이고, ko_KR을 선택하시면 utf8이 기본값으로 설정됩니다.

전체 사용가능한 로케일은 아래 표를 참고하실 수 있습니다.

옵션에 대해서는 아래와 같습니다.

    --db-volume-size=SIZE           처음 생성되는 볼륨(generic)의 크기
    --db-page-size=SIZE             바이트 단위의 데이터베이스 페이지 크기
    --log-volume-size=SIZE          로그 볼륨의 크기
    --log-page-size=SIZE            바이트 단위의 로그 페이지 크기
    --comment=COMMENT               데이터베이스에 관한 설명
-F, --file-path=PATH                데이터베이스가 생성되는 디렉터리 경로
-L, --log-path=PATH                 로그 볼륨이 저장되는 디렉터리 경로
-B, --lob-base-path=PATH            LOB 파일이 저장되는 디렉터리 경로
    --server-name=HOST              서버 호스트 이름
-r, --replace                       같은 이름의 데이터베이스가 존재하면 덮어쓰기
    --more-volume-file=FILE         추가로 확장될 볼륨에 대한 제어 파일
    --user-definition-file=FILE     데이터베이스 사용자를 정의하는 파일
    --csql-initialization-file=FILE 데이터베이스 생성 후 CSQL에서 FILE에 저장된 질의문을 실행
-o, --output-file=FILE              출력 메시지를 파일에 저장
-v, --verbose                       상세한 상태 정보를 화면 출력

 

 

한글 로케일의 utf8 문자셋을 지정하여 데이터베이스를 다음과 같이 생성할 수 있습니다.

아래 명령은 tpcc라는 database이름의 db를 현재 디렉토리에 생성하는 명령입니다.

cubrid:~/database$ cubrid createdb tpcc ko_KR.utf8
Creating database with 512.0M size using locale ko_KR.utf8. The total amount of disk space needed is 1.5G.

CUBRID 11.3

cubrid:~/database$ ls
lob  tpcc  tpcc_keys  tpcc_lgar_t  tpcc_lgat  tpcc_lginf  tpcc_vinf

 

 

CUBRID 데이터베이스 시작

앞에서 생성한 CUBRID 데이터베이스 프로세스를 시작하려면 cubrid server start 명령어를 사용할 수 있습니다.
아래와 같이 시작되는 것을 확인할 수 있습니다.

~$ cubrid server start tpcc
@ cubrid master start
++ cubrid master start: success
@ cubrid server start: tpcc

This may take a long time depending on the amount of recovery works to do.

CUBRID 11.3

++ cubrid server start: success
java_stored_procedure system parameter is not enabled
Calling java stored procedure is not allowed

 

뒷 부분에 데이터베이스 이름인 tpcc를 명시하지 않고, CUBRID 서비스 시작(cubrid service start) 시 tpcc가 같이 시작되게 하려면, CUBRID 환경 변수의 디렉토리 아래에 있는 conf/cubrid.conf 파일에 server 파라미터를 tpcc로 설정할 수 있습니다.

% vi cubrid.conf

[service]

service=server,broker,manager
server=tpcc

 

서비스를 시작시키고 실행된 프로세스를 확인해 보면 다음과 같습니다. cub_master와 cub_server가 실행되고 있으며 cub_server는 tpcc라는 database로 실행된 것을 확인할 수 있습니다.

$ ps -ef |grep cubrid
cubrid    626491       1  0 13:09 pts/5    00:00:00 cub_master
cubrid    626494       1  7 13:09 ?        00:00:02 cub_server tpcc
cubrid    626722  624005  0 13:09 pts/5    00:00:00 ps -ef
cubrid    626723  624005  0 13:09 pts/5    00:00:00 grep cubrid

 

CUBRID 대화형 작업 도구를 통한 기본 명령 수행

CSQL 인터프리터는 큐브리드에서 SQL 질의문을 수행하기 위한 도구입니다. 사용자는 그래픽 사용자 인터페이스(GUI) 기반의 큐브리드 매니저나 콘솔 기반의 CSQL 인터프리터를 사용할 수 있습니다.

CSQL 인터프리터는 대화형(interactive) 방식과 일괄 수행(batch) 방식으로 SQL 질의를 수행하고 결과를 조회할 수 있습니다. 사용자는 명령어 라인 입력 방식의 인터페이스를 통해 SQL 문장을 입력하고, 결과를 파일에 저장할 수도 있습니다.
데이터베이스 조회, 갱신, 삭제 등의 작업을 SQL 문을 이용해 수행할 수 있으며, 외부 셸 명령 실행, 조회 결과의 저장 혹은 출력, SQL 스크립트 파일의 작성 및 실행 등 다양한 기능을 제공합니다.

 

테이블 조회, 생성, 삭제

그러면 먼저, 접속하는 법 부터 진행해 보겠습니다.

로컬 접속을 위해서는 아래와 같이 간단하게 csql 명령어와 데이터베이스 이름을 붙이면 접속이 됩니다.

저는 아직 사용자를 만든적이 없는데, 잘 접속되고 테이블도 생성됩니다. 그래서, 매뉴얼을 좀 확인해 보니 PUBLIC이라는 기본 사용자로 접속된다고 합니다.

아래 예제에서 보시는 것처럼 drop tables;라고 명령을 잘못 쳤을때, public.tables를 찾는 것을 봐서는 public으로 접속된을 확인할 수 있습니다.

~$ csql tpcc

        CUBRID SQL Interpreter


Type `;help' for help messages.

csql> show tables;

=== <Result of SELECT Command in Line 1> ===

There are no results.
0 row selected. (0.030220 sec) Committed. (0.000083 sec)

1 command(s) successfully processed.
csql> create table t1(i1 integer);
Execute OK. (0.013535 sec) Committed. (0.002444 sec)

1 command(s) successfully processed.
csql> show tables;

=== <Result of SELECT Command in Line 1> ===

  Tables_in_tpcc
======================
  't1'

1 row selected. (0.020890 sec) Committed. (0.000095 sec)

1 command(s) successfully processed.
csql> drop tables;

In line 1, column 12,

ERROR: before ' ; '
Unknown class "public.tables".


0 command(s) successfully processed.
csql> drop table t1;
Execute OK. (0.026352 sec) Committed. (0.005133 sec)

1 command(s) successfully processed.
csql>
csql> ;ex

 

추가로 원격접속을 위해서는 다음과 같이 데이터베이스 명 뒤에 "@"를 붙이고 원격 호스트를 입력하면 됩니다.

$ csql tpcc@localhost

        CUBRID SQL Interpreter


Type `;help' for help messages.

csql>

참고로 csql에서 나가기 위해서는 ";ex"를 치면 됩니다. csql의 명령어들은 세미콜론을 앞에 붙이고 나서 실행 가능합니다.

 

admin 접속 및 User 생성

admin(관리자, DBA) 모드

관리자 모드는 CSQL 인터프리터를 통해 특별한 관리 작업을 수행하기 위해 사용됩니다. 서버에 접속하는 사용자 수가 시스템 파라미터 max_clients의 값을 초과하더라도, CSQL 인터프리터를 통해 관리자 모드로 접속하면 추가적으로 한 개의 연결만 허용됩니다. 이 모드에서는 체크 포인트를 수행하거나 트랜잭션 모니터링을 종료하는 등의 작업을 수행할 수 있습니다.

명령어는 아래와 같습니다.

csql -u dba --sysadm <database_name>

 

~$ csql -u dba --sysadm tpcc

        CUBRID SQL Interpreter

Type `;help' for help messages.

sysadm>

 

사용자 생성

CUBRID는 기본적으로 DBA와 PUBLIC 두 종류의 사용자를 제공합니다. 제품을 처음 설치할 때는 비밀번호가 설정되어 있지 않습니다. 앞서 본 것처럼 기본적으로 접속하면 PUBLIC 사용자로 비밀번호 없이 접속이 가능합니다.

모든 사용자는 PUBLIC 사용자에게 부여된 권한을 가지고 있습니다. 데이터베이스의 모든 사용자는 PUBLIC의 멤버가 됩니다. 권한을 부여하는 방법은 주로 PUBLIC 사용자에 대한 권한을 설정하는 것입니다.

DBA는 데이터베이스 관리자를 위한 권한을 갖습니다. DBA는 자동으로 모든 사용자와 그룹의 멤버가 됩니다. 따라서 DBA는 모든 테이블에 대한 접근 권한을 갖게 됩니다. 이에 따라 DBA와 DBA의 멤버에게 명시적으로 권한을 부여할 필요가 없습니다.

 

데이터베이스에 사용자를 생성하고 수정하기 위해서는 CREATE/ALTER/DROP USER 구문을 사용합니다.

 

CREATE/ALTER/DROP USER

DBA 와 DBA 의 멤버는 SQL 문을 사용하여 사용자를 생성, 변경, 삭제할 수 있습니다. 앞에서 보신 것 처럼 admin으로 접속하면 DBA로 접속하게 됩니다.
그 후 아래의 명령을 통해서 사용자를 생성하고 조작하게 됩니다.

CREATE USER user_name
[PASSWORD password]
[GROUPS user_name [{, user_name } ... ]]
[MEMBERS user_name [{, user_name } ... ]]
[COMMENT 'comment_string'];

 

아래 명령은 비밀번호를 바꿀 때 사용합니다.

ALTER USER user_name PASSWORD password;

 

아래 명령은 사용자를 삭제할 때 사용합니다.

DROP USER user_name;

 

user_name: 생성, 삭제, 변경할 사용자 이름을 입력합니다.
password: 생성 혹은 변경할 사용자의 비밀번호를 입력합니다. 비워두면 없는 것입니다.
comment_string: 사용자에 대한 주석을 기록합니다.

 

위의 세 가지 명령어를 사용해서 tpcc라는 사용자를 생성하고 비밀번호를 변경 후 삭제해 보는 예제입니다.

sysadm> create user tpcc;
Execute OK. (0.004768 sec) Committed. (0.002885 sec)

1 command(s) successfully processed.
sysadm> alter user tpcc password tpcc;

In line 1, column 26,

ERROR: invalid password
  password spec: PASSWORD 'STRING'


0 command(s) successfully processed.
sysadm> alter user tpcc password 'tpcc';
Execute OK. (0.002679 sec) Committed. (0.003217 sec)

1 command(s) successfully processed.
sysadm> drop user tpcc;
Execute OK. (0.019388 sec) Committed. (0.002735 sec)

1 command(s) successfully processed.

 

여기서 주의하실 점은 password 뒤에는 '(따옴표)로 둘러쌓인 문자열이 와야합니다.

 

오늘은 국산 오픈소스 데이터베이스인 큐브리드에서 데이터베이스를 생성하고, CSQL을 통해서 admin으로 접속하는 법 그리고 일반 접속하는 법을 알아보았습니다. 접속 후 테이블을 조회하고 생성하고 삭제하는 법을 알아보았고, DBA로 접속해서 사용자를 생성하고 변경하고 삭제도 해보았습니다.

다음번에는 파이썬 언어의 pyodbc를 이용해서 큐브리드에 접속하고 데이터를 조작하는 방법을 알아보도록 하겠습니다.