Partager via

Exemples DiffGram (SQLXML 4.0)

Les exemples de cette rubrique sont constitués de DiffGrams qui effectuent des opérations d’insertion, de mise à jour et de suppression dans la base de données. Avant d’utiliser les exemples, notez les points suivants :

  • Les exemples utilisent deux tables (Cust et Ord) qui doivent être créées si vous souhaitez tester les exemples DiffGram :

    Cust(CustomerID, CompanyName, ContactName)  
Ord(OrderID, CustomerID)

  • La plupart des exemples de cette rubrique utilisent le schéma XSD suivant :

    <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  

<xsd:annotation>  
  <xsd:documentation>  
    Diffgram Customers/Orders Schema.  
  </xsd:documentation>  
  <xsd:appinfo>  
       <sql:relationship name="CustomersOrders"   
                  parent="Cust"  
                  parent-key="CustomerID"  
                  child-key="CustomerID"  
                  child="Ord"/>  
  </xsd:appinfo>  
</xsd:annotation>  

<xsd:element name="Customer" sql:relation="Cust">  
  <xsd:complexType>  
    <xsd:sequence>  
      <xsd:element name="CompanyName"    type="xsd:string"/>  
      <xsd:element name="ContactName"    type="xsd:string"/>  
       <xsd:element name="Order" sql:relation="Ord" sql:relationship="CustomersOrders">  
        <xsd:complexType>  
          <xsd:attribute name="OrderID" type="xsd:int" sql:field="OrderID"/>  
          <xsd:attribute name="CustomerID" type="xsd:string"/>  
        </xsd:complexType>  
      </xsd:element>  
    </xsd:sequence>  
    <xsd:attribute name="CustomerID" type="xsd:string" sql:field="CustomerID"/>  
  </xsd:complexType>  
</xsd:element>  

</xsd:schema>

    Enregistrez ce schéma en tant que DiffGramSchema.xml dans le même dossier où vous enregistrez d’autres fichiers utilisés dans les exemples.

Un. Suppression d’un enregistrement à l’aide d’un DiffGram

Le DiffGram dans cet exemple supprime un enregistrement client (dont CustomerID est ALFKI) de la table Cust et supprime l’enregistrement de commande correspondant (dont OrderID est 1) de la table Ord.

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql" sql:mapping-schema="DiffGramSchema.xml">  
  <diffgr:diffgram   
           xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"   
           xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">  
    <DataInstance/>  
  
    <diffgr:before>  
        <Order diffgr:id="Order1"   
               msdata:rowOrder="0"   
               CustomerID="ALFKI"   
               OrderID="1"/>  
        <Customer diffgr:id="Customer1"   
                  msdata:rowOrder="0"   
                  CustomerID="ALFKI">  
           <CompanyName>Alfreds Futterkiste</CompanyName>  
           <ContactName>Maria Anders</ContactName>  
        </Customer>  
    </diffgr:before>  
    <msdata:errors/>  
  </diffgr:diffgram>  
</ROOT>

Dans le <bloc précédent> , il existe un <élément Order> (diffgr :id="Order1 ») et un <élément Customer> (diffgr :id="Customer1 »). Ces éléments représentent des enregistrements existants dans la base de données. L’élément <DataInstance> n’a pas les enregistrements correspondants (avec le même diffgr :id). Cela indique une opération de suppression.

Pour tester le DiffGram

  1. Créez ces tables dans la base de données tempdb .

    CREATE TABLE Cust(  
        CustomerID  nchar(5) Primary Key,  
        CompanyName nvarchar(40) NOT NULL ,  
        ContactName nvarchar(60) NULL)  
GO  

CREATE TABLE Ord(  
   OrderID    int Primary Key,  
   CustomerID nchar(5) Foreign Key REFERENCES Cust(CustomerID))  
GO

  2. Ajoutez cet exemple de données :

    INSERT INTO Cust(CustomerID, CompanyName, ContactName) VALUES  
     (N'ALFKI', N'Alfreds Futterkiste', N'Maria Anders')  
INSERT INTO Cust(CustomerID, CompanyName, ContactName) VALUES  
     (N'ANATR', N'Ana Trujillo Emparedados y helados', N'Ana Trujillo')  
INSERT INTO Cust(CustomerID, CompanyName, ContactName) VALUES  
     (N'ANTON', N'Antonio Moreno Taquer??a', N'Antonio Moreno')  

INSERT INTO Ord(OrderID, CustomerID) VALUES(1, N'ALFKI')  
INSERT INTO Ord(OrderID, CustomerID) VALUES(2, N'ANATR')  
INSERT INTO Ord(OrderID, CustomerID) VALUES(3, N'ANTON')

  3. Copiez le DiffGram ci-dessus et collez-le dans un fichier texte. Enregistrez le fichier en tant que MyDiffGram.xml dans le même dossier utilisé à l’étape précédente.

  4. Copiez le fichier DiffGramSchema fourni précédemment dans cette rubrique et collez-le dans un fichier texte. Enregistrez le fichier en tant que DiffGramSchema.xml.

  5. Créez et utilisez le script de test SQLXML 4.0 (Sqlxml4test.vbs) pour exécuter le DiffGram.

    Pour plus d'informations, voir Utilisation d'ADO pour exécuter des requêtes SQLXML 4.0.

B. Insertion d’un enregistrement à l’aide d’un DiffGram

Dans cet exemple, le DiffGram insère un enregistrement dans la table Cust et un enregistrement dans la table Ord.

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"   
      sql:mapping-schema="DiffGramSchema.xml">  
  <diffgr:diffgram   
          xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"   
          xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">  
    <DataInstance>  
       <Customer diffgr:id="Customer1" msdata:rowOrder="0"    
                 diffgr:hasChanges="inserted" CustomerID="ALFKI">  
        <CompanyName>C3Company</CompanyName>  
        <ContactName>C3Contact</ContactName>  
        <Order diffgr:id="Order1"   
               msdata:rowOrder="0"  
               diffgr:hasChanges="inserted"   
               CustomerID="ALFKI" OrderID="1"/>  
      </Customer>  
    </DataInstance>  
  
  </diffgr:diffgram>  
</ROOT>

Dans ce DiffGram, le <bloc avant> n’est pas spécifié (aucun enregistrement de base de données existant n’est identifié). Il existe deux instances d’enregistrement (identifiées par les <éléments Customer> et <Order> dans le <bloc DataInstance> ) qui correspondent respectivement aux tables Cust et Ord. Ces deux éléments spécifient l’attribut diffgr :hasChanges (hasChanges="inserted »). Cela indique une opération d’insertion. Dans ce DiffGram, si vous spécifiez hasChanges="modified », vous indiquez que vous souhaitez modifier un enregistrement qui n’existe pas, ce qui entraîne une erreur.

Pour tester le DiffGram

  1. Créez ces tables dans la base de données tempdb .

    CREATE TABLE Cust(  
        CustomerID  nchar(5) Primary Key,  
        CompanyName nvarchar(40) NOT NULL ,  
        ContactName nvarchar(60) NULL)  
GO  

CREATE TABLE Ord(  
   OrderID    int Primary Key,  
   CustomerID nchar(5) Foreign Key REFERENCES Cust(CustomerID))  
GO

  2. Ajoutez cet exemple de données :

    INSERT INTO Cust(CustomerID, CompanyName, ContactName) VALUES  
     (N'ALFKI', N'Alfreds Futterkiste', N'Maria Anders')  
INSERT INTO Cust(CustomerID, CompanyName, ContactName) VALUES  
     (N'ANATR', N'Ana Trujillo Emparedados y helados', N'Ana Trujillo')  
INSERT INTO Cust(CustomerID, CompanyName, ContactName) VALUES  
     (N'ANTON', N'Antonio Moreno Taquer??a', N'Antonio Moreno')  

INSERT INTO Ord(OrderID, CustomerID) VALUES(1, N'ALFKI')  
INSERT INTO Ord(OrderID, CustomerID) VALUES(2, N'ANATR')  
INSERT INTO Ord(OrderID, CustomerID) VALUES(3, N'ANTON')

  3. Copiez le DiffGram ci-dessus et collez-le dans un fichier texte. Enregistrez le fichier en tant que MyDiffGram.xml dans le même dossier utilisé à l’étape précédente.

  4. Copiez le fichier DiffGramSchema fourni précédemment dans cette rubrique et collez-le dans un fichier texte. Enregistrez le fichier en tant que DiffGramSchema.xml.

  5. Créez et utilisez le script de test SQLXML 4.0 (Sqlxml4test.vbs) pour exécuter le DiffGram.

    Pour plus d'informations, voir Utilisation d'ADO pour exécuter des requêtes SQLXML 4.0.

Chapitre C. Mise à jour d’un enregistrement existant à l’aide d’un DiffGram

Dans cet exemple, DiffGram met à jour les informations client (CompanyName et ContactName) pour le client ALFKI.

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql" sql:mapping-schema="DiffGramSchema.xml">  
  <diffgr:diffgram   
           xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"   
           xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">  
    <DataInstance>  
      <Customer diffgr:id="Customer1"   
                msdata:rowOrder="0" diffgr:hasChanges="modified"   
                CustomerID="ALFKI">  
          <CompanyName>Bottom Dollar Markets</CompanyName>  
          <ContactName>Antonio Moreno</ContactName>  
      </Customer>  
    </DataInstance>  
  
    <diffgr:before>  
     <Customer diffgr:id="Customer1"   
               msdata:rowOrder="0"   
               CustomerID="ALFKI">  
        <CompanyName>Alfreds Futterkiste</CompanyName>  
        <ContactName>Maria Anders</ContactName>  
      </Customer>  
    </diffgr:before>  
  
  </diffgr:diffgram>  
</ROOT>

Le <bloc avant> inclut un <élément Customer> (diffgr :id="Customer1 »). Le <bloc DataInstance> inclut l’élément Customer> correspondant< avec le même ID. L’élément <client> dans NewDataSet<> spécifie également diffgr :hasChanges="modified ».. Cela indique une opération de mise à jour et l’enregistrement client dans la table Cust est mis à jour en conséquence. Notez que si l’attribut diffgr :hasChanges n’est pas spécifié, la logique de traitement DiffGram ignore cet élément et aucune mise à jour n’est effectuée.

Pour tester le DiffGram

  1. Créez ces tables dans la base de données tempdb .

    CREATE TABLE Cust(  
        CustomerID  nchar(5) Primary Key,  
        CompanyName nvarchar(40) NOT NULL ,  
        ContactName nvarchar(60) NULL)  
GO  

CREATE TABLE Ord(  
   OrderID    int Primary Key,  
   CustomerID nchar(5) Foreign Key REFERENCES Cust(CustomerID))  
GO

  2. Ajoutez cet exemple de données :

    INSERT INTO Cust(CustomerID, CompanyName, ContactName) VALUES  
     (N'ALFKI', N'Alfreds Futterkiste', N'Maria Anders')  
INSERT INTO Cust(CustomerID, CompanyName, ContactName) VALUES  
     (N'ANATR', N'Ana Trujillo Emparedados y helados', N'Ana Trujillo')  
INSERT INTO Cust(CustomerID, CompanyName, ContactName) VALUES  
     (N'ANTON', N'Antonio Moreno Taquer??a', N'Antonio Moreno')  

INSERT INTO Ord(OrderID, CustomerID) VALUES(1, N'ALFKI')  
INSERT INTO Ord(OrderID, CustomerID) VALUES(2, N'ANATR')  
INSERT INTO Ord(OrderID, CustomerID) VALUES(3, N'ANTON')

  3. Copiez le DiffGram ci-dessus et collez-le dans un fichier texte. Enregistrez le fichier en tant que MyDiffGram.xml dans le même dossier utilisé à l’étape précédente.

  4. Copiez le fichier DiffGramSchema fourni précédemment dans cette rubrique et collez-le dans un fichier texte. Enregistrez le fichier en tant que DiffGramSchema.xml.

  5. Créez et utilisez le script de test SQLXML 4.0 (Sqlxml4test.vbs) pour exécuter le DiffGram.

    Pour plus d'informations, voir Utilisation d'ADO pour exécuter des requêtes SQLXML 4.0.

D. Insertion, mise à jour et suppression d’enregistrements à l’aide d’un DiffGram

Dans cet exemple, un DiffGram relativement complexe est utilisé pour effectuer des opérations d’insertion, de mise à jour et de suppression.

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql" sql:mapping-schema="DiffGramSchema.xml">  
  <diffgr:diffgram   
         xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"   
         xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">  
    <DataInstance>  
      <Customer diffgr:id="Customer2" msdata:rowOrder="1"   
                diffgr:hasChanges="modified"   
                CustomerID="ANATR">  
          <CompanyName>Bottom Dollar Markets</CompanyName>  
          <ContactName>Elizabeth Lincoln</ContactName>  
          <Order diffgr:id="Order2" msdata:rowOrder="1"   
               msdata:hiddenCustomerID="ANATR"   
               CustomerID="ANATR" OrderID="2"/>  
      </Customer>  
  
      <Customer diffgr:id="Customer3" msdata:rowOrder="2"   
                CustomerID="ANTON">  
         <CompanyName>Chop-suey Chinese</CompanyName>  
         <ContactName>Yang Wang</ContactName>  
         <Order diffgr:id="Order3" msdata:rowOrder="2"   
               msdata:hiddenCustomerID="ANTON"   
               CustomerID="ANTON" OrderID="3"/>  
      </Customer>  
      <Customer diffgr:id="Customer4" msdata:rowOrder="3"   
                diffgr:hasChanges="inserted"   
                CustomerID="AROUT">  
         <CompanyName>Around the Horn</CompanyName>  
         <ContactName>Thomas Hardy</ContactName>  
         <Order diffgr:id="Order4" msdata:rowOrder="3"   
                diffgr:hasChanges="inserted"   
                msdata:hiddenCustomerID="AROUT"   
               CustomerID="AROUT" OrderID="4"/>  
      </Customer>  
    </DataInstance>  
    <diffgr:before>  
      <Order diffgr:id="Order1" msdata:rowOrder="0"   
             msdata:hiddenCustomerID="ALFKI"   
             CustomerID="ALFKI" OrderID="1"/>  
      <Customer diffgr:id="Customer1" msdata:rowOrder="0"   
                CustomerID="ALFKI">  
        <CompanyName>Alfreds Futterkiste</CompanyName>  
        <ContactName>Maria Anders</ContactName>  
      </Customer>  
      <Customer diffgr:id="Customer2" msdata:rowOrder="1"   
                CustomerID="ANATR">  
        <CompanyName>Ana Trujillo Emparedados y helados</CompanyName>  
        <ContactName>Ana Trujillo</ContactName>  
      </Customer>  
    </diffgr:before>  
  </diffgr:diffgram>  
</ROOT>

La logique DiffGram traite ce DiffGram comme suit :

  • Conformément à la logique de traitement DiffGram, tous les éléments de niveau supérieur dans le <mappage de blocs avant> aux tables correspondantes, comme décrit dans le schéma de mappage.

  • Le <bloc avant> possède un <élément Order> (dffgr :id="Order1 ») et un <élément Customer> (diffgr :id="Customer1 ») pour lequel il n’existe aucun élément correspondant dans le <bloc DataInstance> (avec le même ID). Cela indique une opération de suppression et les enregistrements sont supprimés des tables Cust et Ord.

  • Le <bloc avant> possède un <élément Customer> (diffgr :id="Customer2 ») pour lequel il existe un élément Customer> correspondant< dans le <bloc DataInstance> (avec le même ID). L’élément du <bloc DataInstance> spécifie diffgr :hasChanges="modified ».. Il s’agit d’une opération de mise à jour dans laquelle pour le client ANATR, les informations CompanyName et ContactName sont mises à jour dans la table Cust à l’aide de valeurs spécifiées dans le <bloc DataInstance> .

  • Le <bloc DataInstance> a un <élément Customer> (diffgr :id="Customer3 ») et un <élément Order> (diffgr :id="Order3 »). Aucun de ces éléments ne spécifie l’attribut diffgr :hasChanges . Par conséquent, la logique de traitement DiffGram ignore ces éléments.

  • Le <bloc DataInstance> a un <élément Customer> (diffgr :id="Customer4 ») et un <élément Order> (diffgr :id="Order4 ») pour lequel il n’existe aucun élément correspondant dans le <bloc avant> . Ces éléments dans le <bloc DataInstance> spécifient diffgr :hasChanges="inserted ».. Par conséquent, un nouvel enregistrement est ajouté dans la table Cust et dans la table Ord.

Pour tester le DiffGram

  1. Créez les tableaux suivants dans la base de données tempdb .

    CREATE TABLE Cust(  
        CustomerID  nchar(5) Primary Key,  
        CompanyName nvarchar(40) NOT NULL ,  
        ContactName nvarchar(60) NULL)  
GO  

CREATE TABLE Ord(  
   OrderID    int Primary Key,  
   CustomerID nchar(5) Foreign Key REFERENCES Cust(CustomerID))  
GO

  2. Ajoutez cet exemple de données :

    INSERT INTO Cust(CustomerID, CompanyName, ContactName) VALUES  
     (N'ALFKI', N'Alfreds Futterkiste', N'Maria Anders')  
INSERT INTO Cust(CustomerID, CompanyName, ContactName) VALUES  
     (N'ANATR', N'Ana Trujillo Emparedados y helados', N'Ana Trujillo')  
INSERT INTO Cust(CustomerID, CompanyName, ContactName) VALUES  
     (N'ANTON', N'Antonio Moreno Taquer??a', N'Antonio Moreno')  

INSERT INTO Ord(OrderID, CustomerID) VALUES(1, N'ALFKI')  
INSERT INTO Ord(OrderID, CustomerID) VALUES(2, N'ANATR')  
INSERT INTO Ord(OrderID, CustomerID) VALUES(3, N'ANTON')

  3. Copiez le DiffGram ci-dessus et collez-le dans un fichier texte. Enregistrez le fichier en tant que MyDiffGram.xml dans le même dossier utilisé à l’étape précédente.

  4. Copiez le fichier DiffGramSchema fourni précédemment dans cette rubrique et collez-le dans un fichier texte. Enregistrez le fichier en tant que DiffGramSchema.xml.

  5. Créez et utilisez le script de test SQLXML 4.0 (Sqlxml4test.vbs) pour exécuter le DiffGram.

    Pour plus d'informations, voir Utilisation d'ADO pour exécuter des requêtes SQLXML 4.0.

E. Application de mises à jour à l’aide d’un DiffGram avec l’annotation diffgr :parentID

Cet exemple montre comment l’annotation parentID spécifiée dans le <bloc avant> le bloc DiffGram est utilisée pour appliquer les mises à jour.

<NewDataSet />  
<diffgr:before>  
   <Order diffgr:id="Order1" msdata:rowOrder="0" OrderID="2" />  
   <Order diffgr:id="Order3" msdata:rowOrder="2" OrderID="4" />  
  
   <OrderDetail diffgr:id="OrderDetail1"   
                diffgr:parentId="Order1"   
                msdata:rowOrder="0"   
                ProductID="13"   
                OrderID="2" />  
   <OrderDetail diffgr:id="OrderDetail3"   
                diffgr:parentId="Order3"  
                ProductID="77"  
                OrderID="4"/>  
</diffgr:before>  
</diffgr:diffgram>

Ce DiffGram spécifie une opération de suppression, car il n’existe qu’un <bloc avant> . Dans le DiffGram, l’annotation parentID est utilisée pour spécifier une relation parent-enfant entre les commandes et les détails de commande. Lorsque SQLXML supprime les enregistrements, il supprime les enregistrements de la table enfant identifiée par cette relation, puis supprime les enregistrements de la table parente correspondante.

  • Last updated on