DBMS_XMLSAVE

DBMS_XMLSAVE 패키지의 기본 개념과 패키지 내의 상수 및 프러시저와 함수들의 의미를 설명합니다.

개요

DBMS_XMLSAVE는 XML-to-database-type 기능을 제공합니다.

상수

DBMS_XMLSAVE에서는 패키지 내의 함수나 프러시저의 파라미터를 설정하기 위한 상수들을 포함하고 있습니다.

지원하는 상수들의 목록은 다음 표에 있습니다.

상수	설명
DEFAULT_ROWTAG	데이터베이스 레코드들에 대응하는 XML 요소에 대한 태그 이름의 기본값을 지칭하는 상수로, 상수 값은 'ROW'
DEFAULT_ROWSETTAG	삭제 예정으로, 상수 값은 'ROWSET'
DEFAULT_ERRORTAG	삭제 예정으로, 상수 값은 'ERROR'
DEFAULT_DATE_FOR MAT	기본 날짜 형식은 'MM/dd/yyyy HH:MI:ss'
MATCH_CASE	XML 요소들을 데이터베이스 개체에 대응시킬 때 XML SQL Utility는 case-sensitive 해야 함을 명시
IGNORE_CASE	XML 요소들을 데이터베이스 개체에 대응시킬 때 XML SQL Utility는 case- insensitive 해야 함을 명시

타입

DBMS_XMLSAVE의 함수와 프러시저 에서는 ctxType 타입을 사용합니다.

타입	설명
ctxType	처리할 쿼리 context 타입으로, “ NEWCONTEXT”의 리턴값
ctxHandle	삭제 예정

프러시저와 함수

본 절에서는 DBMS_XMLSAVE 패키지에서 제공하는 프러시저와 함수를 알파벳 순으로 설명합니다.

CLEARKEYCOLUMNLIST

Key column 리스트를 지웁니다.

CLEARKEYCOLUMNLIST 프러시저의 세부 내용은 다음과 같습니다.

• 프로토타입

PROCEDURE CLEARKEYCOLUMNLIST
(
    ctxHdl IN ctxType
);

• 파라미터

파라미터	IN / OUT	설명
ctxHdl	(IN)	처리할 Context

CLEARUPDATECOLUMNLIST

Update column 리스트를 지웁니다.

CLEARUPDATECOLUMNLIST 프러시저의 세부 내용은 다음과 같습니다.

• 프로토타입

PROCEDURE CLEARUPDATECOLUMNLIST
(
    ctxHdl IN ctxType
);

• 파라미터

파라미터	IN / OUT	설명
ctxHdl	(IN)	처리할 Context

CLOSECONTEXT

특정 save context를 닫습니다.

CLOSECONTEXT 프러시저의 세부 내용은 다음과 같습니다.

• 프로토타입

PROCEDURE CLOSECONTEXT
(
    ctxHdl IN ctxType
);

• 파라미터

파라미터	IN / OUT	설명
ctxHdl	(IN)	처리할 Context

DELETEXML

XML 문서의 데이터에 명시된 레코드들을 context를 생성할 때 명시된 테이블에서 지웁니다. 리턴값은 지워진 행의 개수입니다.

DELETEXML 함수의 세부 내용은 다음과 같습니다.

• 프로토타입

FUNCTION DELETEXML
(
    ctxHdl IN ctxPType,
    xDoc IN VARCHAR2
)
RETURN NUMBER;

FUNCTION DELETEXML
(
    ctxHdl IN ctxType,
    xDoc IN CLOB
)
RETURN NUMBER;

• 파라미터

파라미터	IN / OUT	설명
ctxHdl	(IN)	처리할 Context
xDoc	(IN)	XML 문서를 포함하고 있는 문자열

INSERTXML

Context 형성 시 명시된 테이블에 XML 문서의 데이터를 삽입합니다. 리턴값은 삽입된 행의 개수입니다.

INSERTXML 함수의 세부 내용은 다음과 같습니다.

• 프로토타입

FUNCTION INSERTXML
(
    ctxHdl IN ctxType,
    xDoc IN VARCHAR2
)
RETURN NUMBER;

FUNCTION INSERTXML
(
    ctxHdl IN ctxType,
    xDoc IN CLOB
)
RETURN NUMBER;

• 파라미터

파라미터	IN / OUT	설명
ctxHdl	(IN)	처리할 context
xDoc	(IN)	XML 문서를 포함하고 있는 문자열

NEWCONTEXT

새로운 save context를 만들고 처리할 context를 리턴합니다.

NEWCONTEXT 함수의 세부 내용은 다음과 같습니다.

• 프로토타입

FUNCTION NEWCONTEXT
(
    targetTable IN VARCHAR2
)
RETURN ctxType;

• 파라미터

파라미터	IN / OUT	설명
targetTable	(IN)	XML 문서를 올릴 표적 테이블

SETDATEFORMAT

XML 문서로부터 만들어진 date 타입의 형식을 정합니다.

SETDATEFORMAT 프러시저의 세부 내용은 다음과 같습니다.

• 프로토타입

PROCEDURE SETDATEFORMAT
(
    ctxHdl IN ctxType,
    mask IN VARCHAR2
);

• 파라미터

파라미터	IN / OUT	설명
ctxHdl	(IN)	처리할 context
mask	(IN)	Date 타입의 형식에 대한 syntax

SETIGNORECASE

Database의 column 또는 attribute에 XML 구성 요소를 대응시킬 때 대소문자를 무시할 지 말지 XXML SQL Utility에게 말해줍니다. 이러한 대응은 XML 태그 이름을 기반으로 합니다.

SETIGNORECASE 프러시저의 세부 내용은 다음과 같습니다.

• 프로토타입

PROCEDURE SETIGNORECASE
(
    ctxHdl IN ctxType,
    flag IN NUMBER
);

• 파라미터

파라미터	IN / OUT	설명
ctxHdl	(IN)	처리할 context
flag	(IN)	XML 문서의 대소문자를 무시할 지 말지 결정 1이면 무시하고 0이면 무시하지 않음

SETKEYCOLUMN

Column을 key column 리스트에 추가합니다.

SETKEYCOLUMN 프러시저의 세부 내용은 다음과 같습니다.

• 프로토타입

PROCEDURE SETKEYCOLUMN
(
    ctxHdl IN ctxType,
    colName IN VARCHAR2
);

• 파라미터

파라미터	IN / OUT	설명
ctxHdl	(IN)	처리할 context
colName	(IN)	Key column 리스트에 추가할 column의 이름으로 NULL이면 안됨

SETROWTAG

데이터베이스의 레코드에 대응되는 XML 구성 요소에 대해 XML 문서 상에서 사용되는 태그 이름을 지어 줍니다.

SETROWTAG 프러시저의 세부 내용은 다음과 같습니다.

• 프로토타입

PROCEDURE SETROWTAG
(
    ctxHdl IN ctxType,
    tag IN VARCHAR2
);

• 파라미터

파라미터	IN / OUT	설명
ctxHdl	(IN)	처리할 context.
tag	(IN)	태그 이름

SETUPDATECOLUMN

Column을 update column 리스트에 추가합니다.

SETUPDATECOLUMN 프러시저의 세부 내용은 다음과 같습니다.

• 프로토타입

PROCEDURE SETUPDATECOLUMN
(
    ctxHdl IN ctxType,
    colName IN VARCHAR2
);

• 파라미터

파라미터	IN / OUT	설명
ctxHdl	(IN)	처리할 context
colName	(IN)	Update column 리스트에 추가할 column의 이름으로 NULL이면 안 됨

UPDATEXML

Context 형성 시 명시된 테이블에 XML 문서 데이터를 업데이트합니다. 리턴값은 업데이트 된 행의 개수이 다.

UPDATEXML 함수의 세부 내용은 다음과 같습니다.

• 프로토타입

FUNCTION UPDATEXML
(
    ctxHdl IN ctxType,
    xDoc IN VARCHAR2
)
RETURN NUMBER;

FUNCTION UPDATEXML
(
    ctxHdl IN ctxType,
    xDoc IN CLOB
)
RETURN NUMBER;

• 파라미터

파라미터	IN / OUT	설명
ctxHdl	(IN)	처리할 context
xDoc	(IN)	XML 문서를 포함하고 있는 문자열