排查 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}
      

后续步骤