排查 Microsoft Purview 数据映射 API 请求超时异常

项目
03/13/2024

适用于 Microsoft Purview 数据映射 API 返回的 HTTP 408 请求超时。

疑难解答步骤

下面的列表包含请求超时异常的已知模式和解决方案。

如果它与你的情况不匹配，或者应用解决方案后无法解决失败，请带着所有请求历史记录联系 Microsoft 客户支持。

列出所有术语表超时

# https://learn.microsoft.com/rest/api/purview/datamapdataplane/glossary/get-term
GET {endpoint}/datamap/api/atlas/v2/glossary?ignoreTermsAndCategories={ignoreTermsAndCategories}&limit={limit}&offset={offet}&sort={sort}

默认情况下，此 API 返回所有术语表以及这些术语表下的所有术语/类别。如果有 1000 个词汇表，每个术语表有 1000 个术语和 1000 个类别，则返回 1000 个术语表，其中 1000 * （1000 个术语 + 1000 个类别）。

所有相关术语/类别的大小可能太大，无法通过单个 API 在合理的持续时间内提取。使用查询参数 ignoreTermsAndCategories=true 减少服务器端加载的总计数，并缩小网络传输的响应大小。如果仍需要术语/类别，可以结合以下 API 提取它们。

列出特定术语表下的术语

# https://learn.microsoft.com/rest/api/purview/datamapdataplane/glossary/list-categories
GET {endpoint}/datamap/api/atlas/v2/glossary/{glossaryGuid}/terms?limit={limit}&offset={offset}&sort={sort}

列出特定术语表下的类别

# https://learn.microsoft.com/rest/api/purview/datamapdataplane/glossary/list-terms
GET {endpoint}/datamap/api/atlas/v2/glossary/{glossaryGuid}/categories?limit={limit}&offset={offset}&sort={sort}

所有术语表计数的大小可能太大，无法通过单个 API 在合理的持续时间内提取。使用查询参数 limit 和具有较小分页大小的 offset 逐页获取词汇表。

获取包含详细信息的术语表超时

GET {endpoint}/datamap/api/atlas/v2/glossary/{glossaryGuid}/detailed

默认情况下，此 API 返回术语表以及这些术语表下的所有术语/类别。

所有相关术语/类别的大小可能太大，无法通过单个 API 在合理的持续时间内提取。建议使用以下 API 来获得更好的分页体验。

获取特定术语表

# https://learn.microsoft.com/rest/api/purview/datamapdataplane/glossary/get
GET {endpoint}/datamap/api/atlas/v2/glossary/{glossaryGuid}

列出特定术语表下的术语

# https://learn.microsoft.com/rest/api/purview/datamapdataplane/glossary/list-terms
GET {endpoint}/datamap/api/atlas/v2/glossary/{glossaryGuid}/terms?limit={limit}&offset={offset}&sort={sort}

列出特定术语表下的类别

# https://learn.microsoft.com/rest/api/purview/datamapdataplane/glossary/list-categories
GET {endpoint}/datamap/api/atlas/v2/glossary/{glossaryGuid}/categories?limit={limit}&offset={offset}&sort={sort}

列出特定术语表下的所有术语超时

# https://learn.microsoft.com/rest/api/purview/datamapdataplane/glossary/list-terms
GET {endpoint}/datamap/api/atlas/v2/glossary/{glossaryGuid}/terms

默认情况下，此 API 返回术语表下的所有术语。

术语表下的所有术语的大小可能太大，无法通过单个 API 在合理的持续时间内提取。使用查询参数 limit 和具有较小分页大小的 offset 逐页列举术语。

# https://learn.microsoft.com/rest/api/purview/datamapdataplane/glossary/list-terms
GET {endpoint}/datamap/api/atlas/v2/glossary/{glossaryGuid}/terms?limit={limit}&offset={offset}&sort={sort}

获取单个术语超时

# https://learn.microsoft.com/rest/api/purview/datamapdataplane/glossary/get-term
GET {endpoint}/datamap/api/atlas/v2/glossary/term/{termGuid}

默认情况下，此 API 将返回术语及其所有关系。例如，assignedEntities、父/子术语。

术语中的 assignedEntities 的大小可能太大，无法通过单个 API 在合理的持续时间内提取。使用查询参数 excludeRelationshipTypes 忽略响应中称为 AtlasGlossarySemanticAssignment 的 assignedEntities 关系。然后使用另一个专用 API 通过分页获取 assignedEntities。

获取特定术语

# https://learn.microsoft.com/rest/api/purview/datamapdataplane/glossary/get-term
GET {endpoint}/datamap/api/atlas/v2/glossary/term/{termGuid}?excludeRelationshipTypes=AtlasGlossarySemanticAssignment

列出特定术语下的 assignedEntities

# https://learn.microsoft.com/rest/api/purview/datamapdataplane/glossary/list-entities-assigned-with-term
GET {endpoint}/datamap/api/atlas/v2/glossary/terms/{termGuid}/assignedEntities?limit={limit}&offset={offset}&sort={sort}

通过