SequenceType-Ausdrücke (XQuery)

Artikel
11/19/2024

Gilt für: SQL Server

In XQuery ist jeder Wert eine Sequenz. Der Typ des Werts wird als Sequenztyp bezeichnet. Der Sequenztyp kann in einer Instanz des XQuery-Ausdrucks verwendet werden. Die in der XQuery-Spezifikation beschriebene SequenceType-Syntax wird verwendet, wenn in einem XQuery-Ausdruck auf einen Typ verwiesen werden muss.

Der Atomtypname kann auch in der Umwandlung als XQuery-Ausdruck verwendet werden. In SQL Server werden die Instanzen und Umwandlungen als XQuery-Ausdrücke auf SequenceTypes teilweise unterstützt.

instance of-Operator

Die Operatorinstanz kann verwendet werden, um den dynamischen Oder Laufzeittyp des Werts des angegebenen Ausdrucks zu bestimmen. Zum Beispiel:

  
Expression instance of SequenceType[Occurrence indicator]

Beachten Sie, dass der instance of Operator, der Occurrence indicator, die Kardinalität, Anzahl der Elemente in der resultierenden Sequenz angibt. Wenn dieser Operator nicht angegeben wird, wird eine Kardinalität von 1 verwendet. In SQL Server wird nur der Fragezeichenindikator (?) unterstützt. Der Indikator für das Vorkommen gibt an, dass Expression null oder ein Element zurückgegeben werden kann. Wenn der Indikator für das Vorkommen angegeben ist, wird True zurückgegeben, wenn der Typ mit dem Expression angegebenen SequenceTypeübereinstimmt, unabhängig davon, instance of ob Expression ein Singleton oder eine leere Sequenz zurückgegeben wird.

Wenn der Indikator für das Vorkommen nicht angegeben ist, wird "True" nur zurückgegeben, sequence of wenn der Expression Typ dem Type angegebenen entspricht und Expression ein Singleton zurückgibt.

Hinweis : Das Pluszeichen (+) und das Sternchen (*) werden in SQL Server nicht unterstützt.

Die folgenden Beispiele veranschaulichen die Verwendung derInstanz des XQuery-Operators.

Beispiel A

Im folgenden Beispiel wird eine XML-Typvariable erstellt und eine Abfrage dafür angegeben. Der Abfrageausdruck gibt einen instance of-Operator an, um zu bestimmen, ob der dynamische Typ des von dem ersten Operanden zurückgegebenen Werts mit dem im zweiten Operanden angegebenen Typ übereinstimmt.

Die folgende Abfrage gibt True zurück, da der Wert 125 eine Instanz des angegebenen Typs ist, xs:integer:

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

Die folgende Abfrage gibt True zurück, da der von dem Ausdruck (/a[1]) zurückgegebene Wert im ersten Operanden ein Element ist:

declare @x xml  
set @x='<a>1</a>'  
select @x.query('/a[1] instance of element()')  
go

Entsprechend gibt instance of in der folgenden Abfrage True zurück, da der Werttyp des Ausdrucks im ersten Ausdruck ein Attribut ist:

declare @x xml  
set @x='<a attr1="x">1</a>'  
select @x.query('/a[1]/@attr1 instance of attribute()')  
go

Im folgenden Beispiel gibt der Ausdruck data(/a[1] einen atomaren Wert mit der Typisierung xdt:untypedAtomic zurück. Folglich gibt instance of TRUE zurück.

declare @x xml  
set @x='<a>1</a>'  
select @x.query('data(/a[1]) instance of xdt:untypedAtomic')  
go

In der folgenden Abfrage gibt der Ausdruck data(/a[1]/@attrA einen nicht typisierten atomaren Wert zurück. Folglich gibt instance of TRUE zurück.

declare @x xml  
set @x='<a attrA="X">1</a>'  
select @x.query('data(/a[1]/@attrA) instance of xdt:untypedAtomic')  
go

Beispiel B

In diesem Beispiel fragen Sie eine typisierte XML-Spalte in der AdventureWorks-Beispieldatenbank ab. Die der abzufragenden Spalte zugeordnete XML-Schemaauflistung stellt die Typisierungsinformationen bereit.

Im Ausdruck gibt data() den typierten Wert des ProductModelID-Attributs zurück, dessen Typ "xs:string" gemäß dem Schema ist, das der Spalte zugeordnet ist. Folglich gibt instance of TRUE zurück.

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

Weitere Informationen finden Sie unter Vergleichen von typisiertem XML mit nicht typisiertem XML.

Die folgenden Abfragen verwenden denBoolean-Ausdruck instance of , um zu bestimmen, ob das LocationID-Attribut vom Typ "xs:integer" lautet:

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

Die folgende Abfrage wird für die typisierte CatalogDescription-Spalte vom Typ XML angegeben. Die dieser Spalte zugeordnete XML-Schemaauflistung stellt die Typisierungsinformationen bereit.

Die Abfrage verwendet den element(ElementName, ElementType?)-Test im instance of-Ausdruck, um zu überprüfen, ob /PD:ProductDescription[1] einen Elementknoten eines bestimmten Namens und Typs zurückgibt.

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

Diese Abfrage gibt True zurück.

Beispiel C

Bei Verwendung von Union-Typen weist der instance of Ausdruck in SQL Server eine Einschränkung auf: Wenn der Typ eines Elements oder Attributs ein Union-Typ ist, instance of wird möglicherweise nicht der genaue Typ bestimmt. Folglich gibt eine Abfrage False zurück, es sei denn, der in SequenceType verwendete atomare Typ ist das höchste übergeordnete Element des aktuellen Typs des Ausdrucks in der simpleType-Hierarchie. Mit anderen Worten müssen die in SequenceType angegebenen atomaren Typen dem Typ anySimpleType direkt untergeordnet sein. Informationen zur Typhierarchie finden Sie unter Type Casting Rules in XQuery.

Das nächste Abfragebeispiel führt folgende Vorgänge aus:

Erstellen einer XML-Schemaauflistung und Definieren eines UNION-Typs wie integer oder string.
Deklarieren Sie eine typierte XML-Variable mithilfe der XML-Schemaauflistung.
Zuordnen einer XML-Beispielinstanz zu der Variablen.
Abfragen der Variablen, um das Verhalten von instance of mit einem UNION-Typ zu veranschaulichen.

Im Folgenden wird die Abfrage aufgeführt:

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

Die folgende Abfrage gibt False zurück, da der in dem instance of-Ausdruck angegebene Sequenztyp nicht das höchste übergeordnete Element des aktuellen Typs des angegebenen Ausdrucks ist. Das heißt, der Wert des Werts <TestElement> ist ein ganzzahliger Typ. das höchste übergeordnete Element ist xs:decimal. Es ist jedoch nicht als der zweite Operand des instance of-Operators angegeben.

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

Nachdem das höchste übergeordnete Element von xs:integer xs:decimal ist, würde die Abfrage True zurückgeben, wenn Sie sie ändern und xs:decimal als SequenceType angeben.

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

Beispiel D

In diesem Beispiel erstellen Sie zunächst eine XML-Schemaauflistung und verwenden sie zum Eingeben einer XML-Variablen . Die typierte XML-Variable wird dann abgefragt, um die instance of Funktionalität zu veranschaulichen.

Die folgende XML-Schemaauflistung definiert einen einfachen Typ, myType und ein Element vom <root>Typ "myType":

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

Erstellen Sie nun eine typierte XML-Variable , und fragen Sie sie ab:

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

Nachdem der myType-Typ durch Einschränkung aus einem im sqltpypes-Schema definierten varchar-Typ abgeleitet ist, gibt instance of ebenfalls True zurück.

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

Beispiel E

Im folgenden Beispiel ruft der Ausdruck einen der Werte des IDREFS-Attributs auf und verwendet instance of, um zu bestimmen, ob der Wert vom Typ IDREF ist. Das Beispiel führt die folgenden Aktionen aus:

Erstellt eine XML-Schemaauflistung, in der das <Customer> Element über ein OrderList IDREFS-Typattribute verfügt, und das <>OrderElement verfügt über ein OrderID-ID-Typ-Attribut.
Erstellt eine typierte XML-Variable und weist ihr eine XML-Beispielinstanz zu.
Gibt eine Abfrage für die Variable an. Der Abfrageausdruck ruft den ersten Order-ID-Wert aus dem OrderList IDRERS-Typ-Attribut des ersten <Customer>ab. Der abgerufene Wert ist vom Typ IDREF. Folglich gibt instance of True zurück.

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

Implementierungseinschränkungen

Die folgenden Einschränkungen sind zu beachten:

Die Sequenztypen schema-element() und schema-attribute() werden für den Vergleich mit dem instance of Operator nicht unterstützt.
Vollständige Sequenzen wie z. B. (1,2) instance of xs:integer* werden nicht unterstützt.
Wenn Sie eine Form des Element() -Sequenztyps verwenden, der einen Typnamen angibt, z element(ElementName, TypeName). B. muss der Typ mit einem Fragezeichen (?) qualifiziert werden. element(Title, xs:string?) gibt beispielsweise an, dass für das Element NULL-Werte zulässig sind. SQL Server unterstützt die Laufzeiterkennung der xsi:nil-Eigenschaft nicht mithilfe instance ofvon .
Wenn der Wert Expression aus einem Element oder Attribut stammt, das als Union eingegeben wurde, kann SQL Server nur den Grundtyp, nicht abgeleitet, typ, von dem der Typ des Werts abgeleitet wurde, identifizieren. Wenn beispielsweise <e1> ein statischer Typ von (xs:integer | xs:string) definiert ist, gibt Folgendes "False" zurück.
```
data(<e1>123</e1>) instance of xs:integer  
```
Jedoch gibt data(<e1>123</e1>) instance of xs:decimal True zurück.
Für die Sequenztypen "processing-instruction()" und "document-node()" sind nur Formulare ohne Argumente zulässig. Beispielsweise ist dies zulässig, processing-instruction() aber processing-instruction('abc') nicht zulässig.

cast as-Operator

Die Umwandlung als Ausdruck kann verwendet werden, um einen Wert in einen bestimmten Datentyp zu konvertieren. Zum Beispiel:

  
Expression cast as  AtomicType?

In SQL Server ist das Fragezeichen (?) nach dem AtomicType. Wie in der folgenden Abfrage gezeigt, "2" cast as xs:integer? wird beispielsweise der Zeichenfolgenwert in eine ganze Zahl konvertiert:

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

In der folgenden Abfrage gibt data() den typierten Wert des ProductModelID-Attributs zurück, einen Zeichenfolgentyp. Der cast asOperator konvertiert den Wert in "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

Die explizite Verwendung von Data() ist in dieser Abfrage nicht erforderlich. Der cast as-Ausdruck führt die implizite Atomisierung des Eingabeausdrucks aus.

Konstruktorfunktionen

Sie können die Konstruktorfunktionen für atomare Typen verwenden. Statt beispielsweise den cast as Operator zu verwenden, "2" cast as xs:integer?können Sie die Konstruktorfunktion "xs:integer()" wie im folgenden Beispiel verwenden:

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

Das folgende Beispiel gibt einen Datumswert vom Typ xs:date gleich 2000-01-01Z zurück.

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

Sie können Konstruktoren auch für benutzerdefinierte atomare Typen verwenden. Wenn beispielsweise die dem XML-Datentyp zugeordnete XML-Schemaauflistung einen einfachen Typ definiert, kann ein myType() -Konstruktor verwendet werden, um einen Wert dieses Typs zurückzugeben.

Implementierungseinschränkungen

Der XQuery-Ausdruckstypswitch, die Umwandlung und die Behandlung werden nicht unterstützt.
cast as requires a question mark (?) after the atomic type.
xs:QName wird nicht als Typ für umwandlung unterstützt. Verwenden Sie stattdessen "expanded-QName ".
xs:date, xs:time und xs:datetime erfordern eine Zeitzone, die durch eine Z angegeben wird.

Die folgende Abfrage schlägt fehl, da die Zeitzone nicht angegeben ist.
```
DECLARE @var XML  
SET @var = ''  
SELECT @var.query(' <a>{xs:date("2002-05-25")}</a>')  
go  
```
Wenn Sie dem Wert ein Z zum Anzeigen der Zeitzone hinzufügen, kann die Abfrage ordnungsgemäß ausgeführt werden.
```
DECLARE @var XML  
SET @var = ''  
SELECT @var.query(' <a>{xs:date("2002-05-25Z")}</a>')  
go  
```
Dies ist das Ergebnis:
```
<a>2002-05-25Z</a>  
```

Weitere Informationen

XQuery Expressions (XQuery-Ausdrücke)
Type System (XQuery) (Typensystem (XQuery))

Freigeben über

SequenceType-Ausdrücke (XQuery)

instance of-Operator

Beispiel A

Beispiel B

Beispiel C

Beispiel D

Beispiel E

Implementierungseinschränkungen

cast as-Operator

Konstruktorfunktionen

Implementierungseinschränkungen

Weitere Informationen

Feedback

Zusätzliche Ressourcen