Atomização (XQuery)

A atomização é o processo de extrair o valor digitado de um item. Esse processo está implícito em determinadas circunstâncias. Alguns dos operadores XQuery, como operadores de aritmética e de comparação, dependem desse processo. Por exemplo, quando você aplicar operadores aritméticos diretamente a nós, o valor digitado de um nó é recuperado primeiro invocando implicitamente a função de dados. Isso passa o valor atômico como um operando para o operador aritmético.

Por exemplo, a consulta a seguir retorna o total dos atributos LaborHours. Nesse caso, data() é aplicado implicitamente aos nós de atributo.

declare @x xml
set @x='<ROOT><Location LID="1" SetupTime="1.1" LaborHours="3.3" />
<Location LID="2" SetupTime="1.0" LaborHours="5" />
<Location LID="3" SetupTime="2.1" LaborHours="4" />
</ROOT>'
-- data() implicitly applied to the attribute node sequence.
SELECT @x.query('sum(/ROOT/Location/@LaborHours)')

Embora não obrigatório, você também pode especificar explicitamente a função data():

SELECT @x.query('sum(data(ROOT/Location/@LaborHours))')

Outro exemplo de atomização implícita é quando você usa operadores aritméticos. O operador + requer valores atômicos e data() é aplicado implicitamente para recuperar o valor atômico do atributo LaborHours. A consulta é especificada contra a coluna Instructions do tipo xml na tabela ProductModel. A consulta a seguir retorna o atributo LaborHours três vezes. Na consulta, observe o seguinte:

• Na construção do atributo OriginalLaborHours, a atomização é aplicada implicitamente à seqüência de singleton retornada por ($WC/@LaborHours). O valor digitado do atributo LaborHours é atribuído a OriginalLaborHours.

• Na construção do atributo UpdatedLaborHoursV1, o operador aritmético requer valores atômicos. Dessa forma, data() é aplicado implicitamente ao atributo LaborHours retornado por ($WC/@LaborHours). O valor atômico 1 é então adicionado a ele. A construção do atributo UpdatedLaborHoursV2 mostra o aplicativo explícito de data(), mas não é obrigatória.

SELECT Instructions.query('
     declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
for $WC in /AWMI:root/AWMI:Location[1]
        return
            <WC OriginalLaborHours = "{ $WC/@LaborHours }"
                UpdatedLaborHoursV1 = "{ $WC/@LaborHours + 1 }" 
                UpdatedLaborHoursV2 = "{ data($WC/@LaborHours) + 1 }" >
            </WC>') as Result
FROM Production.ProductModel
where ProductModelID=7

Este é o resultado:

<WC OriginalLaborHours="2.5" 
    UpdatedLaborHoursV1="3.5" 
    UpdatedLaborHoursV2="3.5" />

A atomização resulta em uma instância de um tipo simples, um conjunto vazio ou um erro de tipo estático.

A atomização também ocorre em parâmetros de expressão de comparação passados a funções, valores retornados por funções, expressões cast() e expressões de ordenação passadas na ordem pela cláusula.