sql:relationship e regola di ordinamento delle chiavi (SQLXML 4.0)
Poiché il caricamento bulk XML consente di generare record quando i nodi entrano nell'ambito e di inviare tali record a Microsoft SQL Server quando i nodi abbandonano l'ambito, i dati per il record devono essere presenti nell'ambito del nodo.
Si consideri lo schema XSD seguente, in cui viene specificata la relazione uno-a-molti tra gli elementi <Customer> e <Order> (un cliente può effettuare molti ordini) tramite l'elemento <sql:relationship>:
<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>
Quando il nodo elemento <Customer> entra nell'ambito, il caricamento bulk XML genera un record del cliente. Questo record viene mantenuto fino a quando il caricamento bulk XML non legge </Customer>. Nell'elaborare il nodo elemento <Order>, il caricamento bulk XML utilizza <sql:relationship> per ottenere il valore della colonna di chiave esterna CustomerID della tabella CustOrder dall'elemento padre <Customer>, in quanto l'elemento <Order> non specifica l'attributo CustomerID. Di conseguenza, nel definire l'elemento <Customer>, è necessario specificare l'attributo CustomerID nello schema prima di specificare <sql:relationship>. In caso contrario, quando un elemento <Order> entra nell'ambito, il caricamento bulk XML consente di generare un record per la tabella CustOrder e quando il caricamento bulk XML raggiunge il tag di fine </Order>, consente di inviare il record a SQL Server senza il valore della colonna di chiave esterna CustomerID.
Salvare lo schema fornito in questo esempio come file SampleSchema.xml.
Per testare un esempio reale
Creare le tabelle seguenti:
CREATE TABLE Cust ( CustomerID int PRIMARY KEY, CompanyName varchar(20) NOT NULL, City varchar(20) DEFAULT 'Seattle') GO CREATE TABLE CustOrder ( OrderID varchar(10) PRIMARY KEY, CustomerID int FOREIGN KEY REFERENCES Cust(CustomerID)) GO
Salvare i dati di esempio seguenti come file SampleXMLData.xml:
<ROOT> <Customers> <CompanyName>Hanari Carnes</CompanyName> <City>NY</City> <Order OrderID="1" /> <Order OrderID="2" /> <CustomerID>1111</CustomerID> </Customers> <Customers> <CompanyName>Toms Spezialitten</CompanyName> <City>LA</City> <Order OrderID="3" /> <CustomerID>1112</CustomerID> </Customers> <Customers> <CompanyName>Victuailles en stock</CompanyName> <Order OrderID="4" /> <CustomerID>1113</CustomerID> </Customers> </ROOT>
Per eseguire il caricamento bulk XML, salvare ed eseguire l'esempio di Microsoft Visual Basic, Scripting Edition (VBScript) seguente come file MySample.vbs:
set objBL = CreateObject("SQLXMLBulkLoad.SQLXMLBulkload.4.0") objBL.ConnectionString = "provider=SQLOLEDB;data source=localhost;database=tempdb;integrated security=SSPI" objBL.ErrorLogFile = "c:\error.log" objBL.CheckConstraints = True objBL.Transaction=True objBL.Execute "c:\SampleSchema.xml", "c:\SampleXMLData.xml" set objBL=Nothing
Come risultato, il caricamento bulk XML inserisce un valore NULL nella colonna di chiave esterna CustomerID della tabella CustOrder. Se in seguito a revisione si modificano i dati di esempio XML in modo che l'elemento figlio <CustomerID> venga visualizzato prima dell'elemento figlio <Order>, si ottiene il risultato previsto, ovvero il caricamento bulk XML inserisce nella colonna il valore di chiave esterna specificato.
Di seguito viene riportato lo schema XDR equivalente:
<?xml version="1.0" ?>
<Schema xmlns="urn:schemas-microsoft-com:xml-data"
xmlns:dt="urn:schemas-microsoft-com:xml:datatypes"
xmlns:sql="urn:schemas-microsoft-com:xml-sql" >
<ElementType name="CustomerID" />
<ElementType name="CompanyName" />
<ElementType name="City" />
<ElementType name="root" sql:is-constant="1">
<element type="Customers" />
</ElementType>
<ElementType name="Customers" sql:relation="Cust" >
<element type="CustomerID" sql:field="CustomerID" />
<element type="CompanyName" sql:field="CompanyName" />
<element type="City" sql:field="City" />
<element type="Order" >
<sql:relationship
key-relation ="Cust"
key ="CustomerID"
foreign-key ="CustomerID"
foreign-relation="CustOrder" />
</element>
</ElementType>
<ElementType name="Order" sql:relation="CustOrder" >
<AttributeType name="OrderID" />
<AttributeType name="CustomerID" />
<attribute type="OrderID" />
<attribute type="CustomerID" />
</ElementType>
</Schema>