Proces tworzenia rekordu (SQLXML 4.0)

Zakres węzła

Wprowadza węzła (element lub atrybut) w dokumencie XML do zakres , kiedy wykryje go XML ładowanie zbiorcze w strumieniu dane wejściowe XML.Dla węzła programu elementu tag początkowy elementu przenosi element zakres.Nazwa atrybut dla węzła atrybut programu powoduje atrybut zakres.

Węzeł pozostawia zakres, gdy nie ma więcej danych dla niego: zarówno w tagu końcowego (z wyjątkiem węzeł elementu) lub na końcu wartość atrybut (z wyjątkiem węzeł atrybut).

Zasady tworzenia rekordu

Gdy węzeł (element lub atrybut) wprowadza do zakres, istnieje możliwość generowania rekordu z tego węzła.Rekord mieszka tak długo, jak skojarzony węzeł jest w zakres.Gdy węzeł przechodzi z zakres, XML ładowanie zbiorcze traktuje rekord wygenerowanych (wraz z danych) i wysyła go do SQL Server do wstawiania.

Na przykład rozważmy poniższy fragment schematu XSD:

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
  <xsd:element name="Customer" sql:relation="Customers" >
   <xsd:complexType>
     <xsd:attribute name="CustomerID" type="xsd:string" />
     <xsd:attribute name="CompanyName" type="xsd:string" />
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

Określa schemat <Odbiorcy> element o Identyfikator klienta and CompanyName atrybuty.The sql:relation annotation maps the <Customer> element to the Customers tabela.

Należy wziąć pod uwagę ten fragment dokumentu XML:

<Customer CustomerID="1" CompanyName="xyz" />
<Customer CustomerID="2" CompanyName="abc" />
...

Gdy XML ładowanie zbiorcze jest pod warunkiem, że ze schematem opisane w poprzednich akapitów i dane XML jako danych wejściowych, przetwarza węzłów (elementy i atrybuty) w danych źródłowych w następujący sposób:

• The start tag of the first <Customer> element brings that element in scope.Ten węzeł jest mapowany do tabela Klienci.Dlatego XML ładowanie zbiorcze generuje rekord w tabela Klienci.

• W schemacie, wszystkie atrybuty <Odbiorcy> Mapa element do kolumn z tabela Klienci. Jak wprowadzić te atrybuty do zakresu, XML ładowanie zbiorcze kopiuje ich wartości do rekordu klienta, który już jest generowany przez zakres obiektu nadrzędnego.

• Gdy XML ładowanie zbiorcze osiągnie tag końcowy dla <Odbiorcy> elementu, element wykracza poza zakres. Powoduje to, że XML zbiorcze obciążenia należy wziąć pod uwagę rekord kompletne i wysłać go do SQL Server.

XML ładowanie zbiorcze następuje ten proces dla każdego kolejnego <Odbiorcy> element.

Important Note:
W tym modelu ponieważ rekord zostanie wstawiony po osiągnięciu tagu końcowego (lub węzeł jest poza zakresem), należy zdefiniować wszystkie dane, które są skojarzone z rekordu w zakresie węzła.

Podzbiór rekordów i klucz zamawiania reguły

Po określeniu schematu mapowania, która korzysta z <sql:relationship>, termin podzbiór odnosi się do zestaw rekordów jest generowany na stronie obcego relacji. W poniższym przykładzie rekordy CustOrder są po stronie obcych <sql:relationship>.

Na przykład załóżmy, że baza danych zawiera następujące tabele:

• Cust (identyfikator klienta, NazwaFirmy, Miasto)

• CustOrder (identyfikator klienta, identyfikator zamówienia)

Identyfikator klienta w tabela CustOrder jest klucz obcy, która odwołuje się do klucz podstawowy IDKlienta w tabela Cust.

Teraz należy wziąć pod uwagę Widok XML, jak określono w następujących adnotacjami schematu XSD.Korzysta z tego schematu <sql:relationship> Aby określić relację między tabelami Cust i CustOrder.

<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="CustCustOrder"
          parent="Cust"
          parent-key="CustomerID"
          child="CustOrder"
          child-key="CustomerID" />
  </xsd:appinfo>
</xsd:annotation>

  <xsd:element name="Customers" sql:relation="Cust" >
   <xsd:complexType>
     <xsd:sequence>
       <xsd:element name="CustomerID"  type="xsd:integer" />
       <xsd:element name="CompanyName" type="xsd:string" />
       <xsd:element name="City"        type="xsd:string" />
       <xsd:element name="Order" 
                          sql:relation="CustOrder"
                          sql:relationship="CustCustOrder" >
         <xsd:complexType>
          <xsd:attribute name="OrderID" type="xsd:integer" />
         </xsd:complexType>
       </xsd:element>
     </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

Poniżej podano przykładowe dane XML i czynności, aby utworzyć próbę pracy.

• Gdy <Odbiorcy> węzeł elementu w pliku danych XML wchodzi w zakres, XML ładowanie zbiorcze generuje rekord w tabela Cust. XML ładowanie zbiorcze następnie kopiuje wartości kolumn niezbędne (identyfikator klienta, NazwaFirmy i Miasto) <Identyfikator klienta>, <CompanyName>, a także <Miasto> elementy podrzędność, jak te elementy należy wprowadzić do zakres.

• When an <Order> element node enters into scope, XML Bulk Load generates a record for the CustOrder table.XML ładowanie zbiorcze kopiuje wartości Identyfikator zamówienia atrybut do tego rekordu.Wartość wymagana kolumna IDKlienta są uzyskiwane z <Identyfikator klienta> element podrzędność <Odbiorcy> element. XML Bulk Load uses the information that is specified in <sql:relationship> to obtain the CustomerID foreign key value for this record, unless the CustomerID attribute was specified in the <Order> element.Ogólną zasadą jest, że jeśli element podrzędność jawnie określa wartość dla atrybut klucz obcy, XML ładowanie zbiorcze używa tej wartości i nie uzyskać wartości z elementu nadrzędnego przy użyciu określonego <sql:relationship>. Co to <Zamówienia> węzeł elementu wykracza poza zakres, rekord, który wysyła XML ładowanie zbiorcze SQL Server następnie procesów wszystkich kolejnych i <Zamówienia> element węzły w taki sam sposób.

• Wreszcie <Odbiorcy> węzeł elementu wykracza poza zakres. W tym czasie XML ładowanie zbiorcze wysyła do rekordu klienta SQL Server. XML ładowanie zbiorcze poniżej ten proces dla wszystkich kolejnych odbiorców w strumieniu danych XML.

Oto dwie uwagi dotyczące mapowania schematu:

• Gdy schemat spełnia regułę "zamknięcia" (na przykład, wszystkie dane, które jest skojarzone z klienta i zamówienia definiuje się w zakresie skojarzonym <Odbiorcy> i <Zamówienia> węzły elementu) ładowanie zbiorcze zakończy się pomyślnie.

• W opisujący <Odbiorcy> element, jego podrzędność elementów są określone w odpowiedniej kolejności. W takim przypadek <Identyfikator klienta> element podrzędność zostanie określona przed <Zamówienia> element podrzędność. Oznacza to, że w pliku danych wejściowych XML, <Identyfikator klienta> wartość elementu jest dostępna jako klucz obcy podczas wartość <Zamówienia> element wchodzi w zakres. Atrybuty klucz są określane jako pierwsze; jest to "Reguły zamawianie klucz."

  If you specify the <CustomerID> child element after the <Order> child element, the value is not available when the <Order> element enters into scope.Gdy </ Zamówienia> tag końcowy jest następnie odczytu, rekord do tabela CustOrder uznana za zakończoną i dodaje się w tabela CustOrder o wartości NULL dla kolumna Identyfikator klienta, który nie jest pożądany wynik.

Aby utworzyć próbę pracy

Wyjątki od reguły generowania rekordu

Po wejściu do zakres w przypadku danego węzła typu pakietu IDREF lub IDREFS XML ładowanie zbiorcze nie generuje rekord dla węzła.Użytkownik powinien upewnić się, że pełny opis rekord występuje w miejscu w schemacie.The dt:type="nmtokens" annotations are ignored just as the IDREFS type is ignored.

Na przykład należy wziąć pod uwagę następujące schematu XSD, który opisuje <Odbiorcy> i <Zamówienia> elementy. The <Customer> element includes an OrderList atrybut of the IDREFS type.The <sql:relationship> tag specifies the one-to-many relationship between the customer and list of orders.

Jest to schemat:

<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="CustCustOrder"
                 parent="Cust"
                 parent-key="CustomerID"
                 child="CustOrder"
                 child-key="CustomerID" />
  </xsd:appinfo>
</xsd:annotation>

  <xsd:element name="Customers" sql:relation="Cust" >
   <xsd:complexType>
    <xsd:attribute name="CustomerID" type="xsd:integer" />
    <xsd:attribute name="CompanyName" type="xsd:string" />
    <xsd:attribute name="City" type="xsd:string" />
    <xsd:attribute name="OrderList" 
                       type="xsd:IDREFS" 
                       sql:relation="CustOrder" 
                       sql:field="OrderID"
                       sql:relationship="CustCustOrder" >
    </xsd:attribute>
  </xsd:complexType>
 </xsd:element>

  <xsd:element name="Order" sql:relation="CustOrder" >
   <xsd:complexType>
    <xsd:attribute name="OrderID" type="xsd:string" />
    <xsd:attribute name="CustomerID" type="xsd:integer" />
    <xsd:attribute name="OrderDate" type="xsd:date" />
  </xsd:complexType>
 </xsd:element>
</xsd:schema>

Ponieważ ładowanie zbiorcze ignoruje węzłów typu IDREFS, nie ma żadnych rekordów generowania podczas OrderList węzeł atrybut wchodzi w zakres.Dlatego zapisy zlecenia dodawane do tabela zamówienia, należy musi zawierać opis tych zamówień w dowolnym miejscu w schemacie.W tym schemacie Określanie <Zamówienia> element gwarantuje, że XML ładowanie zbiorcze dodaje kolejność rekordów do tabela zamówienia. The <Order> element describes all the attributes that are required to fill the record for the CustOrder tabela.

Należy się upewnić, że Identyfikator klienta and Identyfikator zamówienia wartości**<Odbiorcy>** element pasują do wartości w <Zamówienia> element. Użytkownik jest odpowiedzialny za zachowanie więzów integralność.

Aby testować przykładowe pracy