OPENXML (Transact-SQL)

Poniższy przykład tworzy reprezentacji wewnętrznej obrazu XML przy użyciu sp_xml_preparedocument. A SELECT Instrukcja, która używa OPENXML zestaw wierszy dostawca następnie jest wykonywane przed reprezentacji wewnętrznej dokumentu XML.

The flag value is zestaw to 1. Oznacza to, że zorientowany atrybut mapowania.Dlatego też atrybutów XML mapować kolumn w zestawie zestaw wierszy.The rowpattern specified as /ROOT/Customer identifies the <Customers> nodes to be processed.

Opcjonalny ColPattern nie określono parametru (wzór kolumn), ponieważ nazwa kolumna jest zgodna nazw atrybut XML.

The OPENXML zestaw wierszy dostawca creates a two-kolumna zestaw wierszy (CustomerID and ContactName) from which the SELECT instrukcja retrieves the necessary columns (in this przypadek, all the columns).

DECLARE @idoc int
DECLARE @doc varchar(1000)
SET @doc ='
<ROOT>
<Customer CustomerID="VINET" ContactName="Paul Henriot">
   <Order CustomerID="VINET" EmployeeID="5" OrderDate="1996-07-04T00:00:00">
      <OrderDetail OrderID="10248" ProductID="11" Quantity="12"/>
      <OrderDetail OrderID="10248" ProductID="42" Quantity="10"/>
   </Order>
</Customer>
<Customer CustomerID="LILAS" ContactName="Carlos Gonzlez">
   <Order CustomerID="LILAS" EmployeeID="3" OrderDate="1996-08-16T00:00:00">
      <OrderDetail OrderID="10283" ProductID="72" Quantity="3"/>
   </Order>
</Customer>
</ROOT>'
--Create an internal representation of the XML document.
EXEC sp_xml_preparedocument @idoc OUTPUT, @doc
-- Execute a SELECT statement that uses the OPENXML rowset provider.
SELECT    *
FROM       OPENXML (@idoc, '/ROOT/Customer',1)
            WITH (CustomerID  varchar(10),
                  ContactName varchar(20))

Here is the result set.

CustomerID ContactName          
---------- -------------------- 
VINET      Paul Henriot
LILAS      Carlos Gonzlez

Jeśli takie same SELECT Instrukcja jest wykonywane z flags Ustaw wartość 2, wskazując zorientowany na element Mapowanie wartości CustomerID i ContactName dla obu klientów w dokumencie XML są zwracane jako wartość NULL, ponieważ <Customers> elementy nie mają żadnych podelementy.

Here is the result set.

CustomerID ContactName
---------- -----------
NULL       NULL
NULL       NULL

Następująca kwerenda zwraca identyfikator klienta, data zamówienia, atrybuty IDENTYFIKATORA i ilość produktu z dokumentu XML.The rowpattern identifies the <OrderDetails> elements.ProductID and Quantity are the attributes of the <OrderDetails> element.Jednak OrderID, CustomerID, a OrderDate atrybutów (element nadrzędny<Orders>).

Opcjonalny ColPattern została określona.Oznacza to, następujące czynności:

• The OrderID, CustomerID, and OrderDate in the zestaw wierszy map to the attributes of the parent of the nodes identified by rowpattern in the XML document.

• The ProdID kolumna in the zestaw wierszy maps to the ProductID atrybut, and the Qty kolumna in the zestaw wierszy maps to the Quantity atrybut of the nodes identified in rowpattern.

Mimo że zorientowany na element określony przez mapowaniaflags parametr, mapowanie określony w ColPattern zastępuje to mapowanie.

DECLARE @idoc int
DECLARE @doc varchar(1000)
SET @doc ='
<ROOT>
<Customer CustomerID="VINET" ContactName="Paul Henriot">
   <Order OrderID="10248" CustomerID="VINET" EmployeeID="5" 
           OrderDate="1996-07-04T00:00:00">
      <OrderDetail ProductID="11" Quantity="12"/>
      <OrderDetail ProductID="42" Quantity="10"/>
   </Order>
</Customer>
<Customer CustomerID="LILAS" ContactName="Carlos Gonzlez">
   <Order OrderID="10283" CustomerID="LILAS" EmployeeID="3" 
           OrderDate="1996-08-16T00:00:00">
      <OrderDetail ProductID="72" Quantity="3"/>
   </Order>
</Customer>
</ROOT>'
--Create an internal representation of the XML document.
EXEC sp_xml_preparedocument @idoc OUTPUT, @doc
-- SELECT stmt using OPENXML rowset provider
SELECT *
FROM   OPENXML (@idoc, '/ROOT/Customer/Order/OrderDetail',2)
         WITH (OrderID       int         '../@OrderID',
               CustomerID  varchar(10) '../@CustomerID',
               OrderDate   datetime    '../@OrderDate',
               ProdID      int         '@ProductID',
               Qty         int         '@Quantity')

Here is the result set.

OrderID CustomerID           OrderDate                 ProdID    Qty
------------------------------------------------------------------------
10248      VINET       1996-07-04 00:00:00.000   11      12
10248      VINET       1996-07-04 00:00:00.000   42      10
10283      LILAS       1996-08-16 00:00:00.000   72      3

Przykładowy dokument XML w poniższym przykładzie składa się z <Customers>, <Orders>, a <Order_0020_Details> elementy. Pierwszy, sp_xml_preparedocument nazywa się uzyskać dojścia do dokumentu.Uchwyt ten dokument jest przekazywany do OPENXML.

W OPENXML Instrukcja, rowpattern (/ROOT/Customers) identyfikuje <Customers> węzły w celu przetworzenia. Ponieważ klauzula WITH nie zostanie podana, OPENXML Zwraca zestaw wierszy w krawędź format tabela.

Na koniec SELECT Instrukcja pobiera wszystkie kolumny krawędź tabela.

DECLARE @idoc int
DECLARE @doc varchar(1000)
SET @doc ='
<ROOT>
<Customers CustomerID="VINET" ContactName="Paul Henriot">
   <Orders CustomerID="VINET" EmployeeID="5" OrderDate=
           "1996-07-04T00:00:00">
      <Order_x0020_Details OrderID="10248" ProductID="11" Quantity="12"/>
      <Order_x0020_Details OrderID="10248" ProductID="42" Quantity="10"/>
   </Orders>
</Customers>
<Customers CustomerID="LILAS" ContactName="Carlos Gonzlez">
   <Orders CustomerID="LILAS" EmployeeID="3" OrderDate=
           "1996-08-16T00:00:00">
      <Order_x0020_Details OrderID="10283" ProductID="72" Quantity="3"/>
   </Orders>
</Customers>
</ROOT>'
--Create an internal representation of the XML document.
EXEC sp_xml_preparedocument @idoc OUTPUT, @doc
-- SELECT statement that uses the OPENXML rowset provider.
SELECT    *
FROM       OPENXML (@idoc, '/ROOT/Customers')
EXEC sp_xml_removedocument @idoc