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

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ímite se establece en la opción de eliminación. Por tanto, los constructores any element y attribute no conservan en la consulta el espacio en blanco 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, consulte Agregar espacios de nombres mediante 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 siguiente consulta, WITH XMLNAMESPACES declara un prefijo (pd) que se enlaza con el espacio de nombres (http://someURI). Sin embargo, en la cláusula WHERE, el prólogo de la consulta reemplaza el enlace.

    WITH XMLNAMESPACES ('http://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 se consulta una columna o variable xml con tipo, los componentes de la colección de esquemas XML asociados a la columna o variable se importan en el contexto estático. Para obtener más información, vea Comparación de 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. Durante el análisis estático, hay disponible una función de conversión correspondiente al tipo, myType(). 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 siguiente ejemplo, la función de conversión para el tipo XML int integrado 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 siguiente consulta devuelve un error estático, porque el operador + requiere argumentos de tipo numérico primitivo:

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

   En el siguiente ejemplo, el operador value() requiere un valor singleton. Tal y 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 el establecimiento de tipos estáticos.

Restricciones de implementación

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 todos estos valores pueden reemplazarse por el método nodes().

  • El tipo de datos xml establece el elemento de contexto, el nodo que se va a procesar, 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

Vea también

Referencia

Conceptos

Otros recursos