Expresiones de ruta de acceso (XQuery)

Se aplica a:SQL Server

Estas expresiones buscan nodos, tales como element, attribute y text, en un documento. El resultado de una expresión de ruta de acceso siempre se produce en el orden de los documentos sin nodos duplicados en la secuencia resultante. Al especificar una ruta de acceso, se puede utilizar sintaxis abreviada o sin abreviar. La información siguiente se centra en la sintaxis sin abreviar. La sintaxis abreviada se describe más adelante en este tema.

Nota

Dado que las consultas de ejemplo de este tema se especifican en las columnas de tipo xml , CatalogDescription e Instructions, en la tabla ProductModel , debe familiarizarse con el contenido y la estructura de los documentos XML almacenados en estas columnas.

Una expresión de ruta de acceso puede ser relativa o absoluta. A continuación se ofrece una descripción de ambas:

• Una expresión de ruta de acceso consta de uno o varios pasos separados por una o dos marcas de barra diagonal (/ o //). Por ejemplo, child::Features es una expresión de ruta de acceso relativa, en la que Child solo hace referencia a los nodos secundarios del nodo de contexto. Se trata del nodo que se está procesando. La expresión recupera los <elementos secundarios del nodo del elemento Features> del nodo de contexto.

• Una expresión de ruta de acceso absoluta empieza con una o dos marcas de barra diagonal (/ o //), seguidas de una ruta de acceso relativa opcional. Por ejemplo, la marca de barra diagonal inicial de la expresión, /child::ProductDescription, indica que se trata de una expresión de ruta de acceso absoluta. Dado que una marca de barra diagonal al principio de una expresión devuelve el nodo raíz del documento del nodo de contexto, la expresión devuelve todos los <elementos secundarios del nodo del elemento ProductDescription> de la raíz del documento.

  Si una ruta de acceso absoluta empieza con una sola marca de barra diagonal, puede ir seguida o no por una ruta de acceso relativa. Si solo se especifica una sola marca de barra diagonal, la expresión devolverá el nodo raíz del nodo de contexto. En el caso de un tipo de datos XML, se trata del nodo de su documento.

Una expresión de ruta de acceso se compone de pasos. Por ejemplo, la expresión de ruta de acceso absoluta, /child::ProductDescription/child::Summary, contiene dos pasos separados por una marca de barra diagonal.

• El primer paso recupera los elementos secundarios del <nodo del elemento ProductDescription> de la raíz del documento.

• El segundo paso recupera los elementos secundarios del <nodo de elemento Summary> para cada nodo de elemento ProductDescription> recuperado<, que a su vez se convierte en el nodo de contexto.

Los pasos de una expresión de ruta de acceso pueden ser de eje o generales.

Paso de eje

Un paso de eje en una expresión de ruta de acceso está formado por las partes que se indican a continuación.

ejes
Define la dirección del movimiento. Se trata de un paso de eje de una expresión de ruta de acceso que empieza en el nodo de contexto y se navega hasta los nodos disponibles en la dirección especificada por el eje.

prueba de nodo
Especifica el tipo de nodo o los nombres de nodo que se seleccionarán.

Cero o más predicados opcionales
Filtra los nodos seleccionando algunos y descartando otros.

En los ejemplos siguientes se usa un ejepaso en las expresiones de ruta de acceso:

• La expresión de ruta de acceso absoluta, /child::ProductDescription, incluye un solo paso. Especifica un eje (child) y una prueba de nodo (ProductDescription).

• La expresión de ruta de acceso relativa, child::ProductDescription/child::Features, incluye dos pasos separados por una marca de barra diagonal. Ambos pasos especifican un eje secundario. ProductDescription y Features son pruebas de nodos.

• La expresión de ruta de acceso relativa, child::root/child::Location[attribute::LocationID=10], contiene dos pasos separados por una barra diagonal. El primero especifica un eje (child) y una prueba de nodo (root). El segundo especifica los tres componentes de un paso de eje: un eje (secundario), una prueba de nodo (Location) y un predicado ([attribute::LocationID=10]).

Para obtener más información sobre los componentes de un paso de eje, vea Especificar eje en un paso de expresión de ruta de acceso, Especificar prueba de nodo en un paso de expresión de ruta de acceso y Especificar predicados en un paso de expresión de ruta de acceso.

Paso general

Un paso general es simplemente una expresión que debe dar como resultado una secuencia de nodos.

La implementación de XQuery en SQL Server admite un paso general como primer paso de una expresión de ruta de acceso. A continuación se muestran ejemplos de expresiones de ruta de acceso que utilizan pasos generales.

(/a, /b)/c  
id(/a/b)  

Para obtener más información sobre la función id, vea Id Function (XQuery).

En esta sección

Especificar ejes en un paso de expresión de ruta de acceso
Se describe el funcionamiento con el paso de eje en una expresión de ruta de acceso.

Especificar una prueba de nodo en un paso de expresión de ruta de acceso
Se describe el funcionamiento con pruebas de nodo en una expresión de ruta de acceso.

Especificar predicados en un paso de expresión de ruta de acceso
Se describe el funcionamiento con predicados en una expresión de ruta de acceso.

Usar sintaxis abreviada en una expresión de ruta de acceso
Se describe el funcionamiento con sintaxis abreviada en una expresión de ruta de acceso.