CREATE XML SCHEMA COLLECTION (Transact-SQL)

將結構描述元件匯入資料庫中。

Transact-SQL 語法慣例

語法

CREATE XML SCHEMA COLLECTION [ <relational_schema>. ]sql_identifier AS Expression

引數

• relational_schema
  識別關聯式結構描述名稱。若未指定，則會假設使用預設的關聯式結構描述。

• sql_identifier
  這是 XML 結構描述集合的 SQL 識別碼。

• Expression
  這是字串常數或純量變數。這是 varchar、varbinary、nvarchar 或 xml 類型。

備註

您也可以利用 ALTER XML SCHEMA COLLECTION 將新命名空間加入集合中，或將新元件加入集合的現有命名空間中。

若要移除集合，請使用＜DROP XML SCHEMA COLLECTION (Transact-SQL)＞。

權限

若要建立 XML SCHEMA COLLECTION，至少需要下列權限集合之一：

• 伺服器的 CONTROL 權限

• 伺服器的 ALTER ANY DATABASE 權限

• 資料庫的 ALTER 權限

• 資料庫的 CONTROL 權限

• 資料庫的 ALTER ANY SCHEMA 權限和 CREATE XML SCHEMA COLLECTION 權限

• 關聯式結構描述的 ALTER 或 CONTROL 權限和資料庫的 CREATE XML SCHEMA COLLECTION 權限

範例

A. 在資料庫中建立 XML 結構描述集合

下列範例會建立 XML 結構描述集合 ManuInstructionsSchemaCollection。這個集合只有一個結構描述命名空間。

-- Create a sample database in which to load the XML schema collection.
CREATE DATABASE SampleDB
GO
USE SampleDB
GO
CREATE XML SCHEMA COLLECTION ManuInstructionsSchemaCollection AS
N'<?xml version="1.0" encoding="UTF-16"?>
<xsd:schema targetNamespace="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions" 
   xmlns          ="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions" 
   elementFormDefault="qualified" 
   attributeFormDefault="unqualified"
   xmlns:xsd="http://www.w3.org/2001/XMLSchema" >

    <xsd:complexType name="StepType" mixed="true" >
        <xsd:choice  minOccurs="0" maxOccurs="unbounded" > 
            <xsd:element name="tool" type="xsd:string" />
            <xsd:element name="material" type="xsd:string" />
            <xsd:element name="blueprint" type="xsd:string" />
            <xsd:element name="specs" type="xsd:string" />
            <xsd:element name="diag" type="xsd:string" />
        </xsd:choice> 
    </xsd:complexType>

    <xsd:element  name="root">
        <xsd:complexType mixed="true">
            <xsd:sequence>
                <xsd:element name="Location" minOccurs="1" maxOccurs="unbounded">
                    <xsd:complexType mixed="true">
                        <xsd:sequence>
                            <xsd:element name="step" type="StepType" minOccurs="1" maxOccurs="unbounded" />
                        </xsd:sequence>
                        <xsd:attribute name="LocationID" type="xsd:integer" use="required"/>
                        <xsd:attribute name="SetupHours" type="xsd:decimal" use="optional"/>
                        <xsd:attribute name="MachineHours" type="xsd:decimal" use="optional"/>
                        <xsd:attribute name="LaborHours" type="xsd:decimal" use="optional"/>
                        <xsd:attribute name="LotSize" type="xsd:decimal" use="optional"/>
                    </xsd:complexType>
                </xsd:element>
            </xsd:sequence>
        </xsd:complexType>
    </xsd:element>
</xsd:schema>' ;
GO
-- Verify - list of collections in the database.
select *
from sys.xml_schema_collections
-- Verify - list of namespaces in the database.
select name
from sys.xml_schema_namespaces

-- Use it. Create a typed xml variable. Note collection name specified.
DECLARE @x xml (ManuInstructionsSchemaCollection)
GO
--Or create a typed xml column.
CREATE TABLE T (
        i int primary key, 
        x xml (ManuInstructionsSchemaCollection))
GO
-- Clean up
DROP TABLE T
GO
DROP XML SCHEMA COLLECTION ManuInstructionsSchemaCollection
Go
USE Master
GO
DROP DATABASE SampleDB

或者，您可以指派結構描述集合到變數中，並在 CREATE XML SCHEMA COLLECTION 陳述式中指定變數，如下所示：

DECLARE @MySchemaCollection nvarchar(max)
Set @MySchemaCollection  = N' copy the schema collection here'
CREATE XML SCHEMA COLLECTION MyCollection AS @MySchemaCollection 

範例中的變數屬於 nvarchar(max) 類型。變數也可以屬於 xml 資料類型，在這個情況下，變數會被隱含地轉換成字串。

如需詳細資訊，請參閱＜檢視儲存的 XML 結構描述集合＞。

您可以在 xml 類型資料行中儲存結構描述集合。在這個情況下，若要建立 XML 結構描述集合，請執行下列動作：

1. 使用 SELECT 陳述式從資料行擷取結構描述集合，並將之指派給 xml 類型或 varchar 類型的變數。

2. 在 CREATE XML SCHEMA COLLECTION 陳述式中指定變數名稱。

CREATE XML SCHEMA COLLECTION 只會儲存 SQL Server 暸解的結構描述元件；XML 結構描述中的所有項目都不會儲存在資料庫中。因此，如果您想要 XML 結構描述集合回復成和原來所提供的完全相同，建議您將 XML 結構描述儲存於資料庫資料行或電腦的其他資料夾中。

B. 在結構描述集合中指定多個結構描述命名空間

建立 XML 結構描述集合時，您也可以指定多個 XML 結構描述。例如：

CREATE XML SCHEMA COLLECTION MyCollection AS N'
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<!-- Contents of schema here -->  
</xsd:schema>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<!-- Contents of schema here -->
</xsd:schema>'

下列範例會建立包括兩個 XML 結構描述命名空間的 XML 結構描述集合 ProductDescriptionSchemaCollection。

CREATE XML SCHEMA COLLECTION ProductDescriptionSchemaCollection AS 
'<xsd:schema targetNamespace="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain"
    xmlns="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain" 
    elementFormDefault="qualified" 
    xmlns:xsd="http://www.w3.org/2001/XMLSchema" >
    <xsd:element name="Warranty"  >
        <xsd:complexType>
            <xsd:sequence>
                <xsd:element name="WarrantyPeriod" type="xsd:string"  />
                <xsd:element name="Description" type="xsd:string"  />
            </xsd:sequence>
        </xsd:complexType>
    </xsd:element>
</xsd:schema>
 <xs:schema targetNamespace="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription" 
    xmlns="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription" 
    elementFormDefault="qualified" 
    xmlns:mstns="http://tempuri.org/XMLSchema.xsd" 
    xmlns:xs="http://www.w3.org/2001/XMLSchema"
    xmlns:wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain" >
    <xs:import 
namespace="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain" />
    <xs:element name="ProductDescription" type="ProductDescription" />
        <xs:complexType name="ProductDescription">
            <xs:sequence>
                <xs:element name="Summary" type="Summary" minOccurs="0" />
            </xs:sequence>
            <xs:attribute name="ProductModelID" type="xs:string" />
            <xs:attribute name="ProductModelName" type="xs:string" />
        </xs:complexType>
        <xs:complexType name="Summary" mixed="true" >
            <xs:sequence>
                <xs:any processContents="skip" namespace="http://www.w3.org/1999/xhtml" minOccurs="0" maxOccurs="unbounded" />
            </xs:sequence>
        </xs:complexType>
</xs:schema>'
;
GO -- Clean up
DROP XML SCHEMA COLLECTION ProductDescriptionSchemaCollection
GO

C. 匯入不指定目標命名空間的結構描述

如果將不包含 targetNamespace 屬性的結構描述匯入集合中，其元件會與空字串目標命名空間關聯，如下列範例所示。請注意，不對匯入集合之一或多個結構描述進行關聯，會造成多個結構描述元件 (可能無關) 與預設空字串命名空間相關聯。

-- Create a collection that contains a schema with no target namespace.
CREATE XML SCHEMA COLLECTION MySampleCollection AS '
<schema xmlns="http://www.w3.org/2001/XMLSchema"  xmlns:ns="http://ns">
<element name="e" type="dateTime"/>
</schema>'
go
-- Query will return the names of all the collections that 
--contain a schema with no target namespace.
SELECT sys.xml_schema_collections.name 
FROM   sys.xml_schema_collections 
JOIN   sys.xml_schema_namespaces 
ON     sys.xml_schema_collections.xml_collection_id = 
       sys.xml_schema_namespaces.xml_collection_id 
WHERE  sys.xml_schema_namespaces.name=''

D. 使用 XML 結構描述集合和批次

在建立結構描述集合所在的同一批次中，不可以參考該結構描述集合。如果您嘗試在建立集合之同一批次中參考該集合，您會看到錯誤訊息，告訴您集合不存在。下列範例是有效的；然而，如果您移除 GO 而因此嘗試參考 XML 結構描述集合在同一批次中輸入 xml 變數，則會傳回錯誤。

CREATE XML SCHEMA COLLECTION mySC AS '
<schema xmlns="http://www.w3.org/2001/XMLSchema">
      <element name="root" type="string"/>
</schema>
'
GO
CREATE TABLE T (Col1 xml (mySC))
GO

請參閱

參考

ALTER XML SCHEMA COLLECTION (Transact-SQL)

DROP XML SCHEMA COLLECTION (Transact-SQL)

EVENTDATA (Transact-SQL)

DROP XML SCHEMA COLLECTION (Transact-SQL)

在伺服器上使用 XML 結構描述集合的指導方針與限制

概念

在 SQL Server 中實作 XML

比較不具類型的 XML 與具類型的 XML