Фильтрация значений при помощи sql:limit-field и sql:limit-value (SQLXML 4.0)

Статья
04/26/2023

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

Количество строк, возвращаемых запросом к базе данных, можно ограничить на основе какого-либо значения. Заметки sql:limit-field и sql:limit-value используются для идентификации столбца базы данных, содержащего ограничивающие значения, и указания определенного ограничивающего значения, которое будет использоваться для фильтрации возвращаемых данных.

Заметка sql:limit-field используется для идентификации столбца, содержащего ограничивающее значение; он допускается для каждого сопоставленного элемента или атрибута.

Заметка sql:limit-value используется для указания ограниченного значения в столбце, указанном в заметке sql:limit-field . Заметка sql:limit-value является необязательной. Если параметр sql:limit-value не указан, предполагается значение NULL.

Примечание

При работе с sql:limit-field, где сопоставленный столбец SQL имеет тип real, SQLXML 4.0 выполняет преобразование в sql:limit-value , как указано в xml-схемах, в качестве указанного значения nvarchar . Для этого необходимо, чтобы десятичные граничные значения были указаны в полном экспоненциальном представлении. Дополнительные сведения см. в приведенном ниже Примере Б.

Примеры

Чтобы создать рабочие образцы на основе этих примеров, должны быть установлены следующие компоненты.

Microsoft SQL Server Native Client
Компоненты MDAC 2.6 или более поздние версии

В этих примерах для задания запросов XPath к схеме сопоставления XSD используются шаблоны.

A. Ограничение адресов заказчиков определенным типом адреса

В этом примере база данных содержит две таблицы

Customer (CustomerID, CompanyName)
Addresses (CustomerID, AddressType, StreetAddress)

Заказчик может иметь адрес для доставки и адрес для выставления счетов. Столбец AddressType содержит значения Shipping и Billing.

Это схема сопоставления, в которой атрибут схемы ShipTo сопоставляется со столбцом StreetAddress в отношении Адреса. Значения, возвращаемые для этого атрибута, ограничиваются только адресами доставки, указывая заметки sql:limit-field и sql:limit-value . Аналогичным образом атрибут схемы BillTo возвращает только адрес выставления счетов клиента.

Схема:

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  
<xsd:annotation>  
  <xsd:appinfo>  
    <sql:relationship name="CustAddr"  
        parent="Customer"  
        parent-key="CustomerID"  
        child="Addresses"  
        child-key="CustomerID" />  
  </xsd:appinfo>  
</xsd:annotation>  
  
  <xsd:element name="Customer" sql:relation="Customer" >  
   <xsd:complexType>  
        <xsd:sequence>  
        <xsd:element name="BillTo"   
                       type="xsd:string"   
                       sql:relation="Addresses"   
                       sql:field="StreetAddress"  
                       sql:limit-field="AddressType"  
                       sql:limit-value="billing"  
                       sql:relationship="CustAddr" >  
        </xsd:element>  
        <xsd:element name="ShipTo"   
                       type="xsd:string"   
                       sql:relation="Addresses"   
                       sql:field="StreetAddress"  
                       sql:limit-field="AddressType"  
                       sql:limit-value="shipping"  
                       sql:relationship="CustAddr" >  
        </xsd:element>  
        </xsd:sequence>  
        <xsd:attribute name="CustomerID"   type="xsd:int" />   
        <xsd:attribute name="CompanyName"  type="xsd:string" />  
    </xsd:complexType>  
  </xsd:element>  
</xsd:schema>

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

Создайте две таблицы в базе данных tempdb :

USE tempdb  
CREATE TABLE Customer (CustomerID int primary key,   
                       CompanyName varchar(30))  
CREATE TABLE Addresses(CustomerID int,   
                       StreetAddress varchar(50),  
                       AddressType varchar(10))

Добавьте образцы данных:

INSERT INTO Customer values (1, 'Company A')  
INSERT INTO Customer values (2, 'Company B')  

INSERT INTO Addresses values  
           (1, 'Obere Str. 57 Berlin', 'billing')  
INSERT INTO Addresses values  
           (1, 'Avda. de la Constituci?n 2222 M?xico D.F.', 'shipping')  
INSERT INTO Addresses values  
           (2, '120 Hanover Sq., London', 'billing')  
INSERT INTO Addresses values  
           (2, 'Forsterstr. 57, Mannheim', 'shipping')

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

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

Результат:

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">   
  <Customer CustomerID="1" CompanyName="Company A">   
     <BillTo>Obere Str. 57 Berlin</BillTo>   
     <ShipTo>Avda. de la Constituci?n 2222 M?xico D.F.</ShipTo>   
  </Customer>   
  <Customer CustomerID="2" CompanyName="Company B">   
     <BillTo>120 Hanover Sq., London</BillTo>   
     <ShipTo>Forsterstr. 57, Mannheim</ShipTo>   
   </Customer>   
</ROOT>

Б. Ограничение результатов на основе значения скидки, имеющего тип данных real

В этом примере база данных содержит две таблицы

Orders (OrderID)
OrderDetails (OrderID, ProductID, UnitPrice, Quantity, Price, Discount)

Это схема сопоставления, в которой атрибут OrderID в сведениях о заказе сопоставляется со столбцом OrderID в отношении заказов. Значения, возвращаемые для этого атрибута, ограничены только теми значениями, которые имеют значение 2,0000000e-001 (0,2), указанное для атрибута Discount с помощью заметок sql:limit-field и sql:limit-value .

Схема:

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  
  <xsd:annotation>  
   <xsd:appinfo>  
    <sql:relationship name="OrderOrderDetails"  
        parent="Orders"  
        parent-key="OrderID"  
        child="OrderDetails"  
        child-key="OrderID" />  
   </xsd:appinfo>  
  </xsd:annotation>  
  <xsd:element name="root" sql:is-constant="1">  
   <xsd:complexType>  
     <xsd:sequence>  
       <xsd:element name="Order" sql:relation="Orders" >  
          <xsd:complexType>  
             <xsd:sequence>  
                <xsd:element name="orderDetail"   
                       sql:relation="OrderDetails"   
                       sql:limit-field="Discount"                       sql:limit-value="2.0000000e-001"  
                       sql:relationship="OrderOrderDetails">  
                   <xsd:complexType>  
                     <xsd:attribute name="OrderID"   />   
                     <xsd:attribute name="ProductID" />   
                     <xsd:attribute name="Discount"  />   
                     <xsd:attribute name="Quantity"  />   
                     <xsd:attribute name="UnitPrice" />   
                   </xsd:complexType>  
                </xsd:element>  
            </xsd:sequence>  
           <xsd:attribute name="OrderID"/>   
          </xsd:complexType>  
       </xsd:element>  
     </xsd:sequence>  
   </xsd:complexType>  
  </xsd:element>  
</xsd:schema>

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

Создайте две таблицы в базе данных tempdb :

USE tempdb  
CREATE TABLE Orders ([OrderID] int NOT NULL ) ON [PRIMARY]  
ALTER TABLE Orders WITH NOCHECK ADD   
CONSTRAINT [PK_Orders] PRIMARY KEY  CLUSTERED (  
   [OrderID]  
 )  ON [PRIMARY]   
CREATE TABLE [OrderDetails] (  
   [OrderID] int NOT NULL ,  
   [ProductID] int NOT NULL ,  
   [UnitPrice] money NULL ,  
   [Quantity] smallint NOT NULL ,  
   [Discount] real NOT NULL   
) ON [PRIMARY]

Добавьте образцы данных:

INSERT INTO Orders ([OrderID]) values (10248)  
INSERT INTO Orders ([OrderID]) values (10250)  
INSERT INTO Orders ([OrderID]) values (10251)  
INSERT INTO Orders ([OrderID]) values (10257)  
INSERT INTO Orders ([OrderID]) values (10258)  
INSERT INTO [OrderDetails] ([OrderID],[ProductID],[UnitPrice],[Quantity],[Discount]) values (10248,11,14,12,0)  
INSERT INTO [OrderDetails] ([OrderID],[ProductID],[UnitPrice],[Quantity],[Discount]) values (10250,51,42.4,35,0.15)  
INSERT INTO [OrderDetails] ([OrderID],[ProductID],[UnitPrice],[Quantity],[Discount]) values (10251,22,16.8,6,0.05)  
INSERT INTO [OrderDetails] ([OrderID],[ProductID],[UnitPrice],[Quantity],[Discount]) values (10257,77,10.4,15,0)  
INSERT INTO [OrderDetails] ([OrderID],[ProductID],[UnitPrice],[Quantity],[Discount]) values (10258,2,15.2,50,0.2)

Сохраните схему (LimitFieldValue.xml) в каталоге.

Создайте следующий скрипт проверки (TestQuery.vbs), замените МойСервер на имя компьютера с SQL Server и сохраните его в том же каталоге, в котором на предыдущем шаге была сохранена схема.

Set conn = CreateObject("ADODB.Connection")  
conn.Open "Provider=SQLOLEDB;Data Source=MyServer;Database=tempdb;Integrated Security=SSPI"  
conn.Properties("SQLXML Version") = "sqlxml.4.0"   
Set cmd = CreateObject("ADODB.Command")  
Set stm = CreateObject("ADODB.Stream")  
Set cmd.ActiveConnection = conn  
stm.open  
result ="none"  
strXPathQuery="/root"  
DBGUID_XPATH = "{EC2A4293-E898-11D2-B1B7-00C04F680C56}"  
cmd.Dialect = DBGUID_XPATH  
cmd.CommandText = strXPathQuery  
cmd.Properties("Mapping schema") = "LimitFieldReal.xml"  
cmd.Properties("Output Stream").Value = stm  
cmd.Properties("Output Encoding") = "utf-8"  
WScript.Echo "executing for xml query"  
On Error Resume Next  
cmd.Execute , ,1024  
if err then  
Wscript.Echo err.description  
Wscript.Echo err.Number  
Wscript.Echo err.source  
On Error GoTo 0  
else  
stm.Position = 0  
result  = stm.ReadText  
end if  
WScript.Echo result  
Wscript.Echo "done"

Запустите файл TestQuery.vbs, щелкнув его в проводнике Windows.

Результат:

<root>  
  <Order OrderID="10248"/>  
  <Order OrderID="10250"/>  
  <Order OrderID="10251"/>  
  <Order OrderID="10257"/>  
  <Order OrderID="10258">  
    <orderDetail OrderID="10258"   
                 ProductID="2"   
                 Discount="0.2"   
                 Quantity="50"/>  
  </Order>  
</root>

См. также:

Типы данных float и real (Transact-SQL)
nchar и nvarchar (Transact-SQL)
Установка собственного клиента SQL Server
Использование схем XSD с заметками в запросах (SQLXML 4.0)

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

Фильтрация значений при помощи sql:limit-field и sql:limit-value (SQLXML 4.0)

Примеры

A. Ограничение адресов заказчиков определенным типом адреса

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

Б. Ограничение результатов на основе значения скидки, имеющего тип данных real

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

См. также:

Обратная связь

Обратная связь

Дополнительные ресурсы