參考內建 XML 結構描述集合 (sys)

適用於：SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceMicrosoft Fabric 中的 SQL 資料庫

您建立的每一個資料庫，在 sys 關聯式結構描述中，都有一個預先定義的 sys XML 結構描述集合。 此集合會保留這些預先定義的結構描述，所以從其他使用者建立的任何 XML 結構描述集合都能存取這些結構描述。 這些預先定義的結構描述中使用的前置詞在 XQuery 中是有意義的。 只有 xml 是保留的前置詞。

xml = http://www.w3.org/XML/1998/namespace
xs = http://www.w3.org/2001/XMLSchema
xsi = http://www.w3.org/2001/XMLSchema-instance
fn = http://www.w3.org/2004/07/xpath-functions
sqltypes = https://schemas.microsoft.com/sqlserver/2004/sqltypes
xdt = http://www.w3.org/2004/07/xpath-datatypes
(no prefix) = urn:schemas-microsoft-com:xml-sql
(no prefix) = https://schemas.microsoft.com/sqlserver/2004/SOAP

sqltypes 命名空間包含的元件可以從任何使用者建立的 XML 結構描述集合參考。 您可以從 Microsoft 網站 下載 sqltypes結構描述。 內建的元件包括下列項目：

• XSD 類型

• XML 屬性 lang, base及 space

• sqltypes 命名空間的元件

下列查詢會傳回可以從使用者建立之 XML 結構描述集合參考的內建元件：

SELECT C.name, N.name, C.symbol_space_desc from sys.xml_schema_components C join sys.xml_schema_namespaces N
on ((C.xml_namespace_id = N.xml_namespace_id) AND (C.xml_collection_id = N.xml_collection_id))
join sys.xml_schema_collections SC
on SC.xml_collection_id = C.xml_collection_id
where ((C.xml_collection_id = 1) AND (C.name is not null) AND (C.scoping_xml_component_id is null)
AND (SC.schema_id = 4));
GO

下列範例顯示這些元件在使用者結構描述中的參考方式。 CREATE XML SCHEMA COLLECTION 建立 XML 結構描述集合，其參考 varchar 命名空間中所定義的 sqltypes 類型。 此範例也會參考 lang 命名空間中定義的 xml 屬性。

CREATE XML SCHEMA COLLECTION SC AS '
<schema
   xmlns="http://www.w3.org/2001/XMLSchema"
   targetNamespace="myNS"
   xmlns:ns="myNS"
   xmlns:s="https://schemas.microsoft.com/sqlserver/2004/sqltypes" >
   <import namespace="http://www.w3.org/XML/1998/namespace"/>
   <import namespace="https://schemas.microsoft.com/sqlserver/2004/sqltypes"/>
   <element name="root">
      <complexType>
          <sequence>
             <element name="a" type="string"/>
             <element name="b" type="string"/>
             <!-- varchar type is defined in the sys.sys collection and
                  can be referenced in any user-defined schema -->
             <element name="c" type="s:varchar"/>
          </sequence>
          <attribute name="att" type="int"/>
          <!-- xml:lang attribute is defined in the sys.sys collection
               and can be referenced in any user-defined schema -->
          <attribute ref="xml:lang"/>
      </complexType>
    </element>
</schema>';
GO
-- Cleanup
DROP xml schema collection SC;
GO

您應該注意下列各項：

• 您不能在任何使用者自訂 XML 結構描述集合中，使用這些命名空間來修改 XML 結構描述。 例如，下列的 XML 結構描述集合會失敗，因為它把元件加入到 sqltypes 保護的命名空間：

  CREATE XML SCHEMA COLLECTION SC AS '
  <schema xmlns="http://www.w3.org/2001/XMLSchema"
  targetNamespace
      ="https://schemas.microsoft.com/sqlserver/2004/sqltypes" >
        <element name="root" type="string"/>
  </schema>';
  GO
  

• 您不能使用 sys XML 結構描述集合來對 xml 資料行、變數或參數進行類型化。 例如，下列程式碼會傳回錯誤：

  DECLARE @x xml (sys.sys);
  

• 不支援這些內建方案的序列化。 例如，下列程式碼會傳回錯誤：

  SELECT XML_SCHEMA_NAMESPACE(N'sys', N'sys')l
  GO
  

下列程式碼是另一個範例，在此您將建立一個 XML 結構描述集合，此結構描述集合會使用 varchar 命名空間中定義的 sqltypes 類型：

CREATE XML SCHEMA COLLECTION SC AS '
<schema xmlns="http://www.w3.org/2001/XMLSchema"
        targetNamespace="myNS" xmlns:ns="myNS"
        xmlns:s="https://schemas.microsoft.com/sqlserver/2004/sqltypes">
   <import
     namespace="https://schemas.microsoft.com/sqlserver/2004/sqltypes"/>
      <simpleType name="myType">
            <restriction base="s:varchar">
                  <maxLength value="20"/>
            </restriction>
      </simpleType>
      <element name="root" type="ns:myType"/>
</schema>';
GO

如下所示，您可以建立具類型的 XML 變數，將 XML 執行個體指派給這個變數，並確認 <root> 元素類型的值是 varchar 類型。

DECLARE @var XML(SC);
SET @var = '<root xmlns="myNS">My data</root>'
SELECT @var.query('declare namespace sqltypes = "https://schemas.microsoft.com/sqlserver/2004/sqltypes";
declare namespace ns="myNS";
data(/ns:root[1]) instance of sqltypes:varchar?');
GO

instance of sqltypes:varchar? 運算式會傳回 TRUE，因為 <root> 元素值的類型是由 varchar 衍生而來 (根據與 @var 變數相關聯的結構描述所衍生)。

另請參閱

• XML 結構描述集合 (SQL Server)