Annotations XDR (désapprouvées dans SQLXML 4.0)
Important
Cette rubrique est fournie à titre de référence pour les applications héritées. Cette fonctionnalité ne fera plus l'objet d'aucun travail de développement. Évitez de l'utiliser dans vos nouveaux travaux de développement. Utilisez à la place des schémas XSD annotés pour créer des vues XML. Pour plus d'informations, consultez Introduction aux schémas XSD annotés (SQLXML 4.0). Vous pouvez convertir les schémas XDR annotés existants en schémas XSD. Pour plus d'informations, consultez Conversion de schémas XDR annotés en schémas XSD équivalents (SQLXML 4.0).
SQL Server continue de fournir plusieurs annotations au langage de schéma XDR qui ont été introduites dans SQL Server 2000. Ces annotations peuvent être utilisées dans le schéma XDR pour spécifier le mappage des données XML aux données relationnelles, notamment le mappage entre les éléments et les attributs du schéma XDR aux tables/vues et aux colonnes dans les bases de données. Par défaut, un nom d'élément dans un schéma annoté est mappé à un nom de table (vue) dans la base de données spécifiée et le nom d'attribut est mappé au nom de colonne. Ces annotations peuvent également être utilisées pour spécifier les relations hiérarchiques en XML (et donc représenter les relations dans la base de données).
Le tableau suivant répertorie les annotations.
Annotation |
Description |
Lien de rubrique |
|---|---|---|
sql:relation |
Mappe un élément XML à la table de base de données. |
|
sql:field |
Mappe un élément XML et la colonne de base de données. |
|
sql:is-constant |
Crée un élément XML qui n'est mappé à aucune table. L'élément apparaît dans le résultat de la requête. |
Création d'éléments constants à l'aide de sql:is-constant (schéma XDR) |
sql:map-field |
Permet à des éléments de schéma d'être exclus du résultat. |
Exclusion d'éléments du schéma du document XML obtenu à l'aide de sql:map-field (schéma XDR) |
<sql:relationship> |
Spécifie des relations entre des éléments XML. Les attributs key, key-relation, foreign-key et foreign-relation sont utilisés pour établir la relation. |
Spécification de relations à l'aide de sql:relationship (schéma XDR) |
sql:limit-fieldsql:limit-value |
Autorise la limitation des valeurs retournées selon une valeur de limitation. |
Filtrage de valeurs à l'aide des annotations sql:limit-field et sql:limit-value (schéma XDR) |
sql:key-fields |
Permet de spécifier une ou des colonnes qui identifient de façon unique les lignes d'une table. |
Identification de colonnes clés à l'aide de sql:key-fields (schéma XDR) |
sql:target-namespace |
Autorise le placement des éléments et des attributs de l'espace de noms par défaut dans un espace de noms différent pour les résultats de requêtes. |
Spécification d'un espace de noms cible à l'aide de sql:target-namespace (schéma XDR) |
sql:id-prefix |
Crée des attributs ID, IDREF et IDREFS XML valides. Ajoute les valeurs des attributs ID, IDREF et IDREFS avec une chaîne. |
Création d'attributs de type ID, IDREF et IDREFS valides à l'aide de sql:id-prefix (schéma XDR) |
sql:use-cdata |
Permet de spécifier les sections CDATA à utiliser pour certains éléments dans le document XML. |
Création de sections CDATA à l'aide de sql:use-cdata (schéma XDR) |
sql:url-encode |
Lorsque l'élément/attribut XML est mappé à une colonne BLOB SQL Server, autorise le retour d'une demande de référence (URI) qui peut être utilisée ultérieurement pour les données BLOB. |
Demande de références URL à des données BLOB à l'aide de sql:url-encode (schéma XDR) |
sql:overflow-field |
Identifie la colonne de la base de données qui contient les données de dépassement. |
Extraction de données non consommées à l'aide de sql:overflow-field (schéma XDR) |
[!REMARQUE]
Tous les exemples présentés dans les rubriques de cette section spécifient des requêtes XPath simples sur le schéma XDR annoté décrit dans chaque exemple. Ces exemples présument que vous connaissiez le langage XPath. Pour plus d'informations, consultez Utilisation des requêtes XPath dans SQLXML 4.0.