通过

fetch 元素

FetchXml 查询的根元素。

了解如何使用 FetchXml 查询数据。

Example

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

特性

Name Required? Description
aggregate 否 用于指定查询返回聚合值的布尔值。 了解如何聚合数据
aggregatelimit 否 将限制设置为低于标准 50,000 条记录聚合限制。 了解聚合限制
count 否 正整数值，用于指定要在页面中返回的记录数。 了解分页结果
datasource 否 使用 Dataverse 长期数据保留时，设置为datasource'retained'指示查询仅用于保留行。 详细了解 Dataverse 长期数据保留
distinct 否 用于指定结果中不包含重复行的布尔值。 详细了解如何返回不同的结果
latematerialize 否 布尔值，用于指示查询分解为较小的部分，并在返回结果之前重新组合结果。 对某些长时间运行的查询使用 latematerialize 可能会提高性能。 详细了解如何使用 Late Materialize 查询。
no-lock 否 用于防止记录上的共享锁的旧设置。 不再需要。
options 否 一个字符串值，用于应用一个或多个 SQL 优化。 请参阅 选项
page 否 正整数值，用于指定要返回的页码。 了解分页结果
paging-cookie 否 数据上一页的字符串值，使检索下一页的数据更高效。 了解分页结果
returntotalrecordcount 否 用于指定是否返回与条件匹配的记录总数的布尔值。 了解如何使用 FetchXml 对行进行计数
top 否 正整数值，用于指定要返回的记录数。
此值不能超过 5,000。
请勿top与page或countreturntotalrecordcount属性一起使用。
详细了解如何限制行数
useraworderby 否 指定选择列数据排序应 使用原始排序依据 模式的布尔值。 这将按整数值对选项进行排序。 如果没有，默认值是使用选择标签值对选择列进行排序。

子元素

Name 事件 Description
实体 1 指定 提取元素的子元素，即查询的“父实体”。 只允许一个实体。

选项

重要

仅当Microsoft技术支持建议时应用这些选项。 使用这些选项不正确可能会损害查询的性能。

将这些值与属性一起使用 options ，以指定要应用于查询的 SQL Server 提示。 设置多个选项时，用逗号分隔它们。

options='HashJoin,DisableRowGoal'
查询选项 SQL Server 提示
ForceOrder 强制顺序
DisableRowGoal 提示： DISABLE_OPTIMIZER_ROWGOAL
EnableOptimizerHotfixes 提示： ENABLE_QUERY_OPTIMIZER_HOTFIXES
LoopJoin 循环联接
MergeJoin 合并联接
HashJoin 哈希联接
NO_PERFORMANCE_SPOOL NO_PERFORMANCE_SPOOL
ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS 提示： ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS

详细信息： 提示（Transact-SQL） - 查询