SequenceType 식(XQuery)
XQuery에서는 값이 항상 시퀀스입니다. 값 유형을 시퀀스 유형이라고 합니다. instance of XQuery 식에 시퀀스 유형을 사용할 수 있습니다. XQuery 식에서 유형을 참조해야 할 경우 XQuery 사양에 설명된 SequenceType 구문이 사용됩니다.
cast as XQuery 식에는 원자성 유형 이름도 사용할 수 있습니다. SQL Server 2005 에서는 SequenceType의 instance of 및 cast as XQuery 식이 부분적으로 지원됩니다.
instance of 연산자
instance of 연산자를 사용하여 지정한 식의 동적 또는 런타임 값 유형을 확인할 수 있습니다. 예를 들어 다음과 같습니다.
Expression instance of SequenceType[Occurrence indicator]
instance of 연산자인 Occurrence indicator는 결과 시퀀스에 있는 항목 수인 카디널리티를 지정합니다. 카디널리티가 지정되지 않은 경우 1로 간주됩니다. SQL Server 2005 에서는 물음표(?) 발생 표시만 지원됩니다. ? 발생 표시는 Expression이 0개 또는 한 개의 항목을 반환할 수 있음을 나타냅니다. ? 발생 표시를 지정하면 Expression 유형이 지정된 SequenceType과 일치할 경우 Expression이 단일 항목 또는 빈 시퀀스를 반환하는지 여부에 관계없이 instance of가 True를 반환합니다.
? 발생 표시를 지정하지 않으면 Expression 유형이 지정된 Type과 일치하고 Expression이 단일 항목을 반환하는 경우에만 sequence of가 True를 반환합니다.
참고 SQL Server 2005 에서는 더하기 기호(+)와 별표(*) 발생 표시가 지원되지 않습니다.
다음 예에서는 instance of XQuery 연산자를 사용하는 방법을 보여 줍니다.
예 1
다음 예에서는 xml 유형 변수를 만들고 이에 대한 쿼리를 지정합니다. 쿼리 식은 instance of 연산자를 지정하여 첫 번째 피연산자가 반환한 동적 값 유형이 두 번째 피연산자에 지정된 유형과 일치하는지 여부를 확인합니다.
125 값은 지정된 유형 xs:integer의 인스턴스이므로 다음 쿼리는 True를 반환합니다.
declare @x xml
set @x=''
select @x.query('125 instance of xs:integer')
go
첫 번째 피연산자의 /a[1] 식에서 반환한 값이 요소이므로 다음 쿼리는 True를 반환합니다.
declare @x xml
set @x='<a>1</a>'
select @x.query('/a[1] instance of element()')
go
마찬가지로 첫 번째 식에서 식의 값 유형이 특성이므로 다음 쿼리에서 instance of는 True를 반환합니다.
declare @x xml
set @x='<a attr1="x">1</a>'
select @x.query('/a[1]/@attr1 instance of attribute()')
go
다음 예에서는 data(/a[1] 식이 xdt:untypedAtomic으로 형식화된 원자성 값을 반환합니다. 따라서 instance of에서는 True를 반환합니다.
declare @x xml
set @x='<a>1</a>'
select @x.query('data(/a[1]) instance of xdt:untypedAtomic')
go
다음 쿼리에서 data(/a[1]/@attrA 식은 형식화되지 않은 원자성 값을 반환합니다. 따라서 instance of에서는 True를 반환합니다.
declare @x xml
set @x='<a attrA="X">1</a>'
select @x.query('data(/a[1]/@attrA) instance of xdt:untypedAtomic')
go
예 2
이 예에서는 AdventureWorks 예제 데이터베이스에 있는 형식화된 XML 열을 쿼리합니다. 쿼리 중인 열과 관련된 XML 스키마 컬렉션이 형식화 정보를 제공합니다.
식에서 **data()**는 열과 관련된 스키마에 따라 유형이 xs:string인 ProductModelID 특성의 형식화된 값을 반환합니다. 따라서 instance of에서는 True를 반환합니다.
SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
data(/PD:ProductDescription[1]/@ProductModelID) instance of xs:string
') as Result
FROM Production.ProductModel
WHERE ProductModelID = 19
자세한 내용은 형식화된 XML과 형식화되지 않은 XML을 참조하십시오. CatalogDescription 열과 관련된 XML 스키마 컬렉션에 대한 자세한 내용은 ProductModel.CatalogDescription xml 열 정보를 참조하십시오.
다음 쿼리에서는 `` 부울 instance of 식을 사용하여 LocationID 특성 유형이 xs:integer인지 여부를 확인합니다.
SELECT Instructions.query('
declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
/AWMI:root[1]/AWMI:Location[1]/@LocationID instance of attribute(LocationID,xs:integer)
') as Result
FROM Production.ProductModel
WHERE ProductModelID=7
CatalogDescription 유형의 XML 열에 대해서는 다음 쿼리가 지정됩니다. 이 열과 관련된 XML 스키마 컬렉션이 형식화 정보를 제공합니다. XML 스키마 컬렉션에 대한 자세한 내용은 ProductModel.CatalogDescription xml 열 정보를 참조하십시오.
쿼리에서는 instance of 식에 element(ElementName, ElementType?) 테스트를 사용하여 /PD:ProductDescription[1]이 특정 이름과 유형의 요소 노드를 반환하는지 확인합니다.
SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
/PD:ProductDescription[1] instance of element(PD:ProductDescription, PD:ProductDescription?)
') as Result
FROM Production.ProductModel
where ProductModelID=19
쿼리에서 True를 반환합니다.
예 3
공용 구조체 유형을 사용할 경우 SQL Server 의 instance of 식에 제한 사항이 있습니다. 특히 요소나 특성의 유형이 공용 구조체 유형이면 instance of가 정확한 유형을 확인하지 못할 수도 있습니다. 따라서 SequenceType에 사용된 원자성 유형이 simpleType 계층에서 실제 식 유형의 최상위 부모가 아닐 경우 쿼리에서 False를 반환합니다. 즉, SequenceType에 지정된 원자성 유형은 anySimpleType의 직계 자식이어야 합니다. 유형 계층에 대한 자세한 내용은 XQuery의 형변환 규칙을 참조하십시오.
다음 쿼리 예에서는 아래의 작업을 수행합니다.
- 정수, 문자열 유형 등의 공용 구조체 유형이 정의된 XML 스키마 컬렉션을 만듭니다.
- XML 스키마 컬렉션을 사용하여 형식화된 xml 변수를 선언합니다.
- 변수에 예제 XML 인스턴스를 할당합니다.
- 변수를 쿼리하여 공용 구조체 유형을 처리할 때의
instance of동작을 보여 줍니다.
다음은 쿼리입니다.
CREATE XML SCHEMA COLLECTION MyTestSchema AS '
<schema xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="http://ns" xmlns:ns="http://ns">
<simpleType name="MyUnionType">
<union memberTypes="integer string"/>
</simpleType>
<element name="TestElement" type="ns:MyUnionType"/>
</schema>'
Go
instance of 식에 지정한 SequenceType이 지정된 실제 식 유형의 최상위 부모가 아니므로 다음 쿼리는 False를 반환합니다. 즉, <TestElement>의 값은 정수 유형입니다. 최상위 부모는 xs:decimal입니다. 그러나 xs:decimal는 instance of 연산자의 두 번째 피연산자로 지정되지 않습니다.
SET QUOTED_IDENTIFIER ON
DECLARE @var XML(MyTestSchema)
SET @var = '<TestElement xmlns="http://ns">123</TestElement>'
SELECT @var.query('declare namespace ns="http://ns"
data(/ns:TestElement[1]) instance of xs:integer')
go
xs:integer의 최상위 부모는 xs:decimal이므로 쿼리를 수정하고 쿼리에서 xs:decimal을 SequenceType으로 지정할 경우 쿼리는 True를 반환합니다.
SET QUOTED_IDENTIFIER ON
DECLARE @var XML(MyTestSchema)
SET @var = '<TestElement xmlns="http://ns">123</TestElement>'
SELECT @var.query('declare namespace ns="http://ns"
data(/ns:TestElement[1]) instance of xs:decimal')
go
예 4
이 예에서는 먼저 XML 스키마 컬렉션을 만들고 이 컬렉션을 사용하여 xml 변수를 형식화합니다. 그러면 형식화된 xml 변수가 쿼리되어 instance of 기능을 보여 줍니다.
다음 XML 스키마 컬렉션은 단순 유형 myType과 myType 유형의 <root> 요소를 정의합니다.
drop xml schema collection SC
go
CREATE XML SCHEMA COLLECTION SC AS '
<schema xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="myNS" xmlns:ns="myNS"
xmlns:s="https://schemas.microsoft.com/sqlserver/2004/sqltypes">
<import namespace="https://schemas.microsoft.com/sqlserver/2004/sqltypes"/>
<simpleType name="myType">
<restriction base="s:varchar">
<maxLength value="20"/>
</restriction>
</simpleType>
<element name="root" type="ns:myType"/>
</schema>'
Go
이제 형식화된 xml 변수를 만들어 쿼리합니다.
DECLARE @var XML(SC)
SET @var = '<root xmlns="myNS">My data</root>'
SELECT @var.query('declare namespace sqltypes = "https://schemas.microsoft.com/sqlserver/2004/sqltypes";
declare namespace ns="myNS";
data(/ns:root[1]) instance of ns:myType')
go
myType 유형은 sqltypes 스키마에 정의된 varchar 유형의 제한으로 인해 파생되므로 instance of도 True를 반환합니다.
DECLARE @var XML(SC)
SET @var = '<root xmlns="myNS">My data</root>'
SELECT @var.query('declare namespace sqltypes = "https://schemas.microsoft.com/sqlserver/2004/sqltypes";
declare namespace ns="myNS";
data(/ns:root[1]) instance of sqltypes:varchar?')
go
예 5
다음 예에서는 식이 IDREFS 특성의 값 중 하나를 검색하고 instance of를 사용하여 값이 IDREF 유형인지 여부를 확인합니다. 이 예에서는 다음을 수행합니다.
- <
Customer> 요소의 IDREFS 유형 특성이 OrderList이고 <Order> 요소의 ID 유형 특성은 OrderID인 XML 스키마 컬렉션을 만듭니다. - 형식화된 xml 변수를 만들고 예제 XML 인스턴스를 여기에 할당합니다.
- 변수에 대한 쿼리를 지정합니다. 쿼리 식이 첫 번째 <
Customer>의 OrderList IDRERS 유형 특성에서 첫 번째 순서 ID 값을 검색합니다. 검색된 값은 IDREF 유형입니다. 따라서instance of에서는 True를 반환합니다.
create xml schema collection SC as
'<schema xmlns="http://www.w3.org/2001/XMLSchema" xmlns:Customers="Customers" targetNamespace="Customers">
<element name="Customers" type="Customers:CustomersType"/>
<complexType name="CustomersType">
<sequence>
<element name="Customer" type="Customers:CustomerType" minOccurs="0" maxOccurs="unbounded" />
</sequence>
</complexType>
<complexType name="OrderType">
<sequence minOccurs="0" maxOccurs="unbounded">
<choice>
<element name="OrderValue" type="integer" minOccurs="0" maxOccurs="unbounded"/>
</choice>
</sequence>
<attribute name="OrderID" type="ID" />
</complexType>
<complexType name="CustomerType">
<sequence minOccurs="0" maxOccurs="unbounded">
<choice>
<element name="spouse" type="string" minOccurs="0" maxOccurs="unbounded"/>
<element name="Order" type="Customers:OrderType" minOccurs="0" maxOccurs="unbounded"/>
</choice>
</sequence>
<attribute name="CustomerID" type="string" />
<attribute name="OrderList" type="IDREFS" />
</complexType>
</schema>'
go
declare @x xml(SC)
set @x='<CustOrders:Customers xmlns:CustOrders="Customers">
<Customer CustomerID="C1" OrderList="OrderA OrderB" >
<spouse>Jenny</spouse>
<Order OrderID="OrderA"><OrderValue>11</OrderValue></Order>
<Order OrderID="OrderB"><OrderValue>22</OrderValue></Order>
</Customer>
<Customer CustomerID="C2" OrderList="OrderC OrderD" >
<spouse>John</spouse>
<Order OrderID="OrderC"><OrderValue>33</OrderValue></Order>
<Order OrderID="OrderD"><OrderValue>44</OrderValue></Order>
</Customer>
<Customer CustomerID="C3" OrderList="OrderE OrderF" >
<spouse>Jane</spouse>
<Order OrderID="OrderE"><OrderValue>55</OrderValue></Order>
<Order OrderID="OrderF"><OrderValue>55</OrderValue></Order>
</Customer>
<Customer CustomerID="C4" OrderList="OrderG" >
<spouse>Tim</spouse>
<Order OrderID="OrderG"><OrderValue>66</OrderValue></Order>
</Customer>
<Customer CustomerID="C5" >
</Customer>
<Customer CustomerID="C6" >
</Customer>
<Customer CustomerID="C7" >
</Customer>
</CustOrders:Customers>'
select @x.query(' declare namespace CustOrders="Customers";
data(CustOrders:Customers/Customer[1]/@OrderList)[1] instance of xs:IDREF ? ') as XML_result
구현 시 제한 사항
제한 사항은 다음과 같습니다.
instance of연산자 비교에는 schema-element() 및 schema-attribute() 시퀀스 유형이 지원되지 않습니다.(1,2) instance of xs:integer*와 같은 전체 시퀀스는 지원되지 않습니다.element(ElementName, TypeName)와 같이 유형 이름을 지정하는 element() 시퀀스 유형의 형태를 사용할 경우 물음표(?)로 유형을 한정해야 합니다. 예를 들어element(Title, xs:string?)은 요소가 Null일 수 있음을 나타냅니다. SQL Server 에서는instance of를 사용하여 런타임에 xsi:nil 속성을 검색할 수 없습니다.공용 구조체로 형식화된 요소나 특성에서
Expression의 값을 가져올 경우 SQL Server 에서는 파생되지 않은 기본 유형만 식별할 수 있습니다. 이 기본 유형에서 값 유형이 파생됩니다. 예를 들어 <e1>이 (xs:integer | xs:string) 정적 유형을 갖도록 정의되면 다음 예에서 False를 반환합니다.data(<e1>123</e1>) instance of xs:integer그러나
data(<e1>123</e1>) instance of xs:decimal에서는 True를 반환합니다.processing-instruction() 및 document-node() 시퀀스 유형에는 인수가 없는 형태만 사용할 수 있습니다. 예를 들어
processing-instruction()은 사용할 수 있지만processing-instruction('abc')은 사용할 수 없습니다.
cast as 연산자
cast as 식을 사용하여 특정 데이터 유형으로 값을 변환할 수 있습니다. 예를 들어 다음과 같습니다.
Expression cast as AtomicType?
SQL Server 에서는 AtomicType 뒤에 물음표(?)가 필요합니다. 예를 들어 다음 쿼리에서처럼 "2" cast as xs:integer?는 문자열 값을 정수로 변환합니다.
declare @x xml
set @x=''
select @x.query('"2" cast as xs:integer?')
다음 쿼리에서 **data()**는 ProductModelID 특성의 형식화된 값인 문자열 유형을 반환합니다. cast as 연산자는 값을 xs:integer로 변환합니다.
WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS PD)
SELECT CatalogDescription.query('
data(/PD:ProductDescription[1]/@ProductModelID) cast as xs:integer?
') as Result
FROM Production.ProductModel
WHERE ProductModelID = 19
이 쿼리에서는 **data()**를 명시적으로 사용할 필요가 없습니다. cast as 식은 입력 식에 암시적 원자화를 수행합니다.
생성자 함수
원자성 유형 생성자 함수를 사용할 수 있습니다. 예를 들어 다음 예와 같이 cast as 연산자 "2" cast as xs:integer?를 사용하는 대신 xs:integer() 생성자 함수를 사용할 수 있습니다.
declare @x xml
set @x=''
select @x.query('xs:integer("2")')
다음 예에서는 2000-01-01Z에 해당하는 xs:date 값을 반환합니다.
declare @x xml
set @x=''
select @x.query('xs:date("2000-01-01Z")')
사용자 정의 원자성 유형에도 생성자를 사용할 수 있습니다. 예를 들어 XML 데이터 유형과 관련된 XML 스키마 컬렉션이 단순 유형을 정의하는 경우 myType() 생성자를 사용하여 해당 유형의 값을 반환할 수 있습니다.
구현 시 제한 사항
XQuery 식 typeswitch, castable 및 treat는 지원되지 않습니다.
cast as에서는 원자성 유형 뒤에 물음표(?)가 필요합니다.
xs:QName은 형변환을 위한 유형으로 지원되지 않습니다. 대신 expanded-QName을 사용하십시오.
xs:date, xs:time 및 xs:datetime에는 Z로 표시되는 표준 시간대가 필요합니다.
표준 시간대를 지정하지 않았으므로 다음 쿼리는 실패합니다.DECLARE @var XML SET @var = '' SELECT @var.query(' <a>{xs:date("2002-05-25")}</a>') go값에 Z 표준 시간대 표시를 추가하면 쿼리가 작동합니다.
DECLARE @var XML SET @var = '' SELECT @var.query(' <a>{xs:date("2002-05-25Z")}</a>') go다음은 결과입니다.
<a>2002-05-25Z</a>