Microsoft Graph 数据连接中的用户选择和筛选功能

  • 项目

你可以使用 Microsoft Graph 数据连接来选择要提取其数据的用户，并包含筛选器以限制返回的数据。 本文介绍数据连接提供的用户选择选项，以及它支持的筛选功能。

用户选择

可以针对一组用户运行管道。 下面是适用于用户选择的选项：

  • 组织内的所有用户
  • 组织内最多有 10 个用户组
  • 基于谓词的一组用户，由Microsoft Entra用户属性组成

在Azure Synapse或Azure 数据工厂复制活动的 SourceDataSet 中指定用户选择。 若要针对组列表运行，请在 typeProperties 下添加一个新字段 allowedGroups，并将此字段设置为最多 10 个组的列表，对象 Id 由逗号分隔。 如果默认情况下未指定组，则为整个组织提取数据。

若要指定针对整个租户运行的谓词，请在 typeProperties 下添加一个新字段 userScopeFilterUri，并将此字段设置为该谓词。 谓词格式应与 Microsoft Graph API 的查询格式匹配。 例如，如果要仅选择在财务部门工作的用户，你可以使用 https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'。 如果要仅选择一个用户，可使用 https://graph.microsoft.com/v1.0/users?$filter=mail eq 'contosouser1@contoso.com'。

查询仅返回你所查询的 Microsoft 365 组织内的用户。 不会返回来宾用户和非用户邮箱。

筛选

可以使用日期时间属性来限制查询提取到的结果。 根据所请求数据的类型，可能需要日期时间筛选器。 DateTime 筛选器通过使用Azure Synapse或Azure 数据工厂复制活动的 SourceDataSet 中的属性提供。 若要指定日期时间筛选器，请在 typeProperties 下添加一个新字段 dateFilterColumn，并将此字段设置为下表中支持筛选的属性之一。 接着，添加表示日期时间值的 startTime 和 endTime，系统将依据这些值对属性进行筛选。

以下数据集需要针对相应的其中一个日期时间属性提供筛选器。

数据集名称 支持筛选的属性
BasicDataSet_v0.Event_v0
BasicDataSet_v0.Event_v1		 CreatedDateTime
LastModifiedDateTime
BasicDataSet_v0.Message_v0
BasicDataSet_v0.Message_v1		 CreatedDateTime
LastModifiedDateTime
ReceivedDateTime
SentDateTime
BasicDataSet_v0.SentItem_v0
BasicDataSet_v0.SentItem_v1		 CreatedDateTime
LastModifiedDateTime
ReceivedDateTime
SentDateTime

注意

请求 BasicDataSet_v0.CalendarView_v0 的管道也需要日期时间筛选器，但 SourceDataSet 中未指定 dateFilterColumn。 但是，需要 startTime 和 endTime，且只提供了在 startTime 之后开始并在 endTime 之前完成的事件。

相关内容