Élément fetch

L’élément racine d’une requête FetchXml.

Découvrez comment interroger des données à l’aide de FetchXml.

Exemple

<fetch>
  <entity name='account' />
</fetch>

Attributs

Nom	Obligatoire ?	Description
aggregate	Non	Valeur booléenne pour spécifier que la requête renvoie des valeurs agrégées. En savoir plus sur l’agrégation des données
aggregatelimit	Non	Définissez une limite inférieure à la limite d’agrégation standard de 50 000 enregistrements. En savoir plus sur les limites d’agrégation
count	Non	Valeur entière positive pour spécifier le nombre d’enregistrements à renvoyer dans une page. En savoir plus sur la pagination des résultats
datasource	Non	Lorsque vous utilisez la conservation des données à long terme Dataverse, définissez datasource sur 'retained' pour indiquer que la requête concerne uniquement les lignes conservées. En savoir plus sur la conservation des données à long terme Dataverse
distinct	Non	Valeur booléenne pour spécifier que les lignes en double ne doivent pas être incluses dans les résultats. En savoir plus sur le renvoi de résultats distincts
latematerialize	Non	Valeur booléenne pour indiquer que la requête doit être divisée en parties plus petites et réassembler les résultats avant de les renvoyer. L’utilisation de latematerialize peut améliorer les performances de certaines requêtes longues. En savoir plus sur l’utilisation de la requête Matérialisation tardive.
no-lock	Non	Paramètre hérité pour empêcher les verrous partagés sur les enregistrements. Ce paramètre n’est plus nécessaire.
options	Non	Une valeur de chaîne pour appliquer une ou plusieurs optimisations SQL. Voir options
page	Non	Valeur entière positive pour spécifier le numéro de page à renvoyer. En savoir plus sur la pagination des résultats
paging-cookie	Non	Valeur de chaîne d’une page de données précédente pour rendre la récupération de la page de données suivante plus efficace. En savoir plus sur la pagination des résultats
returntotalrecordcount	Non	Valeur booléenne pour spécifier si le nombre total d’enregistrements correspondant aux critères est renvoyé. Découvrez comment compter des lignes à l’aide de FetchXml
top	Non	Valeur entière positive pour spécifier le nombre d’enregistrements à renvoyer. Cette valeur ne peut pas dépasser 5 000. N’utilisez pas top avec les attributs page, count ou returntotalrecordcount. En savoir plus sur la limitation du nombre de lignes
useraworderby	Non	Valeur booléenne pour spécifier que le tri des données de la colonne de choix doit utiliser le mode Utiliser l’ordre brut par. Ce paramètre trie les options de choix par valeur entière. Sinon, la valeur par défaut consiste à trier les colonnes de choix en utilisant les valeurs des étiquettes de choix.

Éléments enfants

Nom	Occurrences	Description
entity	1	Spécifie l’élément enfant d’un élément fetch, l’entité parente de la requête. Une seule entité est autorisée.

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).

Options

Important

Appliquez ces options uniquement lorsqu’elles sont recommandées par le support technique Microsoft. Une utilisation incorrecte de ces options peut dégrader les performances d’une requête.

Utilisez ces valeurs avec l’attribut options pour spécifier les indicateurs SQL Server à appliquer à la requête. Lorsque plusieurs options sont définies, séparez-les par des virgules.

options='OptimizeForUnknown,DisableRowGoal,Recompile'

Option FetchXML	Conseil SQL Server
OptimizeForUnknown	Optimiser pour inconnu
ForceOrder	Forcer l’ordre
DisableRowGoal	Conseil : DISABLE_OPTIMIZER_ROWGOAL
EnableOptimizerHotfixes	Conseil : ENABLE_QUERY_OPTIMIZER_HOTFIXES
LoopJoin	Mettre en boucle la jonction
MergeJoin	Fusionner la jonction
HashJoin	Hacher la jonction
NO_PERFORMANCE_SPOOL	NO_PERFORMANCE_SPOOL
ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS	Conseil : ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS

Plus d’information : Conseils (Transact-SQL) - Requête