tbSQL 유틸리티를 실행하는 방법은 다음과 같다.

$ tbsql

tbSQL 6

TmaxData Corporation Copyright (c) 2008-. All rights reserved.  

tbSQL 유틸리티가 정상적으로 실행되면 위 예제처럼 SQL 프롬프트가 나타난다. 이 프롬프트에서 데이터베이스 사용자는 SQL 문장을 실행할 수 있다.

tbSQL 유틸리티를 실행하는 명령어의 문법은 다음과 같다.

tbSQL 유틸리티를 실행한 후 SQL 프롬프트가 나타나면 데이터베이스에 접속할 수 있는 상태가 된다.

tbSQL 유틸리티는 데이터베이스의 세션을 시작하기 전에 수행해야 할 작업이 있을 경우 tbsql.login 파일을 작성하면 된다. 이 파일이 현재 디렉터리에 있는 경우에는 바로 실행하고, 그렇지 않은 경우에는 환경변수 TB_SQLPATH에 설정된 디렉터리에서 찾는다.

tbSQL 유틸리티를 이용하여 데이터베이스에 접속하는 방법은 다음과 같다.

$ tbsql SYS/syspassword

tbSQL 6

TmaxData Corporation Copyright (c) 2008-. All rights reserved.

Connected. 

위 예에서는 UNIX 셸 프롬프트에서 tbSQL 유틸리티의 실행과 함께 사용자명과 패스워드를 입력한다.

사용자명과 패스워드를 입력할 때에는 다음과 같은 규칙이 있다.

[예 1.2]와 같이 connect_identifier를 생략하는 경우엔 디폴트 데이터베이스에 접속이 된다. 만약 특정 데이터베이스에 접속하고자 하는 경우엔 connect_identifier를 명시하면 되고, 다음과 같은 두가지 형식으로 사용할 수 있다.

다음은 tbSQL 유틸리티를 실행했을 때의 화면이다.

$ tbsql

tbSQL 6

TmaxData Corporation Copyright (c) 2008-. All rights reserved.

SQL> CONNECT dbuser
Enter password : dbuserpassword
Connected to Tibero. 

위의 예에서는 tbSQL 유틸리티를 실행한 뒤 CONNECT 명령어를 통해 dbuser라는 사용자명으로 데이터베이스에 접속했다. tbSQL 유틸리티는 이처럼 텍스트 모드의 화면에서 입력을 받고, 사용자의 요구에 따라 결과를 출력한다.

tbSQL 유틸리티는 다음과 같은 특성을 가진 인터페이스로 실행한다.

tbSQL 유틸리티의 사용 환경을 설정하려면 SET 명령어를 사용해야 한다. SET 명령어를 통해 SQL 질의를 수행한 결과의 출력 형태, 트랜잭션의 커밋 여부 등을 설정할 수 있다.

다음은 SET 명령어의 문법이다.

SET [system_variable] [system_variable_value]

tbSQL 유틸리티를 종료하려면 SQL 프롬프트 에서 EXIT 또는 QUIT 명령어를 입력해야 한다.

SQL> EXIT

INSERT, UPDATE, DELETE, MERGE 혹은 PSM 블록 등의 SQL 문장을 실행한 후 자동으로 커밋을 수행하도록 설정한다.

AUTOCOMMIT의 세부 내용은 다음과 같다.

수행 중인 질의의 플랜이나 통계 정보를 보여준다. DBA 권한 또는 PLUSTRACE 권한이 있어야 사용할 수 있다. PLUSTRACE는 AUTOTRACE에 필요한 특권들이 포함된 권한으로 DBA 권한을 가진 사용자가 생성하여 다른 사용자에게 부여할 수 있다. 생성 스크립트는 $TB_HOME/scripts/plustrace.sql이다.

AUTOTRACE의 세부 내용은 다음과 같다.

PSM 문장에서 입력의 마지막을 나타내는 문자를 설정한다.

BLOCKTERMINATOR의 세부 내용은 다음과 같다.

SELECT 문장을 실행한 후 출력되는 여러 컬럼 사이의 구분을 나타내는 문자를 설정한다.

COLSEP의 세부 내용은 다음과 같다.

치환 변수 이름의 끝을 나타내는 문자를 설정한다.

CONCAT의 세부 내용은 다음과 같다.

수행 중인 DDL 문장의 플랜이나 통계 정보를 보여준다. 단, 주의할 점은 AUTOTRACE 기능도 반드시 활성화시켜야 한다.

DDLSTATS의 세부 내용은 다음과 같다.

치환 변수를 정의할 때 사용할 문자를 설정한다.

DEFINE의 세부 내용은 다음과 같다.

DESCRIBE 명령어를 통한 객체 명세를 어느 단계까지 보여줄지를 설정한다.

DESCRIBE의 세부 내용은 다음과 같다.

@ 또는 START 명령으로 스크립트 파일을 실행시킬 때 스크립트 내에서 실행되는 쿼리를 화면에 출력할지를 설정한다.

ECHO의 세부 내용은 다음과 같다.

EDIT 명령어에서 사용할 파일 이름의 기본값을 설정한다. 확장자를 생략할 경우 SUFFIX에 설정된 값을 사용한다.

EDITFILE의 세부 내용은 다음과 같다.

DEFINE에서 정의한 치환 변수 문자를 무시하도록 하는 이스케이프 문자를 설정한다. 이스케이프를 활성화한 뒤 설정한 이스케이프 문자를 '&<문자열>' 앞에 붙여 쓰면, 치환 변수로 인식되지 않는다.

ESCAPE의 세부 내용은 다음과 같다.

유틸리티 종료시에 커밋을 할지 여부를 설정한다.

EXITCOMMIT의 세부 내용은 다음과 같다.

SQL 문장의 수행 결과를 화면에 출력할지 설정한다.

FEEDBACK의 세부 내용은 다음과 같다.

쿼리 실행 결과를 출력할 때 컬럼의 머릿글을 표시할지를 결정한다.

HEADING의 세부 내용은 다음과 같다.

머릿글의 줄바꿈 문자를 설정한다.

HEADSEP의 세부 내용은 다음과 같다.

명령어 히스토리의 크기를 설정한다.

HISTORY의 세부 내용은 다음과 같다.

LOOP 명령어에서 각 수행이 끝난 후 대기하는 시간을 설정한다.

INTERVAL의 세부 내용은 다음과 같다.

화면상의 한 라인의 길이를 설정한다. 라인 길이의 최소값은 1이며, 최댓값은 운영체제에 따라 다르다.

LINESIZE의 세부 내용은 다음과 같다.

CLOB이나 BLOB, NCLOB, LONG, XML 타입의 데이터를 읽어 와서 출력할 길이를 설정한다. 길이는 2,000,000,000을 넘을 수 없다.

LONG의 세부 내용은 다음과 같다.

각 페이지의 시작 부분에 추가할 빈 줄 개수를 설정한다.

NEWPAGE의 세부 내용은 다음과 같다.

NUMBER 타입의 기본 컬럼 포맷을 설정한다. COLUMN 명령으로 FORMAT이 정의된 것을 제외한 숫자형 컬럼에 적용된다.

NUMFORMAT의 세부 내용은 다음과 같다.

NUMBER 타입을 출력할 길이를 설정한다. LINESIZE를 넘을 수 없다.

NUMWIDTH의 세부 내용은 다음과 같다.

tbSQL 유틸리티에서 출력하는 내용이 포함되는 각 페이지 내의 라인 개수를 설정한다.

PAGESIZE의 세부 내용은 다음과 같다.

한 페이지를 출력한 뒤 다음 페이지를 출력하기 전에 사용자 입력을 기다릴지를 설정한다.

PAUSE의 세부 내용은 다음과 같다.

로우 구분자를 출력하는 단위를 설정한다.

RECSEP의 세부 내용은 다음과 같다.

로우 구분자로 사용할 문자를 설정한다. 이 구분자는 LINESIZE 값만큼 반복해서 출력된다.

RECSEPCHAR의 세부 내용은 다음과 같다.

질의문의 결과를 화면에 출력할지를 설정한다.

ROWS의 세부 내용은 다음과 같다.

DBMS_OUTPUT 패키지의 결과를 출력할 것인지 설정한다.

SERVEROUTPUT의 세부 내용은 다음과 같다.

화면상의 프롬프트 문자를 설정한다.

SQLPROMPT의 세부 내용은 다음과 같다.

SQL 문장을 종료하는 문자를 설정한다.

SQLTMINATOR의 세부 내용은 다음과 같다.

파일 확장자를 생략했을 때 사용할 파일 확장자를 설정한다.

SUFFIX의 세부 내용은 다음과 같다.

스크립트에서 수행된 명령어의 결과를 화면에 출력할 것인지 설정한다.

TERMOUT의 세부 내용은 다음과 같다.

프롬프트에 현재 시간을 출력할 것인지 설정한다.

TIME의 세부 내용은 다음과 같다.

PING 명령어에서 서버가 응답할 때까지 기다릴 시간을 설정한다. 단위는 초다.

TIMEOUT의 세부 내용은 다음과 같다.

SQL, PSM 문장의 실행 결과를 출력할 때마다 수행 시간을 출력할 것인지 설정한다.

TIMING의 세부 내용은 다음과 같다.

SQL, PSM 문장의 실행 결과를 출력할 때마다 모든 라인의 뒤에 오는 공백을 제거할 것인지 설정한다.

TRIMOUT의 세부 내용은 다음과 같다.

SQL, PSM 문장의 실행 결과를 스풀링할 때마다 모든 라인의 뒤에 오는 공백을 제거할 것인지 설정한다.

TRIMSPOOL의 세부 내용은 다음과 같다.

머릿글의 밑줄로 사용할 문자를 설정한다.

UNDERLINE의 세부 내용은 다음과 같다.

치환 변수가 포함된 명령을 실행할 때 치환 변수가 값으로 치환되는 결과의 출력 여부를 설정한다.

VERIFY의 세부 내용은 다음과 같다.

화면에서 출력된 라인이 LINESIZE 변수로 설정된 값보다 긴 경우 나머지를 다음 라인에 출력할 것인지 아니면 LINESIZE 만큼만 출력할 것인지 설정한다.

WRAP의 세부 내용은 다음과 같다.

tbSQL 유틸리티의 명령 프롬프트에서의 입력은 크게 SQL 문장, PSM 프로그램, 유틸리티 명령어의 세 가지로 구분할 수 있다. 명령어의 입력 방법은 대체로 서로 유사하다. 각 명령어를 입력하는 방법에 대하여 차례로 설명한다.

SQL 문장의 입력

다음은 SQL 문장을 입력하는 방법이다.

다음은 tbSQL 유틸리티에서 SQL 문장을 입력하는 예이다.

SQL> SELECT ENAME, SALARY, ADDR
    FROM EMP
    -- this is a comment.
    WHERE DEPTNO = 5;
SQL>

PSM 프로그램의 입력

PSM 프로그램은 다수의 SQL 문장 또는 PSM 문장으로 이루어지며, 각 SQL 문장은 세미콜론(;)으로 마친다. PSM 프로그램을 입력하기 시작하면 tbSQL 유틸리티는 자동으로 PSM 프로그램 입력 모드로 전환한다. PSM 프로그램 입력 모드에서는 SQL 문장의 입력이 완료되었을 때 SQL 문장이 개별적으로 실행되지 않는다.

tbSQL 유틸리티가 PSM 프로그램 입력 모드로 전환하도록 만드는 문장에는 DECLARE, BEGIN 등 이름없는 블록(anonymous block)과 각각 프러시저, 함수, 트리거를 생성하는 CREATE (OR REPLACE) PROCEDURE, FUNCTION, TRIGGER가 있다.

PSM 프로그램에서의 입력 방법은 일반 SQL 문장의 경우와 유사하다.

다음은 PSM 프로그램을 입력하는 방법이다.

다음은 tbSQL 유틸리티에서 이름 없는 블록을 입력하는 예이다.

SQL> DECLARE
    deptno NUMBER(2);
    BEGIN
        deptno := 5;
        UPDATE EMP SET SALARY = SALARY * 1.05
        WHERE DEPTNO = deptno;
        -- this is a comment.
    END;
    .
SQL>

위의 예에서는 블록 내에 한 라인의 주석이 삽입되었으며, END 문장 아래의 9번째 라인에 블록종료 문자로 마침표(.)를 입력하여 PSM 프로그램의 입력을 마쳤다. 마지막 라인에서 다른 문자나 문자열 없이 오직 블록종료 문자만 단독으로 한 라인을 형성하고 있는 것을 확인할 수 있다.

tbSQL 유틸리티의 명령어 입력

tbSQL 유틸리티의 명령어에는 SQL 수행과 관련된 명령어나 기타 Tibero 데이터베이스 관리를 위한 명령어 등이 포함된다. tbSQL 유틸리티의 명령어에 대한 자세한 내용은 “1.6. 명령어”를 참고한다.

tbSQL 유틸리티의 명령 프롬프트에 입력된 명령어를 실행하는 방법은 다음과 같은 세 가지가 있다.

tbSQL 유틸리티의 명령어는 SQL 문장이나 PSM 프로그램과 달리 실행을 위한 명령어가 따로 없으며, SQL 버퍼에도 저장되지 않는다. tbSQL 유틸리티의 명령어는 입력을 마침과 동시에 실행된다.

다음은 SQL 버퍼에 저장된 SQL 문장을 실행하는 예이다.

SQL> SELECT ENAME, SALARY, ADDR
    FROM EMP
    -- this is a comment.
    WHERE DEPTNO = 5;
......실행 결과 ①......
SQL> /
......실행 결과 ②......
SQL>

위의 예에서는 첫 번째 SQL 프롬프트에서 SQL 문장을 입력하고 세미콜론(;)으로 종료하여 바로 실행하였다. 그리고 두 번째 SQL 프롬프트에서는 /를 입력하여 SQL 버퍼에 저장된 SQL 문장을 실행하였다. SQL 버퍼에는 가장 최근에 입력된 SQL 문장이 저장되어 있으므로, 첫 번째 SQL 프롬프트에서 입력한 SQL 문장과 동일한 문장이 다시 실행된다. 따라서 실행 결과 ①과 실행 결과 ②는 동일한 결과를 출력한다.

다음은 앞에서 보인 SQL 문장을 슬래시(/)를 이용하여 실행하는 예이다. 이때 SQL 문장의 맨 마지막에 세미콜론(;)을 입력하지 않는다.

SQL> SELECT ENAME, SALARY, ADDR
    FROM EMP
    -- this is a comment.
    WHERE DEPTNO = 5
    /
......실행 결과......
SQL>

본 절에서는 tbSQL 유틸리티의 기본 기능 중에서 주로 사용되는 주석의 삽입, 자동 커밋, 운영체제 명령어 실행, 출력 내용을 저장하는 기능에 대하여 차례로 설명한다.

주석 삽입

주석은 다음의 두 가지 방법으로 삽입할 수 있다.

자동 커밋

SQL 문장으로 갱신된 내용은 트랜잭션이 커밋되기 전에는 데이터베이스에 영구적으로 반영되지 않는다. 하나의 트랜잭션은 대개 여러 개의 SQL 문장으로 이루어지며, SQL 문장으로 갱신된 내용은 데이터베이스에 바로 반영되지 않는다.

tbSQL 유틸리티에서는 SQL 문장이 실행될 때마다 COMMIT 문장을 자동으로 실행하도록 설정하거나 이 기능을 정지시킬 수 있다. 디폴트는 자동 커밋을 사용하지 않는 것이다.

SET AUTOCOMMIT 명령어로 이러한 설정을 할 수 있으며, 현재의 자동 커밋 설정을 출력하여 확인하려면 SHOW AUTOCOMMIT 명령어를 이용한다.

운영체제 명령어 실행

tbSQL 유틸리티를 시작한 상태에서 운영체제 명령어를 실행하려면 HOST 명령어를 입력한다.

다음은 확장자가 .sql인 모든 스크립트 파일을 나열하는 예이다. HOST 명령어 대신에 ! 명령어를 사용해도 같은 동작을 수행한다.

SQL> HOST dir *.sql
..... 운영체제 명령어 실행 결과 .....
SQL>

운영체제 명령어를 실행한 후에는 다시 tbSQL 유틸리티의 프롬프트가 나타나며, 계속하여 tbSQL 유틸리티의 명령어를 입력할 수 있다.

HOST 명령어나 ! 명령어 다음 문장을 생략할 경우 운영체제 명령 프롬프트가 출력된다. 다시 tbSQL 유틸리티로 돌아오기 위해서는 EXIT를 입력한다.

SQL> !
$ dir *.sql
..... 운영체제 명령어 실행 결과 .....
$ EXIT
SQL>

출력 내용 저장

tbSQL 유틸리티에서 입력하거나 출력한 모든 내용을 텍스트 파일로 저장하려면 SPOOL 명령어를 사용한다. SPOOL 명령어를 사용하면, 사용자가 입력한 SQL 문장이나 PSM 프로그램, tbSQL 유틸리티의 명령어는 물론, 질의 결과 및 프로그램 실행 결과, tbSQL 유틸리티 프롬프트까지도 파일에 저장된다.

SPOOL 명령어를 실행하면 바로 다음 라인부터 파일에 저장된다. 이 기능을 정지하려면 SPOOL OFF를 입력한다. SPOOL OFF를 입력하면 그 다음 라인부터는 파일에 저장되지 않는다.

다음은 SPOOL 명령어를 사용하는 예이다. 만약 SPOOL 명령에서 사용되는 save.txt 파일이 이미 존재한다면 이전 파일 위에 덮어 쓰게 되므로 이전의 내용은 사라진다.

SQL> SPOOL save.txt
Spooling is started.
SQL> SELECT
    *
    FROM DUAL;

DUMMY
-----
X

1 row selected.

SQL> SPOOL OFF
Spooling is stopped: save.txt

다음은 앞의 예에서 save.txt 파일에 저장된 내용이다.

SQL> SELECT
    *
    FROM DUAL;

DUMMY
-----
X

1 row selected.

SQL> SPOOL OFF

사용자가 입력한 SQL 문장, 질의 결과, 마지막의 SPOOL OFF 명령까지도 파일에 저장되어 있다.

스크립트란 한 번의 명령으로 일괄적으로 작업을 실행하기 위한 SQL 문장과 PSM 프로그램, tbSQL 유틸리티의 명령어의 모임이다. tbSQL 유틸리티에서 스크립트를 실행하면 그 안에 포함된 모든 명령어가 차례로 실행된다.

스크립트 생성

스크립트 파일은 외부에서 생성, 편집하여 tbSQL 유틸리티 내에서 실행할 수도 있고, tbSQL 유틸리티를 실행한 후에 외부 편집기를 호출하여 생성, 편집할 수도 있다. 외부 편집기를 호출할 경우 어떤 편집기를 이용할 것인지 설정할 수 있다.

다음은 외부 편집기로 vi를 이용하는 예이다.

$ export TB_EDITOR=vi

외부 편집기를 이용하여 특정 스크립트 파일을 편집하기 위해서는 EDIT 명령어를 사용한다. EDIT 명령어와 함께 파일명을 제시해야 하며, 확장자가 SUFFIX 시스템 변수와 같은 경우에는 생략할 수 있다.

다음은 스크립트 파일 run.sql을 편집하기 위하여 외부 편집기를 호출하는 예이다.

SQL> EDIT run

다음은 스크립트 파일 내에 SQL 문장, PSM 프로그램, tbSQL 유틸리티의 명령어를 입력하는 방법이다.

스크립트를 실행하면 SQL 문장은 바로 실행되며, PSM 프로그램은 RUN 또는 / 명령어를 입력하여 실행한다.

다음은 테이블 EMP에 대한 몇 가지 작업을 수행하는 스크립트 파일의 예이다. 라인 사이에 공백이 들어갈 수 있다.

-- SQL 문장
SELECT ENAME, SALARY, ADDR FROM EMP
    WHERE DEPTNO = 5;
UPDATE EMP SET SALARY = SALARY * 1.05
    WHERE DEPTNO = 5;

-- PSM 프로그램
DECLARE
    deptno NUMBER(2);
BEGIN
    deptno := 20;
    UPDATE EMP SET SALARY = SALARY * 1.05
    WHERE DEPTNO = deptno;
END;

RUN -- PSM 프로그램 실행
/* 최종으로 갱신된 내용을 반영한다. */
COMMIT;

스크립트 실행

스크립트 파일을 실행하려면 START 또는 @ 명령어를 사용한다. 명령어와 함께 파일명을 지정하며 확장자가 SUFFIX 시스템 변수(sql)와 동일한 경우에는 생략해도 무방하다.

다음의 두 라인은 스크립트 파일 run.sql을 실행하는 예이며 결과는 동일하다.

SQL> START run
SQL> @run

스크립트 파일 내에서 하나 이상의 다른 스크립트 파일을 실행할 수도 있다. 즉, 스크립트 파일 내에 START 또는 @ 명령어를 포함할 수 있다. 스크립트 파일을 재귀적으로 실행할 때 무한 루프에 빠지지 않도록 해야 한다. tbSQL 유틸리티를 시작할 때 @ 명령어를 사용하면 시작과 동시에 스크립트 파일을 실행할 수 있다. 이러한 방법은 운영체제에서 배치 프로그램을 실행할 때 필요하다.

다음은 tbSQL 유틸리티를 시작하면서 동시에 스크립트 파일 run.sql을 실행하는 예이다.

$ tbsql dbuser/dbuserpassword @run

또는 다음과 같이 셸의 리다이렉션 명령을 이용하여 스크립트를 실행시키는 것도 가능하다.

$ tbsql dbuser/dbuserpassword < run.sql

tbSQL 유틸리티로 DBA 기능을 수행할 수 있다. tbSQL 유틸리티로 DBA 기능을 수행하려면 먼저 DBA 권한을 가진 사용자로 Tibero에 로그인 한다.

다음은 DBA 권한을 가지고 있는 SYS 사용자로 로그인을 하는 예이다.

$ tbsql sys/syspassword

tbSQL 유틸리티를 시작한 후에도 DBA로 연결할 수 있다. 이때 CONNECT 명령어를 사용하며 앞에서와 마찬가지로 DBA 권한을 가진 사용자로 연결하면 된다.

다음은 CONNECT 명령어를 이용하여 DBA로 연결하는 예이다.

SQL> CONNECT sys/syspassword

다음은 DBA가 tbSQL 유틸리티로 수행할 수 있는 기능이다.

tbSQL 유틸리티는 특정 사용자가 수행하는 명령어를 제한할 수 있는 기능을 제공한다.

이 기능을 위해 tbSQL 유틸리티는 SYS 사용자에 생성된 CLIENT_ACCESS_POLICY 테이블을 참조하며, 이 테이블은 DBA로 하여금 특정 사용자가 수행하는 명령어에 대한 접근 정책을 정의할 수 있게 한다.

tbSQL 유틸리티는 사용자가 데이터베이스에 접속할 때 해당 테이블에 있는 정보를 로딩하고, 사용자가 명령어를 수행할 때마다 권한 체크를 통해 수행 가능 여부를 판단한다. 한번 로딩된 정보는 사용자가 접속을 종료할 때 해제된다.

접근 제어 테이블 생성

접근 제어 테이블은 SYS 사용자로 접속하여 $TB_HOME/scripts/client_policy.sql 파일을 실행시켜 생성한다.

CLIENT_ACCESS_POLICY 테이블의 세부 내용은 다음과 같다.

CLIENT  VARCHAR2(32)   NOT NULL
USERID  VARCHAR2(128)
ACTION  VARCHAR2(256)
POLICY  VARCHAR2(64)

명령어 제한 설정

tbSQL 명령어나 SQL, PSM 명령어를 제한하기 위해선 다음 예제와 같이 CLIENT_ACCESS_POLICY 테이블에 로우를 삽입한다. 만약 다시 명령어를 허용하기 위해선 해당 로우를 삭제한다.

CLIENT   USERID       ACTION            POLICY
-------- ------------ ----------------  ----------
tbSQL    TIBERO       HOST              DISABLED
tbSQL    %            INSERT            DISABLED 
tbSQL    PUBLIC       UPDATE            DISABLED

다음은 제한할 수 있는 명령어 목록이다.

다음은 사용자 접근 제어 기능을 사용한 예제이다.

..... SYS 사용자로 접속 .....
SQL> CONNECT SYS
..... 접근 제어 설정 .....
SQL> INSERT INTO CLIENT_ACCESS_POLICY VALUES ('tbSQL', 'TIBERO', 'SELECT', 'DISABLED'); 
..... TIBERO 사용자로 접속 .....
SQL> CONNECT TIBERO
SQL> SELECT * FROM DUAL;
TBS-70082: The 'SELECT' command has been disabled.

tbSQL 유틸리티는 데이터베이스 접속 정보(connect_string)를 암호화 파일(wallet)로 저장하고 사용하는 기능을 제공한다. 환경변수인 ISQL_WALLET_PATH에 지정한 경로의 파일에 tbSQL 유틸리티에서 접속한 데이터베이스의 정보를 암호화 파일로 만들거나 다음 접속 시 사용할 수 있다.

암호화 파일 생성

tbSQL 유틸리티를 이용해서 특정 데이터베이스에 접속한 후 SAVE CREDENTIAL 명령어를 통해서 암호화 파일을 생성할 수 있다.

다음은 ISQL_WALLET_PATH의 값을 현재 경로의 wallet.dat 파일로 설정한 후 접속한 데이터베이스 정보를 암호화하여 생성하는 예이다.

$ export ISQL_WALLET_PATH=./wallet.dat
$ tbsql

tbSQL 6

TmaxData Corporation Copyright (c) 2008-. All rights reserved.

Can't login with the wallet file.
Login the database and SAVE CREDENTIAL again.

Enter Username: dbuser
Enter Password: dbuserpassword
Connected to Tibero.

SQL> SAVE CREDENTIAL
Complete to generate the wallet file.

tbSQL 유틸리티를 실행하기에 앞서 ISQL_WALLET_PATH 환경변수를 설정했기 때문에 ./wallet.dat 파일의 내용을 복호화하려고 시도하지만 해당 파일이 존재하지 않을 경우 위와 같은 에러가 발생한다.

데이터베이스에 정상적으로 다시 접속 후 SAVE CREDENTIAL 명령어를 통해서 ./wallet.dat 파일이 생성된다.

다음은 ISQL_WALLET_PATH 환경변수 설정없이 현재 경로의 wallet.dat 파일에 접속한 데이터베이스 정보를 암호화하여 생성하는 예이다.

$ tbsql

tbSQL 6

TmaxData Corporation Copyright (c) 2008-. All rights reserved.

SQL> CONN dbuser/dbuserpassword
Connected to Tibero.

SQL> SAVE CREDENTIAL "./wallet.dat"
Complete to generate the wallet file.

SAVE CREDENTIAL의 파라미터로 ./wallet.dat 파일 경로를 주면, 데이터베이스 접속한 정보를 암호화하여 ./wallet.dat 파일을 생성한다.

암호화 파일 사용

tbSQL 유틸리티 실행 전 환경변수 ISQL_WALLET_PATH의 값으로 위에서 생성한 암호화 파일(wallet)을 지정하면 암호화 파일 생성 전 접속한 정보를 다시 이용할 수 있다.

다음은 ISQL_WALLET_PATH의 값의 파일을 사용해서 데이터베이스에 접속하는 예이다.

$ tbsql

tbSQL 6

TmaxData Corporation Copyright (c) 2008-. All rights reserved.

Connected to Tibero.

tbSQL 유틸리티 내에서 운영체제의 명령어를 실행한다. ! 명령어 대신에 HOST 명령어를 사용할 수 있다.

! 명령어의 세부 내용은 다음과 같다.

tbSQL 유틸리티 내에서 히스토리 버퍼에 저장된 명령어를 다시 입력할 필요없이 재수행한다.

% 명령어의 세부 내용은 다음과 같다.

스크립트 파일을 실행한다. 스크립트 파일이 SUFFIX 시스템 변수에 등록된 확장자를 가지면 스크립트 파일의 이름을 확장자 없이 지정할 수 있다. tbSQL 유틸리티는 지정된 스크립트 파일을 현재 디렉터리 내에서 찾는다.

스크립트 파일의 실행 전에 SET 명령어로 설정된 시스템 변수는 스크립트 파일을 실행하는 중에도 유효하다. 스크립트 파일 내에서 EXIT 또는 QUIT 명령어를 실행하면 tbSQL 유틸리티를 종료한다.

@ 명령어 대신에 START 명령어를 사용할 수 있다.

@ 명령어의 세부 내용은 다음과 같다.

현재 SQL 버퍼 내의 SQL 문장 또는 PSM 프로그램을 실행한다.

/ 명령어 대신에 RUN 명령어를 사용할 수 있다.

/ 명령어의 세부 내용은 다음과 같다.

사용자의 입력을 받아 치환 변수의 값을 설정한다. 이때 설정된 치환 변수의 값은 이후에 사용자가 입력하는 SQL 문장이나 PSM 프로그램에서 &variable과 일치하는 단어가 있을 경우 자동으로 치환된다.

ACCEPT 명령어의 세부 내용은 다음과 같다.

SQL 버퍼에 사용자가 입력한 텍스트 혹은 statement를 덧붙인다.

APPEND 명령어의 세부 내용은 다음과 같다.

Redo 로그 파일 정보를 출력한다.

ARCHIVE LOG 명령어의 세부 내용은 다음과 같다.

SQL 버퍼에 있는 문장의 현재 라인에서 첫 번째 old 패턴을 찾아 new 패턴으로 변환한다. 일반적으로 마지막으로 실행된 SQL 문장의 현재 라인은 가장 마지막 라인이다. 현재 라인을 변경하려면 예제를 참고한다.

CHANGE 명령어의 세부 내용은 다음과 같다.

설정된 옵션을 초기화하거나 지운다.

CLEAR 명령어의 세부 내용은 다음과 같다.

컬럼의 출력 속성을 지정한다. 컬럼의 이름만 명시했을 경우에는 해당 컬럼의 속성을 출력하고, 컬럼의 이름을 명시하지 않을 경우에는 등록된 모든 컬럼을 출력한다.

COLUMN 명령어의 세부 내용은 다음과 같다.

다른 사용자로 Tibero 데이터베이스에 접속한다. 만약 사용자의 이름 또는 패스워드를 입력하지 않은 경우에는 tbSQL 유틸리티에서 프롬프트를 출력하고 입력을 요구한다.

CONNECT 명령어를 실행하면 이전에 실행되던 트랜잭션을 커밋시키고, 이전 접속을 해제하고 나서 새로운 접속을 시도한다. 만약 새로운 접속이 실패하더라도 이전의 접속을 복구하지 않는다.

CONNECT 명령어의 세부 내용은 다음과 같다.

치환 변수를 정의하거나 출력한다.

DEFINE 명령어의 세부 내용은 다음과 같다.

SQL 버퍼에 설정된 라인을 지운다. 만약 라인 번호를 생략할 경우 전체 라인을 삭제한다.

DEL 명령어의 세부 내용은 다음과 같다.

지정된 객체의 컬럼 정보를 출력한다. 여기에서 객체는 테이블, 뷰, 동의어, 함수, 프러시저, 패키지가 될 수 있다.

DESCRIBE 명령어의 세부 내용은 다음과 같다.

현재 데이터베이스로부터 접속을 종료한다. 진행 중이던 트랜잭션을 커밋하지만 tbSQL 유틸리티를 종료하지는 않는다.

스크립트 파일 내에서 CONNECT 명령어를 실행하고 그대로 종료한 경우 데이터베이스와 접속된 상태가 계속 유지된다. 따라서, 스크립트 파일 내에 CONNECT 명령어가 포함되고 있다면, 마지막에 DISCONNECT 명령어를 실행하는 것이 안전하다.

DISCONNECT 명령어의 세부 내용은 다음과 같다.

특정 파일 또는 SQL 버퍼의 내용을 외부 편집기를 이용하여 편집한다. 어떤 외부 편집기를 사용할 것인지는 환경변수 $TB_EDITOR에서 설정할 수 있다.

$TB_EDITOR가 등록되지 않았다면 환경변수 $EDITOR를 참조하고, $EDITOR도 등록되지 않았다면 vi 편집기를 사용하여 편집한다. 이때 SQL 버퍼가 비어 있다면 에러를 반환한다.

편집할 파일의 확장자가 SUFFIX 시스템 변수로 지정된 디폴트 확장자이면 확장자 없이 파일의 이름을 지정할 수 있다. SUFFIX 시스템 변수의 기본값은 .sql이며, SET 명령어를 이용하여 변경할 수 있다. tbSQL 유틸리티는 현재 디렉터리에서 지정된 파일을 찾는다.

EDIT 명령어의 세부 내용은 다음과 같다.

단일 PSM 문장을 수행한다. 사용할 수 있는 PSM 문장은 CALL 문장과 이름 없는 블록뿐이다. 사용자가 입력한 문장의 제일 끝에는 반드시 세미콜론(;)이 있어야 한다.

EXECUTE 명령어의 세부 내용은 다음과 같다.

tbSQL 유틸리티를 종료한다. 현재 진행 중이던 모든 트랜잭션을 커밋하며 데이터베이스와의 모든 접속을 종료한다.

EXIT 명령어의 세부 내용은 다음과 같다.

SELECT 문장의 수행 결과나 테이블 데이터를 파일로 출력한다. 고정형 포맷으로 출력하거나 각 컬럼과 로우 구분자를 지정하여 가변형 포맷으로 출력할 수 있다.

EXPORT 명령어의 세부 내용은 다음과 같다.

지정된 단어를 포함하는 모든 항목에 대한 도움말을 화면에 출력한다.

HELP 명령어의 세부 내용은 다음과 같다.

히스토리 버퍼에 저장된 명령어를 화면에 출력한다.

HISTORY 명령어의 세부 내용은 다음과 같다.

! 명령어와 동일하다.

HOST 명령어의 세부 내용은 다음과 같다.

SQL 버퍼에 저장된 제일 마지막 라인 뒤에 사용자가 입력한 문장을 추가한다.

INPUT 명령어의 세부 내용은 다음과 같다.

SQL 버퍼 내의 특정 내용을 화면에 출력한다.

LIST 명령어의 세부 내용은 다음과 같다.

Tibero 테이블을 Oracle의 SQL*Loader가 인식할 수 있는 형식으로 저장한다.

LOADFILE 명령어의 세부 내용은 다음과 같다.

임의의 문장을 무한 반복 수행하는 명령어이다. 수행을 종료하기 위해선 <Ctrl>+C를 누른다.

LOOP 명령어의 세부 내용은 다음과 같다.

현재 사용자가 생성한 특정 타입이나 이름의 데이터베이스 객체의 정보를 출력한다.

LS 명령어의 세부 내용은 다음과 같다.

사용자의 패스워드를 바꾸기 위한 명령어이다.

PASSWORD 명령어의 세부 내용은 다음과 같다.

사용자가 <Enter> 키를 누를 때까지 잠시 수행을 멈춘다. 메시지를 입력할 경우 해당 메시지를 화면에 나타낸다.

PAUSE 명령어의 세부 내용은 다음과 같다.

특정 데이터베이스에 대해 접속가능한 상태인지를 출력한다.

PING 명령어의 세부 내용은 다음과 같다.

사용자가 정의한 바인드 변수의 이름과 값을 출력한다.

PRINT 명령어의 세부 내용은 다음과 같다.

특정 메시지나 빈 라인을 화면에 출력한다.

PROMPT 명령어의 세부 내용은 다음과 같다.

EXIT 명령어와 동일하다.

QUIT 명령어의 세부 내용은 다음과 같다.

사용자가 선택한 정보를 지정한 파일로부터 복원한다.

RESTORE 명령어의 세부 내용은 다음과 같다.

/ 명령어와 동일하지만, 이 명령어를 사용할 경우 SQL 버퍼에 저장된 문장을 화면에 출력한다.

RUN 명령어의 세부 내용은 다음과 같다.

사용자가 선택한 정보를 지정한 파일에 저장한다. SAVE CREDENTIAL에 대한 사용법은 “1.5.4. 접속 정보 암호화 기능”에서 구체적으로 설명한다.

SAVE 명령어의 세부 내용은 다음과 같다.

tbSQL 유틸리티의 시스템 변수를 설정한다. SET 명령어로 설정된 시스템 변수는 SHOW 명령어를 사용하여 출력한다. 단, 변경된 시스템 변수는 현재 세션 내에서만 유효하다. 각각의 시스템 변수에 대해서는 “1.3. 시스템 변수”에서 구체적으로 설명한다.

SET 명령어의 세부 내용은 다음과 같다.

tbSQL 유틸리티의 시스템 변수를 출력한다. 출력할 정보를 파라미터를 사용하여 선택할 수 있으며, 모든 정보를 출력할 수 있다.

SHOW 명령어의 세부 내용은 다음과 같다.

화면에 출력되는 모든 내용에 대해 현재 디렉터리 내 파일로 생성한다. 단, HOST 명령어와 ! 명령어의 결과는 제외된다.

SPOOL 명령어의 세부 내용은 다음과 같다.

@ 명령어와 동일하다.

START 명령어의 세부 내용은 다음과 같다.

Tibero 데이터베이스를 종료한다. 긴급성에 따라 종료 옵션을 선택할 수 있으며 옵션에 따라 데이터베이스를 재시동할 때 복구 과정이 필요할 수 있다.

이 명령어를 실행하려면 SYSDBA 또는 SYSOPER로 데이터베이스에 접속해야 한다.

TBDOWN 명령어의 세부 내용은 다음과 같다.

ACCEPT 명령어 등으로 정의된 치환 변수를 삭제한다.

UNDEFINE 명령어의 세부 내용은 다음과 같다.

PSM 프로그램이나 SQL 문장에서 사용할 수 있는 사용자가 정의한 바인드 변수를 선언한다.

VARIABLE 명령어의 세부 내용은 다음과 같다.

오류가 발생한 경우 tbSQL의 동작을 정의한다.

WHENEVER 명령어의 세부 내용은 다음과 같다.

CHAR, NCHAR, VARCHAR, NVARCHAR 타입의 경우 데이터베이스 컬럼의 길이를 디폴트 길이로 가진다. 데이터의 값이 컬럼의 길이보다 클 때 데이터가 다음 라인에 기록되거나 잘릴 수 있는데, 문자형 포맷을 이용할 경우에는 이를 쉽게 처리할 수 있다.

문자형의 컬럼 포맷을 설정하는 세부 내용은 다음과 같다.

숫자형의 컬럼 포맷을 설정하는 세부 내용은 다음과 같다.