Artikel
09/24/2010

Filtern von Werten mit 'sql:limit-field' und 'sql:limit-value' (SQLXML 4.0)

Sie können Zeilen, die von einer Datenbankabfrage zurückgegeben werden, mit einem Grenzwert begrenzen. Mithilfe der sql:limit-field- und der sql:limit-value-Anmerkung können Sie die Datenbankspalte, die die Grenzwerte enthält, identifizieren und einen bestimmten Grenzwert angeben, der zum Filtern der zurückgegebenen Daten verwendet werden soll.

Mithilfe der sql:limit-field-Anmerkung können Sie eine Spalte identifizieren, die einen Grenzwert enthält. Dies ist für alle zugeordneten Elemente oder Attribute zulässig.

Mithilfe der sql:limit-value-Anmerkung wird der Grenzwert in der Spalte angegeben, die in einer sql:limit-field-Anmerkung angegeben ist. Die sql:limit-value-Anmerkung ist optional. Wenn sql:limit-value nicht angegeben wird, wird ein NULL-Wert verwendet.

Hinweis
Bei Verwendung einer sql:limit-field-Anmerkung, bei der die zugeordnete SQL-Spalte eine Spalte vom Typ real ist, konvertiert SQLXML 4.0 die sql:limit-value-Anmerkung wie in XML-Schemas angegeben in einen angegebenen nvarchar-Wert. Hierzu müssen Dezimalgrenzwerte mithilfe der vollständigen wissenschaftlichen Schreibweise angegeben werden. Weitere Informationen finden Sie im Folgenden unter Beispiel B.

Bei Verwendung einer sql:limit-field-Anmerkung, bei der die zugeordnete SQL-Spalte eine Spalte vom Typ real ist, konvertiert SQLXML 4.0 die sql:limit-value-Anmerkung wie in XML-Schemas angegeben in einen angegebenen nvarchar-Wert. Hierzu müssen Dezimalgrenzwerte mithilfe der vollständigen wissenschaftlichen Schreibweise angegeben werden. Weitere Informationen finden Sie im Folgenden unter Beispiel B.

Beispiele

Um mithilfe dieser Daten funktionstüchtige Beispiele zu erstellen, muss Folgendes installiert sein:

Microsoft SQL Server Native Client
MDAC 2.6 oder höher

In diesen Beispielen werden mithilfe der Vorlagen XPath-Abfragen für das XSD-Zuordnungsschema angegeben.

A. Beschränken der zurückgegebenen Kundenadressen auf einen bestimmten Adresstyp

In diesem Beispiel enthält eine Datenbank zwei Tabellen:

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

Ein Kunde kann eine Liefer- und/oder eine Rechnungsadresse haben. Die AddressType-Spaltenwerte sind Shipping (Lieferadresse) und Billing (Rechnungsadresse).

Hierbei handelt es sich um das Zuordnungsschema, in dem das ShipTo-Schemaattribut der StreetAddress-Spalte in der Addresses-Beziehung zugeordnet wird. Die für dieses Attribut zurückgegebenen Werte werden durch die Angabe der Anmerkungen sql:limit-field und sql:limit-value auf Lieferadressen begrenzt. Entsprechend gibt das BillTo-Schemaattribut nur die Rechnungsadresse eines Kunden zurück.

Das ist das Schema:

<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>

So testen Sie eine XPath-Beispielabfrage mit dem Schema

Erstellen Sie in der Datenbank tempdb zwei Tabellen:

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

Fügen Sie die Beispieldaten hinzu:

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')

Kopieren Sie den oben stehenden Schemacode, und fügen Sie ihn in eine Textdatei ein. Speichern Sie die Datei unter dem Dateinamen LimitFieldValue.xml .
Erstellen Sie die folgende Vorlage (LimitFieldValueT.xml), und speichern Sie sie dort, wo Sie im vorherigen Schritt auch das Schema (LimitFieldValue.xml) gespeichert haben.
```
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
    <sql:xpath-query mapping-schema="LimitFieldValue.xml">
        /Customer
    </sql:xpath-query>
</ROOT>
```
Der für das Zuordnungsschema (LimitFieldValue.xml) angegebene Verzeichnispfad bezieht sich auf das Verzeichnis, in dem die Vorlage gespeichert wird. Es kann auch ein absoluter Pfad angegeben werden. Beispiel:
```
mapping-schema="C:\MyDir\LimitFieldValue.xml"
```
Erstellen und verwenden Sie das SQLXML 4.0-Testskript (Sqlxml4test.vbs), um die Vorlage auszuführen.

Weitere Informationen finden Sie unter Verwenden von ADO zum Ausführen von SQLXML-Abfragen.

Dies ist das Ergebnis:

<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>

B. Beschränken von Ergebnissen anhand eines Rabattwerts vom Datentyp 'real'

In diesem Beispiel enthält eine Datenbank zwei Tabellen:

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

Hierbei handelt es sich um das Zuordnungsschema, in dem das OrderID-Attribut in den Bestellungsdetails der OrderID-Spalte in der Orders-Beziehung zugeordnet wird. Die für dieses Attribut zurückgegebenen Werte werden durch die Angabe der Anmerkungen sql:limit-field und sql:limit-value auf die Werte begrenzt, die für das Discount-Attribut den Wert 2,0000000e-001 (0,2) angeben.

Das ist das Schema:

<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>

So testen Sie eine XPath-Beispielabfrage mit dem Schema

Erstellen Sie in der Datenbank tempdb zwei Tabellen:

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]

Fügen Sie die Beispieldaten hinzu:

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)

Speichern Sie das Schema (LimitFieldValue.xml) in einem Verzeichnis.

Erstellen Sie das folgende Testskript (TestQuery.vbs), geben Sie anstelle von MyServer den Namen des SQL Server-Computers ein, und speichern Sie das Skript in dem Verzeichnis, in dem Sie im vorherigen Schritt das Schema gespeichert haben:

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"

Führen Sie die Datei TestQuery.vbs aus, indem Sie in Windows Explorer auf die Datei klicken.

Dies ist das Ergebnis:

<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>