SequenceType 表达式 (XQuery)

在 XQuery 中,值始终是序列。值类型称为序列类型。序列类型可以用在 instance of XQuery 表达式中。当需要引用 XQuery 表达式中的类型时,将使用 XQuery 规范中说明的 SequenceType 语法。

原子类型名称也可以用于 cast as XQuery 表达式中。在 SQL Server 2005 中,部分支持 SequenceType 中的 instance ofcast as XQuery 表达式。

instance of 运算符

instance of 运算符可用于确定所指定的表达式的值是动态类型还是运行时类型的。例如:

Expression instance of SequenceType[Occurrence indicator]

请注意,instance of 运算符 Occurrence indicator 将指定基数(即结果序列中的项数)。如果未指定,则假定基数为 1。在 SQL Server 2005 中,只支持问号 (?) 出现指示符。? 出现指示符指示 Expression 可以返回零或一个项。如果指定了 ? 出现指示符,当 Expression 类型与指定的 SequenceType 相匹配时,无论 Expression 返回单独序列还是空序列,instance of 都将返回 True。

如果未指定 ? 出现指示符,则仅当 Expression 类型与指定的 Type 相匹配并且 Expression 返回单独序列时,sequence of 才返回 True。

注意:SQL Server 2005 中不支持加号 (+) 和星号 (*) 出现指示符。

以下示例说明了 instance of XQuery 运算符的用法。

示例 A

以下示例创建了 xml 类型变量并对它指定了查询。查询表达式将指定 instance of 运算符以确定第一个操作数返回的值的动态类型是否与第二个操作数中指定的类型相匹配。

以下查询将返回 True,因为值 125 是指定类型 xs:integer 的实例:

declare @x xml
set @x=''
select @x.query('125 instance of xs:integer')
go

以下查询将返回 True,因为由第一个操作数中的 /a[1] 表达式返回的值是一个元素:

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

示例 B

在此示例中,将查询 AdventureWorks 示例数据库中的类型化的 XML 列。类型化信息由与被查询的列关联的 XML 架构集合提供。

在表达式中,data() 将根据与列关联的架构,返回 ProductModelID 属性(其类型为 xs:string)的类型化的值。因此,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。有关与 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。

示例 C

使用联合类型时,SQL Server 中的 instance of 表达式有一个限制:具体来说,当某个元素或属性的类型为联合类型时,instance of 可能无法确定其准确的类型。因此,查询将返回 False,除非用于 SequenceType 中的原子类型在简单类型层次结构中是表达式的实际类型的最高父级。即以 SequenceType 指定的原子类型必须是任意简单类型的直接子级。有关类型层次结构的信息,请参阅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

以下查询将返回 False,因为在 instance of 表达式中指定的 SequenceType 不是指定表达式的实际类型的最高父级。即 <TestElement> 的值是整数类型。最高父级为 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

示例 D

在此示例中,首先创建 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 类型仅限于从 varchar 类型(在 sqltypes 架构中定义)派生,因而 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

示例 E

在下列示例中,表达式将检索 IDREFS 属性的值之一,并使用 instance of 来确定该值是否是 IDREF 类型。该示例执行以下操作:

  • 创建 XML 架构集合,其中 <Customer> 元素具有 OrderList IDREFS 类型属性,<Order> 元素具有 OrderID ID 类型属性。
  • 创建类型化的 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

实现限制

限制如下:

  • 不支持 schema-element()schema-attribute() 序列类型与 instance of 运算符进行比较。

  • 不支持完整序列(如 (1,2) instance of xs:integer*)。

  • 当使用某种形式的指定类型名称的 element() 序列类型 [如 element(ElementName, TypeName)] 时,必须用问号 (?) 限定类型。例如,element(Title, xs:string?) 指示元素可能为空。SQL Server 不支持使用 instance ofxsi:nil 属性进行运行时检测。

  • 如果 Expression 中的值来自类型化为联合类型的元素或属性,则 SQL Server 只能识别派生了值类型的非派生的 primitive 类型。例如,如果 <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 表达式在输入表达式中执行隐式原子化。

构造函数

您可以使用原子类型来构造函数。例如,您可以使用 xs:integer() 构造函数而不使用 cast as 运算符(即 "2" cast as xs:integer?)。如以下示例所示:

declare @x xml
set @x=''
select @x.query('xs:integer("2")')

以下示例返回的 xs:date 值等于 2000-01-01Z。

declare @x xml
set @x=''
select @x.query('xs:date("2000-01-01Z")')

您还可以使用用户定义的原子类型的构造函数。例如,如果与 XML 数据类型关联的 XML 架构集合定义了一个简单类型,则 myType() 构造函数可以用于返回该类型的值。

实现限制

  • 不支持 XQuery 表达式 typeswitchcastabletreat

  • cast as 要求问号 (?) 在原子类型之后。

  • 不支持将 xs:QName 作为转换的类型。请改用 expanded-QName

  • xs:datexs:timexs: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>
    

请参阅

概念

XQuery 表达式
类型系统 (XQuery)

帮助和信息

获取 SQL Server 2005 帮助