Fetch-Element

Das Stammelement einer FetchXml-Abfrage.

Erfahren Sie, wie man mithilfe von FetchXml Daten abfragt.

Beispiel

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

Attribute

Name des Dataflows	Erforderlich?	Eigenschaft
aggregate	Nein	Boolescher Wert, um anzugeben, dass die Abfrage Aggregatwerte zurückgibt. Informationen zum Aggregieren von Daten
aggregatelimit	Nein	Legen Sie einen Grenzwert fest, der unter dem standardmäßigen Gesamtlimit von 50.000 Datensätzen liegt. Weitere Informationen zu Aggregatgrenzwerten
count	Nein	Positiver Integer-Wert, um die Anzahl der Datensätze anzugeben, die auf einer Seite zurückgegeben werden sollen. Erfahren Sie mehr über Auslagerungsergebnisse
datasource	Nein	Bei der Verwendung der langfristige Datenaufbewahrung von Dataverse legen Sie datasource auf 'retained', um anzugeben, dass die Abfrage nur für beibehaltene Zeilen gilt. Weitere Informationen über die langfristige Datenaufbewahrung von Dataverse
distinct	Nein	Boolescher Wert, der angibt, dass doppelte Zeilen nicht in die Ergebnisse einbezogen werden. Weitere Informationen über die Rückgabe bestimmter Ergebnisse
latematerialize	Nein	Boolescher Wert, der anweist, dass die Abfrage in kleinere Teile zerlegt wird und die Ergebnisse vor der Rückgabe neu zusammengesetzt werden. Die Verwendung von latematerialize könnte die Leistung einiger lang andauernder Abfragen verbessern. Erfahren Sie mehr über die Verwendung der „Late Materialize“-Abfrage.
no-lock	Nein	Legacy-Einstellung, um gemeinsame Sperren für Datensätze zu verhindern. Nicht mehr notwendig.
options	Nein	Ein Zeichenfolgenwert zum Anwenden einer oder mehrerer SQL-Optimierungen. Siehe Optionen
page	Nein	Positiver Integer-Wert, um die Seitenzahl anzugeben, die zurückgegeben werden soll. Erfahren Sie mehr über Auslagerungsergebnisse
paging-cookie	Nein	Zeichenfolgenwert einer vorherigen Datenseite, um das Abrufen der nächsten Datenseite effizienter zu gestalten. Erfahren Sie mehr über Auslagerungsergebnisse
returntotalrecordcount	Nein	Boolescher Wert, der angibt, ob die Gesamtzahl der Datensätze zurückgegeben wird, die den Kriterien entsprechen. Erfahren Sie, wie Sie Zeilen mithilfe von FetchXml zählen
top	Nein	Positiver Integer-Wert, um die Anzahl der Datensätze anzugeben, die zurückgegeben werden sollen. Dieser Wert darf 5.000 nicht überschreiten. Verwenden Sie top nicht zusammen mit den page-, count- oder returntotalrecordcount-Attributen. Erfahren Sie mehr über die Begrenzung der Zeilenanzahl
useraworderby	Nein	Boolescher Wert, um anzugeben, dass die Sortierung der Auswahlspaltendaten den Modus Rohsortierung verwenden nach verwenden soll. Dadurch werden die Auswahloptionen nach dem Integerwert sortiert. Andernfalls werden Auswahlspalten standardmäßig anhand der Auswahlbeschriftungswerte sortiert.

Untergeordnete Elemente

Name des Dataflows	Ereignisse	Eigenschaft
Entität	1	Specifies the child element for a fetch element, the 'parent entity' for the query. Only one entity is allowed.

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).

Optionen

Wichtig

Wenden Sie diese Optionen nur an, wenn dies vom technischen Microsoft-Support empfohlen wird. Eine falsche Verwendung dieser Optionen kann die Leistung einer Abfrage beeinträchtigen.

Verwenden Sie diese Werte mit dem options-Attribut, um SQL Server-Hinweise anzugeben, die auf die Abfrage angewendet werden sollen. Wenn mehr als eine Option festgelegt ist, trennen Sie diese durch Kommas.

options='OptimizeForUnknown,DisableRowGoal,Recompile'

FetchXML-Option	SQL Server-Hinweis
OptimizeForUnknown	Für unbekannt optimieren
ForceOrder	Befehl durchsetzen
DisableRowGoal	Hinweis: DISABLE_OPTIMIZER_ROWGOAL
EnableOptimizerHotfixes	Hinweis: ENABLE_QUERY_OPTIMIZER_HOTFIXES
LoopJoin	Loop verbinden
MergeJoin	Zusammenführen
HashJoin	Hash Join
NO_PERFORMANCE_SPOOL	NO_PERFORMANCE_SPOOL
ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS	Hinweis: ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS

Weitere Informationen: Hinweise (Transact-SQL) – Abfrage