꼼지락꼼지락

EXEC SQL CONNEXT { :user IDENTIFIED BY :pass }

[[ AT { dbname | :host_variable } ] USING :connect_string ] ;

예제를 보자. 흔히 쓰이는 방법이 다음의 두 가지 이다.

    char *conn_str = "tibero/tmax";

    EXEC SQL CONNECT :conn_str;

    char *user_str = "tibero";
    char *pass_str = "tmax";

     EXEC SQL CONNECT :user_str IDENTIFIED BY :pass_str;

DB에 tibero라는 user로 접속하기 위한 문장이다. password는 tmax이다.
user name과 password를 한 변수에 함께 쓰려면 위의 예와 같이 '/'로 구분할 수 있다.

AT 절이나 USING 절을 사용하는 다른 방법은 나중에 설명하기로 한다.



DDL 사용하기

다음과 같은 file을 작성해서 table을 생성해 보자.

tbesql $ vi test_ddl.tbc

/* test_ddl.tbc */

#include <stdio.h>
#include <string.h>

int main(void)
{  
    char *conn_str = "tibero/tmax";

    /* connection */
    EXEC SQL CONNECT :conn_str;

    if (sqlca.sqlcode == 0)
        printf("Connected.\n");
    else
        return -1;

    /* create table */
    EXEC SQL CREATE TABLE TEST01 (A NUMBER, B VARCHAR(10));

    /* check error code */
    if (sqlca.sqlcode == 0)
        printf("Table has been created.\n");
    else
        printf("Error occurred: %d\n", sqlca.sqlcode);

    return 0;
}  

sqlca는 SQL Communication Area의 약자를 따서 만든 이름이며, structure이다.
이 structure는 program의 수행 결과 등을 알기 위한 용도로 쓰이며, 이 중 sqlcode라는 member변수는 결과 코드 값을 보여준다,
0이면 error가 없이 정상적으로 수행된 것이다.
sqlca의 보다 자세한 쓰임에 대해서도 나중에 설명하겠다.

ESQL에서 DDL을 수행할 때는, 예제와 같이 EXEC SQL을 앞에 붙여서 수행하면 된다.
DDL 문장 자체를 string 변수에 저장하여 사용하는 방법은 나중에 살펴보자.


precompile과 compile을 거쳐 실행해 보자.

tbesql $ tbpc test_ddl

tbESQL Precompiler 4 Trunk

TmaxSoft, Co. Copyright(C) 2001-2009. All rights reserved.


test_ddl.tbc is precompiled successfully!

tbesql $ tbpcc test_ddl

tbesql $ ls
test_ddl    test_ddl.tbc   test_ddl.c

tbesql $ ./test_ddl
Connected.
Table has been created.

INSERT 사용하기

이미 존재하는 table에 데이터를 넣기 위해서는 insert문장을 사용해야 하므로, 다음과 같은 file을 작성해보자.

tbesql $ vi test_insert.tbc

/* test_insert.tbc */

#include <stdio.h>
#include <string.h>

int main(void)
{
    char *conn_str = "tibero/tmax";

    EXEC SQL CONNECT :conn_str;
   
    if (sqlca.sqlcode == 0)
        printf("Connected.\n");
    else
        return -1;

    EXEC SQL INSERT INTO TEST01 VALUES (1, 'Tibero');

    if (sqlca.sqlcode == 0)
        printf("1 row has been inserted.\n");
    else
        printf("Error occurred: %d\n", sqlca.sqlcode);

    return 0;
}

아까 table을 생성하기 위한 SQL을 실행했으므로 정상적으로 실행된다는 가정아래 compile과 실행결과는 다음과 같다.

tbesql $ tbpc test_insert

tbESQL Precompiler 4 Trunk

TmaxSoft, Co. Copyright(C) 2001-2009. All rights reserved.


test_insert.tbc is precompiled successfully!

tbesql $ tbpcc test_insert
tbesql $ ./test_insert
Connected.
1 row has been inserted.

만약에 insert할 테이블이 없다면 다음과 같은 에러가 출력될 것이다.

tbesql $ ./test_insert
Connected.
Error occurred: -8033

-8033 error가 출력되었다. 이 에러가 무엇인지 살펴보기 위해서 tberr라는 명령을 사용할 수 있다.

tbesql $ tberr 8033
/*
 * err:   -8033
 * name:  ERROR_DML_OBJ_NOT_EXIST
 * desc:   Specified schema object was not found.  
 * cause:  The specified schema object does not exist.  
 * action: Check the schema object name.;
 */

object가 존재하지 않아서 발생한 에러라는 것을 알 수 있다.
에러가 발생하면 sqlca.sqlcode를 통해 확인하고 적절한 대처를 해주면 되겠다.

INSERT이외에 UPDATE와 DELETE의 쓰임도 크게 다르지 않다. 문장 앞에 EXEC SQL을 붙여서 사용하면 된다.



SELECT 사용하기

이미 존재하는 row를 가져오기 위해, SELECT를 수행해보자.

tbesql $ vi test_select.tbc

/* test_select.tbc */

#include <stdio.h>
#include <string.h>

int main(void)
{
    char *conn_str = "tibero/tmax";
    char a[11];

    memset(a, 0, sizeof(a));

    EXEC SQL CONNECT :conn_str;

    if (sqlca.sqlcode == 0)
        printf("Connected.\n");
    else
        return -1;

    EXEC SQL SELECT A INTO :a FROM TEST01;

    if (sqlca.sqlcode == 0) {
        printf("1 row has been selected.\n");
        printf("column A: %s\n", a);
    }
    else
        printf("Error occurred: %d\n", sqlca.sqlcode);

    return 0;
}

tbsql(oracle에 sqlplus에 해당하는 실행프로그램) 등에서와는 SELECT 문법이 조금 다름을 볼 수 있다.
일반적인 SELECT 문장은 INTO 절이 없다. PSM(oracle에서는 PL/SQL)에서는 INTO 절을 사용한다.

INTO절에는 C변수가 와야 한다. 앞에는 ':'을 달고.
a는 VARCHAR(10)의 column data를 받아야 하므로 char[10]으로 선언했다.
이러한 C변수를 host 변수, 즉 host variable이라고 한다.
host 변수에 대한 좀 더 자세한 얘기는 다음 편에 다루기로 한다.

아까의 INSERT가 에러없이 수행되었다고 가정하고, 이 SELECT 문장을 수행해보자.
아래와 precompile과 compile을 거쳐 실행한다.

tbesql $ tbpc test_select

tbESQL Precompiler 4 Trunk

TmaxSoft, Co. Copyright(C) 2001-2009. All rights reserved.


test_select.tbc is precompiled successfully!
tbesql $ tbpcc test_select
tbesql $ ./test_select
Connected.
Error occurred: 1403

에러가 발생했다.
그런데 이상하다. 1403은 tberr로 조회가 안된다.

tbesql $ tberr 1403
"1403" is invalid err code

1403은 엄밀히 말하면 oracle의 error code이다. oracle을 사용하던 application이라면 대부분 1403이 숫자에 code로 박혀있기 마련인데, 편의를 위하여 tbESQL에서도 이를 그대로 사용할 수 있게 했다.
1403은 DATA NOT FOUND의 의미를 가진다.

이상한 건 또 있다. 아까 INSERT를 분명히 했는데 왜 row가 하나도 안나오지?
transaction의 종료 없이 program이 끝났기 때문이다. COMMIT이 필요하다.



COMMIT 사용하기

transaction을 control하는 COMMIT, ROLLBACK, SAVEPOINT등의 문장 역시 앞에 EXEC SQL만 붙이면 간단히 사용이 가능하다.

아까의 test_insert.tbc를 다음과 같이 고쳐보자.

/* test_insert.tbc */

#include <stdio.h>
#include <string.h>

int main(void)
{
    char *conn_str = "tibero/tmax";

    EXEC SQL CONNECT :conn_str;

    if (sqlca.sqlcode == 0)
        printf("Connected.\n");
    else
        return -1;

    EXEC SQL INSERT INTO TEST01 VALUES (1, 'Tibero');

    if (sqlca.sqlcode == 0)
        printf("1 row has been inserted.\n");
    else
        printf("Error occurred: %d\n", sqlca.sqlcode);

    EXEC SQL COMMIT;

    if (sqlca.sqlcode == 0)
        printf("Committed.\n");
    else
        printf("Error occurred: %d\n", sqlca.sqlcode);

    return 0;
}

precompile과 compile을 거쳐 실행하면 다음과 같은 결과를 볼 수 있다.
test_insert와 test_select를 차례로 실행했다.

tbesql $ ./test_insert
Connected.
1 row has been inserted.
Committed.
tbesql $ ./test_select
Connected.
1 row has been selected.
column A: 1        

SELECT가 아까와는 달리 error없이 잘 수행되었으며, 결과가 출력된 것을 볼 수 있다.

COMMIT은 다음과 같은 방식으로도 사용할 수 있다.

EXEC SQL COMMIT WORK;

WORK라는 keyword는 아무런 의미를 가지지 않는, 관습적인 쓰임을 지원하기 위한 문법이다. 생략해도 무방하다.

EXEC SQL COMMIT WORK RELEASE;

WORK는 위에 말했던 대로 의미가 없으나, RELEASE는 이후 연결을 끊고 모든 자원을 해제하라는 의미를 가진다.
이 문장이 실행된 후 추가로 ESQL을 실행하기 위해서는 CONNECT 문장을 다시 실행해야 한다.



링크와 펌질 환영. 가져가실 때는 출처를 밝혀주세요.