3. 외부 프로시저용 SQL문#
이 장은 Altibase에서 외부 프로시저를 사용하기 위해 지원하는 SQL문을 설명한다.
CREATE LIBRARY#
구문#
설명#
외부 라이브러리 객체를 새로 생성하거나 이미 생성되어 있는 외부 라이브러리를 새로운 외부 라이브러리로 변경한다.
IF NOT EXISTS#
IF NOT EXISTS 절을 명시하면 같은 이름의 라이브러리 객체가 없을 때만 생성한다. 같은 이름의 라이브러리 객체가 있는 경우, CREATE 문은 이름 중복 오류 없이 실행되며 기존의 라이브러리 객체에는 아무 영향을 주지 않는다.
library_name#
라이브러리 객체의 이름을 명시한다.
file_name#
동적 라이브러리 파일 이름을 명시한다. 이 파일은 $ALTIBASE_HOME/lib에 위치해야 한다. 단, 해당 디렉토리에 사용자가 명시한 파일이 없더라도 라이브러리 객체는 생성된다. 동적 라이브러리 파일의 존재 유무는 외부 프로시저가 실행될 때 검사되며, 만약 존재하지 않을 경우 해당 외부 프로시저 객체는 'INVALID' 상태로 전이한다.
예제#
CREATE OR REPLACE LIBRARY lib1 AS 'shlib.so';
ALTER LIBRARY#
구문#
설명#
라이브러리 객체를 컴파일한다.
외부 프로시저용 언어로 C 또는 C++만 지원하는 현재로서는, 이 구문을 실행하여도 서버에서 아무런 동작이 일어나지 않는다. 추후 다른 언어 지원을 위해 예약된 구문이다.
예제#
ALTER LIBRARY lib1 COMPILE;
DROP LIBRARY#
구문#
설명#
데이터베이스에서 외부 라이브러리 객체를 삭제한다.
삭제하려는 라이브러리 객체에 포함된 외부 프로시저가 실행 중이어도, 해당 라이브러리 객체는 삭제된다. 단, 데이터베이스에서 라이브러리 객체만 삭제될 뿐, 연관된 동적 라이브러리 파일이 삭제되지는 않는다.
IF EXISTS#
IF EXISTS 절을 명시하면 라이브러리 객체가 존재하지 않아도 DROP 구문이 오류 없이 실행된다.
예제#
DROP LIBRARY lib1;
CREATE PROCEDURE#
구문#
create_procedure ::=
argument_list ::=
argument_declaration ::=
call_spec ::=
parameter_list ::=
parameter_declaration ::=
설명#
외부 프로시저를 새로 생성하거나, 이미 생성되어 있는 외부 프로시저를 새로운 외부 프로시저로 변경한다.
procedure_name#
외부 프로시저 객체의 이름을 명시한다.
argument_list#
인자는 생략할 수 있으며, 인자를 명시할 경우엔 인자의 명칭, 데이터 타입 및 입출력 구분을 명시해야 한다. 사용 가능한 입출력 유형은 다음 세가지 중의 하나이고 생략 시에 IN이 기본값이 된다.
-
IN: 프로시저 호출시 입력값이 주어지는 입력 인자
-
OUT: 프로시저 실행 후 출력 값을 반환하는 인자
-
INOUT: 입출력 공용 인자로 프로시저 호출시 입력값이 주어지고, 실행 후에 출력 값을 반환한다.
외부 프로시저가 실행될 때, IN 인자를 사용해서 프로시저에 값을 전달하고, 프로시저는 OUT인자를 사용해서 호출한 루틴에 값을 반환한다.
call_spec#
사용자 함수 이름과 라이브러리 객체의 이름, 파라미터들을 지정하고, internal mode 또는 external mode를 설정 할 수 있다. 만약 EXTERNAL, INTERNAL을 명시하지 않으면, EXTERNAL 모드로 동작한다.
사용자 함수 이름과 라이브러리 객체를 명시하는 순서는 상관이 없으나, 각각 한번씩만 명시해야 한다.
func_name#
해당 외부 프로시저에 대응하는 사용자 정의 함수 이름을 명시한다.
lib_name#
해당 외부 프로시저에 대응하는 사용자 함수를 포함하는 외부 라이브러리 객체의 이름을 명시한다.
parameter_list#
외부 프로시저 객체의 인자들을 이에 대응하는 사용자 정의 함수의 인자들로 할당하기 위해 명시하는 절이다. 이 절의 인자 이름은 argument_list의 인자 이름을 그대로 사용하는 것이 일반적이다.
아래의 속성을 이용하여 각 파라미터에 대해 추가적인 정보를 사용자 정의 함수로 전달할 수 있다. 속성과 함께 명시되는 속성 파라미터는 실제 파라미터를 보조하는 역할을 할 뿐, 외부 프로시저 객체의 인자와는 관계가 없다.
| 속성 이름 | IN 경우 자료형 | INOUT/ OUT/ RETURN 경우 자료형 | 설명 |
|---|---|---|---|
| INDICATOR | short | short * | 해당 파라미터의 값이 NULL인지 아닌지를 나타낸다. 다음의 값 중 하나를 가질 수 있다. ALTIBASE_EXTPROC_IND_NULL ALTIBASE_EXTPROC_IND_NOTNULL |
| LENGTH | long long | long long * | 해당 파라미터 값의 길이를 바이트 단위로 나타낸다. 문자열의 경우 문자의 개수가 아니라 바이트 개수임에 주의하라. 문자열이 아닌 경우, 해당 자료형의 크기를 나타낸다. |
| MAXLEN | - | long long | 해당 파라미터의 버퍼 크기를 나타낸다. IN 모드 파라미터의 경우 이 속성 파라미터를 명시할 수 없다. |
아래 예제에서 PARAMETERS 절은 사용자 정의 함수로 전달되는 인자들과 인자들의 속성을 지정한다.
CREATE OR REPLACE PROCEDURE proc1(
a1 IN CHAR(30),
a2 OUT CHAR(30) )
AS
LANGUAGE C
LIBRARY lib1
NAME "str_uppercase"
PARAMETERS( a1, a1 LENGTH, a2 );
/
extern "C" void str_uppercase( char* str1, long long str1_len, char* str2 );
예제#
create or replace procedure proc1( a1 in char(30), a2 out char(30) )
as
language c
library lib1
name "str_uppercase"
parameters( a1, a1 LENGTH, a2 )
;
/
DROP PROCEDURE#
구문#
설명#
데이터베이스에서 외부 프로시저 객체를 삭제한다.
삭제하고자 하는 외부 프로시저가 실행 중이라면, 삭제되지 않고 오류가 발생한다.
예제#
DROP PROCEDURE proc1;
CREATE FUNCTION#
구문#
create_function ::=
argument_list ::=
argument_declaration ::=
call_spec ::=
parameter_list ::=
parameter_declaration ::=
설명#
외부 함수를 새로 생성하거나 이미 생성되어 있는 외부 함수를 새로운 외부 함수로 변경한다.
function_name#
외부 함수 객체의 이름을 명시한다.
argument_list#
CREATE PROCEDURE 문을 참고하라.
call_spec#
사용자 함수 이름과 라이브러리 객체의 이름, 파라미터들을 지정하고, internal mode 또는 external mode를 설정 할 수 있다. 만약 EXTERNAL, INTERNAL을 명시하지 않으면, EXTERNAL 모드로 동작한다.
사용자 함수 이름과 라이브러리 객체를 명시하는 순서는 상관이 없으나, 각각 한번씩만 명시해야 한다.
func_name#
해당 외부 프로시저에 대응하는 사용자 정의 함수 이름을 명시한다.
lib_name#
해당 외부 프로시저에 대응하는 사용자 함수를 포함하는 외부 라이브러리 객체의 이름을 명시한다.
parameter_list#
CREATE PROCEDURE 문을 참고하라.
RETURN#
외부 함수의 반환값을 가져오는 파라미터임을 명시하는 키워드이다. RETURN 뒤에 함수 파라미터와 마찬가지로 속성 파라미터를 추가로 명시할 수 있다. 속성 파라미터에 대해서는 CREATE PROCEDURE 구문의 설명을 참고하기 바란다.
제약 사항:
-
RETURN 절은 함수의 인자에 대한 파라미터를 모두 명시한 다음 마지막에 명시해야 한다. 그렇지 않으면 오류가 발생한다.
-
RETURN 뒤에 속성 파라미터를 명시하지 않으면, RETURN 자체를 명시하지 않은 것과 차이가 없다. 즉, (a, b, RETURN)과 (a, b)는 동일하다.
DROP FUNCTION#
구문#
설명#
데이터베이스에서 외부 함수 객체를 삭제한다.
삭제하려는 외부 함수가 실행 중이라면, 삭제되지 않고 오류가 발생한다.
예제#
DROP FUNCTION func1;
EXECUTE#
구문#
execute_procedure_statement ::=
execute_function_statement ::=
parameter_notation ::=
설명#
외부 프로시저 또는 외부 함수를 실행한다.
parameter_notation#
파라미터에 값을 전달하는 방식은 아래와 같다.
-
위치기반(Positional) : 기본적인 전달 방식으로, 정의된 파라미터의 위치에 맞춰 값이 입력된다.
-
이름기반(Name-based) : 정의된 파라미터의 이름을 입력하고 화살표(=>) 뒤에 값을 입력하는 방식이다. 파라미터의 순서에 관계없이 값을 전달할 수 있다.
-
혼합(Mixed): 위치기반과 이름기반 방식을 함께 사용할 수 있다. 그러나 반드시 위치기반 전달 방식을 먼저 입력해야 한다.
예제#
var var1 char(30);
var var2 char(30);
exec :var1 := 'hello world';
exec proc1( var1, var2 );
print var2;