Поделиться через

Устранение неполадок с исключениями времени ожидания запросов API Схема данных Microsoft Purview

Применяется к Схема данных Microsoft Purview API вернул время ожидания запроса HTTP 408.

Действия по устранению неполадок

В следующем списке содержатся известные шаблоны и решения для исключений времени ожидания запроса.

Если это не соответствует вашему случаю или сбой не может быть устранен после применения решения, обратитесь в службу поддержки майкрософт со всем журналом запросов.

Время ожидания для вывода списка всех глоссариев

# https://learn.microsoft.com/en-us/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/en-us/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/en-us/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/en-us/rest/api/purview/datamapdataplane/glossary/get
GET {endpoint}/datamap/api/atlas/v2/glossary/{glossaryGuid}

    • Перечисление терминов в определенном глоссарии

      # https://learn.microsoft.com/en-us/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/en-us/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/en-us/rest/api/purview/datamapdataplane/glossary/list-terms
GET {endpoint}/datamap/api/atlas/v2/glossary/{glossaryGuid}/terms

По умолчанию этот API возвращает все термины в глоссарии.

  • Размер всех терминов в глоссарии может быть слишком велик для получения через один API в течение разумного срока. Используйте параметры limit запроса и offset с небольшим размером разбиения на страницы для перечисления терминов по страницам.

    # https://learn.microsoft.com/en-us/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/en-us/rest/api/purview/datamapdataplane/glossary/get-term
GET {endpoint}/datamap/api/atlas/v2/glossary/term/{termGuid}

Этот API по умолчанию возвращает термин вместе со всеми его связями. Например, assignedEntities, родительские или дочерние термины.

  • Размер свойств assignedEntities в термине может быть слишком велик для получения через один API в течение разумного срока. Используйте параметр excludeRelationshipTypes запроса, чтобы игнорировать связь assignedEntities, вызываемую AtlasGlossarySemanticAssignment в ответ. Затем используйте другой выделенный API для получения assignedEntities с разбивкой на страницы.

    • Получение определенного термина

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

    • Перечисление assignedEntities по определенному термину

      # https://learn.microsoft.com/en-us/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}

Дальнейшие действия