Identification de colonnes clés à l'aide de sql:key-fields (SQLXML 4.0)
Lorsqu'une requête XPath est spécifiée contre un schéma XSD, les informations de clés sont requises dans la plupart des cas pour obtenir une imbrication correcte dans le résultat. La spécification de l'annotation sql:key-fields est une méthode permettant de garantir que la hiérarchie appropriée est générée.
Notes
Pour garantir l'imbrication correcte, il est recommandé de spécifier sql:key-fields pour les éléments qui mappent à des tables. Le XML produit est sensible au classement du jeu de résultats sous-jacent. Si sql:key-fields n'est pas spécifié, il se peut que le XML généré ne soit pas formé correctement.
La valeur de sql:key-fields identifie le ou les colonnes qui identifient de manière unique les lignes dans la relation. Si plusieurs colonnes sont requises pour identifier une ligne de manière unique, les valeurs de colonnes sont délimitées par des espaces.
Vous devez utiliser l'annotation sql:key-fields lorsqu'un élément contient un <sql:relationship> qui est défini entre l'élément et un élément enfant mais qui ne fournit pas la clé primaire de la table spécifiée dans l'élément parent.
Exemples
Pour créer des exemples fonctionnels à l'aide des exemples suivants, vous devez remplir certaines conditions. Pour plus d'informations, consultez Configuration requise pour l'exécution des exemples SQLXML.
A. Production de l'imbrication appropriée lorsque <sql:relationship> ne fournit pas d'informations suffisantes
Cet exemple montre où sql:key-fields doit être spécifié.
Prenons le schéma suivant : Le schéma spécifie une hiérarchie entre les éléments <Order> et <Customer>, dans lesquels l'élément <Order> est le parent et l'élément <Customer> est un enfant.
La balise <sql:relationship> est utilisée pour spécifier la relation parent-enfant. Elle identifie CustomerID dans la table Sales.SalesOrderHeader comme clé parente qui fait référence à la clé enfant CustomerID dans la table Sales.Customer. Les informations fournies dans <sql:relationship> ne sont pas suffisantes pour identifier de manière unique des lignes dans la table parente (Sales.SalesOrderHeader). Par conséquent, sans l'annotation sql:key-fields, la hiérarchie générée est inexacte.
Avec sql:key-fields spécifié sur <Order>, l'annotation identifie de manière unique les lignes dans le parent (table Sales.SalesOrderHeader) et ses éléments enfants apparaissent sous son parent.
Voici le schéma :
<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="OrdCust"
parent="Sales.SalesOrderHeader"
parent-key="CustomerID"
child="Sales.Customer"
child-key="CustomerID" />
</xsd:appinfo>
</xsd:annotation>
<xsd:element name="Order" sql:relation="Sales.SalesOrderHeader"
sql:key-fields="SalesOrderID">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Customer" sql:relation="Sales.Customer"
sql:relationship="OrdCust" >
<xsd:complexType>
<xsd:attribute name="CustID" sql:field="CustomerID" />
<xsd:attribute name="SoldBy" sql:field="SalesPersonID" />
</xsd:complexType>
</xsd:element>
</xsd:sequence>
<xsd:attribute name="SalesOrderID" type="xsd:integer" />
<xsd:attribute name= "CustomerID" type="xsd:string" />
</xsd:complexType>
</xsd:element>
</xsd:schema>
Pour créer un exemple fonctionnel de ce schéma
Copiez le code du schéma ci-dessus et collez-le dans un fichier texte. Enregistrez le fichier en tant que KeyFields1.xml.
Copiez le modèle suivant et collez-le dans un fichier texte. Enregistrez le fichier en tant que KeyFields1T.xml dans le même répertoire où vous avez enregistré KeyFields1.xml. La requête XPath dans le modèle retourne tous les éléments <Order> avec un CustomerID inférieur à 3.
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"> <sql:xpath-query mapping-schema="KeyFields1.xml"> /Order[@CustomerID < 3] </sql:xpath-query> </ROOT>Le chemin d'accès au répertoire spécifié pour le schéma de mappage (KeyFields1.xml) est relatif au répertoire où le modèle est enregistré. Vous pouvez également spécifier un chemin d'accès absolu, par exemple :
mapping-schema="C:\MyDir\KeyFields1.xml"Créez et utilisez le script de test SQLXML 4.0 (Sqlxml4test.vbs) pour exécuter le modèle.
Pour plus d'informations, consultez Utilisation d'ADO pour exécuter des requêtes SQLXML.
Voici le jeu de résultats partiel :
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
<Order SalesOrderID="43860" CustomerID="1">
<Customer CustID="1" SoldBy="280"/>
</Order>
<Order SalesOrderID="44501" CustomerID="1">
<Customer CustID="1" SoldBy="280"/>
</Order>
<Order SalesOrderID="45283" CustomerID="1">
<Customer CustID="1" SoldBy="280"/>
</Order>
.....
</ROOT>
B. Spécification de sql:key-fields afin de produire l'imbrication correcte dans le résultat
Dans le schéma suivant, il n'y a aucune hiérarchie spécifiée à l'aide de <sql:relationship>. Le schéma requiert encore la spécification de l'annotation sql:key-fields afin d'identifier de manière unique les employés dans la table HumanResources.Employee.
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:element name="HumanResources.Employee" sql:key-fields="BusinessEntityID" >
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Title">
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="BusinessEntityID" type="xsd:integer" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
Pour créer un exemple fonctionnel de ce schéma
Copiez le code du schéma ci-dessus et collez-le dans un fichier texte. Enregistrez le fichier en tant que KeyFields2.xml.
Copiez le modèle suivant et collez-le dans un fichier texte. Enregistrez le fichier en tant que KeyFields2T.xml dans le même répertoire où vous avez enregistré KeyFields2.xml. La requête XPath dans le modèle retourne tous les éléments <HumanResources.Employee> :
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"> <sql:xpath-query mapping-schema="KeyFields2.xml"> /HumanResources.Employee </sql:xpath-query> </ROOT>Le chemin d'accès au répertoire spécifié pour le schéma de mappage (KeyFields2.xml) est relatif au répertoire où le modèle est enregistré. Vous pouvez également spécifier un chemin d'accès absolu, par exemple :
mapping-schema="C:\MyDir\KeyFields2.xml"Créez et utilisez le script de test SQLXML 4.0 (Sqlxml4test.vbs) pour exécuter le modèle.
Pour plus d'informations, consultez Utilisation d'ADO pour exécuter des requêtes SQLXML.
Voici le résultat obtenu :
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
<HumanResources.Employee>
<Title BusinessEntityID="1">Production Technician - WC60</Title>
</HumanResources.Employee>
<HumanResources.Employee>
<Title BusinessEntityID="2">Marketing Assistant</Title>
</HumanResources.Employee>
<HumanResources.Employee>
<Title BusinessEntityID="3">Engineering Manager</Title>
</HumanResources.Employee>
...
</ROOT>