XML 結構描述集合 (SQL Server)

發行項
08/21/2023

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體

如 xml (Transact-SQL) 一文所說明，SQL Server 是透過 xml 資料類型來提供原生 XML 資料儲存體。您可以選擇透過 XML 結構描述集合，使 XSD 結構描述與類型的變數或資料行產生關聯。 XML 結構描述集合會儲存匯入的 XML 結構描述，然後用來執行下列作業：

驗證 XML 執行個體
當 XML 資料儲存在資料庫中時，設定其類型

XML 結構描述集合是一個中繼資料實體，就像資料庫中的資料表。您可以加以建立、修改及卸除。系統會將 CREATE XML SCHEMA COLLECTION (Transact-SQL) 陳述式中所指定的結構描述，自動匯入新建的 XML 結構描述集合物件中。您可以使用 ALTER XML SCHEMA COLLECTION (Transact-SQL) 陳述式，將其他的結構描述或結構描述元件匯入資料庫的現有集合物件中。

如比較具類型的 XML 與不具類型的 XML一文所說明，如果 XML 是儲存在相關聯結構描述的資料行或變數中，即為具類型的 XML，因為結構描述會提供執行個體資料所需的資料類型資訊。 SQL Server 會使用此類型資訊來將資料儲存最佳化。

查詢處理引擎也會使用結構描述來檢查類型，以及將查詢和資料修改最佳化。

此外，透過具類型的 xml，SQL Server 還會使用相關聯的 XML 結構描述集合來驗證 XML 執行個體。如果 XML 執行個體符合結構描述，資料庫就會允許執行個體以其類型資訊儲存在系統中。否則，資料庫會拒絕該執行個體。

您可以使用內建函數 XML_SCHEMA_NAMESPACE 來擷取儲存在資料庫中的結構描述集合。如需詳細資訊，請參閱檢視儲存的 XML 結構描述集合。

您也可以使用 XML 結構描述集合來輸入 XML 變數、參數及資料行。

管理結構描述集合的 DDL

您可以在資料庫中建立 XML 結構描述集合，然後將它們與 xml 類型的變數和資料行產生關聯。為了管理資料庫中的結構描述集合，SQL Server 提供下列 DDL 陳述式：

CREATE XML SCHEMA COLLECTION (Transact-SQL) 將結構描述元件匯入資料庫中。
ALTER XML SCHEMA COLLECTION (Transact-SQL) 修改現有 XML 結構描述集合中的結構描述元件。
DROP XML SCHEMA COLLECTION (Transact-SQL) 刪除整個 XML 結構描述集合及其所有的元件。

若要使用 XML 結構描述集合及其包含的結構描述，您必須先使用 CREATE XML SCHEMA COLLECTION 陳述式來建立集合和結構描述。在建立結構描述集合之後，您就可以建立類型的變數和資料行，並將結構描述集合與它們產生關聯。建立結構描述集合之後，各種結構描述元件會儲存在中繼資料內。您也可以使用 ALTER XML SCHEMA COLLECTION 將更多元件加入現有的結構描述，或將新的結構描述加入現有的集合。

若要卸除結構描述集合，請使用 DROP XML SCHEMA COLLECTION 陳述式。這會卸除集合中包含的所有結構描述，並移除集合物件。必須符合 DROP XML SCHEMA COLLECTION (Transact-SQL) 中描述的條件，才能卸除結構描述集合。

了解結構描述元件

當您使用 CREATE XML SCHEMA COLLECTION 陳述式時，會將各種結構描述元件匯入資料庫中。結構描述元件包括結構描述元素、屬性和類型定義。當您使用 DROP XML SCHEMA COLLECTION 陳述式時，整個集合都會移除。

CREATE XML SCHEMA COLLECTION 會將結構描述元件儲存到各種系統資料表中。

例如，請考慮下列結構描述：

<?xml version="1.0"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            targetNamespace="uri:Cust_Orders2"
            xmlns="uri:Cust_Orders2" >
  <xsd:attribute name="SomeAttribute" type="xsd:int" />
  <xsd:complexType name="SomeType" />
  <xsd:complexType name="OrderType" >
    <xsd:sequence>
      <xsd:element name="OrderDate" type="xsd:date" />
      <xsd:element name="RequiredDate" type="xsd:date" />
      <xsd:element name="ShippedDate" type="xsd:date" />
    </xsd:sequence>
    <xsd:attribute name="OrderID" type="xsd:ID" />
    <xsd:attribute name="CustomerID"  />
    <xsd:attribute name="EmployeeID"  />
  </xsd:complexType>
  <xsd:complexType name="CustomerType" >
     <xsd:sequence>
        <xsd:element name="Order" type="OrderType"
                     maxOccurs="unbounded" />
       </xsd:sequence>
      <xsd:attribute name="CustomerID" type="xsd:string" />
      <xsd:attribute name="OrderIDList" type="xsd:IDREFS" />
  </xsd:complexType>
  <xsd:element name="Customer" type="CustomerType" />
</xsd:schema>

以上的結構描述顯示可儲存於資料庫的不同類型元件，這些元件包括 SomeAttribute、 SomeType、 OrderType、 CustomerType、 Customer、 Order、 CustomerID、 OrderID、 OrderDate、 RequiredDate及 ShippedDate。

元件類別

儲存在資料庫中的「結構描述」元件可分成下列類別：

ELEMENT
ATTRIBUTE
TYPE (適用於簡單或複雜類型)
ATTRIBUTEGROUP
MODELGROUP

例如：

SomeAttribute 是 ATTRIBUTE 元件。
SomeType、OrderType 和 CustomerType 是 TYPE 元件。
Customer 是 ELEMENT 元件。

將結構描述匯入資料庫後，SQL Server 並不會儲存結構描述本身。不過，SQL Server 會儲存各種個別的元件。也就是說，不會儲存 <Schema> 標記，只是保留其中定義的元件。所有的結構描述元素都沒有保留。如果 <Schema> 標記包含指定其元件預設行為的屬性，則這些屬性會在匯入程序期間移到標記內的結構描述元件，如下表所示。

屬性名稱	行為
attributeFormDefault	form 屬性會套用到結構描述中尚未出現此屬性的所有屬性宣告上，而且其值會設定為 attributeFormDefault 屬性的值。
elementFormDefault	form 屬性會套用到結構描述中尚未出現此屬性的所有元素宣告上，而且其值會設定為 elementFormDefault 屬性的值。
blockDefault	block 屬性會套用到尚未出現此屬性的所有元素宣告和類型定義上，而且其值會設定為 blockDefault 屬性的值。
finalDefault	final 屬性會套用到尚未出現此屬性的所有元素宣告和類型定義上，而且其值會設定為 finalDefault 屬性的值。
targetNamespace	隸屬於目標命名空間之元件的詳細資訊會儲存在中繼資料內。

XML 結構描述集合的權限

您必須有必要權限，才能執行下列作業：

建立/載入 XML 結構描述集合
修改 XML 結構描述集合
卸除 XML 結構描述集合
使用 XML 結構描述集合來輸入 xml 類型的資料行、變數和參數，或者將它用在資料表或資料行條件約束中。

SQL Server 安全性模型允許在每個物件上都可以有 CONTROL 權限。此權限的被授與者可取得物件上的所有其他權限。物件的擁有者也擁有該物件的所有權限。

某物件上 CONTROL 權限的擁有者和被授與者，可以授與該物件上的任何權限。如果指定了 WITH GRANT OPTION，不是擁有者的使用者或沒有 CONTROL 權限的使用者仍可授與物件權限。例如，假設「使用者 A」透過 WITH GRANT OPTION，對於 XML 結構描述集合 S 擁有 REFERENCES 權限，但沒有其他權限。「使用者 A」可以授與「使用者 B」對於結構描述集合 S 的 REFERENCES 權限。

安全性模型也允許建立和使用 XML 結構描述集合的權限，或將所有權從某個使用者轉給另一個使用者的權限。下列文章說明 XML 結構描述集合權限。

授與 XML 結構描述集合的權限

本文討論如何授與權限以建立 XML 結構描述集合，以及如何授與 XML 結構描述集合物件的權限。
撤銷 XML 結構描述集合的權限

本文討論如何使用撤銷權限以防止建立 XML 結構描述集合，以及如何撤銷 XML 結構描述集合物件的權限。
拒絕 XML 結構描述集合的權限

本文討論如何拒絕建立 XML 結構描述集合的權限，以及拒絕 XML 結構描述集合物件的權限。

取得有關 XML 結構描述和結構描述集合的資訊

XML 結構描述集合會列舉在目錄檢視 sys.xml_schema_collections 中。 XML 結構描述集合 sys 是由系統定義。其包含預先定義的命名空間，您不需要明確地將其載入，即可用在所有使用者自訂的 XML 結構描述集合中。此清單包含 xml、xs、xsi、fn 和 xdt 的命名空間。另外二個目錄檢視為 sys.xml_schema_namespaces (列舉出每個 XML 結構描述集合中的所有命名空間)，以及 sys.xml_components (列舉出每個 XML 結構描述中的所有 XML 結構描述元件)。

內建函式 XML_SCHEMA_NAMESPACE (schemaName, XmlSchemacollectionName, namespace-uri) 會產生 xml 資料類型執行個體。此執行個體包含 XML 結構描述集合中所包含之結構描述的 XML 結構描述片段 (預先定義的 XML 結構描述除外)。

您可以用下列方法來列舉 XML 結構描述集合的內容：

在 XML 結構描述集合的適當目錄檢視上撰寫 Transact-SQL 查詢。
使用內建系統函式 XML_SCHEMA_NAMESPACE()。您可以將 xml 資料類型方法套用在此函數的輸出上。但是您不能修改基礎 XML 結構描述。

如下列範例所示。

範例

列舉 XML 結構描述集合中的 XML 命名空間

針對 XML 結構描述集合 myCollection 來使用下列查詢：

SELECT XSN.name
FROM    sys.xml_schema_collections XSC JOIN sys.xml_schema_namespaces XSN
    ON (XSC.xml_collection_id = XSN.xml_collection_id)
WHERE    XSC.name = 'myCollection';

列舉 XML 結構描述集合的內容

下列陳述式會列舉關聯式結構描述 dbo 中 XML 結構描述集合 myCollection 的內容。

SELECT XML_SCHEMA_NAMESPACE (N'dbo', N'myCollection');

您可以將目標命名空間指定為 XML_SCHEMA_NAMESPACE() 的第三個引數，以 xml資料類型執行個體的型式來取得集合中的個別 XML 結構描述。下列範例會顯示這一點。

從 XML 結構描述集合輸出指定的結構描述

下列陳述式會從關聯式結構描述 dbo 中的 XML 結構描述集合 myCollection，輸出含有 pretend 目標命名空間 https://www.microsoft.com/was-books 的 XML 結構描述。

SELECT XML_SCHEMA_NAMESPACE (N'dbo', N'myCollection',
N'https://www.microsoft.com/was-books')

查詢 XML 結構描述

您可以用下列方法來查詢您已載入至 XML 結構描述集合的 XML 結構描述：

在 XML 結構描述命名空間的目錄檢視上撰寫 Transact-SQL 查詢。
建立一個包含 xml 資料類型資料行的資料表來儲存您的 XML 結構描述，並將其載入 XML 類型系統中。您可以使用 xml 資料類型方法來查詢 XML 資料行。您也可以在此資料行上建立 XML 索引。然而，使用這個方法時，應用程式必須維護儲存在 XML 資料行中之 XML 結構描述與 XML 類型系統之間的一致性。例如，若您從 XML 類型系統中卸除 XML 結構描述命名空間，就必須也將它從資料表中卸除，以維持一致性。

共用方式為