Partekatu bidez

Instrucción FLWOR e iteración (XQuery)

Se aplica a:SQL Server

XQuery define la sintaxis de iteración FLWOR. FLWOR es el acrónimo de for, let, where, order by y return.

Una instrucción FLWOR está formada por cuatro partes:

  • Una o varias FOR cláusulas que enlazan una o varias variables de iterador a secuencias de entrada.

    Las secuencias de entrada pueden ser otras expresiones XQuery como expresiones XPath. Son secuencias de nodos o secuencias de valores atómicos. Las secuencias de valores atómicos se pueden construir con literales o funciones constructoras. Los nodos XML construidos no se permiten como secuencias de entrada en SQL Server.

  • Una cláusula opcional let. Esta cláusula asigna un valor a la variable para una iteración concreta. La expresión asignada puede ser una expresión XQuery, como una expresión XPath, y puede devolver una secuencia de nodos o una secuencia de valores atómicos. Las secuencias de valores atómicos se pueden construir con literales o con funciones constructoras. Los nodos XML construidos no se permiten como secuencias de entrada en SQL Server.

  • Una variable de iteración. Esta variable puede tener una aserción de tipo opcional mediante la palabra clave as.

  • Una cláusula opcional where. Esta cláusula aplica un predicado de filtro en la iteración.

  • Una cláusula opcional order by.

  • Una expresión return. La expresión de la cláusula return construye el resultado de la instrucción FLWOR.

Por ejemplo, la consulta siguiente recorre en iteración los <Step> elementos en la primera ubicación de fabricación y devuelve el valor de cadena de los <Step> nodos:

DECLARE @x AS XML;

SET @x = '<ManuInstructions ProductModelID="1" ProductModelName="SomeBike" >
<Location LocationID="L1" >
  <Step>Manu step 1 at Loc 1</Step>
  <Step>Manu step 2 at Loc 1</Step>
  <Step>Manu step 3 at Loc 1</Step>
</Location>
<Location LocationID="L2" >
  <Step>Manu step 1 at Loc 2</Step>
  <Step>Manu step 2 at Loc 2</Step>
  <Step>Manu step 3 at Loc 2</Step>
</Location>
</ManuInstructions>';

SELECT @x.query('
   for $step in /ManuInstructions/Location[1]/Step
   return string($step)
');

Este es el resultado:

Manu step 1 at Loc 1 Manu step 2 at Loc 1 Manu step 3 at Loc 1

La consulta siguiente es similar a la anterior, salvo que se especifica en la columna Instructions, una columna xml con tipo, de la tabla ProductModel. La consulta recorre en iteración todos los pasos de fabricación, <step> elementos, en la primera ubicación del centro de trabajo para un producto específico.

SELECT Instructions.query('
   declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
for $Step in //AWMI:root/AWMI:Location[1]/AWMI:step
      return
           string($Step)
') AS Result
FROM Production.ProductModel
WHERE ProductModelID = 7;

Observe lo siguiente en la consulta anterior:

  • $Step es la variable de iteración.

  • La expresión path, //AWMI:root/AWMI:Location[1]/AWMI:step, genera la secuencia de entrada. Esta secuencia es la secuencia de los <step> elementos secundarios del nodo de elemento del primer <Location> nodo de elemento.

  • No se usa la cláusula de predicado opcional , where.

  • La return expresión devuelve un valor de cadena del <step> elemento .

La función de cadena (XQuery) se usa para recuperar el valor de cadena del <step> nodo.

Este es el resultado parcial:

Insert aluminum sheet MS-2341 into the T-85A framing tool.
Attach Trim Jig TJ-26 to the upper and lower right corners of
the aluminum sheet. ....

Estos son ejemplos de otras secuencias de entrada que se permiten:

DECLARE @x AS XML;

SET @x = '';

SELECT @x.query('
for $a in (1, 2, 3)
  return $a');
-- result = 1 2 3

DECLARE @x AS XML;

SET @x = '';

SELECT @x.query('
for $a in
   for $b in (1, 2, 3)
      return $b
return $a');
-- result = 1 2 3

DECLARE @x AS XML;

SET @x = '<ROOT><a>111</a></ROOT>';

SELECT @x.query('
  for $a in (xs:string( "test"), xs:double( "12" ), data(/ROOT/a ))
  return $a');
-- result test 12 111

En SQL Server, no se permiten secuencias heterogéneas. En concreto, no se permiten secuencias que contengan una combinación de valores atómicos y nodos.

La iteración se usa con frecuencia junto con la sintaxis de construcción XML (XQuery) en la transformación de formatos XML, como se muestra en la siguiente consulta.

En la base de datos de ejemplo AdventureWorks, las instrucciones de fabricación almacenadas en la Instructions columna de la Production.ProductModel tabla tienen la siguiente forma:

<Location LocationID="10" LaborHours="1.2"
            SetupHours=".2" MachineHours=".1">
  <step>describes 1st manu step</step>
   <step>describes 2nd manu step</step>
   ...
</Location>
...

La consulta siguiente construye un nuevo XML que tiene los elementos con los <Location> atributos de ubicación del centro de trabajo devueltos como elementos secundarios:

<Location>
   <LocationID>10</LocationID>
   <LaborHours>1.2</LaborHours>
   <SetupHours>.2</SetupHours>
   <MachineHours>.1</MachineHours>
</Location>
...

Esta es la consulta:

SELECT Instructions.query('
     declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
        for $WC in /AWMI:root/AWMI:Location
        return
          <Location>
            <LocationID> { data($WC/@LocationID) } </LocationID>
            <LaborHours>   { data($WC/@LaborHours) }   </LaborHours>
            <SetupHours>   { data($WC/@SetupHours) }   </SetupHours>
            <MachineHours> { data($WC/@MachineHours) } </MachineHours>
          </Location>
') AS Result
FROM Production.ProductModel
WHERE ProductModelID = 7;

Tenga en cuenta las siguientes consideraciones de la consulta anterior:

  • La instrucción FLWOR recupera una secuencia de <Location> elementos para un producto específico.

  • La función de datos (XQuery) se usa para extraer el valor de cada atributo para que se agreguen al XML resultante como nodos de texto en lugar de como atributos.

  • La expresión de la RETURN cláusula construye el XML que desea.

Éste es un resultado parcial:

<Location>
  <LocationID>10</LocationID>
  <LaborHours>2.5</LaborHours>
  <SetupHours>0.5</SetupHours>
  <MachineHours>3</MachineHours>
</Location>
<Location>
   ...
<Location>
...

Uso de la let cláusula

Puede utilizar la cláusula let para asignar nombre a las expresiones que se repiten y poder hacer referencia a ellas por medio de la variable asignada. La expresión asignada a una variable let se insertará en la consulta cada vez que se haga referencia a la variable en la consulta. Esto significa que la instrucción no se ejecutará una sola vez, sino tantas veces como se haga referencia a la expresión.

En la base de datos AdventureWorks2025, las instrucciones de fabricación contienen información sobre las herramientas requeridas y la ubicación donde se utilizan. La consulta siguiente usa la let cláusula para enumerar las herramientas necesarias para crear un modelo de producción y las ubicaciones donde se necesita cada herramienta.

SELECT Instructions.query('
     declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
        for $T in //AWMI:tool
            let $L := //AWMI:Location[.//AWMI:tool[.=data($T)]]
        return
          <tool desc="{data($T)}" Locations="{data($L/@LocationID)}"/>
') AS Result
FROM Production.ProductModel
WHERE ProductModelID = 7;

Uso de la where cláusula

Puede usar la where cláusula para filtrar los resultados de una iteración. Esto se ilustra en este ejemplo siguiente.

El proceso de fabricación de una bicicleta incluye una serie de ubicaciones de centro de trabajo. Cada una define una secuencia de pasos de fabricación. La consulta siguiente recupera únicamente las ubicaciones de centro de trabajo que fabrican un modelo de bicicleta y tienen menos de tres pasos de fabricación. Es decir, tienen menos de tres <step> elementos.

SELECT Instructions.query('
     declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
for $WC in /AWMI:root/AWMI:Location
      where count($WC/AWMI:step) < 3
      return
          <Location >
           { $WC/@LocationID }
          </Location>
') AS Result
FROM Production.ProductModel
WHERE ProductModelID = 7;

Observe lo siguiente en la consulta anterior:

  • La where palabra clave usa la count() función para contar el número de <step> elementos secundarios en cada ubicación del centro de trabajo.

  • La expresión return construye el XML deseado a partir de los resultados de la iteración.

Este es el resultado:

<Location LocationID="30"/>

El resultado de la expresión de la cláusula where se convierte en un valor booleano mediante las reglas siguientes, en el orden especificado. Son las mismas que las reglas para predicados en expresiones de ruta de acceso, excepto que no se permiten enteros:

  1. Si la expresión where devuelve una secuencia vacía, su valor booleano efectivo será False.

  2. Si la expresión where devuelve un valor de tipo booleano simple, éste será el valor booleano efectivo.

  3. Si la expresión where devuelve una secuencia que incluye al menos un nodo, el valor booleano efectivo será True.

  4. De lo contrario, provocará un error estático.

Enlace de varias variables en FLWOR

Puede tener una sola expresión FLWOR que enlace diversas variables a secuencias de entrada. En el ejemplo siguiente, la consulta se especifica con una variable xml sin tipo. La expresión FLOWR devuelve el primer <Step> elemento secundario de cada <Location> elemento.

DECLARE @x AS XML;

SET @x = '<ManuInstructions ProductModelID="1" ProductModelName="SomeBike" >
<Location LocationID="L1" >
  <Step>Manu step 1 at Loc 1</Step>
  <Step>Manu step 2 at Loc 1</Step>
  <Step>Manu step 3 at Loc 1</Step>
</Location>
<Location LocationID="L2" >
  <Step>Manu step 1 at Loc 2</Step>
  <Step>Manu step 2 at Loc 2</Step>
  <Step>Manu step 3 at Loc 2</Step>
</Location>
</ManuInstructions>';

SELECT @x.query('
   for $Loc in /ManuInstructions/Location,
       $FirstStep in $Loc/Step[1]
   return
       string($FirstStep)
');

Observe lo siguiente en la consulta anterior:

  • La for expresión define $Loc y $FirstStep variables.

  • Las expresiones two, /ManuInstructions/Location y $FirstStep in $Loc/Step[1], están correlacionadas: los valores de $FirstStep dependen de los valores de $Loc.

  • La expresión asociada a $Loc genera una secuencia de <Location> elementos. Para cada <Location> elemento, $FirstStep genera una secuencia de un <Step> elemento, un singleton.

  • $Loc se especifica en la expresión asociada con la variable $FirstStep.

Este es el resultado:

Manu step 1 at Loc 1
Manu step 1 at Loc 2

La consulta siguiente es similar, salvo que se especifica en la columna Instrucciones, columna xml con tipo, de la ProductModel tabla. La construcción XML (XQuery) se usa para generar el XML que desee.

SELECT Instructions.query('
     declare default element namespace "https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
for $WC in /root/Location,
            $S  in $WC/step
      return
          <Step LocationID= "{$WC/@LocationID }" >
            { $S/node() }
          </Step>
') AS Result
FROM Production.ProductModel
WHERE ProductModelID = 7;

Observe lo siguiente en la consulta anterior:

  • La cláusula for define dos variables, $WC y $S. La expresión asociada con $WC genera una secuencia de ubicaciones de centro de trabajo para la fabricación de un modelo de bicicleta. La expresión de ruta de acceso asignada a la variable $S genera una secuencia de pasos para cada secuencia de ubicaciones de centro de trabajo de $WC.

  • La instrucción return construye XML que tiene un <Step> elemento que contiene el paso de fabricación y LocationID como su atributo.

  • El espacio de nombres de elemento predeterminado declare se usa en el prólogo XQuery para que todas las declaraciones de espacio de nombres del XML resultante aparezcan en el elemento de nivel superior. Esto facilita la lectura del resultado. Para obtener más información sobre los espacios de nombres predeterminados, consulte Control de espacios de nombres en XQuery.

Este es el resultado parcial:

<Step xmlns=
    "https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions"
  LocationID="10">
     Insert <material>aluminum sheet MS-2341</material> into the <tool>T-
     85A framing tool</tool>.
</Step>
...
<Step xmlns=
      "https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions"
    LocationID="20">
        Assemble all frame components following blueprint
        <blueprint>1299</blueprint>.
</Step>
...

Uso de la order by cláusula

La ordenación en XQuery se realiza usando la cláusula order by en la expresión FLWOR. Las expresiones de ordenación que se pasan a la order by cláusula deben devolver valores cuyos tipos son válidos para el gt operador . Cada expresión de ordenación debe dar como resultado una secuencia de singleton con un elemento. De forma predeterminada, la ordenación se realiza en orden ascendente. Podrá especificar opcionalmente un orden ascendente o descendente para cada expresión de ordenación.

Nota:

Las comparaciones de ordenación en valores de cadena realizadas por la implementación de XQuery en SQL Server siempre se realizan mediante la intercalación de punto de código Unicode binario.

La consulta siguiente recupera todos los números de teléfono de un cliente determinado de la columna AdditionalContactInfo. Los resultados se ordenan por número de teléfono.

USE AdventureWorks2022;
GO

SELECT AdditionalContactInfo.query('
   declare namespace act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes";
   declare namespace aci="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactInfo";
   for $a in /aci:AdditionalContactInfo//act:telephoneNumber
   order by $a/act:number[1] descending
   return $a
') AS Result
FROM Person.Person
WHERE BusinessEntityID = 291;

El proceso de atomización (XQuery) recupera el valor atómico de los <number> elementos antes de pasarlo a .order by Puede escribir la expresión mediante la data() función , pero eso no es necesario.

order by data($a/act:number[1]) descending

Este es el resultado:

<act:telephoneNumber xmlns:act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes">
  <act:number>333-333-3334</act:number>
</act:telephoneNumber>
<act:telephoneNumber xmlns:act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes">
  <act:number>333-333-3333</act:number>
</act:telephoneNumber>

En lugar de declarar los espacios de nombres en el prólogo de consultas, puede declararlos mediante WITH XMLNAMESPACES.

WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes' AS act, 'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactInfo' AS aci)
SELECT AdditionalContactInfo.query('
   for $a in /aci:AdditionalContactInfo//act:telephoneNumber
   order by $a/act:number[1] descending
   return $a
') AS Result
FROM Person.Person
WHERE BusinessEntityID = 291;

También puede ordenar por valor de atributo. Por ejemplo, la consulta siguiente recupera los elementos recién creados <Location> que tienen los atributos LocationID y LaborHours ordenados por el atributo LaborHours en orden descendente. Como resultado, se devolverán primero las ubicaciones de centro de trabajo que tengan el máximo de horas de trabajo (LaborHours).

SELECT Instructions.query('
     declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
for $WC in /AWMI:root/AWMI:Location
order by $WC/@LaborHours descending
        return
          <Location>
             { $WC/@LocationID }
             { $WC/@LaborHours }
          </Location>
') AS Result
FROM Production.ProductModel
WHERE ProductModelID = 7;

Este es el resultado:

<Location LocationID="60" LaborHours="4"/>
<Location LocationID="50" LaborHours="3"/>
<Location LocationID="10" LaborHours="2.5"/>
<Location LocationID="20" LaborHours="1.75"/>
<Location LocationID="30" LaborHours="1"/>
<Location LocationID="45" LaborHours=".5"/>

En la consulta siguiente, se ordenan los resultados por nombre de elemento. La consulta recupera las especificaciones de un producto determinado del catálogo de productos. Las especificaciones son los elementos secundarios del <Specifications> elemento.

SELECT CatalogDescription.query('
     declare namespace
 pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
      for $a in /pd:ProductDescription/pd:Specifications/*
     order by local-name($a)
      return $a
    ') AS Result
FROM Production.ProductModel
WHERE ProductModelID = 19;

Observe lo siguiente en la consulta anterior:

  • La /p1:ProductDescription/p1:Specifications/* expresión devuelve elementos secundarios de <Specifications>.

  • La expresión order by (local-name($a)) ordena la secuencia por la parte local del nombre del elemento.

Este es el resultado:

<Color>Available in most colors</Color>
<Material>Aluminum Alloy</Material>
<ProductLine>Mountain bike</ProductLine>
<RiderExperience>Advanced to Professional riders</RiderExperience>
<Style>Unisex</Style>

Los nodos en los que se devuelve la expresión de ordenación vacía se ordenan al principio de la secuencia, tal como se muestra en el ejemplo siguiente:

DECLARE @x AS XML;

SET @x = '<root>
  <Person Name="A" />
  <Person />
  <Person Name="B" />
</root>
';

SELECT @x.query('
  for $person in //Person
  order by $person/@Name
  return   $person
');

Este es el resultado:

<Person />
<Person Name="A" />
<Person Name="B" />

Se pueden especificar varios criterios de ordenación, tal como se muestra en el ejemplo siguiente. La consulta de este ejemplo ordena <Employee> primero los elementos por Title y, a continuación, por los valores de atributo Administrator.

DECLARE @x AS XML;

SET @x = '<root>
  <Employee ID="10" Title="Teacher"        Gender="M" />
  <Employee ID="15" Title="Teacher"  Gender="F" />
  <Employee ID="5" Title="Teacher"         Gender="M" />
  <Employee ID="11" Title="Teacher"        Gender="F" />
  <Employee ID="8" Title="Administrator"   Gender="M" />
  <Employee ID="4" Title="Administrator"   Gender="F" />
  <Employee ID="3" Title="Teacher"         Gender="F" />
  <Employee ID="125" Title="Administrator" Gender="F" /></root>';

SELECT @x.query('for $e in /root/Employee
order by $e/@Title ascending, $e/@Gender descending

  return
     $e
');

Este es el resultado:

<Employee ID="8" Title="Administrator" Gender="M" />
<Employee ID="4" Title="Administrator" Gender="F" />
<Employee ID="125" Title="Administrator" Gender="F" />
<Employee ID="10" Title="Teacher" Gender="M" />
<Employee ID="5" Title="Teacher" Gender="M" />
<Employee ID="11" Title="Teacher" Gender="F" />
<Employee ID="15" Title="Teacher" Gender="F" />
<Employee ID="3" Title="Teacher" Gender="F" />

Limitaciones

Éstas son las limitaciones:

  • Las expresiones de ordenación deben tener un tipo homogéneo. Esto se comprueba de forma estática.

  • No se pueden controlar las secuencias vacías de ordenación.

  • No se admiten las palabras clave de intercalación mínimas vacías y vacías en order by

Contenido relacionado

  • Last updated on