엑시엄이 보는 DB 세상
Table Function & Pipelined Table 4 4 99,999+

by axiom Table Function Pipelined Table Function TYPE Function [2012.12.18]


업무를 수행하다 보면 Result Set 전체를 인자 값으로 받아서 결과를 Return하고자 하는 경우가 종종 있다. 이때 Oracle Table Function을 사용하면 이를 간단히 해결할 수 있다.

Oracle Table Function은 Result Set(Multi column + Multi Row)의 형태를 인자 값으로 받아들여 값을 Return할 수 있는 PL/SQL Function이고, Pipelined Table Function은 Oracle Table Function과 마찬가지로 Result Set의 형태로 인자 값을 제공하거나 전체 집합을 한번에 처리하지 않고 Row 단위로 한 건씩 처리하는 Function으로 PL/SQL의 부분범위 처리를 가능하게 해주는 Function이다.

그럼 Table Function과 Pipelined Table Function을 살펴보도록 하자.

Table Function은 어떻게 사용하는가?

Table Function은 Function으로 정의되며 Function의 Input으로 Row들의 집합을 취할 수 있고 출력으로 Row들의 집합을 생성할 수 있다.

Query의 FROM 절에서 'TABLE'이라는 키워드로 접근 가능하며 Return Type은 Nested Table 또는 Varray 형태이다. 간단한 예제를 통해 Table Function을 어떻게 사용하는지 확인해 보자.

  • Return 받을 행을 받는 Object Type을 생성
CREATE OR REPLACE TYPE obj_type AS object
( c1 INT,
  c2 INT
);
/

유형이 생성되었습니다.

  • Collection Type 생성
CREATE OR REPLACE TYPE table_type 
AS TABLE OF obj_type;
/

유형이 생성되었습니다.

  • Table Function을 생성 - 원하는 만큼의 Row를 출력하는 Function
CREATE OR REPLACE FUNCTION table_func (p_start int, p_end int)
  RETURN table_type
  IS
    v_type TABLE_TYPE := table_type();
  BEGIN
  
    FOR i IN p_start..p_end LOOP
      v_type.extend;
      v_type(i) := obj_type(i,i);
    END LOOP;
    
    RETURN v_type;
 END;
 /

함수가 생성되었습니다.

  • FROM 절에 'TABLE'이라는 Keyword를 이용해 아래와 같은 결과 추출
SELECT * FROM TABLE(table_func(1,3));


   C1         C2
----- ----------
    1          1
    2          2
    3          3

Pipelined Table Function은 어떻게 사용하는가?

다음은 Pipelined Table Function에 대해 알아보도록 하자.

Pipelined Table Function은 한 행 단위로 즉시 값을 리턴하는 함수로, 9i 이상에서만 가능하며 수행 속도가 향상되었고 부분범 위 처리가 가능하다.

간단한 예제를 통해 Pipelined Table Function을 어떻게 사용하는지 확인해 보자.

  • Return 받을 행을 받는 Object Type을 생성
CREATE OR REPLACE TYPE obj_type1 AS object
( c1 INT,
  c2 INT
 );
 /
 
 유형이 생성되었습니다.

  • Collection Type 생성
CREATE OR REPLACE TYPE table_type1 
AS TABLE OF obj_type1;
/

유형이 생성되었습니다.

  • Pipelined Table Function을 생성 - 원하는 만큼의 Row를 출력하는 Function
CREATE OR REPLACE FUNCTION pipe_table_func(p_start INT, p_end INT)
  RETURN table_type1
  PIPELINED
  IS
    v_type obj_type1;
  BEGIN
    FOR i IN p_start..p_end LOOP
      v_type := obj_type1(i, i);
      PIPE ROW(v_type);
    END LOOP;
  END;
 /
 
함수가 생성되었습니다.

  • FROM 절에 'TABLE'이라는 Keyword를 이용해 수행한다면 아래와 같은 결과 추출
SELECT * FROM TABLE(pipe_table_func(1,3));

   C1         C2
----- ----------
    1          1
    2          2
    3          3

Pipelined Table Function은 하나의 Row를 받아서 바로 처리하므로 수행 속도가 빠르다. 이에 비해 Table Function은 전체 Row가 처리된 이후에 동작되므로 Pipelined Table Function에 비해 이전 처리된 Row를 Cache할 Memory를 더 요구하게 된다.

Table Function & Pipelined Table Function을 비교하자

위에서 생성한 Function을 이용해 Table Function & Pipelined Table Function을 확인할 수 있다.

  • Table Function만을 사용한 table_func에 큰 Row를 Return하는 Test
-- 커서가 깜빡거린 이후 일정 시간 경과 후(모든 결과가 계산됨) Row 가 출력된다.
SELECT * FROM TABLE(table_func(1, 1000000));

  • Pipeline Table Function만을 사용한 table_func에 큰 Row를 Return하는 Test
-- 한 Row씩 처리하므로 바로 결과 값들이 출력되기 시작
SELECT * FROM TABLE(pipe_table_func(1, 1000000));

이처럼 Table Function은 전체 데이터 처리를 수행하지만 Pipelined Table Function은 부분 범위 처리를 수행한다는 것을 확인할 수 있다.

우리가 Oracle 10g부터 사용하는 dbms_xplan Package의 Function들도 Pipelined Table Function으로 구현되어 있다.

EXPLAIN PLAN FOR SELECT * FROM emp;

해석되었습니다.


SELECT * FROM TABLE(DBMS_XPLAN.DISPLAY);

PLAN_TABLE_OUTPUT
-----------------------------------------------------------------------------
Plan hash value: 3956160932

--------------------------------------------------------------------------
| Id  | Operation         | Name | Rows  | Bytes | Cost (%CPU)| Time     |
--------------------------------------------------------------------------
|   0 | SELECT STATEMENT  |      |    15 |   555 |     3   (0)| 00:00:01 |
|   1 |  TABLE ACCESS FULL| EMP  |    15 |   555 |     3   (0)| 00:00:01 |
--------------------------------------------------------------------------

이처럼 Pipelined Table Function을 적재적소에 사용해 강력 한 PL/SQL Query를 잘 이용하길 바란다.

- 강좌 URL : http://www.gurubee.net/lecture/2238

- 구루비 강좌는 개인의 학습용으로만 사용 할 수 있으며, 다른 웹 페이지에 게재할 경우에는 출처를 꼭 밝혀 주시면 고맙겠습니다.~^^

- 구루비 강좌는 서비스 제공을 위한 목적이나, 학원 홍보, 수익을 얻기 위한 용도로 사용 할 수 없습니다.

by 아발란체 [2012.12.18 13:52:46]

우왕 킹왕짱...!! 좋은 자료 감사합니다.


by 김정식 [2012.12.18 14:40:12]
Pipelined Table Function 잘 활용하면 정말 유용할 꺼 같아요..

by 늙은초보신입개발자 [2013.03.18 17:18:32]
좋은글 감사합니다

by 궁금이 [2017.09.29 08:29:54]

오라클 8이라서 첫번째 방식으로 구현했습니다.
함수내에서 output 확인해보니 리턴타입에 저장은 잘되는데 실제 SELECT하면 ROW는 저장된 갯수만큼 나오는데 실제 데이터는 공백이나 깨져서 나옵니다.

혹시 원인을 알 수 있을까요

댓글등록
SQL문을 포맷에 맞게(깔끔하게) 등록하려면 code() 버튼을 클릭하여 작성 하시면 됩니다.
로그인 사용자만 댓글을 작성 할 수 있습니다. 로그인, 회원가입