Compartilhar via

Funções do acessador de dados – dados (XQuery)

Aplica-se:SQL Server

Retorna o valor digitado para cada item especificado por $arg.

Sintaxe

fn:data ($arg as item()*) as xdt:untypedAtomic*

Argumentos

$arg

Sequência de itens cujos valores tipado são retornados.

Comentários

As seguintes considerações se aplicam a valores tipado:

  • O valor digitado de um valor atômico é o valor atômico.

  • O valor digitado de um nó de texto é o valor da cadeia de caracteres do nó de texto.

  • O valor digitado de um comentário é o valor da cadeia de caracteres do comentário.

  • O valor digitado de uma instrução de processamento é o conteúdo da instrução de processamento, sem o nome de destino da instrução de processamento.

  • O valor digitado de um nó de documento é seu valor de cadeia de caracteres.

As seguintes considerações se aplicam a nós de atributo e elemento:

  • Se um nó de atributo é digitado com um tipo de esquema XML, seu valor digitado será o valor digitado.

  • Se o nó de atributo não for tipado, seu valor digitado será igual ao valor de cadeia de caracteres retornado como uma instância de xdt:untypedAtomic.

  • Se o nó de elemento não tiver sido digitado, seu valor digitado será igual ao valor de cadeia de caracteres retornado como uma instância de xdt:untypedAtomic.

As seguintes considerações se aplicam a nós de elemento digitado:

  • Se o elemento tiver um tipo de conteúdo simples, data() retornará o valor digitado do elemento.

  • Se o nó for de tipo complexo, incluindo xs:anyType, data() retornará um erro estático.

Embora o uso da data() função seja frequentemente opcional, conforme mostrado nos exemplos a seguir, especificar a data() função aumenta explicitamente a legibilidade da consulta. Para obter mais informações, consulte Noções básicas do XQuery.

Você não pode especificar data() em XML construído, conforme mostrado no exemplo a seguir:

DECLARE @x AS XML;

SET @x = '';

SELECT @x.query('data(<SomeNode>value</SomeNode>)');

Exemplos

Este artigo fornece exemplos XQuery em instâncias XML armazenadas em várias colunas de tipo xml no banco de dados AdventureWorks.

R. Usar a função XQuery data() para extrair o valor digitado de um nó

A consulta a seguir ilustra como a data() função é usada para recuperar valores de um atributo, um elemento e um nó de texto:

WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS p1, 'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain' AS wm)
SELECT CatalogDescription.query(N'
 for $pd in //p1:ProductDescription
 return
    <Root
      ProductID = "{ data( ($pd//@ProductModelID)[1] ) }"
      Feature =   "{ data( ($pd/p1:Features/wm:Warranty/wm:Description)[1] ) }" >
    </Root>
 ') AS Result
FROM Production.ProductModel
WHERE ProductModelID = 19;

Eis o resultado:

<Root ProductID="19" Feature="parts and labor"/>

Conforme mencionado, a data() função é opcional quando você está construindo atributos. Se você não especificar a data() função, ela será assumida implicitamente. A consulta a seguir produz os mesmos resultados da consulta prévia:

WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS p1, 'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain' AS wm)
SELECT CatalogDescription.query('
      for $pd in //p1:ProductDescription
         return
          <Root
                ProductID = "{ ($pd/@ProductModelID)[1] }"
                Feature =   "{ ($pd/p1:Features/wm:Warranty/wm:Description)[1] }" >
           </Root>
 ') AS Result
FROM Production.ProductModel
WHERE ProductModelID = 19;

Os exemplos a seguir ilustram instâncias nas quais a data() função é necessária.

Na consulta a seguir, $pd/p1:Specifications/Material retorna o <Material> elemento. Além disso, data($pd/p1:Specifications/ Material) retorna dados de caractere digitados como xdt:untypedAtomic, porque <Material> não são tipados. Quando a entrada não é tipada, o resultado é data() digitado como xdt:untypedAtomic.

SELECT CatalogDescription.query('
declare namespace p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
      for $pd in //p1:ProductDescription
         return
          <Root>
             { $pd/p1:Specifications/Material }
             { data($pd/p1:Specifications/Material) }
           </Root>
 ') AS Result
FROM Production.ProductModel
WHERE ProductModelID = 19;

Eis o resultado:

<Root>
  <Material>Aluminum Alloy</Material>Aluminum Alloy
</Root>

Na consulta a seguir, data($pd/p1:Features/wm:Warranty) retorna um erro estático, porque <Warranty> é um elemento de tipo complexo.

WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS p1, 'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain' AS wm)
SELECT CatalogDescription.query('
 <Root>
   {     /p1:ProductDescription/p1:Features/wm:Warranty }
   { data(/p1:ProductDescription/p1:Features/wm:Warranty) }
 </Root>
 ') AS Result
FROM Production.ProductModel
WHERE ProductModelID = 23;

Conteúdo relacionado

  • Last updated on