Bagikan melalui

Koleksi skema XML dalam proyek SQL

Aplikasi ke:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL dalam database Microsoft Fabric

Proyek database SQL mendukung pembuatan otomatis objek pengumpulan skema XML dari file XSD (Definisi Skema XML). Saat Anda menyertakan file XSD dalam proyek Anda dengan metadata yang sesuai, proses build membuat CREATE XML SCHEMA COLLECTION pernyataan yang dapat Anda gunakan untuk memberlakukan validasi data XML di database Anda.

Koleksi skema XML menyediakan kolom XML yang diketik di SQL Server, memungkinkan mesin database memvalidasi data XML terhadap skema yang ditentukan dan mengoptimalkan performa kueri.

Mengonfigurasi file XSD dalam proyek

Untuk menghasilkan koleksi skema XML dari file XSD, tambahkan Build item ke file proyek Anda (.sqlproj) dengan dua elemen metadata yang diperlukan:

  • RelationalSchema: Skema database tempat koleksi skema XML dibuat (misalnya, dbo)
  • XMLSchemaCollectionName: Nama objek pengumpulan skema XML yang dihasilkan dalam database

Contoh berikut menunjukkan cara mengonfigurasi file XSD dalam proyek SQL:

<?xml version="1.0" encoding="utf-8"?>
<Project DefaultTargets="Build">
  <Sdk Name="Microsoft.Build.Sql" Version="2.1.0" />
  <PropertyGroup>
    <Name>MyDatabase</Name>
    <DSP>Microsoft.Data.Tools.Schema.Sql.Sql170DatabaseSchemaProvider</DSP>
    <ModelCollation>1033, CI</ModelCollation>
  </PropertyGroup>
  <ItemGroup>
    <Build Include="OrderSchema.xsd">
      <RelationalSchema>dbo</RelationalSchema>
      <XMLSchemaCollectionName>OrderSchemaCollection</XMLSchemaCollectionName>
    </Build>
  </ItemGroup>
</Project>

Contoh file XSD

File XSD menentukan struktur yang harus diikuti data XML. Contoh berikut mendefinisikan skema untuk elemen yang Order berisi satu atau beberapa Item elemen:

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="Order">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="Item" type="xs:string" maxOccurs="unbounded"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

Saat proyek dibangun, file XSD ini menghasilkan CREATE XML SCHEMA COLLECTION pernyataan yang membuat OrderSchemaCollection objek dalam dbo skema.

Menggunakan kolom XML bertipe

Setelah kumpulan skema XML ditentukan, referensikan dalam definisi tabel untuk membuat kolom XML yang diketik. Kolom XML yang diketik memvalidasi data terhadap skema dan meningkatkan performa kueri.

Contoh berikut membuat tabel dengan kolom XML yang diketik yang menggunakan koleksi skema yang dihasilkan:

CREATE TABLE dbo.Orders (
    Id INT PRIMARY KEY,
    OrderData XML(dbo.OrderSchemaCollection)
);

Saat Anda menyisipkan data ke kolom OrderData, SQL Server memvalidasi XML terhadap skema OrderSchemaCollection. XML tidak valid yang tidak sesuai dengan skema ditolak.

Konten terkait

  • Last updated on