PostgreSQL 8.3.3문서
Prev	Fast Backward	Chapter 37. PL/pgSQL - SQL수속 언어	Fast Forward	Next

37.4. 선언

블록내에서 사용되는 모든 변수는 그 블록의 선언부에서 선언되어야 합니다 (유일한 예외는, FOR루프인 정수값의 범위에 건너 반복해지는 루프 변수로, 이는 자동적으로 정수형 변수로서 선언됩니다).

PL/pgSQL변수는, integer, varchar, char라는, 임의의 SQL 데이터형을 가질 수가 있습니다.

변수 선언의 예를 이하에 나타냅니다.

user_id integer;
quantity numeric(5);
url varchar;
myrow tablename%ROWTYPE;
myfield tablename.columnname%TYPE;
arow RECORD;

변수 선언의 일반적인 구문은 이하와 같습니다.


name
 [ CONSTANT ] 
type
 [ NOT NULL ] [ { DEFAULT | := } 
expression
 ];

DEFAULT구가 지정되었을 경우, 블록에 들어갔을 때에 변수에 대입되는 초기값을 지정합니다. DEFAULT구가 지정되지 않는 경우, 변수는 SQL의 NULL값에 초기화됩니다. CONSTANT옵션에 의해, 그 블록내에서 그 값이 불변하도록, 그 변수에의 대입은 금지됩니다. NOT NULL가 지정되었을 경우, NULL값의 대입은 실행시 에러가 됩니다. NOT NULL로서 선언한 변수는 모두, 비NULL의 디폴트값을 지정해야 합니다.

기본값은 블록에 들어갈 때에 평가되어 변수에 대입됩니다. 그러니까, 예를 들면 now()를 timestamp형의 변수에 대입하는 것으로, 그 변수에는 함수를 프리컴파일 했을 때가 아닌, 함수 호출시의 현재 시각이 저장됩니다.

Examples:

quantity integer DEFAULT 32;
url varchar := 'http://mysite.com';
user_id CONSTANT integer := 10;

37.4.1. 함수 인수의 별명

함수에게 건네지는 매개변수의 이름에는 $1, $2이라는 식별자를 붙일 수 있습니다. 옵션으로서 $n라는 매개변수명에 별명을 선언할 수 있어 가독성이 향상합니다. 선택적으로, 별명이나 숫자에 의한 식별자, 양쪽 모두 인자의 값을 참조할 때에 사용할 수 있습니다.

별명을 생성하는 두가지 방법이 있습니다. CREATE FUNCTION명령에서의 매개변수가 이름을 주는 방법이 선호됩니다. 예를들면:

CREATE FUNCTION sales_tax(subtotal real) RETURNS real AS $$
BEGIN
    RETURN subtotal * 0.06;
END;
$$ LANGUAGE plpgsql;

다른 방법은, 선언 구문을 이용해 별명을 명확하게 선언하는 것입니다. 이것은 PostgreSQL 8.0 이전에, 유일한 방법입니다.


name
 ALIAS FOR $
n
;

이하에 이 방법에 따르는 예를 나타냅니다.

CREATE FUNCTION sales_tax(real) RETURNS real AS $$
DECLARE
    subtotal ALIAS FOR $1;
BEGIN
    RETURN subtotal * 0.06;
END;
$$ LANGUAGE plpgsql;

한층 더 여러 예를 나타냅니다.

CREATE FUNCTION instr(varchar, integer) RETURNS integer AS $$
DECLARE
    v_string ALIAS FOR $1;
    index ALIAS FOR $2;
BEGIN
    -- v_string 와 인덱스를 사용한 어떠한 연산을 행한다
END;
$$ LANGUAGE plpgsql;


CREATE FUNCTION concat_selected_fields(in_t sometablename) RETURNS text AS $$
BEGIN
    RETURN in_t.f1 || in_t.f3 || in_t.f5 || in_t.f7;
END;
$$ LANGUAGE plpgsql;

PL/pgSQL함수가 출력 매개변수와 함께 선언되면, 통상의 입력 매개변수와 같게, 출력 매개변수에는 $ n라는 매개변수명과 임의의 별명이 주어집니다. 출력 매개변수는 실질적으로는 첫번째가 NULL값의 변수이며, 함수의 실행중에 값이 지정되어야 합니다. 출력 매개변수의 마지막 값은, 반환값입니다. 예를 들면, 소비세의 예제는, 다음과 같이 할 수도 있습니다.

CREATE FUNCTION sales_tax(subtotal real, OUT tax real) AS $$
BEGIN
    tax := subtotal * 0.06;
END;
$$ LANGUAGE plpgsql;

RETURNS real를 생략 했던 것에 주의해 주세요. 삽입할 수도 있습니다만, 장황하게 됩니다.

출력 매개변수는 복수의 값을 돌려줄 때에, 가장 유용하게 됩니다. 간단한 예제를 나타냅니다.

CREATE FUNCTION sum_n_product(x int, y int, OUT sum int, OUT prod int) AS $$
BEGIN
    sum := x + y;
    prod := x * y;
END;
$$ LANGUAGE plpgsql;

Section 33.4.3에서 말한 것처럼, 이 방법은 함수의 결과에 대한 익명의 레코드형을 실질적으로 작성합니다. RETURNS구가 주어졌을 때는, RETURNS record라고 말해야합니다.

PL/pgSQL함수의 반환값이 다양형(anyelement, anyarray, anynonarray 또는 anyenum)으로서 선언되면, 특별한 $0매개변수가 작성됩니다. 이 데이터형이, 실제의 입력형으로부터 추정(Section 33.2.5를 참조)된 함수의 실제의 반환값형입니다. $0는 NULL로 초기화되어 함수내에서 변경할 수가 있습니다. 그러므로, 필수는 아닙니다만, 이것을 반환값을 보관 유지하기 위해서 사용해도 상관없습니다. 또 $0에 별명을 부여할 수도 있습니다. 예를 들면, 이하의 함수는 +연산자를 가지는 임의의 데이터형에 대해서 가동합니다.

CREATE FUNCTION add_three_values(v1 anyelement, v2 anyelement, v3 anyelement)
RETURNS anyelement AS $$
DECLARE
    result ALIAS FOR $0;
BEGIN
    result := v1 + v2 + v3;
    RETURN result;
END;
$$ LANGUAGE plpgsql;

1개 이상의 출력 매개변수를 다양형으로서 선언하는 것으로써, 같은 결과를 얻을 수 있습니다. 이 경우, 특수한 $0매개변수는 사용되지 않습니다. 출력 매개변수 자신이 같은 목적을 제공합니다. 이하에 예를 나타냅니다.

CREATE FUNCTION add_three_values(v1 anyelement, v2 anyelement, v3 anyelement,
                                 OUT sum anyelement)
AS $$
BEGIN
    sum := v1 + v2 + v3;
END;
$$ LANGUAGE plpgsql;

37.4.2. 형태의 복제


variable
%TYPE

%TYPE는 변수나 테이블열의 데이터형을 제공합니다. 이것을 사용해 데이터베이스값을 보관 유지하는 변수를 선언할 수가 있습니다. 예를 들면, users테이블에 user_id라는 열이 있는 것으로 합니다. users.user_id와 같은 데이터형의 변수를 선언하려면, 이하와 같이 기술합니다.

user_id users.user_id%TYPE;

%TYPE를 사용하는 것으로, 참조하는 구조의 데이터형을 파악할 필요가 없어집니다. 또, 이것이 가장 중요한 일입니다만, 참조되는 항목의 데이터형이 향후 변경되었을(예를 들면, user_id의 테이블 정의를 integer로부터 real로 변경할) 경우에서도, 함수 정의를 변경할 필요가 없어집니다.

내부 변수용의 데이터형은 호출할 때로 바뀔지도 모르므로 %TYPE는 특히 다양 함수로 유용합니다. 함수의 인자나 결과용의 플레이스홀더에 %TYPE를 적용하는 것으로, 적절한 변수를 작성할 수 있습니다.

37.4.3. 행형


name
 
table_name

%ROWTYPE;

name
 
composite_type_name
;

복합형의 변수는, 행변수(또는행형변수)로 불립니다. 이러한 변수에는, 쿼리의 열집합이 변수의 형태 선언과 일치하는 한, SELECT나 FOR쿼리의 결과의 행 전체를 보관 유지할 수가 있습니다. 행 변수의 개개의 필드값에는, 예를 들면, rowvar.field라는 도트 기법을 사용해 접근 할 수가 있습니다.

table_name %ROWTYPE라는 기법을 사용해, 기존의 테이블이나 뷰의 행과 같은 형태를 가지는 행 변수를 선언할 수 있습니다. 혹은, 복합형의 이름을 부여해 선언할 수 있습니다 (모든 테이블은, 같은 이름의 관련하는 복합형을 가지기 때문에, 실제의 PostgreSQL에서는, %ROWTYPE라고 써도, 쓰지 않아도 문제되지 않습니다. 그러나, %ROWTYPE가 보다 이식성이 높아집니다).

함수에의 매개변수로서 복합형(테이블행 전체)을 취할 수가 있습니다. 그 경우, 대응하는 식별자$ n하행 변수이며, 그 필드를, 예를 들어, $1. user_id로 선택할 수가 있습니다.

테이블행의 사용자 정의의 속성에만 행형변수로 접근 할 수 있습니다. OID나 그 외의 시스템 속성에는 접근 할 수 없습니다(뷰로부터의 행이 있기 위해서). 행형의 필드는, 예를 들면 char( n )등의 테이블의 필드의 크기나 데이터형의 정밀도를 계승합니다.

이하에 복합형을 사용하는 예를 나타냅니다. table1 및 table2는, 적어도 언급된 필드를 가지는 실제 테이블입니다.

CREATE FUNCTION merge_fields(t_row table1) RETURNS text AS $$
DECLARE
    t2_row table2%ROWTYPE;
BEGIN
    SELECT * INTO t2_row FROM table2 WHERE ... ;
    RETURN t_row.f1 || t2_row.f3 || t_row.f5 || t2_row.f7;
END;
$$ LANGUAGE plpgsql;

SELECT merge_fields(t.*) FROM table1 t WHERE ... ;

37.4.4. 레코드형


name
 RECORD;

레코드 변수는 행형변수와 닮아 있습니다만, 사전에 정의된 구조를 가지고 있지 않습니다. 이것은 SELECT나 FOR명령의 사이에 대입된 행의 실제의 행 구조를 취합니다. 레코드 변수의 부구조는, 대입을 실시할 때 변경할 수 있습니다. 즉, 레코드 변수는, 최초로 대입될 때까지 부구조를 가지지 않고 , 따라, 필드에의 접근을 시도하면 실행시 에러가 발생합니다.

RECORD는 진정한 데이터형은 아니고, 단순한 플레이스홀더인 것에 주의해 주세요. PL/pgSQL함수가 record형을 돌려줄 때, 이 함수는 그 결과를 보관 유지하는 레코드 변수를 문제없이 사용할 수 있습니다만, 이것은 레코드 변수로서의 개념과는 완전히 다른 것을 인식해야 합니다. 두 가지 모두의 경우, 함수의 작성 단계에서는 실제의 행 구조는 불명합니다. 그러나, record를 돌려주는 함수에서는, 레코드 변수는 그 자리에서 그 행 구조를 변경할 수 있는 것에도 불구하고, 호출하는 쿼리가 해석된 시점에서 실제의 구조가 결정됩니다.

37.4.5. `RENAME`

RENAME 
oldname
 TO 
newname
;

RENAME선언을 사용해, 변수, 레코드, 행의 이름을 변경할 수가 있습니다. 이것은 주로, 크리거 프로시저의 안쪽에서 NEW나 OLD를 다른 이름으로 참조해야 하는 경우에 유용합니다. ALIAS도 참조해 주세요.

이하에 예를 나타냅니다.

RENAME id TO user_id;
RENAME this_var TO that_var;

Note: RENAME는, PostgreSQL 7.3의 시점에서는 망가진 것 같습니다. ALIAS로 RENAME의 실용적인 사용 방법의 대부분을 대용할 수 있기 때문에, 이 수정의 우선 순위는 낮습니다.

Prev	Home	Next
PL/pgSQL의 구조	Up	표현식