Bagikan melalui

Membuat Skema XSD Sebaris

Dalam klausul FOR XML, Anda bisa meminta kueri mengembalikan skema sebaris bersama dengan hasil kueri. Jika Anda menginginkan skema XDR, Anda menggunakan kata kunci XMLDATA dalam klausa FOR XML. Jika Anda menginginkan skema XSD, Anda menggunakan kata kunci XMLSCHEMA.

Topik ini menjelaskan kata kunci XMLSCHEMA dan menjelaskan struktur skema XSD sebaris yang dihasilkan. Berikut ini adalah batasan saat Anda meminta skema sebaris:

  • Anda hanya dapat menentukan XMLSCHEMA dalam mode RAW dan AUTO, bukan dalam mode EKSPLISIT.

  • Jika kueri XML bersarang menentukan direktif TYPE, hasil kueri berjenis xml, dan hasil ini dianggap sebagai instans data XML tidak bertipe. Untuk informasi selengkapnya, lihat Data XML (SQL Server).

Saat Anda menentukan XMLSCHEMA dalam kueri FOR XML, Anda menerima data skema dan XML, hasil kueri. Setiap elemen data tingkat atas mengacu pada skema sebelumnya dengan menggunakan deklarasi namespace default yang kemudian mengacu pada namespace target skema sebaris.

Contohnya:

<xsd:schema targetNamespace="urn:schemas-microsoft-com:sql:SqlRowSet1" xmlns:schema="urn:schemas-microsoft-com:sql:SqlRowSet1" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:sqltypes="https://schemas.microsoft.com/sqlserver/2004/sqltypes" elementFormDefault="qualified">  
  <xsd:import namespace="https://schemas.microsoft.com/sqlserver/2004/sqltypes" schemaLocation="https://schemas.microsoft.com/sqlserver/2004/sqltypes/sqltypes.xsd" />  
  <xsd:element name="Production.ProductModel">  
    <xsd:complexType>  
      <xsd:attribute name="ProductModelID" type="sqltypes:int" use="required" />  
      <xsd:attribute name="Name" use="required">  
        <xsd:simpleType sqltypes:sqlTypeAlias="[AdventureWorks2012].[dbo].[Name]">  
          <xsd:restriction base="sqltypes:nvarchar" sqltypes:localeId="1033" sqltypes:sqlCompareOptions="IgnoreCase IgnoreKanaType IgnoreWidth" sqltypes:sqlSortId="52">  
            <xsd:maxLength value="50" />  
          </xsd:restriction>  
        </xsd:simpleType>  
      </xsd:attribute>  
    </xsd:complexType>  
  </xsd:element>  
</xsd:schema>  
<Production.ProductModel xmlns="urn:schemas-microsoft-com:sql:SqlRowSet1" ProductModelID="1" Name="Classic Vest" />

Hasilnya mencakup skema XML dan hasil XML. Elemen <ProductModel> tingkat atas dalam hasil mengacu pada skema dengan menggunakan deklarasi namespace default, xmlns="urn:schemas-microsoft-com:sql:SqlRowSet1" .

Bagian skema dari hasil mungkin berisi beberapa dokumen skema yang menjelaskan beberapa namespace. Minimal, dua dokumen skema berikut dikembalikan:

  • Satu dokumen skema untuk namespace Sqltypes, dan untuk mana jenis dasar SQL tersebut dikembalikan.

  • Dokumen skema lain yang menjelaskan bentuk hasil kueri FOR XML.

Selain itu, jika ada tipe data yang diketik xml yang disertakan dalam hasil kueri, skema yang terkait dengan jenis data yang diketik xml tersebut disertakan.

Namespace target dari dokumen skema yang menggambarkan bentuk hasil FOR XML berisi bagian tetap dan bagian numerik yang berubah secara otomatis. Format namespace ini diperlihatkan dalam berikut ini di mana n adalah bilangan bulat positif. Misalnya, dalam kueri sebelumnya, urn:schemas-microsoft-com:sql:SqlRowSet1 adalah namespace target.

urn:schemas-microsoft-com:sql:SqlRowSetn

Perubahan namespace target dalam hasil yang terjadi dari satu eksekusi ke eksekusi lainnya mungkin tidak diinginkan. Misalnya, jika Anda mengkueri XML yang dihasilkan, perubahan dalam namespace layanan target akan mengharuskan Anda memperbarui kueri Anda. Anda dapat secara opsional menentukan namespace layanan target saat opsi XMLSCHEMA ditambahkan dalam klausa FOR XML. XML yang dihasilkan akan menyertakan namespace yang Anda berikan dan akan tetap sama, terlepas dari berapa kali Anda menjalankan kueri.

SELECT ProductModelID, Name  
FROM   Production.ProductModel  
WHERE ProductModelID=1  
FOR XML AUTO, XMLSCHEMA ('MyURI')

Elemen Entitas

Untuk membahas detail struktur skema XSD yang dihasilkan untuk hasil kueri, elemen entitas harus terlebih dahulu dijelaskan

Elemen entitas dalam data XML yang dikembalikan oleh kueri FOR XML adalah elemen yang dihasilkan dari tabel dan bukan dari kolom. Misalnya, kueri FOR XML berikut mengembalikan informasi kontak dari Person tabel dalam AdventureWorks2012 database.

SELECT BusinessEntityID, FirstName  
FROM Person.Person  
WHERE BusinessEntityID = 1  
FOR XML AUTO, ELEMENTS

Ini adalah hasilnya:

<Person>

<BusinessEntityID>1</BusinessEntityID>

<FirstName>Ken</FirstName>

</Person>

Dalam hasil ini, <Person> adalah elemen entitas. Mungkin ada beberapa elemen entitas dalam hasil XML dan masing-masing memiliki deklarasi global dalam skema XSD sebaris. Misalnya, kueri berikut mengambil header pesanan penjualan dan informasi detail untuk pesanan tertentu.

SELECT  SalesOrderHeader.SalesOrderID, ProductID, OrderQty  
FROM    Sales.SalesOrderHeader, Sales.SalesOrderDetail  
WHERE   SalesOrderHeader.SalesOrderID = SalesOrderDetail.SalesOrderID  
AND     SalesOrderHeader.SalesOrderID=5001  
FOR XML AUTO, ELEMENTS, XMLSCHEMA

Karena kueri menentukan arahan ELEMENTS, XML yang dihasilkan berpusat pada elemen. Kueri juga menentukan perintah XMLSCHEMA. Oleh karena itu, dikembalikan skema XSD sebaris. Ini adalah hasilnya:

<xsd:schema targetNamespace="urn:schemas-microsoft-com:sql:SqlRowSet1" xmlns:schema="urn:schemas-microsoft-com:sql:SqlRowSet1" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:sqltypes="https://schemas.microsoft.com/sqlserver/2004/sqltypes" elementFormDefault="qualified">

<xsd:import namespace="https://schemas.microsoft.com/sqlserver/2004/sqltypes" schemaLocation="https://schemas.microsoft.com/sqlserver/2004/sqltypes/sqltypes.xsd" />

<xsd:element name="Sales.SalesOrderHeader">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="SalesOrderID" type="sqltypes:int" />

<xsd:element ref="schema:Sales.SalesOrderDetail" minOccurs="0" maxOccurs="unbounded" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="Sales.SalesOrderDetail">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="ProductID" type="sqltypes:int" />

<xsd:element name="OrderQty" type="sqltypes:smallint" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

Perhatikan hal berikut ini dari kueri sebelumnya:

  • Dalam hasilnya, <SalesOrderHeader> dan <SalesOrderDetail> merupakan elemen entitas. Karena itu, mereka secara global dinyatakan dalam skema. Artinya, deklarasi muncul di tingkat atas di dalam <Schema> elemen .

  • < > SalesOrderID,ProductID>< , dan <OrderQty> bukan elemen entitas, karena dipetakan ke kolom. Data kolom dikembalikan sebagai elemen dalam XML, karena arahan ELEMENTS. Ini dipetakan ke elemen-elemen lokal dari tipe kompleks elemen entitas. Perhatikan bahwa jika arahan ELEMENTS tidak disebutkan, nilai SalesOrderID, ProductID, dan OrderQty dipetakan ke atribut lokal dari tipe kompleks elemen entitas yang sesuai.

Bentrokan Nama Atribut

Diskusi berikut didasarkan pada tabel CustOrder dan CustOrderDetail. Untuk menguji sampel berikut, buat tabel ini dan tambahkan data sampel Anda sendiri:

CREATE TABLE CustOrder (OrderID int primary key, CustomerID int)  
GO  
CREATE TABLE CustOrderDetail (OrderID int, ProductID int, Qty int)  
GO

Di FOR XML, nama yang sama terkadang digunakan untuk menunjukkan properti, atribut yang berbeda. Misalnya, kueri mode RAW yang ber sentris atribut berikut menghasilkan dua atribut yang memiliki nama yang sama, OrderID. Ini menghasilkan kesalahan.

SELECT CustOrder.OrderID,   
       CustOrderDetail.ProductID,   
       CustOrderDetail.OrderID  
FROM   dbo.CustOrder, dbo.CustOrderDetail  
WHERE  CustOrder.OrderID = CustOrderDetail.OrderID  
FOR XML RAW, XMLSCHEMA

Namun, karena dapat diterima untuk memiliki dua elemen yang memiliki nama yang sama, Anda dapat menghilangkan masalah dengan menambahkan arahan ELEMENTS:

SELECT CustOrder.OrderID,  
       CustOrderDetail.ProductID,   
       CustOrderDetail.OrderID  
from   dbo.CustOrder, dbo.CustOrderDetail  
where  CustOrder.OrderID = CustOrderDetail.OrderID  
FOR XML RAW, XMLSCHEMA, ELEMENTS

Ini adalah hasilnya. Perhatikan dalam skema XSD sebaris, elemen OrderID ditentukan dua kali. Salah satu deklarasi memiliki minOccurs yang diatur ke 0, sesuai dengan OrderID dari tabel CustOrderDetail, dan yang kedua secara default dipetakan ke kolom kunci utama OrderID dari tabel CustOrder di mana minOccurs diatur ke 1.

<xsd:schema targetNamespace="urn:schemas-microsoft-com:sql:SqlRowSet1" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:sqltypes="https://schemas.microsoft.com/sqlserver/2004/sqltypes" elementFormDefault="qualified">

<xsd:import namespace="https://schemas.microsoft.com/sqlserver/2004/sqltypes" schemaLocation="https://schemas.microsoft.com/sqlserver/2004/sqltypes/sqltypes.xsd" />

<xsd:element name="row">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="OrderID" type="sqltypes:int" />

<xsd:element name="ProductID" type="sqltypes:int" minOccurs="0" />

<xsd:element name="OrderID" type="sqltypes:int" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

Bentrokan Nama Elemen

Di FOR XML, nama yang sama dapat digunakan untuk menunjukkan dua subelemen. Misalnya, kueri berikut mengambil nilai ListPrice dan DealerPrice produk, tetapi kueri menentukan alias yang sama, Harga, untuk dua kolom ini. Oleh karena itu, himpunan baris yang dihasilkan akan memiliki dua kolom dengan nama yang sama.

Kasus 1: Kedua subelemen adalah kolom non-kunci dengan jenis yang sama dan dapat berupa NULL

Dalam kueri berikut, kedua sublemen adalah kolom non-kunci dengan jenis yang sama dan bisa NULL.

DROP TABLE T  
go  
CREATE TABLE T (ProductID int primary key, ListPrice money, DealerPrice money)  
go  
INSERT INTO T values (1, 1.25, null)  
go  
  
SELECT ProductID, ListPrice Price, DealerPrice Price  
FROM   T  
for    XML RAW, ELEMENTS, XMLSCHEMA

Ini adalah XML terkait yang dihasilkan. Hanya sebagian kecil dari sebaris XSD yang ditampilkan.

...

<xsd:schema targetNamespace="urn:schemas-microsoft-com:sql:SqlRowSet1" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:sqltypes="https://schemas.microsoft.com/sqlserver/2004/sqltypes" elementFormDefault="qualified">

<xsd:import namespace="https://schemas.microsoft.com/sqlserver/2004/sqltypes" />

<xsd:element name="row">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="ProductID" type="sqltypes:int" />

<xsd:element name="Price" type="sqltypes:money" minOccurs="0" maxOccurs="2" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

<row xmlns="urn:schemas-microsoft-com:sql:SqlRowSet1">

<ProductID>1</ProductID>

<Price>1.2500</Price>

</row>

Perhatikan hal berikut dalam skema XSD sebaris:

  • ListPrice dan DealerPrice memiliki jenis yang sama, money, dan keduanya dapat berupa NULL dalam tabel. Oleh karena itu, karena mungkin tidak dikembalikan dalam XML yang dihasilkan, hanya ada satu <Price> elemen turunan <row> dalam deklarasi jenis kompleks elemen yang memiliki minOccurs=0 dan maxOccurs=2.

  • Dalam hasilnya, karena DealerPrice nilainya adalah NULL dalam tabel, hanya ListPrice dikembalikan sebagai <Price> elemen. Jika Anda menambahkan parameter XSINIL ke dalam arahan ELEMENTS, Anda akan menerima elemen-elemen yang memiliki nilai xsi:nil yang diatur ke TRUE untuk elemen <Price> yang sesuai dengan DealerPrice. Anda juga akan menerima dua <Price> elemen anak dalam <row> definisi jenis kompleks dalam skema XSD sebaris dengan atribut nillable diatur ke TRUE untuk keduanya. Fragmen ini adalah hasil parsial:

...

<xsd:schema targetNamespace="urn:schemas-microsoft-com:sql:SqlRowSet1" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:sqltypes="https://schemas.microsoft.com/sqlserver/2004/sqltypes" elementFormDefault="qualified">

<xsd:import namespace="https://schemas.microsoft.com/sqlserver/2004/sqltypes" />

<xsd:element name="row">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="ProductID" type="sqltypes:int" nillable="1" />

<xsd:element name="Price" type="sqltypes:money" nillable="1" />

<xsd:element name="Price" type="sqltypes:money" nillable="1" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

<row xmlns="urn:schemas-microsoft-com:sql:SqlRowSet1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<ProductID>1</ProductID>

<Price>1.2500</Price>

<Price xsi:nil="true" />

</row>

Kasus 2: Satu kunci dan satu kolom non-kunci dengan jenis yang sama

Kueri berikut mengilustrasikan satu kunci dan satu kolom non-kunci dengan jenis yang sama.

CREATE TABLE T (Col1 int primary key, Col2 int, Col3 nvarchar(20))  
go  
INSERT INTO T VALUES (1, 1, 'test')  
go

Kueri berikut terhadap tabel T menentukan alias yang sama untuk Col1 dan Col2, di mana Col1 adalah kunci utama dan tidak boleh null, dan Col2 bisa null. Ini menghasilkan dua elemen saudara yang merupakan anak dari <row> elemen .

SELECT Col1 as Col, Col2 as Col, Col3  
FROM T  
FOR XML RAW, ELEMENTS, XMLSCHEMA

Ini adalah hasilnya. Hanya fragmen skema XSD sebaris yang ditampilkan.

...

<xsd:schema targetNamespace="urn:schemas-microsoft-com:sql:SqlRowSet1" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:sqltypes="https://schemas.microsoft.com/sqlserver/2004/sqltypes" elementFormDefault="qualified">

<xsd:import namespace="https://schemas.microsoft.com/sqlserver/2004/sqltypes" />

<xsd:element name="row">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="Col" type="sqltypes:int" />

<xsd:element name="Col" type="sqltypes:int" minOccurs="0" />

<xsd:element name="Col3" minOccurs="0">

<xsd:simpleType>

<xsd:restriction base="sqltypes:nvarchar"

sqltypes:localeId="1033"

sqltypes:sqlCompareOptions="IgnoreCase

IgnoreKanaType IgnoreWidth"

sqltypes:sqlSortId="52">

<xsd:maxLength value="20" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

<row xmlns="urn:schemas-microsoft-com:sql:SqlRowSet1">

<Col>1</Col>

<Col>1</Col>

<Col3>test</Col3>

</row>

Perhatikan dalam skema XSD sebaris bahwa elemen <Col> yang sesuai dengan Col2 disetel ke minOccurs 0.

Kasus 3: Kedua elemen dari berbagai jenis dan kolom terkait dapat berupa NULL

Kueri berikut ditentukan terhadap tabel sampel yang diperlihatkan dalam kasus 2:

SELECT Col1, Col2 as Col, Col3 as Col  
FROM T  
FOR XML RAW, ELEMENTS, XMLSCHEMA

Dalam kueri berikut, Col2 dan Col3 diberi alias yang sama. Ini menghasilkan dua elemen saudara yang memiliki nama yang sama dan keduanya merupakan anak dari <raw> elemen dalam hasilnya. Kedua kolom ini memiliki tipe yang berbeda dan keduanya dapat berupa NULL. Ini adalah hasilnya. Hanya sebagian skema XSD sebaris yang ditampilkan.

...

<xsd:schema targetNamespace="urn:schemas-microsoft-com:sql:SqlRowSet1" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:sqltypes="https://schemas.microsoft.com/sqlserver/2004/sqltypes" elementFormDefault="qualified">

<xsd:import namespace="https://schemas.microsoft.com/sqlserver/2004/sqltypes" />

<xsd:simpleType name="Col1">

<xsd:restriction base="sqltypes:int" />

</xsd:simpleType>

<xsd:simpleType name="Col2">

<xsd:restriction base="sqltypes:nvarchar" sqltypes:localeId="1033"

sqltypes:sqlCompareOptions="IgnoreCase

IgnoreKanaType IgnoreWidth" sqltypes:sqlSortId="52">

<xsd:maxLength value="20" />

</xsd:restriction>

</xsd:simpleType>

<xsd:element name="row">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="Col1" type="sqltypes:int" />

<xsd:element name="Col" minOccurs="0" maxOccurs="2" type="xsd:anySimpleType" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

<row xmlns="urn:schemas-microsoft-com:sql:SqlRowSet1">

<Col1>1</Col1>

<Col xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:type="Col1">1</Col>

<Col xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:type="Col2">test</Col>

</row>

Perhatikan hal berikut dalam skema XSD sebaris:

  • Karena Col2 dan Col3 dapat berupa NULL, <Col> deklarasi elemen menentukan minOccurs sebagai 0 dan maxOccurs sebagai 2.

  • Karena kedua elemen tersebut <Col> adalah saudara kandung, ada satu deklarasi elemen dalam skema. Selain itu, karena kedua elemen juga memiliki jenis yang berbeda, meskipun keduanya adalah jenis sederhana, jenis elemen dalam skema adalah xsd:anySimpleType. Dalam hasilnya, setiap jenis instans diidentifikasi oleh xsi:type atribut .

  • Dalam hasilnya, setiap elemen instans <Col> mengacu pada jenis instansnya dengan menggunakan atribut xsi:type.

  • Last updated on