Исключение элементов схемы из XML-документа с помощью sql:mapped

Статья
04/26/2023

Применимо к:База данных SQL Server Azure SQL

В результате сопоставления по умолчанию каждый элемент и атрибут в схеме XSD будет сопоставлен с таблицей и столбцом в базе данных. Если вы хотите создать элемент в схеме XSD, который не сопоставляется ни с какой таблицей (представлением) или столбцом базы данных и не отображается в XML-коде, можно указать заметку sql:mappped .

Заметка sql:mapped особенно полезна, если невозможно изменить схему или если схема используется для проверки XML из других источников и при этом содержит данные, которые не хранятся в базе данных. Заметка sql:mapped отличается от sql:is-constant тем, что несопоставленные элементы и атрибуты не отображаются в XML-документе.

Заметка sql:mapped принимает логическое значение (0 = false, 1 = true). Допустимые значения: 0, 1, true и false.

Примеры

Чтобы создать рабочие образцы на основе следующих примеров, необходимо выполнить определенные требования. Дополнительные сведения см. в разделе Требования для выполнения примеров SQLXML.

A. Задание заметки sql:mapped

Предположим, существует схема XSD, полученная из другого источника. Эта схема XSD состоит из <элемента Person.Contact> с атрибутами ContactID, FirstName, LastName и HomeAddress .

При сопоставлении этой схемы XSD с таблицей Person.Contact в базе данных AdventureWorks в атрибуте HomeAddress указывается sql:mapped, так как в таблице Employees не хранятся домашние адреса сотрудников. В результате этот атрибут не сопоставлен с базой данных и не возвращается в результирующем XML-документе в ответ на запрос XPath к схеме сопоставления.

Для остальной части схемы используется сопоставление по умолчанию. Элемент <Person.Contact> сопоставляется с таблицей Person.Contact, а все атрибуты сопоставляется со столбцами с тем же именем в таблице Person.Contact.

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  
  <xsd:element name="Person.Contact">  
    <xsd:complexType>  
      <xsd:attribute name="ContactID"   type="xsd:string"/>  
      <xsd:attribute name="FirstName"    type="xsd:string" />  
      <xsd:attribute name="LastName"     type="xsd:string" />  
      <xsd:attribute name="HomeAddress" type="xsd:string"   
                     sql:mapped="false" />  
    </xsd:complexType>  
  </xsd:element>  
</xsd:schema>

Проверка образца запроса XPath к схеме

Скопируйте приведенный выше код схемы и вставьте его в текстовый файл. Сохраните файл под именем sql-mapped.xml.
Скопируйте следующий шаблон и вставьте его в текстовый файл. Сохраните файл под именем sql-mappedT.xml в том же каталоге, где был сохранен файл sql-mapped.xml.
```
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
    <sql:xpath-query mapping-schema="sql-mapped.xml">  
        /Person.Contact[@ContactID < 10]  
    </sql:xpath-query>  
</ROOT>  
```
Путь к каталогу для схемы сопоставления (MySchema.xml) задается относительно каталога, в котором сохранен шаблон. Можно также задать абсолютный путь, например:
```
mapping-schema="C:\MyDir\sql-mapped.xml"  
```
Создайте и запустите тестовый скрипт SQLXML 4.0 (Sqlxml4test.vbs), чтобы выполнить шаблон.

Дополнительные сведения см. в статье Использование ADO для выполнения запросов SQLXML.

Результирующий набор:

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <Person.Contact ContactID="1" FirstName="Gustavo" LastName="Achong" />   
  <Person.Contact ContactID="2" FirstName="Catherine" LastName="Abel" />   
  <Person.Contact ContactID="3" FirstName="Kim" LastName="Abercrombie" />   
  <Person.Contact ContactID="4" FirstName="Humberto" LastName="Acevedo" />   
  <Person.Contact ContactID="5" FirstName="Pilar" LastName="Ackerman" />   
  <Person.Contact ContactID="6" FirstName="Frances" LastName="Adams" />   
  <Person.Contact ContactID="7" FirstName="Margaret" LastName="Smith" />   
  <Person.Contact ContactID="8" FirstName="Carla" LastName="Adams" />   
  <Person.Contact ContactID="9" FirstName="Jay" LastName="Adams" />   
</ROOT>

Обратите внимание, что contactID, FirstName и LastName присутствуют, но HomeAddress не является, так как схема сопоставления, указанная 0 для атрибута sql:mapped .

См. также:

Сопоставление элементов и атрибутов XSD с таблицами и столбцами по умолчанию (SQLXML 4.0)

Поделиться через