Teilen über


Konstruktorfunktionen (XQuery)

Gilt für:SQL Server

Die Konstruktorfunktionen erstellen Instanzen beliebiger integrierter oder benutzerdefinierter atomarer XSD-Typen aus den angegebenen Eingaben.

Syntax

  
TYP($atomicvalue as xdt:anyAtomicType?  
  
) as TYP?  
  

Argumente

$strval
Zu konvertierende Zeichenfolge.

TYP
Ein beliebiger integrierter XSD-Typ.

Bemerkungen

Konstruktoren werden von atomaren XSD-Basistypen sowie abgeleiteten Typen unterstützt. Die Untertypen von xs:duration, die xdt:yearMonthDuration und xdt:dayTimeDuration sowie xs:QName, xs:NMTOKEN und xs:NOTATION umfassen, werden jedoch nicht unterstützt. Die benutzerdefinierten atomaren Typen, die in den damit verbundenen Schemaauflistungen verfügbar sind, stehen auch hier zur Verfügung, unter der Voraussetzung, dass sie direkt oder indirekt aus den folgenden Typen abgeleitet sind.

Unterstützte Basistypen

Es folgen die unterstützten Basistypen:

  • xs:string

  • xs:boolean

  • xs:decimal

  • xs:float

  • xs:double

  • xs:duration

  • xs:dateTime

  • xs:time

  • xs:date

  • xs:gYearMonth

  • xs:gYear

  • xs:gMonthDay

  • xs:gDay

  • xs:gMonth

  • xs:hexBinary

  • xs:base64Binary

  • xs:anyURI

Unterstützte abgeleitete Typen

Es folgen die unterstützten abgeleiteten Typen:

  • xs:normalizedString

  • xs:token

  • xs:language

  • xs:Name

  • xs:NCName

  • xs:ID

  • xs:IDREF

  • xs:ENTITY

  • xs:integer

  • xs:nonPositiveInteger

  • xs:negativeInteger

  • xs:long

  • xs:int

  • xs:short

  • xs:byte

  • xs:nonNegativeInteger

  • xs:unsignedLong

  • xs:unsignedInt

  • xs:unsignedShort

  • xs:unsignedByte

  • xs:positiveInteger

SQL Server unterstützt außerdem die Reduktion konstanter Ausdrücke beim Aufrufen von Konstruktorfunktionen unter folgenden Bedingungen:

  • Wenn das Argument ein Zeichenfolgenliteral ist, wird der Ausdruck zur Kompilierzeit ausgewertet. Wenn der Wert die Typeinschränkungen nicht erfüllt, wird ein statischer Fehler ausgelöst.

  • Wenn das Argument ein Literal eines anderen Typs ist, wird der Ausdruck zur Kompilierzeit ausgewertet. Wenn der Wert die Typeinschränkungen nicht erfüllt, wird die leere Sequenz zurückgegeben.

Beispiele

Dieses Thema enthält XQuery-Beispiele für XML-Instanzen, die in verschiedenen Xml-Typspalten in der AdventureWorks-Datenbank gespeichert sind.

A. Abrufen älterer Produktbeschreibungen mit der dateTime()-Funktion von XQuery

In diesem Beispiel wird zunächst ein XML-Beispieldokument einer xml-Typvariablen zugewiesen. Dieses Dokument enthält drei Beispielelemente <ProductDescription> , wobei jedes ein untergeordnetes <DateCreated> Element enthält.

Die Variable wird dann abgefragt, um nur diejenigen Produktbeschreibungen abzurufen, die vor einem bestimmten Datum erstellt worden sind. Zum Vergleich verwendet die Abfrage die xs:dateTime() -Konstruktorfunktion, um die Datumsangaben einzugeben.

declare @x xml  
set @x = '<root>  
<ProductDescription ProductID="1" >  
  <DateCreated DateValue="2000-01-01T00:00:00Z" />  
  <Summary>Some Summary description</Summary>  
</ProductDescription>  
<ProductDescription  ProductID="2" >  
  <DateCreated DateValue="2001-01-01T00:00:00Z" />  
  <Summary>Some Summary description</Summary>  
</ProductDescription>  
<ProductDescription ProductID="3" >  
  <DateCreated DateValue="2002-01-01T00:00:00Z" />  
  <Summary>Some Summary description</Summary>  
</ProductDescription>  
</root>'  
  
select @x.query('  
     for $PD in  /root/ProductDescription  
     where xs:dateTime(data( ($PD/DateCreated/@DateValue)[1] )) < xs:dateTime("2001-01-01T00:00:00Z")  
     return  
        element Product  
       {   
        ( attribute ProductID { data($PD/@ProductID ) },  
        attribute DateCreated { data( ($PD/DateCreated/@DateValue)[1] ) } )  
        }  
 ')  

Beachten Sie hinsichtlich der vorherigen Abfrage Folgendes:

  • Die FOR ... Die WHERE-Schleifenstruktur wird verwendet, um das <ProductDescription-Element> abzurufen, das die in der WHERE-Klausel angegebene Bedingung erfüllt.

  • Die dateTime()- Konstruktorfunktion wird verwendet, um dateTime-Typwerte zu erstellen, damit sie entsprechend verglichen werden können.

  • Anschließend konstruiert die Abfrage die resultierende XML-Ausgabe: Nachdem dabei eine Reihe von Attributen konstruiert wird, werden in der XML-Konstruktion Kommas und Klammern verwendet.

Dies ist das Ergebnis:

<Product   
   ProductID="1"   
   DateCreated="2000-01-01T00:00:00Z"/>  

Weitere Informationen

XML Construction (XQuery) (XML-Konstruktion (XQuery))
XQuery-Funktionen für den xml-Datentyp