Fonctions relatives aux QName : expanded-QName
S'applique à : 
SQL Server
Retourne une valeur du type xs :QName avec l’URI d’espace de noms spécifié dans le $paramURI et le nom local spécifié dans le $paramLocal. Si $paramURI est la chaîne vide ou la séquence vide, elle ne représente aucun espace de noms.
Syntaxe
fn:expanded-QName($paramURI as xs:string?, $paramLocal as xs:string?) as xs:QName?
Arguments
$paramURI
URI d'espace de noms du QName.
$paramLocal
Partie du nom local du QName.
Notes
Les éléments suivants s’appliquent à la fonction expanded-QName() :
Si la valeur $paramLocal spécifiée n’est pas dans la forme lexicale correcte pour le type xs :NCName, la séquence vide est retournée et représente une erreur dynamique.
La conversion du type xs :QName vers un autre type n’est pas prise en charge dans SQL Server. Pour cette raison, la fonction expanded-QName() ne peut pas être utilisée dans la construction XML. Par exemple, lorsque vous construisez un nœud, tel que
<e> expanded-QName(...) </e>, la valeur doit être non typée. Cela suppose que vous convertissiez la valeur de type xs:QName renvoyée parexpanded-QName()en xdt:untypedAtomic. Toutefois, cette opération n'est pas prise en charge. Une solution est proposée dans un exemple, plus loin dans cette rubrique.Vous pouvez modifier ou comparer les valeurs de type QName existantes. Par exemple,
/root[1]/e[1] eq expanded-QName("http://nsURI" "myNS")compare la valeur de l’élément, <e>avec le QName retourné par la fonction expanded-QName().
Exemples
Cette rubrique fournit des exemples XQuery sur des instances XML stockées dans différentes colonnes de type XML dans la AdventureWorks2022 base de données.
R : Remplacement d'une valeur de nœud de type QName
Cet exemple montre comment vous pouvez modifier la valeur d'un nœud d'élément de type QName. Cet exemple illustre les opérations suivantes :
Crée une collection de schémas XML qui définit un élément de type QName.
Crée une table avec une colonne de type XML à l’aide de la collection de schémas XML.
Enregistre une instance XML dans la table.
Utilise la méthode modify() du type de données xml pour modifier la valeur de l’élément de type QName dans l’instance. La fonction expanded-QName() est utilisée pour générer la nouvelle valeur de type QName.
-- If XML schema collection (if exists)
-- drop xml schema collection SC
-- go
-- Create XML schema collection
CREATE XML SCHEMA COLLECTION SC AS N'
<schema xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
targetNamespace="QNameXSD"
xmlns:xqo="QNameXSD" elementFormDefault="qualified">
<element name="Root" type="xqo:rootType" />
<complexType name="rootType">
<sequence minOccurs="1" maxOccurs="1">
<element name="ElemQN" type="xs:QName" />
</sequence>
</complexType>
</schema>'
go
-- Create table.
CREATE TABLE T( XmlCol xml(SC) )
-- Insert sample XML instance
INSERT INTO T VALUES ('
<Root xmlns="QNameXSD" xmlns:ns="https://myURI">
<ElemQN>ns:someName</ElemQN>
</Root>')
go
-- Verify the insertion
SELECT * from T
go
-- Result
<Root xmlns="QNameXSD" xmlns:ns="https://myURI">
<ElemQN>ns:someName</ElemQN>
</Root>
Dans la requête suivante, la valeur de l’élément <>ElemQNest remplacée à l’aide de la méthode modify() du type de données xml et de la valeur de remplacement de DML XML, comme indiqué.
-- the value.
UPDATE T
SET XmlCol.modify('
declare default element namespace "QNameXSD";
replace value of /Root[1]/ElemQN
with expanded-QName("https://myURI", "myLocalName") ')
go
-- Verify the result
SELECT * from T
go
Voici l'ensemble de résultats. Notez que l’élément <ElemQN> du type QName a maintenant une nouvelle valeur :
<Root xmlns="QNameXSD" xmlns:ns="urn">
<ElemQN xmlns:p1="https://myURI">p1:myLocalName</ElemQN>
</Root>
Les instructions suivantes suppriment les objets utilisés dans l'exemple.
-- Cleanup
DROP TABLE T
go
drop xml schema collection SC
go
B. Gestion des limites liées à l'utilisation de la fonction expanded-QName()
La fonction expanded-QName ne peut pas être utilisée dans la construction XML. L'exemple suivant illustre ce comportement. Pour contourner cette limite, l'exemple insère d'abord un nœud, puis le modifie.
-- if exists drop the table T
--drop table T
-- go
-- Create XML schema collection
-- DROP XML SCHEMA COLLECTION SC
-- go
CREATE XML SCHEMA COLLECTION SC AS '
<schema xmlns="http://www.w3.org/2001/XMLSchema">
<element name="root" type="QName" nillable="true"/>
</schema>'
go
-- Create table T with a typed xml column (using the XML schema collection)
CREATE TABLE T (xmlCol XML(SC))
go
-- Insert an XML instance.
insert into T values ('<root xmlns:a="https://someURI">a:b</root>')
go
-- Verify
SELECT *
FROM T
La tentative suivante ajoute un autre <root> élément, mais échoue, car la fonction expanded-QName() n’est pas prise en charge dans la construction XML.
update T SET xmlCol.modify('
insert <root>{expanded-QName("http://ns","someLocalName")}</root> as last into / ')
go
Une solution à ceci consiste à insérer d’abord une instance avec une valeur pour l’élément, puis à la <root> modifier. Dans cet exemple, une valeur initiale nulle est utilisée lorsque l’élément <root> est inséré. La collection de schémas XML de cet exemple autorise une valeur nulle pour l’élément <root> .
update T SET xmlCol.modify('
insert <root xsi:nil="true"/> as last into / ')
go
-- now replace the nil value with another QName.
update T SET xmlCol.modify('
replace value of /root[last()] with expanded-QName("http://ns","someLocalName") ')
go
-- verify
SELECT * FROM T
go
-- result
<root>b</root>
<root xmlns:a="https://someURI">a:b</root>
<root xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p1="http://ns">p1:someLocalName</root>
Vous pouvez comparer la valeur QName, comme le montre la requête ci-après. La requête retourne uniquement les éléments dont les <root> valeurs correspondent à la valeur de type QName retournée par la fonction expanded-QName().
SELECT xmlCol.query('
for $i in /root
return
if ($i eq expanded-QName("http://ns","someLocalName") ) then
$i
else
()')
FROM T
Limites de mise en œuvre
Il existe une limitation : la fonction expanded-QName() accepte la séquence vide en tant que deuxième argument et retourne vide au lieu de déclencher une erreur d’exécution lorsque le deuxième argument est incorrect.