Compartir vía

Contexto de expresiones y evaluación de consultas (XQuery)

  • Artículo

Se aplica a:SQL Server

El contexto de una expresión es la información que se utiliza para analizarla y evaluarla. A continuación, se muestran las dos fases de evaluación de XQuery:

  • Contexto estático : esta es la fase de compilación de consultas. En función de la información disponible, a veces pueden producirse errores durante este análisis estático de la consulta.

  • Contexto dinámico : esta es la fase de ejecución de la consulta. Aunque una consulta no presente errores estáticos, como errores que se hayan producido durante la compilación de la consulta, la consulta puede devolver errores durante su ejecución.

Contexto estático

La inicialización del contexto estático se refiere al proceso que consiste en reunir toda la información de cara al análisis estático de la expresión. Como parte de la inicialización del contexto estático, se llevan a cabo los siguientes pasos:

  • La directiva de espacio en blanco de límites se establece en seccionar. Por lo tanto, los constructores de elementos y atributos de la consulta no conservan el espacio en blanco del límite. Por ejemplo:

    declare @x xml  
set @x=''  
select @x.query('<a>  {"Hello"}  </a>,  

    <b> {"Hello2"}  </b>')

    La siguiente consulta devuelve el siguiente resultado, porque el espacio límite se elimina durante el análisis de la expresión XQuery:

    <a>Hello</a><b>Hello2</b>

  • El enlace del espacio de nombres y el prefijo se inicializan para los siguientes espacios de nombres:

    • Un conjunto de espacios de nombres predefinidos.

    • Cualquier espacio de nombres definido mediante WITH XMLNAMESPACES. Para obtener más información, vea Agregar espacios de nombres a consultas con WITH XMLNAMESPACES).

    • Cualquier espacio de nombres definido en el prólogo de la consulta. Tenga en cuenta que las declaraciones de espacios de nombres del prólogo pueden reemplazar la declaración de espacio de nombres de WITH XMLNAMESPACES. Por ejemplo, en la consulta siguiente, WITH XMLNAMESPACES declara un prefijo (pd) que lo enlaza al espacio de nombres (https://someURI). Sin embargo, en la cláusula WHERE, el prólogo de la consulta reemplaza el enlace.

      WITH XMLNAMESPACES ('https://someURI' AS pd)  
SELECT ProductModelID, CatalogDescription.query('  
    <Product   
        ProductModelID= "{ sql:column("ProductModelID") }"   
        />  
') AS Result  
FROM Production.ProductModel  
WHERE CatalogDescription.exist('  
    declare namespace  pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";  
     /pd:ProductDescription[(pd:Specifications)]'  
    ) = 1

    Todos estos enlaces de espacio de nombres se resuelven durante la inicialización del contexto estático.

  • Si consulta una columna o variable xml con tipo, los componentes de la colección de esquemas XML asociada a la columna o variable se importan en el contexto estático. Para obtener más información, vea Comparar XML con tipo y XML sin tipo.

  • Se pone a disposición de cada uno de los tipos atómicos de los esquemas importados una función de conversión en el contexto estático. Esto se muestra en el ejemplo siguiente. En este ejemplo, se especifica una consulta en una variable xml con tipo. La colección de esquemas XML asociada a esta variable define un tipo atómico, myType. Correspondiente a este tipo, una función de conversión, myType(), está disponible durante el análisis estático. La expresión de consulta (ns:myType(0)) devuelve un valor de tipo myType.

    -- DROP XML SCHEMA COLLECTION SC  
-- go  
CREATE XML SCHEMA COLLECTION SC AS '<schema xmlns="http://www.w3.org/2001/XMLSchema"   
targetNamespace="myNS" xmlns:ns="myNS"  
xmlns:s="https://schemas.microsoft.com/sqlserver/2004/sqltypes">  
      <import namespace="https://schemas.microsoft.com/sqlserver/2004/sqltypes"/>  
      <simpleType name="myType">  
            <restriction base="int">  
             <enumeration value="0" />  
              <enumeration value="1"/>  
            </restriction>  
      </simpleType>  
      <element name="root" type="ns:myType"/>  
</schema>'  
go  

DECLARE @var XML(SC)  
SET @var = '<root xmlns="myNS">0</root>'  
-- specify myType() casting function in the query  
SELECT @var.query('declare namespace ns="myNS"; ns:myType(0)')

    En el ejemplo siguiente, la función de conversión para el tipo XML integrado int se especifica en la expresión .

    declare @x xml  
set @x = ''  
select @x.query('xs:int(5)')  
go

Una vez inicializado el contexto estático, se analiza la expresión de consulta (se compila). El análisis estático conlleva los siguientes pasos:

  1. Análisis de la consulta.

  2. Resolución de los nombres de tipos y funciones que se hayan especificado en la expresión.

  3. Escritura estática de la consulta. Este paso garantiza la seguridad de tipos de la consulta. Por ejemplo, la consulta siguiente devuelve un error estático, porque el + operador requiere argumentos de tipo primitivo numérico:

    declare @x xml  
set @x=''  
SELECT @x.query('"x" + 4')

    En el ejemplo siguiente, el operador value() requiere un singleton. Como se especifica en el esquema XML, puede haber varios <elementos Elem> . El análisis estático de la expresión determina que no tiene seguridad de tipos y se devuelve un error estático. Para resolver este error, hay que volver a escribir la expresión y especificar explícitamente un valor singleton (data(/x:Elem)[1]).

    DROP XML SCHEMA COLLECTION SC  
go  
CREATE XML SCHEMA COLLECTION SC AS '<schema xmlns="http://www.w3.org/2001/XMLSchema"   
targetNamespace="myNS" xmlns:ns="myNS"  
xmlns:s="https://schemas.microsoft.com/sqlserver/2004/sqltypes">  
      <import namespace="https://schemas.microsoft.com/sqlserver/2004/sqltypes"/>  
      <element name="Elem" type="string"/>  
</schema>'  
go  

declare @x xml (SC)  
set @x='<Elem xmlns="myNS">test</Elem><Elem xmlns="myNS">test2</Elem>'  
SELECT @x.value('declare namespace x="myNS"; data(/x:Elem)[1]','varchar(20)')

    Para obtener más información, vea XQuery y Escritura estática.

Restricciones de implementación

A continuación se muestran las limitaciones relativas al contexto estático:

  • No se admite el modo de compatibilidad de XPath.

  • Para una construcción XML, solo se admite el modo de construcción de eliminación. Esta es la configuración predeterminada. Por lo tanto, el tipo del nodo de elemento construido es de tipo xdt:untyped y los atributos son de tipo xdt:untypedAtomic .

  • Solo se admite el modo de ordenación ordenado.

  • Solo se admite la directiva de eliminación de espacio XML.

  • No se admite la funcionalidad URI básica.

  • no se admite fn:doc().

  • no se admite fn:collection().

  • No se proporciona un indicador estático de XQuery.

  • Se usa la intercalación asociada al tipo de datos xml . Esta intercalación siempre se establece en la intercalación de punto de código Unicode.

Contexto dinámico

El contexto dinámico se refiere a la información que debe estar disponible en el momento de ejecución de la expresión. Además del contexto estático, también se inicializa la siguiente información como parte del contexto dinámico:

  • El foco de la expresión, como el elemento de contexto, la posición de contexto y el tamaño de contexto, se inicializa del modo que se muestra a continuación. Tenga en cuenta que el método nodes() puede invalidar todos estos valores.

    • El tipo de datos xml establece el elemento de contexto, el nodo que se está procesando, en el nodo de documento.

    • La posición de contexto, la posición del elemento de contexto con respecto a los nodos que se van a procesar, se establece primero en 1.

    • El tamaño de contexto, el número de elementos de la secuencia que se va a procesar, se establece primero en 1, porque siempre hay un nodo de documento.

Restricciones de implementación

A continuación se muestran las limitaciones relativas al contexto dinámico:

  • No se admiten las funciones de contexto de fecha y hora actuales , fn:current-date, fn:current-time y fn:current-dateTime.

  • La zona horaria implícita se fija en UTC+0 y no se puede cambiar.

  • No se admite la función fn:doc(). Todas las consultas se ejecutan en columnas o variables de tipo xml .

  • No se admite la función fn:collection().

Consulte también

Conceptos básicos de XQuery
Comparar XML con tipo y XML sin tipo
Colecciones de esquemas XML (SQL Server)