Partilhar via


Colunas com um nome

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

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 arroba (@).

  • O nome da coluna não começa com 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 arroba (@) e não contiver uma barra (/), será criado um atributo do elemento row com o valor de coluna correspondente. Por exemplo, a consulta a seguir retorna um conjunto de linhas com duas colunas (@PmId, Name). No XML resultante, um atributo PmId é adicionado ao elemento row correspondente, e um valor de ProductModelID é atribuído a ele.

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

Este é o resultado:

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

Atributos devem vir antes de qualquer outro tipo de nó, 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;

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

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

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

SELECT 2 + 2 as result
for xml PATH;

Este é o resultado:

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

A consulta a seguir especifica o nome da coluna, ManuWorkCenterInformation, para o XML retornado pela XQuery especificada na coluna Instructions do tipo xml. Portanto, um elemento ManuWorkCenterInformation é adicionado como um filho do elemento row.

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

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 arroba (@) e contém uma barra (/)

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

Por exemplo, a consulta a seguir retorna um ID do funcionário e um nome que são representados como um elemento complexo EmpName que contém um nome First, Middle e Last.

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 os valores de ID do funcionário começa com '@'. Portanto, um atributo, EmpID, é adicionado ao elemento row. Todas as outras colunas incluem uma barra (/) no nome da coluna que indica a hierarquia. O XML resultante terá o filho EmpName sob o elemento row e o filho EmpName terá os filhos dos elementos First, Middle e Last.

<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 das colunas de endereço, um filho do elemento Address é adicionado ao elemento row e os detalhes do endereço são adicionados como filhos do elemento Address.

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 com o mesmo nome. Se diferentes prefixos de namespace estiverem sendo usados, mesmo que estejam limitados ao mesmo namespace, um caminho será considerado diferente. Na consulta anterior, as colunas FirstName, MiddleName e LastName compartilham o mesmo prefixo EmpName. Portanto, elas são adicionados como filhos do elemento EmpName. Esse também é o caso quando o elemento Address foi criado 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 entre as 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 elementos EmpName. O primeiro elemento EmpName tem o filho do elemento FirstName e o segundo elemento EmpName tem os filhos dos elementos MiddleName 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>

Confira também