Sintaks Dasar Klausul FOR XML

Mode FOR XML dapat berupa RAW, AUTO, EXPLICIT, atau PATH. Ini menentukan bentuk XML yang dihasilkan.

Penting

Direktif XMLDATA ke opsi FOR XML tidak digunakan lagi. Gunakan pembuatan XSD dalam kasus mode RAW dan AUTO. Tidak ada penggantian untuk direktif XMLDATA dalam mode EXPLICT. Fitur ini akan dihapus dalam versi Microsoft SQL Server di masa mendatang. Hindari menggunakan fitur ini dalam pekerjaan pengembangan baru, dan rencanakan untuk memodifikasi aplikasi yang saat ini menggunakan fitur ini.

Berikut ini adalah sintaks dasar yang dijelaskan dalam Klausul FOR (Transact-SQL):

[ FOR { BROWSE | <XML> } ]  
<XML> ::=  
XML   
    {   
      { RAW [ ('ElementName') ] | AUTO }   
        [   
           <CommonDirectives>   
           [ , { XMLDATA | XMLSCHEMA [ ('TargetNameSpaceURI') ]} ]   
           [ , ELEMENTS [ XSINIL | ABSENT ]   
        ]  
      | EXPLICIT   
        [   
           <CommonDirectives>   
           [ , XMLDATA ]   
        ]  
      | PATH [ ('ElementName') ]   
        [   
           <CommonDirectives>   
           [ , ELEMENTS [ XSINIL | ABSENT ] ]  
        ]  
     }   
  
 <CommonDirectives> ::=   
   [ , BINARY BASE64 ]  
   [ , TYPE ]  
   [ , ROOT [ ('RootName') ] ]  

Argumen

RAW[('ElementName')]
Mengambil hasil kueri dan mengubah setiap baris dalam hasil yang diatur menjadi elemen XML yang memiliki pengidentifikasi generik, <baris />, sebagai tag elemen. Anda dapat secara opsional menentukan nama untuk elemen baris saat Anda menggunakan direktif ini. XML yang dihasilkan akan menggunakan ElementName yang ditentukan sebagai elemen baris yang dihasilkan untuk setiap baris. Untuk informasi selengkapnya, lihat Menggunakan Mode RAW dengan FOR XML.

Mobil
Mengembalikan hasil kueri di pohon XML berlapis sederhana. Setiap tabel dalam klausa FROM yang setidaknya satu kolomnya tercantum dalam klausa SELECT diwakili sebagai elemen XML. Kolom yang tercantum dalam klausa SELECT dipetakan ke atribut elemen yang sesuai. Untuk informasi selengkapnya, lihat Menggunakan Mode OTOMATIS dengan FOR XML.

EKSPLISIT
Menentukan bahwa bentuk pohon XML yang dihasilkan ditentukan secara eksplisit. Dengan menggunakan mode ini, kueri harus ditulis dengan cara tertentu sehingga jenis informasi tambahan tentang pemasangan bersarang yang Anda inginkan ditentukan secara eksplisit. Untuk informasi selengkapnya, lihat Menggunakan Mode EKSPLISIT dengan FOR XML.

JALAN
Menyediakan cara yang lebih sederhana untuk mencampur elemen dan atribut, dan untuk memperkenalkan sarang tambahan untuk mewakili properti yang kompleks. Anda dapat menggunakan kueri mode EKSPLISIT FOR XML untuk membuat XML semacam ini dari set baris, tetapi mode PATH menyediakan alternatif yang lebih sederhana untuk kueri mode EKSPLISIT yang mungkin rumit. Mode PATH, bersama dengan kemampuan untuk menulis kueri XML berlapis dan direktif TYPE untuk mengembalikan instans jenis xml , memungkinkan Anda menulis kueri dengan kompleksitas yang lebih sedikit. Ini menyediakan alternatif untuk menulis kueri dalam mode yang paling eksplisit. Secara default, mode PATH menghasilkan pembungkus <elemen baris> untuk setiap baris dalam tataan hasil. Anda dapat secara opsional menentukan nama elemen. Jika Anda melakukannya, nama yang ditentukan digunakan sebagai nama elemen pembungkus. Jika Anda menyediakan string kosong (UNTUK JALUR XML ('')), tidak ada elemen pembungkus yang dihasilkan. Untuk informasi selengkapnya, lihat Menggunakan Mode JALUR dengan FOR XML.

XMLDATA
Menentukan bahwa skema inline XML-Data Reduced (XDR) harus dikembalikan. Skema ditambahkan ke dokumen sebagai skema sebaris. Untuk sampel kerja, lihat Menggunakan Mode RAW dengan FOR XML.

XMLSCHEMA
Mengembalikan Skema XML W3C sebaris (XSD). Anda dapat secara opsional menentukan URI namespace target saat menentukan direktif ini. Ini mengembalikan namespace yang ditentukan dalam skema. Untuk informasi selengkapnya, lihat Membuat Skema XSD Sebaris. Untuk sampel kerja, lihat Menggunakan Mode RAW dengan FOR XML.

ELEMEN
Jika opsi ELEMENTS ditentukan, kolom dikembalikan sebagai subelemen. Jika tidak, atribut tersebut dipetakan ke atribut XML. Opsi ini hanya didukung dalam mode RAW, AUTO, dan PATH. Anda dapat secara opsional menentukan XSINIL atau ABSENT saat anda menggunakan direktif ini. XSINIL menentukan bahwa elemen yang memiliki atribut xsi:nil diatur ke True dibuat untuk nilai kolom NULL. Secara default atau ketika ABSENT ditentukan bersama dengan ELEMENTS, tidak ada elemen yang dibuat untuk nilai NULL. Untuk sampel kerja, lihat Menggunakan Mode RAW dengan FOR XML dan Menggunakan Mode OTOMATIS dengan FOR XML.

BINER BASE64
Jika opsi BINARY Base64 ditentukan, data biner apa pun yang dikembalikan oleh kueri diwakili dalam format yang dikodekan base64. Untuk mengambil data biner dengan menggunakan mode RAW dan EXPLICIT, opsi ini harus ditentukan. Dalam mode OTOMATIS, data biner dikembalikan sebagai referensi secara default. Untuk sampel kerja, lihat Menggunakan Mode RAW dengan FOR XML.

JENIS
Menentukan bahwa kueri mengembalikan hasil sebagai jenis xml . Untuk informasi selengkapnya, lihat DIREKTIF TIPE di Untuk Kueri XML.

ROOT [('RootName')]
Menentukan bahwa elemen tingkat atas tunggal ditambahkan ke XML yang dihasilkan. Anda dapat secara opsional menentukan nama elemen akar yang akan dihasilkan. Nilai defaultnya adalah "root".

Lihat Juga

Gunakan Mode RAW dengan FOR XML
Menggunakan Mode OTOMATIS dengan FOR XML
Gunakan Mode EKSPLISIT dengan FOR XML
Gunakan Mode JALUR dengan FOR XML
SELECT (Transact-SQL)
UNTUK XML (SQL Server)