Clause FOR (Transact-SQL)

La clause FOR est utilisée pour spécifier l'option BROWSE ou l'option XML. BROWSE et XML sont des options non liées.

Conventions de la syntaxe de Transact-SQL

Syntaxe

[ FOR { BROWSE | <XML> } ]
<XML> ::=
XML 
{ 
    { RAW [ ( 'ElementName' ) ] | AUTO } 
    [ 
        <CommonDirectives> 
        [ , { XMLDATA | XMLSCHEMA [ ( 'TargetNameSpaceURI' ) ] } ] 
        [ , ELEMENTS [ XSINIL | ABSENT ] 
    ]
  | EXPLICIT 
    [ 
        <CommonDirectives> 
        [ , XMLDATA ] 
    ]
  | PATH [ ( 'ElementName' ) ] 
    [
        <CommonDirectives> 
        [ , ELEMENTS [ XSINIL | ABSENT ] ]
    ]
} 

<CommonDirectives> ::= 
[ , BINARY BASE64 ]
[ , TYPE ]
[ , ROOT [ ( 'RootName' ) ] ]

Arguments

• BROWSE
  Indique que des mises à jour sont autorisées pendant la consultation des données dans un curseur de mode de navigation DB-Library. Il est possible de naviguer dans une table d'une application si la table inclut une colonne timestamp, si elle possède un index unique, et si l'option FOR BROWSE se trouve à la fin des instructions SELECT envoyées à une instance de SQL Server.

  Remarque :
  Il est impossible d'utiliser <lock_hint> HOLDLOCK dans une instruction SELECT qui comporte l'option FOR BROWSE.

  FOR BROWSE ne peut pas apparaître dans des instructions SELECT qui sont jointes par l'opérateur UNION.

  Remarque :
  Lorsque les colonnes de clé d'index unique d'une table peuvent accepter les valeurs NULL, et si la table se trouve sur le côté intérieur d'une jointure externe, l'index n'est pas pris en charge par le mode de navigation.

• XML
  Spécifie que les résultats d'une requête doivent être retournés sous la forme d'un document XML. Un des modes XML suivants doit être spécifié : RAW, AUTO ou EXPLICIT. Pour plus d'informations sur les données XML et sur SQL Server, consultez Construction de code XML à l'aide de FOR XML.

• RAW [ ('ElementName') ]
  Prend le résultat de la requête et transforme chaque ligne du jeu de résultats en un élément XML comportant un identificateur générique <row /> comme balise d'élément. Vous pouvez éventuellement spécifier un nom pour l'élément de ligne. La sortie XML utilise le paramètre ElementName spécifié comme élément de ligne généré pour chaque ligne. Pour plus d'informations, consultez Utilisation du mode RAW et Optimisation du mode RAW.

• AUTO
  Retourne les résultats de la requête dans une arborescence XML simple et imbriquée. Chaque table de la clause FROM, dont au moins une colonne est répertoriée dans la clause SELECT, est représentée sous la forme d'un élément XML. Les colonnes figurant dans la clause SELECT sont mappées vers les attributs d'éléments appropriés. Pour plus d'informations, consultez Utilisation du mode AUTO et Améliorations du mode AUTO.

• EXPLICIT
  Spécifie que la forme de l'arborescence XML résultante est définie de manière explicite. L'utilisation de ce mode nécessite toutefois que les requêtes soient écrites d'une manière particulière, de sorte que les informations complémentaires sur l'imbrication souhaitée soient spécifiées de manière explicite. Pour plus d'informations, consultez Utilisation du mode EXPLICIT et Améliorations apportées au mode EXPLICIT.

• XMLDATA
  Retourne un schéma XDR inclus, mais n'ajoute pas l'élément racine au résultat. Si XMLDATA est spécifié, le schéma XDR est ajouté au document.

• XMLSCHEMA [ ('TargetNameSpaceURI') ]
  Retourne le schéma XSD inclus. Lorsque vous spécifiez cette directive, vous pouvez éventuellement spécifier un URI d'espace de noms cible, qui retourne l'espace de noms spécifié dans le schéma. Pour plus d'informations, consultez Génération de schéma XSD en ligne.

• ELEMENTS
  Spécifie que les colonnes sont retournées sous la forme de sous-éléments. Sinon, elles sont mappées avec des attributs XML. Cette option est prise en charge dans les modes RAW, AUTO et PATH uniquement. Pour plus d'informations, consultez Optimisation du mode RAW.

• XSINIL
  Spécifie qu'un élément ayant un attribut xsi:nil défini à True soit créé pour les valeurs de colonne NULL. Cette option peut uniquement être spécifiée avec la directive ELEMENTS. Pour plus d'informations, consultez Génération d'éléments pour des valeurs NULL à l'aide du paramètre XSINIL.

• ABSENT
  Indique que pour les valeurs de colonne NULL, les éléments XML correspondants ne seront pas ajoutés dans le résultat XML. Vous ne devez spécifier cette option qu'avec ELEMENTS.

• PATH [ ('ElementName') ]
  Génère un élément wrapper <row> pour chaque ligne du jeu de résultats. Vous pouvez éventuellement spécifier un nom d'élément pour l'élément wrapper <row>. Si une chaîne vide est fournie, comme FOR XML PATH ('') ), aucun élément wrapper n'est généré. L'utilisation de PATH peut constituer une solution plus simple pour les requêtes écrites à l'aide de la directive EXPLICIT. Pour plus d'informations, consultez Utilisation du mode PATH.

• BINARY BASE64
  Spécifie que la requête retourne les données binaires au format binaire codé base64. Cette option doit être spécifiée lors de l'extraction de données binaires en mode RAW et EXPLICIT. Cette option est utilisée par défaut en mode AUTO.

• TYPE
  Spécifie que la requête retourne des résultats de type xml. Pour plus d'informations, consultez Directive TYPE dans les requêtes FOR XML.

• ROOT [ ('RootName') ]
  Spécifie qu'un élément de premier niveau unique doit être ajouté au XML résultant. Vous pouvez éventuellement spécifier le nom de l'élément racine à générer. Si le nom de racine facultatif n'est pas spécifié, l'élément <root> par défaut est ajouté.

Exemple

L'exemple suivant spécifie FOR XML AUTO avec les options TYPE et XMLSCHEMA. En raison de la présence de l'option TYPE, le jeu de résultats est retourné au client comme un type xml. L'option XMLSCHEMA spécifie que le schéma XSD inclus est intégré aux données XML retournées, et l'option ELEMENTS spécifie que le résultat XML est centré sur les éléments.

USE AdventureWorks;
GO
SELECT ContactID, FirstName, LastName, Phone
FROM Person.Contact
WHERE LastName LIKE 'G%'
ORDER BY LastName, FirstName 
FOR XML AUTO, TYPE, XMLSCHEMA, ELEMENTS XSINIL;

Voir aussi

Référence

SELECT (Transact-SQL)

Autres ressources

Utilisation de FOR XML et OPENXML pour publier et traiter des données XML

Aide et Informations

Assistance sur SQL Server 2005