Directrices para usar métodos de tipo de datos xml

Se aplica a:SQL ServerAzure SQL DatabaseInstancia administrada de Azure SQLBase de datos SQL en Microsoft Fabric

En este artículo se describen las instrucciones para usar los métodos de tipo de datos xml .

Instrucción PRINT

Los métodos de tipo de datos xml no se pueden usar en la PRINT instrucción como se muestra en el ejemplo siguiente. Los métodos de tipo de datos xml se tratan como subconsultas y las subconsultas no se permiten en la PRINT instrucción . Como resultado, el ejemplo siguiente devuelve un error:

DECLARE @x XML
SET @x = '<root>Hello</root>'
PRINT @x.value('/root[1]', 'varchar(20)') -- will not work because this is treated as a subquery (select top 1 col from table)

Una solución es asignar primero el resultado del método value() a una variable de tipo xml y, después, especificar la variable en la consulta.

DECLARE @x XML
DECLARE @c VARCHAR(max)
SET @x = '<root>Hello</root>'
SET @c = @x.value('/root[1]', 'VARCHAR(11)')
PRINT @c

La cláusula GROUP BY

Los métodos del tipo de datos xml se tratan internamente como subconsultas. Dado GROUP BY que requiere un escalar y no permite agregados y subconsultas, no se pueden especificar los métodos de tipo de datos xml en la GROUP BY cláusula . Una solución es llamar a una función definida por el usuario que utilice métodos XML en su interior.

Cómo comunicar un error

Al informar de errores, los métodos del tipo de datos xml generan un único error con el formato siguiente:

Msg errorNumber, Level levelNumber, State stateNumber:
XQuery [database.table.method]: description_of_error

Por ejemplo:

Msg 2396, Level 16, State 1:
XQuery [xmldb_test.xmlcol.query()]: Attribute may not appear outside of an element

Nota:

Análisis de errores generados por el analizador XQuery (por ejemplo, errores de sintaxis en el XML al que se hace referencia como parte del método de tipo de datos XML, por ejemplo), anule la transacción activa, independientemente de la configuración XACT_ABORT de la sesión actual.

Comprobaciones singleton

Los pasos de ubicación, los parámetros de función y los operadores que requieren singletons devolverán un error si el compilador no puede determinar si se garantiza un singleton en tiempo de ejecución. Este problema es frecuente con datos sin tipo. Por ejemplo, la búsqueda de un atributo requiere un elemento primario singleton. Es suficiente con un ordinal que seleccione un solo nodo primario. Es posible que la evaluación de una combinación node()-value() para extraer valores de atributo no requiera la especificación ordinal. Esto se muestra en el ejemplo siguiente.

Ejemplo: Singleton conocido

En este ejemplo, el método nodes() genera una fila distinta por cada elemento <book>. El método value() que se evalúa en un nodo <book> extrae el valor de @genre y, siendo un atributo, es un singleton.

SELECT nref.value('@genre', 'VARCHAR(max)') LastName
FROM T CROSS APPLY xCol.nodes('//book') AS R(nref)

El esquema XML se utiliza para comprobar el tipo del XML con tipo. Si se especifica un nodo como singleton en el esquema XML, el compilador usa esa información y no se produce ningún error. En caso contrario, se necesita un ordinal que seleccione un solo nodo. En particular, el uso de ejes descendant-or-self (//), como en /book//title, pierde inferencia de cardinalidad de singleton para el elemento <title>, incluso si el esquema XML especifica que sea así. Por tanto, se debe volver a escribir como (/book//title)[1].

Es importante seguir teniendo en cuenta la diferencia entre //first-name[1] y (//first-name)[1] para la comprobación de tipos. La primera expresión devuelve una secuencia de nodos <first-name> en la que cada nodo es el nodo <first-name> que está más a la izquierda entre los de su mismo nivel. La última expresión devuelve el primer nodo singleton <first-name> por orden de los documentos en la instancia XML.

Ejemplo: uso de value()

La consulta siguiente en una columna XML sin tipo da como resultado un error estático de compilación. Esto se debe a que value() espera un nodo singleton como primer argumento y el compilador no puede determinar si solo se producirá un <last-name> nodo en tiempo de ejecución:

SELECT xCol.value('//author/last-name', 'NVARCHAR(50)') LastName
FROM T

A continuación, se ofrece una solución que debe contemplar:

SELECT xCol.value('//author/last-name[1]', 'NVARCHAR(50)') LastName
FROM T

Sin embargo, esta solución no resuelve el error, ya que varios <author> nodos pueden producirse en cada instancia XML. Resulta útil volver a escribir lo siguiente:

SELECT xCol.value('(//author/last-name/text())[1]', 'NVARCHAR(50)') LastName
FROM T

Esta consulta devuelve el valor del primer elemento <last-name> de cada instancia XML.

Contenido relacionado

• Métodos del tipo de datos xml