xml 데이터 형식에 대한 FOR XML 지원

아티클
12/15/2008

FOR XML 쿼리가 SELECT 절에서 xml 유형의 열을 지정하는 경우 ELEMENTS 지시어를 지정했는지 여부에 관계없이 열 값은 반환된 XML의 요소로 매핑됩니다. xml 유형의 열에 있는 XML 선언은 직렬화되지 않습니다.

예를 들어 다음 쿼리는 xml 유형의 AdditionalContactInfo열에서 ContactID, FirstName 및 LastName 열과 전화 번호와 같은 고객 연락 정보를 검색합니다.

SELECT ContactID, FirstName, LastName, AdditionalContactInfo.query('
declare namespace act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes";
 //act:telephoneNumber/act:number
') AS PhoneNumber
FROM Person.Contact
FOR XML AUTO, TYPE

쿼리는 ELEMENTS 지시어를 지정하지 않기 때문에 xml 유형의 열로부터 검색된 추가 연락 정보 값을 제외하면 열 값이 특성으로 반환됩니다. 이러한 값은 요소로 반환됩니다.

다음은 결과의 일부입니다.

<Contact ContactID="1" FirstName="Syed" LastName="Abbas">
    <act:number xmlns:act=
       "http://schemas.adventure-works.com/AdditionalContactTypes">
          111-111-1111</act:number>
    <act:number xmlns:act=
       "http://schemas.adventure-works.com/AdditionalContactTypes">
         112-111-1111</act:number>
</Contact>
<Contact ContactID="2" FirstName="Catherine" LastName="Abel">
    ...
</Contact>
...

XQuery에 의해 생성된 XML 열에 대한 열 별칭을 지정하면 XQuery에 의해 생성되는 XML에 래퍼 요소를 추가하는 데 해당 별칭이 사용됩니다. 예를 들어 다음 쿼리는 MorePhoneNumbers를 열 별칭으로 지정합니다.

SELECT ContactID, FirstName, LastName, AdditionalContactInfo.query('
declare namespace act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes";
 //act:telephoneNumber/act:number
') as MorePhoneNumbers
FROM Person.Contact
FOR XML AUTO, TYPE

XQuery에 의해 반환된 XML은 다음 부분 결과에 표시된 것과 같이 <MorePhoneNumbers> 요소에 래핑됩니다.

<Contact ContactID="1" FirstName="Syed" LastName="Abbas">
  <MorePhoneNumbers>
    <act:number xmlns:act="http://schemas.adventure-works.com/AdditionalContactTypes">111-111-1111</act:number>
    <act:number xmlns:act="http://schemas.adventure-works.com/AdditionalContactTypes">112-111-1111</act:number>
  </MorePhoneNumbers>
</Contact>
<Contact ContactID="2" FirstName="Catherine" LastName="Abel">
  <MorePhoneNumbers>
        ...
  </MorePhoneNumbers>
</Contact>
...

쿼리에서 ELEMENTS 지시어를 지정하면 ContactID, LastName 및 FirstName이 결과 XML에 요소로 반환됩니다.

다음 예에서는 FOR XML 처리 논리가 xml 유형 열의 XML 데이터에 있는 모든 XML 선언을 직렬화하지 않음을 보여 줍니다.

create table t(i int, x xml)
go
insert into t values(1, '<?xml version="1.0" encoding="UTF-8" ?>
                             <Root SomeID="10" />')
select i, x
from   t
for xml auto

다음은 결과입니다. 결과에서 XML 선언 <?xml version="1.0" encoding="UTF-8" ?>은 직렬화되지 않습니다.

<root>
  <t i="1">
    <x>
      <Root SomeID="10" />
    </x>
  </t>
</root>

사용자 정의 함수로부터 XML 반환

FOR XML 쿼리를 사용하여 다음 중 하나를 반환하는 사용자 정의 함수로부터 XML을 반환할 수 있습니다.

단일 xml 유형 열이 포함된 테이블
xml 유형의 인스턴스

예를 들어 다음 사용자 정의 함수는 xml 유형의 단일 열이 포함된 테이블을 반환합니다.

CREATE FUNCTION MyUDF (@ProudctModelID int)
RETURNS @T TABLE
  (
     ProductDescription xml
  )
AS
BEGIN
  INSERT @T
     SELECT CatalogDescription.query('
declare namespace PD="https://www.adventure-works.com/schemas/products/description";
                    //PD:ProductDescription  ')
     FROM Production.ProductModel
     WHERE ProductModelID = @ProudctModelID
  RETURN
END

사용자 정의 함수를 실행하고 함수로 반환된 테이블을 쿼리할 수 있습니다. 이 예에서 테이블 쿼리를 통해 반환된 XML은 xml 유형의 변수에 할당됩니다.

declare @x xml
set @x = (SELECT * FROM MyUDF(19))
select @x

이 예는 사용자 정의 함수의 또 다른 예입니다. 이 사용자 정의 함수는 xml 유형의 인스턴스를 반환합니다. 이 예에서 사용자 정의 함수는 스키마 네임스페이스가 지정되어 있기 때문에 형식화된 XML 인스턴스를 반환합니다.

drop function MyUDF4
go
CREATE FUNCTION MyUDF4 (@ProductModelID int) 
RETURNS xml ([Production].[ProductDescriptionSchemaCollection])
AS
BEGIN
  declare @x xml
  set @x =   ( SELECT CatalogDescription
          FROM Production.ProductModel
          WHERE ProductModelID = @ProductModelID )
  return @x
END

사용자 정의 함수로 반환된 XML은 다음과 같이 xml 유형의 변수에 할당될 수 있습니다.

declare @x xml
SELECT @x= dbo.MyUDF4 (19) 
select @x

xml 데이터 형식에 대한 FOR XML 지원

사용자 정의 함수로부터 XML 반환

참고 항목

참조

도움말 및 정보

추가 리소스