使用 FetchXML 查询数据

  • 10 分钟

FetchXML 是一种查询语言，由 Microsoft 开发，用于针对 Microsoft Dataverse 数据执行复杂的查询操作。 它提供比 OData 连接器多得多的筛选选项，允许您查看引用数据的标签，例如选项集标签或查阅字段。

您可以使用以下方法运行 FetchXML 查询：

  • Dataverse Web API

  • 组织服务

还可以将自定义 FetchXML 筛选器应用于模型驱动应用中的查阅字段。 该方法允许更复杂的查找应用场景，这些应用场景不容易开箱即用。 有关如何完成此流程的详细信息，请参阅 addCustomFilter 客户端 API 引用。

示例 FetchXML 查询

以下示例查询从客户表中检索 accountid 和 name 字段：

<fetch mapping='logical'>
   <entity name='account'>
      <attribute name='accountid'/>
      <attribute name='name'/>
   </entity>
</fetch>

如果您需要筛选这些数据，例如按状态筛选，可以执行以下示例查询：

<fetch mapping='logical'>
   <entity name='account'>
      <attribute name='accountid'/>
      <attribute name='name'/>
      <filter type='and'>
        <condition attribute='address1_stateorprovince' operator='eq' value='WA' />
      </filter>
   </entity>
</fetch>

用于帮助生成查询的工具

如果您要查询数据，并且有一个模型驱动应用包含您要查询的表，则构建 FetchXML 查询的最简单方法是使用高级查找，它包含下载 FetchXML 功能。 您只能使用可拉取的筛选器和相关数据的 UI，但是这通常是一个很好的开端，因为您不必亲自撰写 XML。

高级查找中下载 Fetch XML 的屏幕截图。

社区创建的另一个重要工具称为 FetchXML Builder。 通过此工具，您可以使用高级查找无法做到的方式（聚合、外部联接、“没有”查询和来自多级链接实体的属性）来构造 FetchXML。 它还提供了大量其他功能，您可以在其网站中找到这些功能：FetchXML Builder。

更多资源

有关 FetchXML 查询语言的更多详细信息，请查看使用 FetchXML 查询数据部分，其中涵盖了几个高级主题，例如处理分页、查询分层数据等。