Freigeben über


sql:variable()-Funktion (XQuery)

Macht eine Variable verfügbar, die einen relationalen SQL-Wert in einem XQuery-Ausdruck enthält.

Syntax

sql:variable("variableName") as xdt:anyAtomicType?

Hinweise

Wie im Thema Einbinden relationaler Daten in XML-Daten beschrieben wird, können Sie diese Funktion verwenden, wenn Sie mithilfe von XML-Datentypmethoden einen relationalen Wert innerhalb von XQuery verfügbar machen.

Die query()-Methode wird z. B. zum Angeben einer Abfrage für eine XML-Instanz verwendet, die in einer Variablen oder Spalte des xml-Datentyps gespeichert ist. Manchmal sollen in einer Abfrage auch Werte aus einer Transact-SQL-Variablen oder einem -Parameter verwendet werden, um relationale und XML-Daten zu verbinden. Zu diesem Zweck können Sie die sql:variable-Funktion verwenden:

Der SQL-Wert wird einem entsprechenden XQuery-Wert zugeordnet, und sein Datentyp ist ein XQuery-Basistyp, der mit dem entsprechenden SQL-Typ äquivalent ist.

Sie können auf eine xml-Instanz nur im Kontext des Quellenausdrucks einer XML DML-Insert-Anweisung verweisen. Andernfalls können Sie nicht auf Werte vom Typ xml oder eines CLR-benutzerdefinierten Typs (Common Language Runtime) verweisen.

Beispiele:

A. Verwenden der sql:variable()-Funktion, um einen Transact-SQL-Variablenwert in XML zu verwenden

Im folgenden Beispiel wird eine XML-Instanz erstellt, die aus Folgendem besteht:

  • Einem Wert (ProductID) aus einer Nicht-XML-Spalte. Zum Binden dieses Werts im XML-Code wird die sql:column()-Funktion verwendet.

  • Einem Wert (ListPrice) aus einer Nicht-XML-Spalte aus einer anderen Tabelle. Die sql:column()-Funktion wird auch hier zum Binden dieses Werts im XML-Code verwendet.

  • Einem Wert (DiscountPrice) aus einer Transact-SQL-Variablen. Zum Binden dieses Werts im XML-Code wird die sql:variable()-Methode verwendet.

  • Einem Wert (ProductModelName) aus einer Spalte vom Typ xml, um die Abfrage interessanter zu gestalten.

Im Folgenden wird die Abfrage aufgeführt:

DECLARE @price money

SET @price=2500.00
SELECT ProductID, Production.ProductModel.ProductModelID,CatalogDescription.query('
declare namespace pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";

       <Product 
           ProductID="{ sql:column("Production.Product.ProductID") }"
           ProductModelID= "{ sql:column("Production.Product.ProductModelID") }"
           ProductModelName="{/pd:ProductDescription[1]/@ProductModelName }"
           ListPrice="{ sql:column("Production.Product.ListPrice") }"
           DiscountPrice="{ sql:variable("@price") }"
        />') 
FROM Production.Product 
JOIN Production.ProductModel
ON Production.Product.ProductModelID = Production.ProductModel.ProductModelID
WHERE ProductID=771

Beachten Sie hinsichtlich der vorherigen Abfrage Folgendes:

  • Der XML-Code wird durch die XQuery-Abfrage in der query()-Methode erstellt.

  • Das namespace-Schlüsselwort wird zum Definieren eines Namespacepräfixes im XQuery-Prolog verwendet. Dies geschieht, weil der ProductModelName-Attributwert aus der Spalte des CatalogDescription xml-Typs abgerufen wird, der ein Schema zugeordnet ist.

Dies ist das Ergebnis:

<Product ProductID="771" ProductModelID="19" 
         ProductModelName="Mountain 100" 
         ListPrice="3399.99" DiscountPrice="2500" />