Funciones usadas en secuencias: id
Se aplica a:
SQL Server
Devuelve la secuencia de nodos de elemento con valores xs:ID que coinciden con los valores de uno o varios de los valores xs:IDREF proporcionados en $arg.
Sintaxis
fn:id($arg as xs:IDREF*) as element()*
Argumentos
$arg
Uno o varios valores xs:IDREF.
Comentarios
El resultado de la función es una secuencia de elementos de la instancia XML, en el orden del documento, que tiene un valor xs:ID equivalente a uno o varios de los valores xs:IDREF de la lista de posibles valores xs:IDREF.
Si el valor xs:IDREF no coincide con ningún elemento, la función devolverá la secuencia vacía.
Ejemplos
En este tema se proporcionan ejemplos de XQuery en instancias XML que se almacenan en varias columnas de tipo xml de la AdventureWorks2022 base de datos.
A. Recuperar elementos en función del valor del atributo IDREF
En el ejemplo siguiente se usa fn:id para recuperar los <employee> elementos, según el atributo idref manager. En este ejemplo, el atributo manager es de tipo IDREF y el atributo eid es de tipo ID.
Para un valor de atributo de administrador específico, la función id() busca el <employee> elemento cuyo valor de atributo de tipo de identificador coincide con el valor de IDREF de entrada. En otras palabras, para un empleado específico, la función id() devuelve el administrador de empleados.
A continuación se expone lo que ocurre en el ejemplo:
Se crea una colección de esquemas XML.
Se crea una variable xml con tipo mediante la colección de esquemas XML.
La consulta recupera el elemento que tiene un valor de atributo id. al que hace referencia el atributo IDREF del administrador del <
employee> elemento.
-- If exists, drop the XML schema collection (SC).
-- drop xml schema collection SC
-- go
create xml schema collection SC as
'<schema xmlns="http://www.w3.org/2001/XMLSchema" xmlns:e="emp" targetNamespace="emp">
<element name="employees" type="e:EmployeesType"/>
<complexType name="EmployeesType">
<sequence>
<element name="employee" type="e:EmployeeType" minOccurs="0" maxOccurs="unbounded" />
</sequence>
</complexType>
<complexType name="EmployeeType">
<attribute name="eid" type="ID" />
<attribute name="name" type="string" />
<attribute name="manager" type="IDREF" />
</complexType>
</schema>'
go
declare @x xml(SC)
set @x='<e:employees xmlns:e="emp">
<employee eid="e1" name="Joe" manager="e10" />
<employee eid="e2" name="Bob" manager="e10" />
<employee eid="e10" name="Dave" manager="e10" />
</e:employees>'
select @x.value(' declare namespace e="emp";
(fn:id(e:employees/employee[@name="Joe"]/@manager)/@name)[1]', 'varchar(50)')
Go
La consulta devuelve "Dave" como valor. Esto indica que Dave es el superior (manager) de Joe.
B. Recuperar elementos en función del valor del atributo IDREFS OrderList
En el ejemplo siguiente, el atributo OrderList del <Customer> elemento es un atributo de tipo IDREFS. Enumera los Id. de orden del cliente en cuestión. Para cada identificador de pedido, hay un <Order> elemento secundario en el que <Customer> se proporciona el valor de pedido.
La expresión de consulta, data(CustOrders:Customers/Customer[1]/@OrderList)[1], recupera el primer valor de la lista IDRES para el primer cliente. A continuación, este valor se pasa a la función id(). A continuación, la función busca el <Order> elemento cuyo valor de atributo OrderID coincide con la entrada de la función id().
drop xml schema collection SC
go
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";
id(data(CustOrders:Customers/Customer[1]/@OrderList)[1])')
-- result
<Order OrderID="OrderA">
<OrderValue>11</OrderValue>
</Order>
Limitaciones de la implementación
Éstas son las limitaciones:
SQL Server no admite la versión de dos argumentos de id().
SQL Server requiere que el tipo de argumento id() sea un subtipo de xs:IDREF*.