UNTUK XML (SQL Server)

Berlaku untuk:SQL Server Azure SQL DatabaseAzure SQL Managed Instance

Kueri SELECT mengembalikan hasil sebagai kumpulan baris. Anda dapat secara opsional mengambil hasil formal kueri SQL sebagai XML dengan menentukan klausa FOR XML dalam kueri. Klausa FOR XML dapat digunakan dalam kueri tingkat atas dan dalam subkueri. Klausa FOR XML tingkat atas hanya dapat digunakan dalam pernyataan SELECT. Dalam subkueri, FOR XML dapat digunakan dalam pernyataan INSERT, UPDATE, dan DELETE. FOR XML juga dapat digunakan dalam pernyataan penugasan.

Dalam klausa FOR XML, Anda menentukan salah satu mode ini:

  • RAW
  • AUTO
  • EKSPLISIT
  • PATH

Mode RAW menghasilkan elemen baris> tunggal <per baris dalam kumpulan baris yang dikembalikan oleh pernyataan SELECT. Anda dapat membuat hierarki XML dengan menulis kueri XML berlapis.

Mode AUTO menghasilkan bersarang dalam XML yang dihasilkan dengan menggunakan heuristik berdasarkan cara pernyataan SELECT ditentukan. Anda memiliki kontrol minimal atas bentuk XML yang dihasilkan. Kueri XML BERlapis dapat ditulis untuk menghasilkan hierarki XML di luar bentuk XML yang dihasilkan oleh heuristik mode OTOMATIS.

Mode EKSPLISIT memungkinkan lebih banyak kontrol atas bentuk XML. Anda dapat mencampur atribut dan elemen sesuai kemauan dalam memutuskan bentuk XML. Ini memerlukan format tertentu untuk kumpulan baris yang dihasilkan karena eksekusi kueri. Format set baris ini kemudian dipetakan ke dalam bentuk XML. Kekuatan mode EKSPLISIT adalah mencampur atribut dan elemen sesering mungkin, membuat pembungkus dan properti kompleks berlapis, membuat nilai yang dipisahkan spasi (misalnya, atribut OrderID mungkin memiliki daftar nilai ID pesanan), dan konten campuran.

Namun, menulis kueri mode EKSPLISIT bisa rumit. Anda dapat menggunakan beberapa kemampuan FOR XML baru, seperti menulis kueri mode FOR XML RAW/AUTO/PATH berlapis dan direktif TYPE, alih-alih menggunakan mode EXPLICIT untuk menghasilkan hierarki. Kueri XML berlapis dapat menghasilkan XML apa pun yang dapat Anda hasilkan dengan menggunakan mode EKSPLISIT. Untuk informasi selengkapnya, lihat Menggunakan Kueri XML Berlapis danDirektif TYPE di Untuk Kueri XML.

Mode PATH bersama dengan kemampuan kueri FOR XML berlapis memberikan fleksibilitas mode EKSPLISIT dengan cara yang lebih sederhana.

Mode ini hanya berlaku untuk eksekusi kueri yang ditetapkan. Mereka tidak memengaruhi hasil kueri berikutnya.

UNTUK XML tidak valid untuk pilihan apa pun yang digunakan dengan klausa FOR BROWSE.

Contoh

Pernyataan berikut SELECT mengambil informasi dari Sales.Customer tabel dan Sales.SalesOrderHeader dalam AdventureWorks2012 database. Kueri ini menentukan mode dalam FOR XML klausaAUTO:

USE AdventureWorks2012
GO
SELECT Cust.CustomerID,
       OrderHeader.CustomerID,
       OrderHeader.SalesOrderID,
       OrderHeader.Status
FROM Sales.Customer Cust 
INNER JOIN Sales.SalesOrderHeader OrderHeader
ON Cust.CustomerID = OrderHeader.CustomerID
FOR XML AUTO;

Klausa FOR XML dan Nama Server

Saat pernyataan SELECT dengan klausul FOR XML menentukan nama empat bagian dalam kueri, nama server tidak dikembalikan dalam dokumen XML yang dihasilkan saat kueri dijalankan di komputer lokal. Namun, nama server dikembalikan sebagai nama empat bagian ketika kueri dijalankan di server jaringan.

Misalnya, pertimbangkan kueri ini:

SELECT TOP 1 LastName
  FROM ServerName.AdventureWorks2012.Person.Person
  FOR XML AUTO;

 

Server lokal: Ketika ServerName adalah server lokal, kueri mengembalikan teks berikut:

<AdventureWorks2012.Person.Person LastName="Achong" />  

 

Server jaringan: Ketika ServerName adalah server jaringan, kueri mengembalikan teks berikut:

<ServerName.AdventureWorks2012.Person.Person LastName="Achong" />

 

Hindari ambiguitas: Ambiguitas potensial ini dapat dihindari dengan menentukan alias ini:

SELECT TOP 1 LastName
  FROM ServerName.AdventureWorks2012.Person.Person x
  FOR XML AUTO;

Sekarang kueri yang disambiguasi mengembalikan teks berikut:

<x LastName="Achong"/>

Lihat juga

Sintaks Dasar Klausul FOR XML
Gunakan Mode RAW dengan FOR XML
Gunakan Mode OTOMATIS dengan FOR XML
Gunakan Mode EKSPLISIT dengan FOR XML
Gunakan Mode PATH dengan FOR XML
OPENXML (SQL Server)
Menambahkan Namespace ke Kueri dengan WITH XMLNAMESPACES