【오라클(Oracle) SQL 함수】SYS_XMLGEN 함수

o SYS_XMLGEN

 

---

문법

 

sys_xmlgen::=

 

---

목적 

SYS_XMLGEN 함수는 스칼라 값, object type, xml type 인스턴스를 XML 문서로 변형한다.

SYS_XMLGen함수는 데이터 베이스의 특정 행과 열을 평가하는 식을 인수로 지정하여서, XML 문서를 포함하는 XMLtype 타입의 인스턴스를 반환한다. 인수 expr은 스칼라 값, 사용자 정의 타입, XMLType 인스턴스를 지정할 수 있다.

• 만약 인수 expr이 스칼라 값이라면, 함수는 스칼라 값을 소유한 XML 문서를 반환한다.
• 만약 인수 expr이 type라면, 함수는 XML요소에서 사용자 정의 타입 속성을 맵핑한다.
• 만약 인수 expr이 XMLType인스턴스라면, 함수는 행에서 기본적 Tag 명을 가지는 XML요소로 문서를 둘러쌓는다.

기본적으로 XML 문서의 요소는 인수 expr의 요소와 일치한다. 예를 들어, 만약 expr이 열 명으로 변환되는 경우, XML 둘러싸인 요소는 같은 열명이 된다. 만약 XML 문서를 다른 게 서식을 원한다면, XMLFormat 오브젝트의 인스턴스인 fmt를 지정한다.

 

---

관련 함수

함수명	함수내용
DEPTH	UNDER_PAHT와 EQUALS_PAHT 조건과 함께 이용되는 보조 함수이다. 이 함수는 같은 상관 변수를 가지는 UNDER_PATH조건에 의해 지정된 PATH에서 레벨의 수를 반환한다.
EXISTSNODE	XPath에서 node의 존재 여부를 확인하여 그 결과를 반환한다.
EXTRACT (XML)	VARCHAR2 XPath 문자열에서  XML 플래그먼트(fragment)를 포함한 XMLType 인스턴스를 반환한다.
EXTRACTVALUE	existsnode 함수와 유사한 함수로써 결과 node의 스칼라 값을 반환한다.
PATH	under_path나 equals_path의 보조 함수로서, 자원의 관계 경로를 반환한다.
SYS_DBURIGEN	하나 이상의 열 또는 속성 및 선택적으로 ROWID를 인수로 지정하여서, 특정 열 또는 행 오브젝트에 대한 DBURIType 데이터 타입의 URL을 생성한다.
SYS_XMLAGG	입력받은 모든 문서를 취합하여서 하나의 XML 문서를 통합한다.
SYS_XMLGEN	스칼라 값, object type, xml type 인스턴스를 XML 문서로 변형한다.
XMLAGG	XML fragment(조각)의 집합체를 인수로 지정한 후 이 결과를 하나로 취합하여 XML 문서를 생성하여 반환한다.
XMLCOLATTVAL	파라미터로 지정한 변수들을 "column name" 속성으로 구성된 XML 조각(XML fragment)으로 변환하고, 이 결과를 취합한 XML 문서를 생성한다.
XMLCONCAT	둘 이상의 XML 값을 연결하는 함수.
XMLELEMENT	XML 문서를 생성하기 위하여 identifier에 대한 요소의 이름(element name), 요소에 대한 속성의 옵션 집합, 요소의 내용으로 구성된 인수를 지정한다.
XMLFOREST	개별 인수의 파라미터를 XML로 변환하고, 변환된 인수를 결합한 XML 조각(XML 단편, XML fragment)을 반환한다.
XMLSEQUENCE	- XMLType 인스턴트를 지정하여서 XMLType에 있는 top-level 노드의 varray를 반환한다.  - XMLFormat 오브젝트의 옵션 인스턴스를 가지는 REFCURSOR 인스턴스를 지정하여서 커서의 각 행에 대하여 XMLSequence 형태로써 XML 문서를 반환한다.
XMLTRANSFORM	XMLType인스턴스와 그 자체가 XMLType 인스턴스인 XSL스타일 시트를 인수로 지정한다. 이 함수는 스타일 슈트를 인스턴스로 적용하여서 XMLType를 반환한다.

 

---

예제

다음 예제는 employee_id 값이 205dls 샘플 테이블 oe.employees에서 종업원 이메일 ID를 찾아서, EMAIL요소를 가지는 XML 문서를 가지는 XMLType의 인스턴스를 생성한다.

Oracle Program

SELECT SYS_XMLGEN(email)      
FROM   employees
WHERE  employee_id = 205;

 

Results

SYS_XMLGEN(EMAIL)
-------------------------------------------------------------------
<EMAIL>SHIGGINS</EMAIL>

 

---

오라클 SQL 함수(Oracle SQL Function) 목록 리스트 링크

 

[SQL, Pandas, R Prog, Dplyr, SQLDF, PANDASQL, DATA.TABLE] SQL EMP 예제로 만나는 테이블 데이터 처리 방법 리스트 링크