Partilhar via


Colunas com um nome

As seguintes são as condições específicas nas quais colunas de conjunto de linhas com um nome são mapeadas, diferenciando maiúsculas e minúsculas, para o XML resultante:

  • O nome da coluna começa com uma arroba (@).

  • O nome da coluna não começa com uma arroba (@).

  • O nome da coluna não começa com uma arroba @ e contém uma barra (/).

  • Várias colunas compartilham o mesmo prefixo.

  • Uma coluna tem um nome diferente.

O nome da coluna começa com uma arroba (@)

Se o nome da coluna começar com um sinal de at (@) e não contiver uma barra (/), um atributo do <row> elemento que tem o valor de coluna correspondente será criado. Por exemplo, a consulta a seguir retorna um conjunto de linhas de duas colunas (@PmId, Name). No XML resultante, um atributo PmId é adicionado ao elemento correspondente <row> e um valor de ProductModelID é atribuído a ele.

  
SELECT ProductModelID as "@PmId",  
       Name  
FROM Production.ProductModel  
WHERE ProductModelID=7  
FOR XML PATH   
go  
  

Este é o resultado:

<row PmId="7">  
  <Name>HL Touring Frame</Name>  
</row>  

Observe que os atributos devem vir antes de quaisquer outros tipos de nós, como nós de elemento e nós de texto, no mesmo nível. A consulta a seguir retornará um erro:

SELECT Name,  
       ProductModelID as "@PmId"  
FROM Production.ProductModel  
WHERE ProductModelID=7  
FOR XML PATH   
go  

O nome da coluna não começa com uma arroba (@)

Se o nome da coluna não começar com um sinal de at (@), não for um dos testes de nó XPath e não contiver uma barra (/), um elemento XML que é um subelemento do elemento de linha, <row> por padrão, será criado.

A consulta a seguir especifica o nome da coluna, o resultado. Portanto, um <result> filho do elemento é adicionado ao <row> elemento .

SELECT 2+2 as result  
for xml PATH  

Este é o resultado:

<row>  
  <result>4</result>  
</row>  

O exemplo a seguir especifica o nome da coluna, ManuWorkCenterInformation, para o XML retornado pelo XQuery especificado em relação à coluna Instructions de tipo xml. Portanto, um <ManuWorkCenterInformation> elemento é adicionado como um filho do <row> elemento .

SELECT   
       ProductModelID,  
       Name,  
       Instructions.query('declare namespace MI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";  
                /MI:root/MI:Location   
              ') as ManuWorkCenterInformation  
FROM Production.ProductModel  
WHERE ProductModelID=7  
FOR XML PATH   
go  

Este é o resultado:

<row>  
  <ProductModelID>7</ProductModelID>  
  <Name>HL Touring Frame</Name>  
  <ManuWorkCenterInformation>  
    <MI:Location ...LocationID="10" ...></MI:Location>  
    <MI:Location ...LocationID="20" ...></MI:Location>  
     ...  
  </ManuWorkCenterInformation>  
</row>  

O nome da coluna não começa com uma arroba @ e contém uma barra (/)

Se o nome da coluna não começar com uma arroba (@), mas contiver uma barra (/), o nome da coluna indicará uma hierarquia XML. Por exemplo, se o nome da coluna for "Name1/Name2/Name3.../Namen ", cada Nomei representará um nome de elemento aninhado no elemento de linha atual (para i=1) ou que esteja sob o elemento que tem o nome Nomei-1. Se Namen começar com '@', ele será mapeado para um atributo do elemento Namen-1 .

Por exemplo, a consulta a seguir retorna a ID e o nome de um funcionário que são representados como um elemento complexo EmpName que contém um Nome, Segundo nome e Sobrenome.

SELECT EmployeeID "@EmpID",   
       FirstName  "EmpName/First",   
       MiddleName "EmpName/Middle",   
       LastName   "EmpName/Last"  
FROM   HumanResources.Employee E, Person.Contact C  
WHERE  E.EmployeeID = C.ContactID  
AND    E.EmployeeID=1  
FOR XML PATH  

Os nomes de colunas são usados como um caminho para construir XML no modo PATH. O nome da coluna que contém valores de ID do funcionário começa com '@'. Portanto, um atributo, EmpID, é adicionado ao <row> elemento . Todas as outras colunas incluem uma barra ('/') no nome da coluna que indica hierarquia. O XML resultante terá o <>EmpNamefilho sob o <>rowelemento e o>EmpName< filho teráMiddle<>><First o elemento e <Last> filhos.

<row EmpID="1">  
  <EmpName>  
    <First>Gustavo</First>  
    <Last>Achong</Last>  
  </EmpName>  
</row>  

O segundo nome do funcionário é nulo e, por padrão, o valor nulo é mapeado para a ausência do elemento ou atributo. Se você quiser elementos gerados para os valores NULL, poderá especificar a diretiva ELEMENTS com XSINIL conforme mostrado nesta consulta.

SELECT EmployeeID "@EmpID",   
       FirstName  "EmpName/First",   
       MiddleName "EmpName/Middle",   
       LastName   "EmpName/Last"  
FROM   HumanResources.Employee E, Person.Contact C  
WHERE  E.EmployeeID = C.ContactID  
AND    E.EmployeeID=1  
FOR XML PATH, ELEMENTS XSINIL  

Este é o resultado:

<row xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"   
      EmpID="1">  
  <EmpName>  
    <First>Gustavo</First>  
    <Middle xsi:nil="true" />  
    <Last>Achong</Last>  
  </EmpName>  
</row>  

Por padrão, o modo PATH gera XML centrado em elemento. Portanto especificar a diretiva ELEMENTS em uma consulta em modo PATH não tem nenhum efeito. No entanto, conforme mostrado no exemplo anterior, a diretiva ELEMENTS é útil com XSINIL para gerar elementos para valores nulos.

Além da ID e do nome, a consulta a seguir recupera um endereço de funcionário. De acordo com o caminho nos nomes de coluna para colunas de endereço, um <>Addressfilho do elemento é adicionado aorow><elemento e os detalhes do endereço são adicionados como filhos do <Address> elemento.

SELECT EmployeeID   "@EmpID",   
       FirstName    "EmpName/First",   
       MiddleName   "EmpName/Middle",   
       LastName     "EmpName/Last",  
       AddressLine1 "Address/AddrLine1",  
       AddressLine2 "Address/AddrLIne2",  
       City         "Address/City"  
FROM   HumanResources.Employee E, Person.Contact C, Person.Address A  
WHERE  E.EmployeeID = C.ContactID  
AND    E.AddressID = A.AddressID  
AND    E.EmployeeID=1  
FOR XML PATH  

Este é o resultado:

<row EmpID="1">  
  <EmpName>  
    <First>Gustavo</First>  
    <Last>Achong</Last>  
  </EmpName>  
  <Address>  
    <AddrLine1>7726 Driftwood Drive</AddrLine1>  
    <City>Monroe</City>  
  </Address>  
</row>  

Várias colunas compartilham o mesmo prefixo

Se várias colunas subsequentes compartilharem o mesmo prefixo de caminho, elas serão agrupadas sob o mesmo nome. Se diferentes prefixos de namespace estiverem sendo usados, mesmo que estejam associados ao mesmo namespace, um caminho será considerado diferente. Na consulta anterior, as colunas FirstName, MiddleName e LastName compartilham o mesmo prefixo EmpName. Portanto, eles são adicionados como filhos do <EmpName> elemento . Esse também é o caso quando você estava criando o <Address> elemento no exemplo anterior.

Uma coluna tem um nome diferente

Se uma coluna com um nome diferente aparecer no meio, ela quebrará o agrupamento, conforme mostrado na seguinte consulta modificada. A consulta quebra o agrupamento de FirstName, MiddleName e LastName, conforme especificado na consulta anterior, adicionando colunas de endereço no meio das colunas FirstName e MiddleName.

SELECT EmployeeID "@EmpID",   
       FirstName "EmpName/First",   
       AddressLine1 "Address/AddrLine1",  
       AddressLine2 "Address/AddrLIne2",  
       City "Address/City",  
       MiddleName "EmpName/Middle",   
       LastName "EmpName/Last"  
FROM   HumanResources.EmployeeAddress E, Person.Contact C, Person.Address A  
WHERE  E.EmployeeID = C.ContactID  
AND    E.AddressID = A.AddressID  
AND    E.EmployeeID=1  
FOR XML PATH  

Como resultado, a consulta cria dois <EmpName> elementos. O primeiro <EmpName> elemento tem o <FirstName> elemento filho e o segundo <EmpName> elemento tem os filhos doMiddleName><elemento e .<LastName>

Este é o resultado:

<row EmpID="1">  
  <EmpName>  
    <First>Gustavo</First>  
  </EmpName>  
  <Address>  
    <AddrLine1>7726 Driftwood Drive</AddrLine1>  
    <City>Monroe</City>  
  </Address>  
  <EmpName>  
    <Last>Achong</Last>  
  </EmpName>  
</row>  

Consulte Também

Usar o modo PATH com FOR XML