排查 Microsoft Purview 数据映射 API 请求超时异常
适用于 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}