CUBRID Manual KO 8.4.1

LIKE 조건식

2012-05-22T03:33:39-07:00

LIKE 조건식

설명

LIKE 조건식은 문자열 데이터 간의 패턴을 비교하는 연산을 수행하여, 검색어와 일치하는 패턴의 문자열이 검색되면 TRUE를 반환한다. 패턴 비교 대상이 되는 도메인은 CHAR, VARCHAR, STRING이며, NCHAR 또는 BIT 타입에 대해서는 LIKE 검색을 수행할 수 없다. LIKE 키워드 앞에 NOT이 있으면 LIKE 연산의 결과에 NOT 연산을 수행하여 결과를 반환한다.

LIKE 연산자 오른쪽에 오는 검색어에는 임의의 문자 또는 문자열에 대응되는 와일드 카드(wild card) 문자열을 포함할 수 있으며, %(percent)와 _(underscore)를 사용할 수 있다. %는 길이가 0 이상인 임의의 문자열에 대응되며, _는 1개의 문자에 대응된다. 또한, 이스케이프 문자(escape character)는 와일드 카드 문자 자체에 대한 검색을 수행할 때 사용되는 문자로서, 사용자에 의해 길이가 1인 다른 문자(NULL, 알파벳 또는 숫자)로 지정될 수 있다. 와일드 카드 문자 또는 이스케이프 문자를 포함하는 문자열을 검색어로 사용하는 예제는 아래를 참고한다.

구문

expression [ NOT ] LIKE expression [ ESCAPE char]

expression (left) : 문자열 데이터 타입 컬럼이 지정된다. 패턴 비교는 컬럼 값의 첫 번째 문자부터 시작되며, 대소문자를 구분한다.
expression (right) : 검색어를 입력하며, 길이가 0 이상인 문자열이 된다. 이때, 검색어 패턴에는 와일드 카드 문자(% 또는 _)가 포함될 수 있다. 문자열의 길이는 0 이상이다.
ESCAPE char : char에 올 수 있는 문자는 NULL, 알파벳, 숫자이다. 만약 검색어의 문자열 패턴이 "_" 또는 "%" 자체를 포함하는 경우 이스케이프 문자가 반드시 지정되어야 한다. 예를 들어, 이스케이프 문자를 백슬래시(\)로 지정한 후 '10%'인 문자열을 검색하고자 한다면, expression (right)에 '10\%'을 지정해야 한다. 또한, 'C:\'인 문자열을 검색하고자 한다면, expression (right)에 'C:\\ '을 지정하면 된다.

참고 사항

LIKE 조건식은 대소문자를 구분한다. 대소문자를 구분하지 않게 하려면 RLIKE 조건식을 이용한다.

UTF-8과 같은 멀티바이트 문자 세트 환경에서 입력된 데이터에 대해서는 LIKE 검색 결과가 정상적이지 않을 수 있다. 이는 문자 세트에 따라 문자열 비교 연산을 수행하는 바이트 단위가 다르기 때문이며, 1바이트 단위로 문자열 비교를 수행하도록 하는 파라미터(single_byte_compare=yes)를 cubrid.conf 파일에 추가한 후 DB를 재가동하면 정상적인 검색 결과를 얻을 수 있다.

CUBRID가 지원하는 문자 세트에 관한 상세한 설명은 문자열 데이터 타입을 참고하며, single_byte_compare 파라미터에 관한 상세한 설명은 기타 파라미터를 참고한다.

LIKE 조건식의 이스케이프 문자 인식은 cubrid.conf 파일의 no_backslash_escapes 파라미터와 require_like_escape_character 파라미터의 설정에 따라 달라진다. 이에 대한 상세한 설명은 구문/타입 관련 파라미터를 참고한다.

예제

--selection rows where name contains lower case 's', not upper case

SELECT * FROM condition_tbl WHERE name LIKE '%s%';

id name dept_name salary

======================================================================

3 'Jones ' 'sales' 5400000

--selection rows where second letter is 'O' or 'o'

SELECT * FROM condition_tbl WHERE UPPER(name) LIKE '_O%';

id name dept_name salary

======================================================================

2 'Moy ' 'sales' 3000000

3 'Jones ' 'sales' 5400000

--selection rows where name is 3 characters

SELECT * FROM condition_tbl WHERE name LIKE '___';

id name dept_name salary

======================================================================

1 'Kim ' 'devel' 4000000

2 'Moy ' 'sales' 3000000

5 'Kim ' 'account' 3800000

WHERE 절

2012-04-19T03:42:56-07:00

WHERE 절

설명

질의에서 컬럼은 조건에 따라 처리될 수 있다. WHERE 절은 조회하려는 데이터의 조건을 명시한다.

구문

WHERE search_condition

search_condition :
• comparison_predicate
• between_predicate
• exists_predicate
• in_predicate
• null_predicate
• like_predicate
• quantified predicate
• set_predicate

WHERE 절은 search_condition 또는 질의에서 조회되는 데이터를 결정하는 조건식을 지정한다. 조건식이 참인 데이터만 질의 결과로 조회된다(NULL 값은 알 수 없는 값으로서 질의 결과로 조회되지 않는다).

search_condition : 자세한 내용은 다음의 항목을 참고한다.

복수의 조건은 논리연산자 AND, OR를 사용할 수 있다. AND가 지정된 경우 모든 조건이 참이어야 하고, OR로 지정된 경우에는 하나의 조건만 참이어도 된다. 만약 키워드 NOT이 조건 앞에 붙는다면 조건은 반대의 의미를 갖는다. 논리 연산이 평가 되는 순서는 다음 표와 같다.

우선순위	연산자	기능
1	( )	괄호 내에 포함된 논리 표현식은 첫 번째로 평가된다.
2	NOT	논리 표현식의 결과를 부정한다.
3	AND	논리 표현식에 포함된 모든 조건이 참이어야 한다.
4	OR	논리 표현식에 포함된 조건 중 하나의 조건은 참이어야 한다.

RLIKE 조건식

2012-04-19T03:42:56-07:00

REGEXP 조건식, RLIKE 조건식

설명

REGEXP, RLIKE는 동일하며, 정규 표현식을 이용한 패턴을 매칭하기 위해 사용된다. 정규 표현식은 복잡한 검색 패턴을 표현하는 강력한 방법이다. CUBRID는 Henry Spencer가 구현한 정규 표현식을 사용하며, 이는 POSIX 1003.2 표준을 따른다. 이 페이지는 정규 표현식에 대한 세부 사항을 설명하지는 않으므로, 정규 표현식에 대한 자세한 사항은 Henry Spencer의 regex(7)을 참고한다.

다음은 정규 표현식 패턴의 일부이다.

"." 은 문자 하나와 매칭된다(줄바꿈 문자(new line)와 캐리지 리턴 문자(carrage return)를 포함).
"[...]" 은 대괄호 안의 문자 중 하나와 매칭된다. 예를 들어, "[abc]" 는 "a", "b" 또는 "c"와 매칭된다. 문자의 범위를 나타내려면 대시(-)를 사용한다. "[a-z]" 은 임의의 알파벳 문자 하나와 매칭되고, "[0-9]"는 임의의 숫자 하나와 매칭된다.
"*"은 앞의 문자 또는 문자열이 0번 이상 연속으로 나열된 문자열과 매칭된다. 예를 들어, "xabc*"는 "xab", "xabc", "xabcc", "xabcxabc" 등과 매칭되며, "[0-9][0-9]*" 는 어떤 숫자와도 매칭된다. 그리고 ".*" 은 모든 문자열과 매칭된다.
" ", " ", " ", ""의 특수 문자를 매칭하기 위해서는 시스템 파라미터 no_backslash_escapes(기본값: yes)를 no로 설정하여 백슬래시()를 이스케이프 문자로 허용해야 한다. no_backslash_escapes에 대한 자세한 설명은 특수 문자 이스케이프를 참고한다.

REGEXP와 LIKE의 차이는 다음과 같다.

LIKE 절은 입력값 전체가 패턴과 매칭되어야 성공한다.
REGEXP는 입력값의 일부가 패턴과 매칭되면 성공한다. REGEXP에서 전체 값에 대한 패턴 매칭을 하려면, 패턴의 시작에는 "^"을, 끝에는 "$"을 사용해야 한다.
LIKE 절의 패턴은 대소문자를 구분하지만 REGEXP에서 정규 표현식의 패턴은 대소문자를 구분하지 않는다. 대소문자를 구분하려면 REGEXP BINARY 구문을 사용해야 한다.

아래 구문에서 expr에 매칭되는 패턴 pat이 존재하면 1을 반환하며, 그렇지 않은 경우 0을 반환한다. expr과 pat 중 하나가 NULL이면 NULL을 반환한다.

NOT을 사용하는 두 번째 구문과 세 번째 구문은 같은 의미이다.

구문

expr REGEXP|RLIKE [BINARY] pat

expr NOT REGEXP|RLIKE pat

NOT (expr REGEXP|RLIKE pat)

expr : 컬럼 또는 입력 표현식
pat : 정규 표현식에 사용될 패턴. 대소문자 구분 없음

예제

-- When REGEXP is used in SELECT list, enclosing this with parentheses is required. But used in WHERE clause, no need parentheses.

-- case insensitive, except when used with BINARY.

SELECT name FROM athlete where name REGEXP '^[a-d]';

name

======================

'Dziouba Irina'

'Dzieciol Iwona'

'Dzamalutdinov Kamil'

'Crucq Maurits'

'Crosta Daniele'

'Bukovec Brigita'

'Bukic Perica'

'Abdullayev Namik'

-- : match a special character, when no_backslash_escapes=no

SELECT ('new line' REGEXP 'new

line');

('new

line' regexp 'new

line')

=====================================

-- ^ : match the beginning of a string

SELECT ('cubrid dbms' REGEXP '^cub');

('cubrid dbms' regexp '^cub')

===============================

-- $ : match the end of a string

SELECT ('this is cubrid dbms' REGEXP 'dbms$');

('this is cubrid dbms' regexp 'dbms$')

========================================

--.: match any character

SELECT ('cubrid dbms' REGEXP '^c.*$');

('cubrid dbms' regexp '^c.*$')

================================

-- a+ : match any sequence of one or more a characters. case insensitive.

SELECT ('Aaaapricot' REGEXP '^A+pricot');

('Aaaapricot' regexp '^A+pricot')

================================

-- a? : match either zero or one a character.

SELECT ('Apricot' REGEXP '^Aa?pricot');

('Apricot' regexp '^Aa?pricot')

==========================

SELECT ('Aapricot' REGEXP '^Aa?pricot');

('Aapricot' regexp '^Aa?pricot')

===========================

SELECT ('Aaapricot' REGEXP '^Aa?pricot');

('Aaapricot' regexp '^Aa?pricot')

============================

-- (cub)* : match zero or more instances of the sequence abc.

SELECT ('cubcub' REGEXP '^(cub)*$');

('cubcub' regexp '^(cub)*$')

==========================

-- [a-dX], [^a-dX] : matches any character that is (or is not, if ^ is used) either a, b, c, d or X.

SELECT ('aXbc' REGEXP '^[a-dXYZ]+');

('aXbc' regexp '^[a-dXYZ]+')

==============================

SELECT ('strike' REGEXP '^[^a-dXYZ]+$');

('strike' regexp '^[^a-dXYZ]+$')

================================

참고 사항

다음은 REGEXP 조건식를 구현하기 위해 사용한 라이브러리인 RegEx-Specer의 라이선스이다.

This software is not subject to any license of the American Telephone

and Telegraph Company or of the Regents of the University of California.

Permission is granted to anyone to use this software for any purpose on

any computer system, and to alter it and redistribute it, subject

to the following restrictions:

1. The author is not responsible for the consequences of use of this

software, no matter how awful, even if they arise from flaws in it.

2. The origin of this software must not be misrepresented, either by

explicit claim or by omission. Since few users ever read sources,

credits must appear in the documentation.

3. Altered versions must be plainly marked as such, and must not be

misrepresented as being the original software. Since few users

ever read sources, credits must appear in the documentation.

4. This notice may not be removed or altered.

REGEXP 조건식

2012-04-19T03:42:56-07:00

REGEXP 조건식, RLIKE 조건식

설명

다음은 정규 표현식 패턴의 일부이다.

"." 은 문자 하나와 매칭된다(줄바꿈 문자(new line)와 캐리지 리턴 문자(carrage return)를 포함).
"[...]" 은 대괄호 안의 문자 중 하나와 매칭된다. 예를 들어, "[abc]" 는 "a", "b" 또는 "c"와 매칭된다. 문자의 범위를 나타내려면 대시(-)를 사용한다. "[a-z]" 은 임의의 알파벳 문자 하나와 매칭되고, "[0-9]"는 임의의 숫자 하나와 매칭된다.
"*"은 앞의 문자 또는 문자열이 0번 이상 연속으로 나열된 문자열과 매칭된다. 예를 들어, "xabc*"는 "xab", "xabc", "xabcc", "xabcxabc" 등과 매칭되며, "[0-9][0-9]*" 는 어떤 숫자와도 매칭된다. 그리고 ".*" 은 모든 문자열과 매칭된다.
" ", " ", " ", ""의 특수 문자를 매칭하기 위해서는 시스템 파라미터 no_backslash_escapes(기본값: yes)를 no로 설정하여 백슬래시()를 이스케이프 문자로 허용해야 한다. no_backslash_escapes에 대한 자세한 설명은 특수 문자 이스케이프를 참고한다.

REGEXP와 LIKE의 차이는 다음과 같다.

LIKE 절은 입력값 전체가 패턴과 매칭되어야 성공한다.
REGEXP는 입력값의 일부가 패턴과 매칭되면 성공한다. REGEXP에서 전체 값에 대한 패턴 매칭을 하려면, 패턴의 시작에는 "^"을, 끝에는 "$"을 사용해야 한다.
LIKE 절의 패턴은 대소문자를 구분하지만 REGEXP에서 정규 표현식의 패턴은 대소문자를 구분하지 않는다. 대소문자를 구분하려면 REGEXP BINARY 구문을 사용해야 한다.

아래 구문에서 expr에 매칭되는 패턴 pat이 존재하면 1을 반환하며, 그렇지 않은 경우 0을 반환한다. expr과 pat 중 하나가 NULL이면 NULL을 반환한다.

NOT을 사용하는 두 번째 구문과 세 번째 구문은 같은 의미이다.

구문

expr REGEXP|RLIKE [BINARY] pat

expr NOT REGEXP|RLIKE pat

NOT (expr REGEXP|RLIKE pat)

expr : 컬럼 또는 입력 표현식
pat : 정규 표현식에 사용될 패턴. 대소문자 구분 없음

예제

-- When REGEXP is used in SELECT list, enclosing this with parentheses is required. But used in WHERE clause, no need parentheses.

-- case insensitive, except when used with BINARY.

SELECT name FROM athlete where name REGEXP '^[a-d]';

name

======================

'Dziouba Irina'

'Dzieciol Iwona'

'Dzamalutdinov Kamil'

'Crucq Maurits'

'Crosta Daniele'

'Bukovec Brigita'

'Bukic Perica'

'Abdullayev Namik'

-- : match a special character, when no_backslash_escapes=no

SELECT ('new line' REGEXP 'new

line');

('new

line' regexp 'new

line')

=====================================

-- ^ : match the beginning of a string

SELECT ('cubrid dbms' REGEXP '^cub');

('cubrid dbms' regexp '^cub')

===============================

-- $ : match the end of a string

SELECT ('this is cubrid dbms' REGEXP 'dbms$');

('this is cubrid dbms' regexp 'dbms$')

========================================

--.: match any character

SELECT ('cubrid dbms' REGEXP '^c.*$');

('cubrid dbms' regexp '^c.*$')

================================

-- a+ : match any sequence of one or more a characters. case insensitive.

SELECT ('Aaaapricot' REGEXP '^A+pricot');

('Aaaapricot' regexp '^A+pricot')

================================

-- a? : match either zero or one a character.

SELECT ('Apricot' REGEXP '^Aa?pricot');

('Apricot' regexp '^Aa?pricot')

==========================

SELECT ('Aapricot' REGEXP '^Aa?pricot');

('Aapricot' regexp '^Aa?pricot')

===========================

SELECT ('Aaapricot' REGEXP '^Aa?pricot');

('Aaapricot' regexp '^Aa?pricot')

============================

-- (cub)* : match zero or more instances of the sequence abc.

SELECT ('cubcub' REGEXP '^(cub)*$');

('cubcub' regexp '^(cub)*$')

==========================

-- [a-dX], [^a-dX] : matches any character that is (or is not, if ^ is used) either a, b, c, d or X.

SELECT ('aXbc' REGEXP '^[a-dXYZ]+');

('aXbc' regexp '^[a-dXYZ]+')

==============================

SELECT ('strike' REGEXP '^[^a-dXYZ]+$');

('strike' regexp '^[^a-dXYZ]+$')

================================

참고 사항

다음은 REGEXP 조건식를 구현하기 위해 사용한 라이브러리인 RegEx-Specer의 라이선스이다.

This software is not subject to any license of the American Telephone

and Telegraph Company or of the Regents of the University of California.

Permission is granted to anyone to use this software for any purpose on

any computer system, and to alter it and redistribute it, subject

to the following restrictions:

1. The author is not responsible for the consequences of use of this

software, no matter how awful, even if they arise from flaws in it.

2. The origin of this software must not be misrepresented, either by

explicit claim or by omission. Since few users ever read sources,

credits must appear in the documentation.

3. Altered versions must be plainly marked as such, and must not be

misrepresented as being the original software. Since few users

ever read sources, credits must appear in the documentation.

4. This notice may not be removed or altered.

문자열 데이터 타입

2012-04-19T03:42:38-07:00

문자열 데이터 타입

PHP API

2012-04-19T03:43:29-07:00

PHP API

PHP 모듈 설치

2012-04-19T03:42:36-07:00

PHP 모듈 설치

필수 소프트웨어 설치

아래의 소프트웨어를 먼저 설치한다.

Apache 웹 서버 : 2.0 이상 버전
PHP : 5.2 이상 버전
CUBRID

CUBRID PHP 모듈 다운로드

ftp://ftp.cubrid.org/CUBRID_Drivers/PHP_Driver/에서 드라이버를 다운로드한다. PHP 드라이버에 관한 최신 정보는 http://www.cubrid.org/php_api_for_cubrid를 참고한다.

Windows 버전 설치

php_cubrid.dll 파일을 PHP extentions 디렉터리(기본 위치 C:Program FilesPHPext)에 저장한다.
시스템 환경 변수를 설정한다. PHPRC 환경 변수 값이 C:Program FilesPHP이고 Path 환경 변수 값에 %PHPRC%와 %PHPRC%ext이 있는지 확인한다.
php.ini 파일(기본 위치: C:Program FilesPHPphp.ini)의 제일 마지막에 다음 라인을 더한다.
- [PHP_CUBRID] extension=php_cubrid.dll
설정이 완료되면 웹 서버를 재시작한다.

Linux 버전 설치

cubrid.so 파일을 PHP extensions 디렉터리에 저장한다. cubrid.so 파일은 PHP 5.3.3에서는 보통 /usr/lib/php5/20090626에 위치하나 PHP 버전에 따라 다를 수 있다.
php.ini 파일(기본 위치: /etc/php5/apache2/php.ini)의 제일 마지막에 다음 라인을 더한다.
- [CUBRID] extension=cubrid.so
설정이 완료되면 웹 서버를 재시작한다.

설치 패키지를 이용한 쉬운 설치

Windows에서 설치 마법사를 이용한 PHP 드라이버 설치

http://www.cubrid.org/php_install_wizard 페이지에 있는 CUBRID PHP API Installer를 이용하여 설치할 수 있다.

Ubuntu Linux에서 PEAR 패키지를 이용한 PHP 드라이버 설치

phpize와 PEAR 패키지가 설치되어 있어야 한다. 다음의 순서를 따른다.

Apache 웹서버, PHP를 설치한다. Apache 웹 서버, PHP 설치와 관련된 내용은 http://www.cubrid.org/cubrid_apache_php_ubuntu 페이지를 참고한다.
phpize를 설치하기 위해 다음을 실행한다.
1. sudo apt-get install php5-dev
PEAR 패키지를 설치하기 위해 다음을 실행한다.
1. sudo apt-get install php-pear
PEAR 패키지에서 pecl 명령을 사용하여 최신 CUBRID PHP extension을 설치한다.
- sudo pecl install cubrid
- 이전 버전의 PHP 드라이버를 설치하려면 해당 버전을 명시해야 한다.
1. sudo pecl install cubrid-8.3.0.0005
php.ini(기본 위치: /etc/php5/apache2/php.ini) 파일의 제일 마지막에 다음 줄을 더한다.
1. [CUBRID] extension=cubrid.so
웹 서버를 재시작한다.

다른 배포판 Linux에서 PEAR 패키지를 이용한 PHP 드라이버 설치

phpize와 PEAR 패키지가 설치되어 있어야 한다. 다음의 순서를 따른다.

phpize를 설치한다. php-dev 의 버전은 PHP 5.2.x 혹은 PHP 5.3.x여야 한다. 이전 버전의 PHP를 사용하고 있다면 먼저 PHP를 업데이트해야 한다.
1. yum install php-devel
PEAR 패키지를 다운로드 받는다.
1. wget http://pear.php.net/go-pear.phar
PEAR 패키지를 설치한다.
1. php go-pear.phar
최신 버전의 CUBRID-PHP Extension을 설치한다.
1. pecl install cubrid
- 이전 버전의 PHP 드라이버를 설치하려면 해당 버전을 명시해야 한다.
- sudo pecl install cubrid-8.3.0.0005
php.ini(기본 위치: /etc/php5/apache2/php.ini) 파일의 제일 마지막에 다음 줄을 더한다.
1. [CUBRID] extension=cubrid.so
웹 서버를 재시작한다.

참고 phpinfo() 함수를 사용하여 test.php를 생성한 후 웹 브라우저에서 http://<웹서버가 설치된 IP 주소>/test.php 를 입력했을 때, CUBRID 설정 페이지가 출력되면 정상적으로 설치가 완료된 것이다.

JDBC 환경 설정

2012-04-19T03:42:36-07:00

JDBC 환경 설정

기본 환경

JDK 1.6 이상
CUBRID 2008 R1.0 이상
CUBRID JDBC Driver 2008 R1.0 이상

Java 설치 및 환경 변수 설정

시스템에 Java가 설치되어 있고 JAVA_HOME 환경 변수가 등록되어 있어야 한다. Java는 Developer Resources for Java Technology 사이트(http://java.sun.com)에서 다운로드할 수 있다. 이에 대한 자세한 설명은 Java 저장 함수/프로시저 사용을 위한 환경 설정을 참고한다.

Windows 환경에서 환경 변수 설정

Java 설치 후 [내 컴퓨터]를 마우스 오른쪽 버튼 클릭하여 [속성]을 선택하면 [시스템 등록 정보] 대화 상자가 나타난다. [고급] 탭의 [환경 변수]를 클릭하면 나타나는 [환경 변수] 대화 상자가 나타난다.

[시스템 변수]에서 [새로 만들기]를 선택한다. [변수 이름]에 JAVA_HOME을 입력하고, 변수 값으로 Java 설치 경로(예: C:Program FilesJavajdk1.6.0_16)를 입력한 후 [확인]을 클릭한다.

[시스템 변수] 중 Path를 선택하고 [편집]을 클릭한다. [변수 값]에 %JAVA_HOME%bin를 추가하고 [확인]을 클릭한다.

위의 방법을 사용하지 않고 다음과 같이 셸에서 JAVA_HOME과 PATH 환경 변수를 설정할 수도 있다.

set JAVA_HOME= C:Program FilesJavajdk1.6.0_16

set PATH=%PATH%;%JAVA_HOME%bin

Linux 환경에서 환경 변수 설정

다음과 같이 Java가 설치된 JAVA_HOME 환경 변수로 디렉토리 경로(예: /usr/java/jdk1.6.0_16)를 설정하고, PATH 환경 변수에 $JAVA_HOME/bin을 추가한다.

export JAVA_HOME=/usr/java/jdk1.6.0_16 //bash

export PATH=$JAVA_HOME/bin:$PATH //bash

setenv JAVA_HOME /usr/java/jdk1.6.0_16 //csh

set path = ($JAVA_HOME/bin $path) //csh

JDBC 드라이버 설정

JDBC를 사용하려면 CUBRID JDBC 드라이버가 존재하는 경로를 환경 변수 CLASSPATH에 추가해야 한다.

CUBRID JDBC 드라이버(cubrid_jdbc.jar)는 CUBRID 설치 디렉터리 아래의 jdbc 디렉터리에 위치한다.

Windows 환경에서 CLASSPATH 환경 변수 설정

set CLASSPATH=C:CUBRIDjdbccubrid_jdbc.jar:.

Linux 환경에서 CLASSPATH 환경 변수 설정

export CLASSPATH=$HOME/CUBRID/jdbc/cubrid_jdbc.jar:.

주의 만약 JRE가 설치된 라이브러리 디렉터리($JAVA_HOME/jre/lib/ext)에 일반 CUBRID JDBC 드라이버가 설치되어 있다면, Java 저장 프로시저에서 사용하는 서버 사이드 JDBC 드라이버보다 먼저 로드되어 Java 저장 프로시저가 비정상적으로 구동될 수 있다. Java 저장 프로시저를 사용하는 환경에서는 JRE가 설치된 라이브러리 디렉터리($JAVA_HOME/jre/lib/ext)에 일반 CUBRID JDBC 드라이버를 설치하지 않도록 주의한다.

특수 문자 이스케이프

2012-08-20T06:50:53-07:00

특수 문자 이스케이프

설명

CUBRID는 특수 문자를 이스케이프(escape)하는 방법을 두 가지 지원한다. 하나는 따옴표를 이용한 방법이고, 다른 하나는 백슬래시(\)를 이용한 방법이다.

따옴표를 이용한 이스케이프

cubrid.conf의 시스템 파라미터 ansi_quotes가 no로 설정되어 있으면 문자열을 감쌀 때 큰따옴표(")와 작은따옴표(') 둘 다 사용할 수 있다. ansi_quotes 파라미터의 기본값은 yes로, 문자열을 감쌀 때 작은따옴표만 사용할 수 있다. 아래 설명에서 2와 3은 ansi_quotes 값이 no일 때에만 적용된다.

작은따옴표로 감싼 문자열에 포함된 작은따옴표는 두 개의 작은따옴표('')를 쓴다.
큰따옴표로 감싼 문자열에 포함된 큰따옴표는 두 개의 큰따옴표("")를 쓴다.
큰따옴표로 감싼 문자열에 포함된 작은따옴표는 이스케이프하지 않아도 된다.
작은따옴표로 감싼 문자열에 포함된 큰따옴표는 이스케이프하지 않아도 된다.

백슬래시를 이용한 이스케이프

백슬래시(\)를 이용한 이스케이프는 cubrid.conf의 시스템 파라미터 no_backslash_escapes를 no로 설정했을 때에만 사용할 수 있다. no_backslash_escapes 파라미터의 기본값은 yes이다. 입력값에 따라 다음과 같은 특수 문자를 의미한다.

\' : 작은따옴표(')
\" : 큰따옴표(")
\n : 뉴라인(newline, linefeed) 문자
\r : 캐리지 리턴(carrage return) 문자
\t : 탭(tab) 문자
\\ : 백슬래시(backslash)
\% : 퍼센트 기호(%). 자세한 내용은 아래 설명을 참고한다.
\_ : 언더바(_). 자세한 내용은 아래 설명을 참고한다.

다른 모든 이스케이프에 대해서는 백슬래시가 무시된다. 예를 들어 "\x"는 그냥 "x"라고 입력한 것과 같다.

\%와 \_는 LIKE와 같은 패턴 매칭 구문에서 퍼센트 기호와 언더바를 찾을 때 쓰이며, 백슬래시가 없으면 와일드카드 문자(wildcard character)로 쓰인다. 패턴 매칭 구문 밖에서는 와일드카드 문자가 아닌 일반 문자열 "\%"와 "\_"로 그대로 쓰인다. 자세한 내용은 LIKE 조건식을 참고한다.

예제 1

다음은 cubrid.conf의 시스템 파라미터 ansi_quotes가 no이고 no_backslash_escapes가 no일 때 이스케이프를 수행한 결과이다.

SELECT STRCMP('single quotes test('')', 'single quotes test(\')');

strcmp('single quotes test('')', 'single quotes test('')')

=============================================================

SELECT STRCMP("\a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z", "a\bcdefghijklm\nopq\rs\tuvwxyz");

strcmp('abcdefghijklm

s uvwxyz', 'abcdefghijklm

s uvwxyz')

=====================================================================

SELECT LENGTH('\\');

char_length('\')

===================

예제 2

다음은 cubrid.conf의 시스템 파라미터 ansi_quotes가 yes이고 no_backslash_escapes가 yes일 때 이스케이프를 수행한 결과이다.

SELECT STRCMP('single quotes test('')', 'single quotes test(\')');

In the command from line 2,

ERROR: unterminated string

In the command from line 2,

ERROR: syntax error, unexpected UNTERMINATED_STRING

SELECT STRCMP("\a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z", "a\bcdefghijklm\nopq\rs\tuvwxyz");

In line 1, column 18,

ERROR: [\a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z] is not defined.

In line 1, column 18,

ERROR: [a\bcdefghijklm\nopq\rs\tuvwxyz] is not defined.

SELECT LENGTH('\\');

char_length('\\')

====================

예제 3

다음은 cubrid.conf의 시스템 파라미터 ansi_quotes가 yes이고 no_backslash_escapes가 no일 때 이스케이프를 수행한 결과이다.

CREATE TABLE t1 (a varchar(200));

INSERT INTO t1 VALUES ('aaabbb'), ('aaa%');

SELECT a FROM t1 WHERE a LIKE 'aaa\%' escape '\\';

======================

'aaa%'

cubrid_real_escape_string

2012-05-22T03:29:53-07:00

cubrid_real_escape_string

설명

cubrid_real_escape_string 함수는 질의를 서버로 전송하기 전에 문자열 내에 작은따옴표(')가 있으면 작은따옴표를 하나 더 추가하여('') 안전하게 질의를 수행할 수 있도록 한다.

일반적으로 문자열을 감쌀 때 작은따옴표(')를 사용하며, CUBRID 시스템 파라미터인 ansi_quotes의 값에 따라 큰따옴표(")도 사용할 수 있다. ansi_quotes의 값이 no이면 큰따옴표로 감싼 것을 식별자가 아닌 문자열로 인식한다. 기본값은 yes이다.

구문

string cubrid_real_escape_string (string $unescaped_string[, resource $conn_identifier])

unescaped_string : 이스케이프할 문자열을 지정한다.
conn_identifier : CUBRID 연결을 지정한다. 지정하지 않으면 최근 연결을 사용한다.

리턴 값

성공: 이스케이프된 문자열
에러: FALSE

예제

<?php

$conn = cubrid_connect("localhost", 33000, "demodb");

$unescaped_str = ' !"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~';

$escaped_str = cubrid_real_escape_string($unescaped_str);

$len = strlen($unescaped_str);

@cubrid_execute($conn, "DROP TABLE cubrid_test");

cubrid_execute($conn, "CREATE TABLE cubrid_test (t char($len))");

cubrid_execute($conn, "INSERT INTO cubrid_test (t) VALUES('$escaped_str')");

$req = cubrid_execute($conn, "SELECT * FROM cubrid_test");

$row = cubrid_fetch_assoc($req);

var_dump($row);

cubrid_close_request($req);

cubrid_disconnect($conn);

The above example will output:

array(1) {

["t"]=>

string(95) " !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~"

}

구문/타입 관련 파라미터

2012-04-19T03:43:25-07:00

구문/타입 관련 파라미터

다음은 CUBRID에서 지원하는 SQL 구문 및 데이터 타입에 관한 파라미터로 각 파라미터의 타입과 설정 가능한 값의 범위는 다음과 같다.

파라미터 이름	타입	기본값
add_column_update_hard_default	bool	no
alter_table_change_type_strict	bool	no
ansi_quotes	bool	yes
block_ddl_statement	bool	no
block_nowhere_statement	bool	no
compat_numeric_division_scale	bool	no
default_week_format	int	0
group_concat_max_len	int	1024
intl_mbs_support	bool	no
no_backslash_escapes	bool	yes
only_full_group_by	bool	no
oracle_style_empty_string	bool	no
pipes_as_concat	bool	yes
plus_as_concat	bool	yes
require_like_escape_character	bool	no
return_null_on_function_errors	bool	no

add_column_update_hard_default

add_column_update_hard_default는 ALTER TABLE … ADD COLUMN 절로 새로운 컬럼을 추가할 때 이 컬럼에 입력할 값을 고정 기본값(hard_default)으로 제공할지 여부를 설정하는 파라미터로서, 기본값은 no이다.

이 파라미터 값이 yes이면 NOT NULL 제약 조건이 있고 DEFAULT 제약 조건이 없을 때 컬럼의 새로운 입력값을 고정 기본값(hard default value)으로 입력하며, no이면 NOT NULL 제약조건이 있더라도 NULL로 입력한다. 이 파라미터의 값이 yes일 때 추가하려는 컬럼의 타입에 고정 기본값이 없으면 오류를 출력하고 롤백한다. 각 타입별 고정 기본값에 대해서는 ALTER TABLE 문의 CHANGE, MODIFY 절을 참고한다.

-- add_column_update_hard_default=no

CREATE TABLE tbl (i INT);

INSERT INTO tbl VALUES (1),(2);

ALTER TABLE tbl ADD COLUMN j INT NOT NULL;

SELECT * FROM TBL;

i j

========================

2 NULL

1 NULL

-- add_column_update_hard_default=yes

CREATE TABLE tbl (i int);

INSERT INTO tbl VALUES (1),(2);

ALTER TABLE tbl ADD COLUMN j INT NOT NULL;

SELECT * FROM tbl;

i j

=========================

2 0

1 0

alter_table_change_type_strict

alter_table_change_type_strict는 타입 변경에 따른 해당 컬럼 값들의 변환 허용 여부를 지정하는 파라미터로서, 기본값은 no이다. 이 파라미터 값이 no이면 컬럼의 타입 변경이나 NOT NULL 제약 조건을 추가할 때 값의 변경이 발생하며, yes이면 값의 변경이 발생하지 않는다. 자세한 내용은 ALTER TABLE 문의 CHANGE, MODIFY 절을 참고한다.

ansi_quotes

ansi_quotes는 식별자 처리를 위한 기호 또는 문자열을 감싸는 기호에 관한 파라미터로 기본값은 yes이다. 이 파라미터 값이 yes이면 큰따옴표는 식별자 처리 기호로 해석되고, 작은따옴표는 문자열 처리 기호로 해석된다. 이 값이 no이면 큰 따옴표와 작은 따옴표 모두 문자열 처리 기호로 해석된다.

block_ddl_statement

block_ddl_statement는 클라이언트가 수행하는 데이터 정의문(Data Definition Language, DDL)을 제한하기 위한 파라미터로 no로 설정하면 해당 클라이언트의 데이터 정의문 수행을 허용하며, yes로 설정하면 해당 클라이언트의 데이터 정의문 수행을 허용하지 않는다. 기본값은 no이다.

block_nowhere_statement

block_nowhere_statement는 클라이언트가 수행하는 조건절(WHERE)이 없는 UPDATE/DELETE 문을 제한하기 위한 파라미터로 no로 설정하면 해당 클라이언트의 조건절이 없는 UPDATE/DELETE 문을 허용하며, yes로 설정하면 해당 클라이언트의 조건절이 없는 UPDATE/DELETE 문의 수행을 허용하지 않는다. 기본값은 no이다.

compat_numeric_division_scale

compat_numeric_division_scale은 나눗셈 연산의 결과 값(몫)에 대하여 소수점 이하 자릿수를 몇 자리까지 표시할 것인가를 지정하기 위한 파라미터로 no로 설정하면 몫의 소수점 이하 자릿수가 9개가 되고, yes로 설정하면 몫의 소수점 이하 자릿수가 피연산자의 소수점 이하 자릿수에 따라 결정된다. 기본값은 no이다.

default_week_format

default_week_format은 WEEK 함수 mode 인자의 기본값을 설정한다. 기본값은 0이다. 자세한 내용은 WEEK 함수를 참고한다.

group_concat_max_len

group_concat_max_len은 GROUP_CONCAT 함수의 리턴 값의 크기를 제한하는 파라미터로서 기본값은 1024바이트이며, 최소값은 4바이트, 최대값은 33,554,432바이트이다. GROUP_CONCAT 함수의 결과가 제한을 넘으면 NULL을 반환한다.

intl_mbs_support

intl_mbs_support는 멀티바이트 문자 세트(Multibyte Character Set)의 지원 여부를 지정하기 위한 파라미터이며, 기본값은 no이다. 한글과 같은 멀티바이트 문자로 테이블 이름 또는 컬럼 이름을 생성하는 경우, 이 파라미터 값을 yes로 설정해야 한다. 단, 멀티바이트 문자 세트를 지원하기 위한 연산 비용이 크므로, 성능 향상을 위해 intl_mbs_support 파라미터를 no로 설정하고 테이블 이름이나 컬럼 이름을 영어로 사용할 것을 권장한다.

no_backslash_escapes

no_backslash_escapes은 이스케이프 문자로 백슬래시() 사용 여부에 관한 파라미터로서, 기본값은 yes이다. 이 파라미터 값이 no이면 백슬래시()가 이스케이프 문자로 사용되며, yes이면 백슬래시는 일반 문자로 사용된다. 자세한 설명은 특수 문자 이스케이프를 참고한다.

only_full_group_by

only_full_group_by는 GROUP BY 절 사용에 관한 확장된 문법의 사용 여부를 설정하는 파라미터이다.

이 파라미터 값이 no이면 확장된 문법이 적용되므로 GROUP BY 절에 명시되지 않은 컬럼을 SELECT 컬럼 리스트에 명시할 수 있고, 이 값이 yes이면 GROUP BY 절에 명시된 컬럼만 SELECT 컬럼 리스트에 명시할 수 있다.

기본값은 no이므로, SQL 표준에 따라 질의를 수행하려면 only_full_group_by 파라미터 값을 yes로 설정한다. 이 경우에는 확장된 문법이 적용되지 않으므로 실행 결과로 아래와 같은 에러가 출력된다.

ERROR: Attributes exposed in aggregate queries must also appear in the group by clause.

oracle_style_empty_string

oracle_style_empty_string은 다른 DBMS(Database Management System)와의 호환성을 향상시키기 위한 파라미터로 빈 문자열(empty string)을 Oracle DBMS와 마찬가지로 NULL로 처리할 것인지 지정한다. oracle_style_empty_string 파라미터를 no로 설정하면 빈 문자열을 유효한 문자열로 처리하고, yes로 설정하면 Oracle DBMS와 마찬가지로 빈 문자열을 NULL로 처리한다.

pipes_as_concat

pipes_as_concat은 이중 파이프 기호(||)의 사용에 관한 파라미터로서, 기본값은 yes이다. 이 파라미터 값이 yes이면 이중 파이프 기호가 문자열의 병합 연산자로 해석되고, no이면 부울린(boolean) 연산자인 OR로 해석된다.

plus_as_concat

plus_as_concat은 + 연산자의 사용에 관한 파라미터로서, 기본값은 yes이다. 이 파라미터 값이 yes이면 + 연산자가 문자열의 병합 연산자로 해석되고, no이면 수치 연산자로 해석된다.

-- plus_as_concat = yes

SELECT '1'+'1';

'1'+'1'

======================

'11' SELECT '1'+'a';

'1'+'a'

======================

'1a'

-- plus_as_concat = no

SELECT '1'+'1';

'1'+'1'

==========================

2.000000000000000e+000

SELECT '1'+'a';

ERROR: Cannot coerce 'a' to type double.

require_like_escape_character

require_like_escape_character는 LIKE 절의 이스케이프 문자 사용 여부에 관한 파라미터로서, 기본값은 no이다. 이 파라미터 값이 yes이고 no_backslash_escapes가 no이면 LIKE 절의 문자열에서 백슬래시()가 이스케이프 문자로 사용되며, 그렇지 않으면 LIKE… ESCAPE 절을 사용하여 이스케이프 문자를 명시해야 한다. 자세한 내용은 LIKE 조건식을 참고한다.

return_null_on_function_errors

return_null_on_function_errors는 일부 SQL 함수에서 에러가 발생할 때의 동작을 정의하는 파라미터로서, 기본값은 no이다. 이 파라미터 값이 yes이면 함수에서 에러가 발생할 때 NULL을 반환하며, no이면 함수에서 에러가 발생할 때 에러를 반환하고 관련 메시지를 출력한다.

다음 SQL 함수가 이 시스템 파라미터의 영향을 받는다.

ADDTIME
DATEDIFF
DAY
DAYOFMONTH
DAYOFWEEK
DAYOFYEAR
FROM_DAYS
FROM_UNIXTIME
HOUR
LAST_DAY
MAKEDATE
MAKETIME
MINUTE
MONTH
QUARTER
SEC_TO_TIME
SECOND
TIME
TIME_TO_SEC
TIMEDIFF
TO_DAYS
WEEK
WEEKDAY
YEAR

-- return_null_on_function_errors=no

SELECT HOUR('2010-01-01');

ERROR: Conversion error in time format.

-- return_null_on_function_errors=yes

SELECT HOUR('2010-01-01');

hour('2010-01-01')

======================

NULL

데이터베이스 서버 설정

2012-04-19T03:43:25-07:00

데이터베이스 서버 설정

조건식

2012-04-19T03:42:55-07:00

조건식

CM 사용자의 데이터베이스 정보 변경

2012-04-19T03:43:45-07:00

CM 사용자의 데이터베이스 정보 변경

설명

cm_admin changedbinfo 유틸리티는 지정한 CM 사용자의 데이터베이스 정보를 변경한다.

구문

cm_admin changedbinfo options cmuser-name database-name

options :

[{-u | --uid} userid]

[{-h | --host} broker-ip]

[{-p | --port} broker-port]

cm_admin : CUBRID 매니저를 관리하는 통합 유틸리티
changedbinfo : CM 사용자의 데이터베이스 정보를 변경하는 명령어
options : -u, -h, -p 옵션이 지원된다. 자세한 정보는 해당 옵션의 설명 및 예제를 참조한다.
cmuser-name : CM 사용자 이름
databse-name : 변경할 데이터베이스 이름

옵션

옵션	설명
-u --uid	데이터베이스의 사용자 ID를 지정한다.
-h --host	클라이언트가 데이터베이스에 접속할 때 사용하는 브로커의 호스트를 지정한다.
-p --port	클라이언트가 데이터베이스에 접속할 때 사용하는 브로커의 포트 번호를 지정한다.

데이터베이스 사용자 ID(-u)

다음은 이름이 "testcm"인 CM 사용자의 "testdb" 데이터베이스에서 사용자 ID 정보를 "uid"로 업데이트하는 예이다.

cm_admin changedbinfo -u uid testcm testdb

브로커의 호스트 IP(-h)

다음은 이름이 "testcm"인 CM 사용자의 "testdb" 데이터베이스에서 호스트 IP 정보를 "10.34.63.132"로 업데이트하는 예이다.

cm_admin changedbinfo -h 10.34.63.132 testcm testdb

브로커의 포트(-p)

다음은 이름이 "testcm"인 CM 사용자의 "testdb" 데이터베이스에서 브로커 포트 정보를 "33000"로 업데이트하는 예이다.

cm_admin changedbinfo -p 33000 testcm testdb

CM 사용자 정보 출력

2012-04-19T03:43:45-07:00

CM 사용자 정보 출력

설명

cm_admin viewuser 유틸리티는 지정한 CM 사용자 이름을 기준으로 CM 사용자를 삭제한다.

구문

cm_admin viewuser cmuser-name

cm_admin : CUBRID 매니저를 관리하는 통합 유틸리티
viewuser : CM 사용자의 권한 및 데이터베이스 정보를 출력하는 명령어
cmuser-name : CM 사용자 이름. 이 값을 입력하면 해당 사용자의 정보만 출력하고, 생략하면 모든 기존 CM 사용자 정보를 표시한다.

예제

다음은 이름이 "testcm"인 CM 사용자의 정보를 출력하는 예이다.

cm_admin viewuser testcm

다음과 같이 정보가 출력된다.

CM USER: testcm

Auth info:

broker: none

dbcreate: none

statusmonitorauth: none

DB info:

==========================================================================================

DBNAME UID BROKER INFO

==========================================================================================

testdb dba localhost,30000

CM 사용자 권한 변경

2012-04-19T03:43:45-07:00

CM 사용자 권한 변경

설명

cm_admin changeuserauth 유틸리티는 CM 사용자의 권한을 변경한다.

구문

cm_admin changeuserauthoptions cmuser-name

options :

[{-b | --broker} authority]

[{-c | --dbcreate} authority]

[{-m | --monitor} authority]

cm_admin : CUBRID 매니저를 관리하는 통합 유틸리티
changeuserauth : CM 사용자의 권한 정보를 변경하는 명령어
options : -b, -c, -m 옵션이 지원된다. 자세한 정보는 해당 옵션의 설명 및 예제를 참조한다.
cmuser-name : 권한을 변경할 CM 사용자의 이름

옵션

옵션	설명
-b --broker	CM 사용자의 브로커 권한을 지정한다. 사용할 수 있는 값: admin, none, monitor
-c --dbcreate	CM 사용자의 데이터베이스 생성 권한을 지정한다. 사용할 수 있는 값: none, admin
-m --monitor	CM 사용자의 모니터링 권한을 지정한다. 사용할 수 있는 값: admin, none, monitor

브로커 권한(-b)

다음은 이름이 "testcm"인 CM 사용자의 브로커 권한을 monitor로 변경하는 예이다.

cm_admin changeuserauth -b monitor testcm

데이터베이스 생성 권한(-c)

다음은 이름이 "testcm"인 CM 사용자의 데이터베이스 생성 권한을 admin으로 변경하는 예이다.

cm_admin changeuserauth -c admin testcm

상태 모니터링 권한(-m)

다음은 이름이 "testcm"인 CM 사용자의 상태 모니터링 권한을 admin으로 변경하는 예이다.

cm_admin changeuserauth -m admin testcm

CM 사용자 비밀번호 변경

2012-04-19T03:43:45-07:00

CM 사용자 비밀번호 변경

설명

cm_admin changeuserpwd 유틸리티는 CM 사용자의 비밀번호를 변경한다.

구문

cm_admin changeuserpwd old_pwd new_pwd cmuser-name

old_pwd :

{-o | --oldpass oldpassword } | --adminpass adiminpassword

new_pwd :

{-n | --newpass} newpassword

cm_admin : CUBRID 매니저를 관리하는 통합 유틸리티
changeuserpwd : CM 사용자의 비밀번호를 변경하는 명령어
options : -o, -n, --adminpass 옵션이 지원된다. --oldpass 옵션이나 --adminpass 옵션 중 하나는 사용해야 한다. 자세한 정보는 해당 옵션의 설명 및 예제를 참조한다.
cmuser-name : 비밀번호를 변경할 CM 사용자의 이름이다.

옵션

옵션	설명
-o --oldpass	CM 사용자의 이전 비밀번호를 지정한다. 이 옵션이나 --adminpass 옵션 중 하나는 사용해야 한다.
-n --newpass	CM 사용자의 새 비밀번호를 지정한다.
--adminpass	admin 사용자의 비밀번호를 지정한다. 이 옵션이나 --oldpass 옵션 중 하나는 사용해야 한다.

이전 비밀번호(-o)와 새 비밀번호(-n)

다음은 이름이 "testcm"인 CM 사용자의 비밀번호를 변경하는 예이다. --oldpass 옵션이나 --adminpass 옵션 중 하나는 사용해야 한다.

cm_admin changeuserpwd -o old_password -n new_password testcm

이전 비밀번호(-o)와 새 비밀번호(-n)

다음은 관리자 비밀번호를 사용하여 이름이 "testcm"인 CM 사용자의 비밀번호를 변경하는 예이다. --oldpass 옵션이나 --adminpass 옵션 중 하나는 사용해야 한다.

cm_admin changeuserauth --adminpass admin_password -n new_password testcm

CM 사용자의 데이터베이스 정보 추가

2012-04-19T03:43:45-07:00

CM 사용자의 데이터베이스 정보 추가

설명

cm_admin adddbinfo 유틸리티는 데이터베이스 정보(데이터베이스 이름, UID, 브로커 IP 및 브로커 포트)를 CM 사용자에게 추가한다.

구문

cm_admin adddbinfo options cmuser-name database-name

options :

[{-u | --uid} userid]

[{-h | --host} broker-ip]

[{-p | --port} broker-port]

cm_admin : CUBRID 매니저를 관리하는 통합 유틸리티
adddbinfo : CM 사용자에게 데이터베이스 정보를 추가하는 명령어
options : -u, -h, -p 옵션이 지원된다. 자세한 정보는 해당 옵션의 설명 및 예제를 참조한다.
cmuser-name : CM 사용자 이름
databse-name : 추가할 데이터베이스 이름

옵션

옵션	설명
-u --uid	데이터베이스의 사용자 ID를 지정한다. 기본값: dba
-h --host	클라이언트가 데이터베이스에 접속할 때 사용하는 브로커의 호스트를 지정한다. 기본값: localhost
-p --port	클라이언트가 데이터베이스에 접속할 때 사용하는 브로커의 포트 번호를 지정한다. 기본값: 30000

데이터베이스 사용자 ID(-u)

다음은 이름이 "testcm"인 CM 사용자에게 이름이 "testdb"이고 사용자 ID가 "uid"인 데이터베이스를 추가하는 예이다.

cm_admin adddbinfo -u uid testcm testdb

브로커의 호스트 IP(-h)

다음은 이름이 "testcm"인 CM 사용자에게 이름이 "testdb"이고 호스트 IP가 "127.0.0.1"인 데이터베이스를 추가하는 예이다.

cm_admin adddbinfo -h 127.0.0.1 testcm testdb

브로커의 포트(-p)

다음은 이름이 "testcm"인 CM 사용자에게 이름이 "testdb"이고 브로커 포트가 "33000"인 데이터베이스를 추가하는 예이다.

cm_admin adddbinfo -p 33000 testcm testdb

기본값으로 데이터베이스 생성

다음은 이름이 "testcm"인 CM 사용자에게 이름이"testdb"이고 기본값을 사용하는 데이터베이스를 추가하는 예이다.

cm_admin adddbinfo testcm testdb

CM 사용자의 데이터베이스 정보 삭제

2012-04-19T03:43:45-07:00

CM 사용자의 데이터베이스 정보 삭제

설명

cm_admin deldbinfo 유틸리티는 지정한 CM 사용자의 데이터베이스 정보를 삭제한다.

구문

cm_admin deldbinfo options cmuser-name database-name

cm_admin : CUBRID 매니저를 관리하는 통합 유틸리티
deldbinfo : CM 사용자의 데이터베이스 정보를 삭제하는 명령어
cmuser-name : CM 사용자 이름
databse-name : 삭제할 데이터베이스 이름

예제

다음은 이름이 "testcm"인 CM 사용자에게서 이름이 "testdb"인 데이터베이스 정보를 삭제하는 예이다.

cm_admin deldbinfo testcm testdb

데이터베이스 모니터

2012-04-19T03:43:45-07:00

데이터베이스 모니터

운영 중인 데이터베이스 서버를 모니터링하며, 해당 데이터베이스 서버의 CPU, MEMORY, HA 지연(msec) 항목의 현재 값을 보여준다. 데이터베이스 모니터를 마우스 오른쪽 버튼 클릭하면 다음과 상세 기능을 설정할 수 있는 바로가기 메뉴가 나타난다.

상세 정보 보기

[상세 정보 보기]는 해당 데이터베이스 서버의 CPU 사용 정보, 메모리 정보, HA 지연 정보 항목의 시간에 따른 변화를 보여준다.

오른쪽 위의 차트 설정()을 클릭하면 차트 속성을 설정할 수 있다.

그림 모양: 데이터베이스 모니터 차트의 배경색과 가로 세로 눈금선의 색상을 설정한다.
계열 선택: 데이터베이스 모니터 차트에 보여줄 항목을 선택하고 해당 항목 그래프의 색상 및 선 굵기를 설정한다. 기본값으로 data_page_buffer_hit_ratio와 num_data_page_fetches가 설정되어 있으며, cubrid statdump에서 보여 주는 모든 항목을 설정할 수 있다. 단, 동시에 다른 터미널에서 cubrid statdump 명령을 실행하면 부정확한 값이 출력될 수 있다.
저장 설정: 기록 기능을 실행했을 때 기록한 내용을 저장할 디렉토리를 설정한다.
차트 선택: 모니터링할 차트를 선택한다.

오른쪽 위의 기록 시작()을 클릭하면 현재 모니터링 중인 모든 수치 데이터를 로컬에 저장하여 이후 차트에서 다시 확인할 수 있다. 기록을 중지하려면 기록 중지()를 클릭하면 된다.

삭제하기

호스트 정보에서 해당 데이터베이스 정보를 삭제한다.

별칭 이름 편집

해당 데이터베이스 모니터 창에 표시되는 별칭을 수정할 수 있다. 기본값으로 해당 데이터베이스의 이름이 표시되며, 데이터베이스 모니터에서 운영자가 쉽게 파악할 수 있는 다른 이름으로 편집할 수 있다.

모니터링 기록 정보 보기

기록한 모니터링 정보를 확인할 수 있는 기능이다. 일자, 시간을 입력하여 특정 시간 대의 항목 값 추이를 확인한다.

HA 적용 로그 보기

HA 구성된 standby 데이터베이스 서버에서 활성화되는 기능이며, cubrid applylogdb 명령 수행 시 발생한 로그를 확인한다.

HA 복사 로그 보기

HA 구성된 active 데이터베이스 서버에서 활성화되는 기능이며, cubrid copylogdb 명령 수행 시 발생한 로그를 확인한다.

데이터베이스 로그 보기

해당 데이터베이스의 오류 로그 파일을 선택하여 확인한다.

호스트 보기

해당 데이터베이스 서버가 구동 중인 호스트 정보를 확인한다.

최소화하기

해당 데이터베이스 모니터 창을 최소화한다. 데이터베이스 별칭 및 연결 정보만 표시된다.

새로고침

해당 데이터베이스 모니터를 수동으로 새로 읽어들인다.

브로커 모니터

2012-04-19T03:43:45-07:00

브로커 모니터

운영 중인 브로커를 모니터링하며, 해당 브로커의 session 수, active session 수, TPS 항목의 현재 값을 보여준다. 브로커 모니터를 마우스 오른쪽 버튼 클릭하면 다음과 상세 기능을 설정할 수 있는 바로가기 메뉴가 나타난다.

상세 정보 보기

[상세 정보 보기]는 해당 브로커에 대한 항목 값을 보여준다.

삭제하기

호스트 정보에서 해당 브로커 정보를 삭제한다.

별칭 이름 편집

해당 브로커 모니터 창에 표시되는 별칭을 수정할 수 있다. 기본값으로 해당 브로커의 이름이 표시되며, 운영자가 쉽게 파악할 수 있는 다른 이름으로 편집할 수 있다.

모니터링 기록 정보 보기

기록한 모니터링 정보를 확인할 수 있는 기능이다. 일자, 시간을 입력하여 특정 시간 대의 항목 값 추이를 확인한다.

연결된 클라이언트 보기

해당 브로커에 접속한 응용 클라이언트의 정보를 표시하는 창을 활성화시킨다. 접속한 응용 클라이언트의 IP 주소가 표시된다.

연결된 데이터베이스 보기

해당 브로커를 통해 접속하는 데이터베이스 정보를 확인한다. 해당 정보는 브로커 모니터링 항목 중 DB 항목 값을 기준으로 표시된다.

호스트 보기

해당 브로커가 구동 중인 호스트 정보를 확인한다.

최소화하기

해당 브로커 모니터 창을 최소화한다. 브로커 별칭 및 연결 정보만 표시된다.

새로고침

해당 브로커 모니터를 수동으로 새로 읽어들인다.

로그

2012-04-19T03:43:45-07:00

로그

로그는 브로커 로그, 매니저 로그, 데이터베이스 로그로 구성되어 있다. 로그 정보를 구성하는 것은 접근 로그, 오류 로그 그리고 관리 로그로 분류해 볼 수 있다. 각 로그는 다음과 같이 구성된다.

브로커 로그
매니저 로그
데이터베이스 로그

브로커 로그

접근 로그

접근 로그 파일은 응용 클라이언트 접속에 관한 정보를 기록하며, "broker_name.access"의 이름으로 저장된 것을 분석하여 출력한다. 또한, 브로커 환경 설정 파일에서 LOG_BACKUP 매개 변수가 "ON"으로 설정된 경우, 브로커의 구동이 정상적으로 종료되면 접속 로그 파일에 종료된 날짜와 시간 정보가 추가되어 로그 파일이 저장된다.

오류 로그

오류 로그 파일은 응용 클라이언트의 요청을 처리하는 도중에 발생된 오류에 관한 정보를 기록하며, "broker_name_app_server_num.err"의 이름으로 저장된다.

다음은 오류 로그의 예와 설명이다.

Time: 02/04/09 13:45:17.687 - SYNTAX ERROR *** ERROR CODE = -493, Tran = 1, EID = 38

Syntax: Unknown class "unknown_tbl". select * from unknown_tbl

Time: 02/04/09 13:45:17.687 : 오류 발생 시각
SYNTAX ERROR : 오류의 종류(SYNTAX ERROR, ERROR 등)
*** ERROR CODE = -493 : 에러 코드
Tran = 1 : 트랜잭션 ID. -1은 트랜잭션 ID를 할당받지 못한 경우.
EID = 38 : 오류 ID. SQL 문 처리 중 오류가 발생한 경우, 서버와 클라이언트 오류 로그가 관련이 있는 SQL 로그를 찾을 때 사용함.

오류 로그 추적

SYNTAX ERROR 타입의 브로커 오류 로그는 추적할 수 있다.

추적할 오류 로그를 마우스 오른쪽 버튼 클릭하여 [오류 추적]을 선택하면 다음과 같은 오류 추적 결과 대화상자가 나타난다.

관리 로그

서비스 구동 및 정지에 관한 이력을 관리한다.

매니저 로그

접근 로그

접근 로그 파일은 매니저 접속에 관한 정보를 기록하며, 매니저 사용자 계정, 작업 수행 내역, 시간 정보를 확인할 수 있다.

오류 로그

오류 로그 파일은 매니저 접속에 대해 발생한 오류에 관한 정보를 기록한다.

데이터베이스 로그

관리 로그

데이터베이스 서버 구동에 관한 오류 정보를 기록하며, 이는 <database_name>_<date>_<time>.err 파일 내용을 출력한다.

CUBRID 매니저 관리자 안내서

2012-04-19T03:43:45-07:00

CUBRID 매니저 관리자 안내서

CUBRID 매니저 관리자는 CUBRID 매니저 사용자 관리를 돕는 CLI 도구로, Linux 버전에서만 지원한다. 이 장에서는 CUBRID 매니저 관리자를 이용한 CUBRD 매니저 사용자 관리 방법을 설명한다. 이 장에서 설명하는 주요 내용은 다음과 같다.

CUBRID 매니저 관리자 유틸리티 사용법
CUBRID 매니저 관리자 유틸리티 구문
CM 사용자
CM 사용자 추가
CM 사용자 삭제
CM 사용자 정보 출력
CM 사용자 권한 변경
CM 사용자 비밀번호 변경
CM 사용자의 데이터베이스 정보 추가
CM 사용자의 데이터베이스 정보 삭제
CM 사용자의 데이터베이스 정보 변경

CUBRID 매니저 관리자 유틸리티

2012-04-19T03:43:45-07:00

CUBRID 매니저 관리자 유틸리티

CUBRID 매니저 관리자 유틸리티는 CUBRID 매니저 서비스 관리 기능을 제공한다. Linux 버전에서만 지원하며, CM 사용자(데이터베이스 관리 사용자, CUBRID에서는 CUBRID 매니저 사용자를 나타냄) 정보에 대한 작업을 제공한다. 관리 유틸리티는 다음과 같다.

CM 사용자 추가/삭제/정보 출력 유틸리티
- cm_admin adduser
- cm_admin deluser
- cm_admin viewuser
CM 사용자 변경 유틸리티: CM 사용자 권한 정보 및 해당 사용자의 데이터베이스 정보를 변경한다.
- cm_admin changeuserauth
- cm_admin changeuserpwd
- cm_admin adddbinfo
- cm_admin changedbinfo
- cm_admin deldbinfo

프롬프트에서 cm_admin을 입력하면 다음과 같은 정보가 표시된다.

cmserver utility, version R0.1

usage: cm_admin <utility-name> [args]

Available Utilities:

adduser

deluser

viewuser

changeuserauth

changeuserpwd

adddbinfo

deldbinfo

changedbinfo

CUBRID 매니저 관리자 유틸리티 구문

2012-04-19T03:43:45-07:00

CUBRID 매니저 관리자 유틸리티

다음은 CUBRID 매니저 관리자 유틸리티 구문 사용법이다.

cm_admin utility_name

utility_name:

adduser [option] <cmuser-name> <cmuser-password> --- CM 사용자 추가

deluser <cmuser-name> --- CM 사용자 삭제

viewuser [cmuser-name] --- CM 사용자 정보 출력

changeuserauth [option] <cmuser-name> --- CM 사용자 권한 변경

changeuserpwd [option] <cmuser-name> --- CM 사용자 비밀번호 변경

adddbinfo [option] <cmuser-name> <database-name> --- CM 사용자의 데이터베이스 정보 추가

deldbinfo <cmuser-name> <database-name> --- CM 사용자의 데이터베이스 정보 삭제

changedbinfo [option] <database-name> number-of-pages --- CM 사용자의 데이터베이스 정보 변경

CM 사용자

2012-04-19T03:43:45-07:00

CM 사용자

CM(CUBRID 매니저) 사용자 정보는 다음과 같은 정보로 구성된다.

CM 사용자 권한: 다음과 같은 권한 정보를 포함한다.
- 브로커 권한
- 데이터베이스 생성 권한. 현재는 admin 사용자만 이 권한을 가질 수 있다.
- 상태 모니터링 권한
데이터베이스 정보: CM 사용자가 사용할 수 있는 데이터베이스
CM 사용자 비밀번호

CUBRID 매니저의 기본 사용자는 모든 관리 권한을 가진 admin 사용자이며 기본 비밀번호는 admin이다.

CM 사용자 추가

2012-04-19T03:43:45-07:00

CM 사용자 추가

설명

cm_admin adduser 유틸리티는 특정 권한과 데이터베이스 정보를 갖는 CM 사용자를 생성한다. 브로커 권한, 데이터베이스 생성 권한 및 상태 모니터링 권한 등을 CM 사용자에게 부여할 수 있다.

구문

cm_admin adduser options cmuser-name cmuser-password

options :

[{-b | --broker} authority]

[{-c | --dbcreate} authority]

[{-m | --monitor} authority]

[{-d | --dbinfo} database-info]

cm_admin : CUBRID 매니저를 관리하는 통합 유틸리티
adduser : 새 CM 사용자를 생성하는 명령어
options : -b, -c, -m, -d 옵션이 지원된다. 자세한 정보는 해당 옵션의 설명 및 예제를 참조한다.
cmuser-name : 생성할 CM 사용자의 고유한 이름을 지정한다. CM 사용자 이름은 4자 이상이어야 한다. 지정한 cmuser-name이 기존 cmuser-name과 같으면 cm_admin은 CM 사용자 생성을 중지한다.
cmuser-password : CM 사용자의 비밀번호이다. 비밀번호는 4자 이상이어야 한다.

옵션

옵션	설명
-b --broker	생성할 CM 사용자의 브로커 권한을 지정한다. 사용할 수 있는 값: admin, none, monitor. 기본값: none
-c --dbcreate	생성할 CM 사용자의 데이터베이스 생성 권한을 지정한다. 사용할 수 있는 값: none, admin, 기본값: none
-m --monitor	생성할 CM 사용자의 모니터링 권한을 지정한다. 사용할 수 있는 값: admin, none, monitor. 기본값: none
-d --dbinfo	생성할 CM 사용자의 데이터베이스 정보를 지정한다. DBINFO는 "<dbname>;<uid>;<broker_ip>,<broker_port>"의 형식으로 지정해야 한다.

브로커 권한(-b)

다음은 이름이 "testcm"이고 비밀번호가 "testcmpwd"인 CM 사용자를 생성하고 브로커 권한을 monitor로 설정하는 예이다.

cm_admin adduser -b monitor testcm testcmpwd

데이터베이스 생성 권한(-c)

다음은 이름이 "testcm"이고 비밀번호가 "testcmpwd"인 CM 사용자를 생성하고 데이터베이스 생성 권한을 admin으로 설정하는 예이다.

cm_admin adduser -c admin testcm testcmpwd

상태 모니터링 권한(-m)

다음은 이름이 "testcm"이고 비밀번호가 "testcmpwd"인 CM 사용자를 생성하고 상태 모니터링 권한을 admin으로 설정하는 예이다.

cm_admin adduser -m admin testcm testcmpwd

데이터베이스 정보 추가(-d)

다음은 이름이 "testcm"인 CM 사용자에게 "testdb;dba;localhost,30000"이라는 데이터베이스 정보를 추가하는 예이다.

cm_admin adduser -d "testdb;dba;localhost,30000" testcm testcmpwd

CM 사용자 삭제

2012-04-19T03:43:45-07:00

CM 사용자 삭제

설명

cm_admin deluser 유틸리티는 지정한 CM 사용자 이름을 기준으로 CM 사용자를 삭제한다.

구문

cm_admin deluser cmuser-name cmuser-password

cm_admin : CUBRID 매니저를 관리하는 통합 유틸리티
deluser : 기존 CM 사용자를 삭제하는 명령어
cmuser-name : 삭제할 CM 사용자 이름

예제

다음은 이름이 "testcm"인 CM 사용자를 삭제하는 예이다.

cm_admin deluser testcm

대시보드 창 관리

2012-04-19T03:43:44-07:00

대시보드 창 관리

마우스나 키보드 방향 키를 사용하여 대시보드 창에 표시된 대상 객체의 위치를 사용자가 조정할 수 있다. 조정한 위치 정보는 CUBRID 매니저 클라이언트가 설치된 로컬 디렉터리에 저장되어, 항상 마지막으로 저장된 위치 정보에 따라 객체를 표시한다. <Ctrl> 키를 누른 상태에서 마우스 휠을 움직이거나 <+> 키 또는 <-> 키를 누르면 화면의 배율을 조절할 수 있다.

대시보드 창에서 마우스 오른쪽 버튼 클릭하면 다음과 같은 바로가기 메뉴가 나타난다.

모두 선택: 대시보드 창에 표시된 객체 전부를 선택하여 위치를 이동할 수 있다.
호스트 모니터 추가: 해당 대시보드에 모니터링하고자 하는 새로운 호스트 정보를 추가할 수 있다.
새로 고침: 해당 대시보드를 수동으로 새로 읽어들인다.

호스트 모니터

2012-04-19T03:43:45-07:00

호스트 모니터

데이터베이스 또는 브로커가 구동 중인 호스트를 모니터링하며, 해당 호스트의 CPU, MEMORY, IO WAIT 항목의 현재 값을 퍼센트 단위로 보여준다. 호스트 모니터를 마우스 오른쪽 버튼 클릭하면 다음과 상세 기능을 설정할 수 있는 바로가기 메뉴가 나타난다.

상세 정보 보기

[상세 정보 보기]는 해당 호스트의 CPU, MEMORY, IO WAIT 상태의 시간에 따른 변화를 보여준다.

오른쪽 위의 차트 설정()을 클릭하면 차트 속성을 설정할 수 있다.

그림 모양: 호스트 모니터 차트의 배경색과 가로 세로 눈금선의 색상을 설정한다.
계열 선택: 호스트 모니터 차트에 보여줄 항목을 선택하고 해당 항목 그래프의 색상 및 선 굵기를 설정한다.
저장 설정: 기록 기능을 실행했을 때 기록한 내용을 저장할 디렉토리를 설정한다.
차트 선택: 모니터링할 차트를 선택한다.

삭제하기

모니터링 대상 호스트 정보 및 이에 포함된 데이터베이스 정보, 브로커 정보를 삭제한다.

별칭 이름 편집

해당 호스트 모니터 창에 표시되는 별칭을 수정할 수 있다. 기본값으로 해당 호스트의 IP 주소가 표시되며, 호스트 모니터에서 운영자가 쉽게 파악할 수 있는 서비스 이름으로 편집할 수 있다.

모니터링 기록 정보 보기

기록한 모니터링 정보를 확인할 수 있는 기능이다. 일자, 시간을 입력하여 특정 시간 대의 항목 값 추이를 확인할 수 있다.

데이터베이스 추가

해당 호스트에 구동 중인 데이터베이스를 직접 추가한다.

브로커 추가

해당 호스트에서 구동 중인 브로커를 직접 추가한다.

호스트 감추기

해당 호스트 모니터가 모니터링 대시보드에 표시되지 않도록 한다.

최소화하기

해당 호스트 모니터 창을 최소화한다. 호스트 별칭 및 접속 상태만 표시된다.

새로고침

해당 호스트 모니터를 수동으로 새로 읽어들인다.