Funktionen für Zeichenfolgenwerte – concat

Artikel
11/19/2024

Gilt für: SQL Server

Nimmt null oder mehr Zeichenfolgen als Argumente an und gibt eine Zeichenfolge zurück, die durch Verketten der Werte der einzelnen Argumente erstellt wird.

Syntax

  
fn:concat ($string as xs:string?  
           ,$string as xs:string?  
           [, ...]) as xs:string

Argumente

$string
Optionale zu verkettende Zeichenfolge.

Hinweise

Die Funktion erfordert mindestens zwei Argumente. Wenn ein Argument eine leere Sequenz ist, wird diese als eine Zeichenfolge mit der Länge Null behandelt.

Ergänzende Zeichen (Ersatzpaare)

Das Verhalten von Ersatzzeichenpaaren in XQuery-Funktionen hängt vom Kompatibilitätsgrad der Datenbank ab und in einigen Fällen vom Standardnamespace-URI für Funktionen. Weitere Informationen finden Sie im Abschnitt "XQuery Functions Are Surrogate-Aware" im Thema Breaking Changes to Datenbank-Engine Features in SQL Server 2016. Siehe auch ALTER DATABASE Compatibility Level (Transact-SQL) und Sortierung und Unicode-Unterstützung.

Beispiele

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

A. Verwenden der concat()-Funktion von XQuery zum Verketten von Zeichenfolgen

Diese Abfrage gibt für ein bestimmtes Produktmodell eine Zeichenfolge zurück, die durch Verketten des Garantiezeitraumes und der Garantiebeschreibung erstellt wird. Im Katalogbeschreibungsdokument besteht das <>WarrantyElement ausWarrantyPeriod<> und <Description> untergeordneten Elementen.

WITH XMLNAMESPACES (  
'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS pd,  
'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain' AS wm)  
SELECT CatalogDescription.query('  
    <Product   
        ProductModelID= "{ (/pd:ProductDescription/@ProductModelID)[1] }"  
        ProductModelName = "{ sql:column("PD.Name") }" >  
        {   
          concat( string((/pd:ProductDescription/pd:Features/wm:Warranty/wm:WarrantyPeriod)[1]), "-",  
                  string((/pd:ProductDescription/pd:Features/wm:Warranty/wm:Description)[1]))   
         }   
     </Product>  
 ') as Result  
FROM Production.ProductModel PD  
WHERE  PD.ProductModelID=28

Beachten Sie hinsichtlich der vorherigen Abfrage Folgendes:

In der SELECT-Klausel ist CatalogDescription eine XML-Typspalte . Daher wird die Query()-Methode (XML-Datentyp), Instructions.query() verwendet. Die XQuery-Anweisung wird als Argument der query-Methode angegeben.
Das Dokument, für das die Abfrage ausgeführt wird, verwendet Namespaces. Daher wird das Namespace-Schlüsselwort verwendet, um das Präfix für den Namespace zu definieren. Weitere Informationen finden Sie unter XQuery Prolog.

Dies ist das Ergebnis:

<Product ProductModelID="28" ProductModelName="Road-450">1 year-parts and labor</Product>

Die vorherige Abfrage ruft Informationen für ein bestimmtes Produkt ab. Die folgende Abfrage ruft die gleichen Informationen für alle Produkte ab, für die XML-Katalogbeschreibungen gespeichert sind. Die exist()- Methode des XML-Datentyps in der WHERE-Klausel gibt True zurück, wenn das XML-Dokument in den Zeilen ein <ProductDescription> Element aufweist.

WITH XMLNAMESPACES (  
'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS pd,  
'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain' AS wm)  
  
SELECT CatalogDescription.query('  
    <Product   
        ProductModelID= "{ (/pd:ProductDescription/@ProductModelID)[1] }"   
        ProductName = "{ sql:column("PD.Name") }" >  
        {   
          concat( string((/pd:ProductDescription/pd:Features/wm:Warranty/wm:WarrantyPeriod)[1]), "-",  
                  string((/pd:ProductDescription/pd:Features/wm:Warranty/wm:Description)[1]))   
         }   
     </Product>  
 ') as Result  
FROM Production.ProductModel PD  
WHERE CatalogDescription.exist('//pd:ProductDescription ') = 1

Beachten Sie, dass der boolesche Wert, der von der exist() -Methode des XML-Typs zurückgegeben wird, mit 1 verglichen wird.

Implementierungseinschränkungen

Die folgenden Einschränkungen sind zu beachten:

Die Funktion "concat()" in SQL Server akzeptiert nur Werte vom Typ "xs:string". Andere Werte müssen explizit in xs:string oder xdt:untypedAtomic umgewandelt werden.

Weitere Informationen

XQuery Functions against the xml Data Type (XQuery-Funktionen für den xml-Datentyp)

Freigeben über