Compartir a través de

Expresiones de ruta de acceso: Especificación de predicados

  • Artículo

Se aplica a:SQL Server

Como se describe en el tema Expresiones de ruta de acceso en XQuery, un paso del eje en una expresión de ruta de acceso incluye los siguientes componentes:

El predicado opcional representa la tercera parte del paso de eje en una expresión de ruta de acceso.

Predicados

Un predicado se utiliza para filtrar una secuencia de nodos aplicando una prueba específica. La expresión de predicado se incluye entre corchetes y se enlaza con el último nodo de una expresión de ruta de acceso.

Por ejemplo, supongamos que se declara un valor de parámetro SQL (x) del tipo de datos xml , como se muestra en lo siguiente:

declare @x xml  
set @x = '  
<People>  
  <Person>  
    <Name>John</Name>  
    <Age>24</Age>  
  </Person>  
  <Person>  
    <Name>Goofy</Name>  
    <Age>54</Age>  
  </Person>  
  <Person>  
    <Name>Daffy</Name>  
    <Age>30</Age>  
  </Person>  
</People>  
'

En este caso, las siguientes expresiones son expresiones válidas que utilizan el valor de predicado [1] en cada uno de los tres niveles de nodos diferentes:

select @x.query('/People/Person/Name[1]')  
select @x.query('/People/Person[1]/Name')  
select @x.query('/People[1]/Person/Name')

Tenga en cuenta que, en cada caso, el predicado se enlaza con el nodo de la expresión de ruta de acceso donde se aplica. Por ejemplo, la primera expresión de ruta de acceso selecciona el primer <Name> elemento dentro de cada nodo /Personas/Person y, con la instancia XML proporcionada, devuelve lo siguiente:

<Name>John</Name><Name>Goofy</Name><Name>Daffy</Name>

Sin embargo, la segunda expresión de ruta de acceso selecciona todos los <Name> elementos que están en el primer nodo /Personas/Persona. Por tanto, devuelve lo siguiente:

<Name>John</Name>

Se pueden utilizar paréntesis para cambiar el orden de evaluación del predicado. Por ejemplo, en la siguiente expresión se utiliza un conjunto de paréntesis para separar la ruta de acceso de (/People/Person/Name) del predicado [1]:

select @x.query('(/People/Person/Name)[1]')

En este ejemplo cambia el orden en que se aplica el predicado. Esto se debe a que primero se evalúa la ruta de acceso incluida entre paréntesis (/People/Person/Name) y después se aplica el operador de predicado [1] al conjunto que contiene todos los nodos que hayan coincidido con la ruta de acceso entre paréntesis. Sin los paréntesis, el orden de las operaciones sería diferente, ya que [1] se aplicaría como prueba de nodo child::Name, de manera similar al primer ejemplo de expresión de ruta de acceso.

Cuantificadores y predicados

Dentro de las llaves del predicado se pueden utilizar cuantificadores, y se pueden agregar más de una vez. Partiendo del ejemplo anterior, a continuación se muestra el uso correcto de varios cuantificadores en una subexpresión de predicado compleja.

select @x.query('/People/Person[contains(Name[1], "J") and xs:integer(Age[1]) < 40]/Name/text()')

El resultado de una expresión de predicado se convierte en un valor booleano, que se conoce como el valor real del predicado. En el resultado solo se devuelven los nodos de la secuencia cuyo valor real del predicado es True. Los demás nodos se descartan.

Por ejemplo, la siguiente expresión de ruta de acceso incluye un predicado en su segundo paso:

/child::root/child::Location[attribute::LocationID=10]

La condición especificada por este predicado se aplica a todos los elementos secundarios del nodo de <Location> elemento. El resultado es que solo se devuelven las ubicaciones de centros de trabajo cuyo atributo LocationID tenga el valor 10.

La expresión de ruta de acceso anterior se ejecuta en la siguiente instrucción SELECT:

SELECT Instructions.query('  
declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";  
 /child::AWMI:root/child::AWMI:Location[attribute::LocationID=10]  
')  
FROM Production.ProductModel  
WHERE ProductModelID=7

Calcular valores reales de predicado

Para determinar el valor real del predicado se aplican las siguientes reglas, según las especificaciones de XQuery:

  1. Si el valor de la expresión de predicado es una secuencia vacía, el valor real del predicado es False.

    Por ejemplo:

    SELECT Instructions.query('  
declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";  
 /child::AWMI:root/child::AWMI:Location[attribute::LotSize]  
')  
FROM Production.ProductModel  
WHERE ProductModelID=7

    La expresión path de esta consulta devuelve solo los <Location> nodos de elemento que tienen un atributo LotSize especificado. Si el predicado devuelve una secuencia vacía para un elemento específico <Location>, esa ubicación del centro de trabajo no se devuelve en el resultado.

  2. Los valores de predicado solo pueden ser xs:integer, xs:Boolean o node*. En el caso de node*, el predicado se evalúa como True si hay nodos, y como False si es una secuencia vacía. Cualquier otro tipo numérico, como double y float, genera un error de tipos estáticos. El valor real del predicado de una expresión es True si y solo si el entero resultante es igual al valor de la posición de contexto. Además, solo los valores literales enteros y la función last() reducen la cardinalidad de la expresión de paso filtrado a 1.

    Por ejemplo, la consulta siguiente recupera el tercer nodo de elemento secundario del <Features> elemento .

    SELECT CatalogDescription.query('  
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";  
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";  
 /child::PD:ProductDescription/child::PD:Features/child::*[3]  
')  
FROM Production.ProductModel  
WHERE ProductModelID=19

    Observe lo siguiente en la consulta anterior:

    • El tercer paso de la expresión especifica una expresión de predicado cuyo valor es 3. Por tanto, el valor real del predicado de esta expresión es True solo para los nodos cuya posición de contexto sea 3.

    • El tercer paso especifica también un carácter comodín (*) que indica todos los nodos de la prueba de nodo. Sin embargo, el predicado filtra los nodos y devuelve solo el nodo que ocupa la tercera posición.

    • La consulta devuelve el tercer nodo de elemento secundario del <Features> elemento secundario del elemento secundario del <ProductDescription> elemento secundario de la raíz del documento.

  3. Si el valor de la expresión de predicado es un valor booleano de tipo simple, el valor real del predicado es igual al valor de la expresión de predicado.

    Por ejemplo, la consulta siguiente se especifica en una variable de tipo xmlque contiene una instancia XML, la instancia XML de encuesta del cliente. La consulta recupera los clientes que tienen elementos secundarios. En esta consulta, sería <HasChildren>1</HasChildren>.

    declare @x xml  
set @x='  
<Survey>  
  <Customer CustomerID="1" >  
  <Age>27</Age>  
  <Income>20000</Income>  
  <HasChildren>1</HasChildren>  
  </Customer>  
  <Customer CustomerID="2" >  
  <Age>27</Age>  
  <Income>20000</Income>  
  <HasChildren>0</HasChildren>  
  </Customer>  
</Survey>  
'  
declare @y xml  
set @y = @x.query('  
  for $c in /child::Survey/child::Customer[( child::HasChildren[1] cast as xs:boolean ? )]  
  return   
      <CustomerWithChildren>  
          { $c/attribute::CustomerID }  
      </CustomerWithChildren>  
')  
select @y

    Observe lo siguiente en la consulta anterior:

    • La expresión del bucle for tiene dos pasos y el segundo paso especifica un predicado. El valor de este predicado es de tipo Boolean. Si este valor es True, el valor real del predicado también es True.

    • La consulta devuelve los <Customer> elementos secundarios, cuyo valor de predicado es True, del <elemento Survey> secundario de la raíz del documento. El resultado es el siguiente:

      <CustomerWithChildren CustomerID="1"/>

  4. Si el valor de la expresión de predicado es una secuencia que contiene al menos un nodo, el valor real del predicado es True.

Por ejemplo, la consulta siguiente recupera ProductModelID para los modelos de producto cuya descripción del catálogo XML incluye al menos una característica, un elemento secundario del <Features> elemento, del espacio de nombres asociado al prefijo wm .

SELECT ProductModelID  
FROM   Production.ProductModel  
WHERE CatalogDescription.exist('  
             declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";  
             declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";  
             /child::PD:ProductDescription/child::PD:Features[wm:*]  
             ') = 1

Observe lo siguiente en la consulta anterior:

  • La cláusula WHERE especifica el método exist() (tipo de datos XML).

  • La expresión de ruta de acceso dentro del método exist() especifica un predicado en el segundo paso. Si la expresión de predicado devuelve una secuencia de al menos una característica, el valor de esta expresión de predicado es True. En este caso, dado que el método exist() devuelve un valor True, se devuelve productModelID.

Tipos estáticos y filtros de predicado

Los predicados también pueden afectar al tipo de una expresión deducido de forma estática. Los valores literales enteros y la función last() reducen la cardinalidad de la expresión de paso filtrado a, como máximo, una.