fetch, élément

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

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

Example

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

Attributes

Nom	Obligatoire ?	Descriptif
aggregate	Non	Valeur booléenne pour spécifier que la requête retourne des valeurs d’agrégation. En savoir plus sur l’agrégation des données
aggregatelimit	Non	Définissez une limite inférieure à la limite d’agrégation d’enregistrements standard de 50 000. En savoir plus sur les limites d’agrégation
count	Non	Valeur entière positive pour spécifier le nombre d’enregistrements à retourner dans une page. En savoir plus sur la pagination des résultats
datasource	Non	Lors de l’utilisation de la conservation des données à long terme dataverse, définissez datasource pour 'retained' 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 dupliquées ne sont pas incluses dans les résultats. En savoir plus sur le retour de résultats distincts
latematerialize	Non	Valeur booléenne pour diriger la requête à décomposer en parties plus petites et réassembler les résultats avant de les renvoyer. L’utilisation latematerialize peut améliorer les performances pour certaines requêtes de longue durée. En savoir plus sur l’utilisation de la requête Late Materialize.
no-lock	Non	Paramètre hérité pour empêcher les verrous partagés sur les enregistrements. Il n’est plus nécessaire.
options	Non	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 à retourner. En savoir plus sur la pagination des résultats
paging-cookie	Non	Valeur de chaîne d’une page précédente de données pour rendre la récupération de la page suivante des données 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 retourné. Découvrez comment compter des lignes à l’aide de FetchXml
top	Non	Valeur entière positive pour spécifier le nombre d’enregistrements à retourner. Cette valeur ne peut pas dépasser 5 000. N’utilisez top pas avec les attributs ou countreturntotalrecordcount les pageattributs. En savoir plus sur la limitation du nombre de lignes
useraworderby	Non	Valeur booléenne pour spécifier le tri des données de colonne de choix doit utiliser le mode Ordre brut par mode. Cela trie les options de choix par la valeur entière. Sans cela, la valeur par défaut consiste à trier les colonnes de choix à l’aide des valeurs d’étiquette de choix.

Éléments enfants

Nom	Occurrences	Descriptif
entité	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.

Options

Important

Appliquez uniquement ces options lorsque cela est recommandé par le support technique Microsoft. L’utilisation incorrecte de ces options peut endommager les performances d’une requête.

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

options='HashJoin,DisableRowGoal'

Option de requête	Indicateur SQL Server
ForceOrder	Forcer l’ordre
DisableRowGoal	Indice: DISABLE_OPTIMIZER_ROWGOAL
EnableOptimizerHotfixes	Indice: ENABLE_QUERY_OPTIMIZER_HOTFIXES
LoopJoin	Jointure de boucle
MergeJoin	Jointure de fusion
HashJoin	Jointure de hachage
NO_PERFORMANCE_SPOOL	NO_PERFORMANCE_SPOOL
ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS	Indice: ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS

Plus d’informations : indicateurs (Transact-SQL) - Requête