Contexto de expressão e avaliação de consulta (XQuery)

Contexto estático

A inicialização de contexto estático refere-se ao processo de reunir todas as informações para análise estática da expressão. Como parte da inicialização do contexto estático, o seguinte é completado:

• A diretiva de boundary white space é configurada para ser eliminada. Portanto, a boundary white space não é preservada pelos construtores any element e attribute na consulta. Por exemplo:

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

  Esta consulta retorna o resultado a seguir, porque boundary space é retirado durante a análise da expressão XQuery:

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

• O prefixo e a associação de namespace são inicializados para o seguinte:

  • Um conjunto de namespaces predefinidos.

  • Qualquer namespace definido usando WITH XMLNAMESPACES. Para obter mais informações, consulte Adicionando namespaces usando WITH XMLNAMESPACES.

  • Qualquer namespace definido no prólogo da consulta. Observe que as declarações de namespace no prólogo podem substituir a declaração de namespace no WITH XMLNAMESPACES. Por exemplo, na consulta a seguir, WITH XMLNAMESPACES declara um prefixo (pd) que o associa ao namespace (http://someURI). Entretanto, na cláusula WHERE, o prólogo da consulta substitui a associação.

    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
    

  Todas essas associações de namespace são resolvidas durante a inicialização de contexto estática.

• Se consultar uma coluna ou variável xml digitada, os componentes da coleção de esquemas XML associados com a coluna ou variável serão importados no contexto estático. Para obter mais informações, consulte XML digitado comparado com XML não digitado.

• Para todo tipo atômico nos esquemas importados, uma função de conversão também se torna disponível no contexto estático. Isso é ilustrado no exemplo a seguir. Nesse exemplo, uma consulta é especificada em uma variável xml digitada. A coleção de esquemas XML associada a essa variável define um tipo atômico, myType. Correspondendo a esse tipo, uma função de lançamento, myType(), está disponível durante as análises estáticas. A expressão de consulta (ns:myType(0)) retorna um valor de 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)')
  

  No exemplo a seguir, a função de conversão do tipo XML interno int é especificada na expressão.

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

Depois que o contexto estático é inicializado, a expressão de consulta é analisada (compilada). A análise estática envolve o seguinte:

1. Análise de consulta.

2. Resolução dos nomes de tipo e função especificados na expressão.

3. Digitação estática da consulta. Isso garante que a consulta é do tipo seguro. Por exemplo, a consulta a seguir retorna um erro estático, pois o operador + requer argumentos de tipo primitivo numéricos:

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

   No exemplo a seguir, o operador value() requer um singleton. Como especificado no esquema XML, pode haver vários elementos <Elem>. A análise estática da expressão estabelece que não é de tipo seguro e um erro estático é retornado. Para resolver o erro, a expressão deve ser reescrita para especificar um singleton (data(/x:Elem)[1]) explicitamente.

   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 obter mais informações, consulte XQuery e digitação estática.

Restrições de implementação

Contexto dinâmico

O contexto dinâmico refere-se a informações que devem estar disponíveis no momento que a expressão é executada. Além do contexto estático, as informações a seguir são inicializadas como parte do contexto dinâmico:

• O foco de expressão, como item de contexto, posição de contexto e tamanho de contexto, é inicializado como mostrado a seguir. Observe que todos esses valores podem ser substituídos pelo método nodes().

  • O tipo de dados xml define o item de contexto, o nó sendo processado, para o nó de documento.

  • A posição de contexto, a posição do item de contexto relativo aos nós que são processados, é primeiro configurada como 1.

  • O tamanho de contexto, o número de itens na seqüência sendo processada, é primeiro definido como 1, pois sempre há um nó de documento.

Restrições de implementação

Consulte também

Referência

Conceitos

Outros recursos