Solución de problemas de excepciones de tiempo de espera de solicitudes de API de Mapa de datos de Microsoft Purview

Se aplica a Mapa de datos de Microsoft Purview API devuelta http 408 tiempo de espera de solicitud.

Pasos para la solución de problemas

La lista siguiente contiene patrones conocidos y soluciones para las excepciones de tiempo de espera de solicitud.

Si no coincide con su caso o el error no se puede resolver después de aplicar la solución, póngase en contacto con el servicio de atención al cliente de Microsoft con todo el historial de solicitudes.

Tiempo de espera para enumerar todos los glosarios

# 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}

Esta API devuelve de forma predeterminada todos los glosarios junto con todos los términos o categorías de esos glosarios. Si hay 1000 glosarios, cada glosario tiene 1000 términos y 1000 categorías, devuelve 1000 glosarios con 1000 * (1000 términos + 1000 categorías).

• El tamaño de todos los términos o categorías relacionados podría ser demasiado grande para capturar a través de una sola API dentro de una duración razonable. Use el parámetro ignoreTermsAndCategories=true de consulta para reducir el recuento total para cargar en el lado servidor y reducir el tamaño de respuesta para la transferencia de red. Si todavía se necesitan términos o categorías, puede combinarlas con las API siguientes para capturarlas.

  • Enumerar términos en un glosario específico

    # 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}
    

  • Enumerar categorías en un glosario específico

    # 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}
    

• El tamaño de todo el recuento de glosarios podría ser demasiado grande para capturarlo a través de una sola API dentro de una duración razonable. Use el parámetro limit de consulta y offset con un tamaño de paginación pequeño para obtener glosarios página por página.

Tiempo de espera para obtener glosario con información detallada

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

Esta API devuelve de forma predeterminada el glosario junto con todos los términos o categorías del glosario.

• El tamaño de todos los términos o categorías relacionados podría ser demasiado grande para capturar a través de una sola API dentro de una duración razonable. Se recomienda usar las API siguientes para tener una mejor experiencia de paginación.

  • Obtener glosario específico

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

  • Enumerar términos en un glosario específico

    # 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}
    

  • Enumerar categorías en un glosario específico

    # 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}
    

Tiempo de espera para enumerar todos los términos en un glosario específico

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

De forma predeterminada, esta API devuelve todos los términos del glosario.

• El tamaño de todos los términos del glosario podría ser demasiado grande para capturar a través de una sola API dentro de una duración razonable. Use parámetros de limit consulta y offset con un tamaño de paginación pequeño para enumerar los términos página por página.

  # 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}
  

Tiempo de espera para obtener un solo término

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

Esta API devuelve de forma predeterminada el término junto con todas sus relaciones. Por ejemplo, assignedEntities, términos primarios o secundarios.

• El tamaño de assignedEntities en el término podría ser demasiado grande para capturar a través de una sola API dentro de una duración razonable. Use el parámetro excludeRelationshipTypes de consulta para omitir la relación assignedEntities a la que se llama AtlasGlossarySemanticAssignment en respuesta. A continuación, use otra API dedicada para obtener assignedEntities con paginación.

  • Obtención de un término específico

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

  • Enumerar assignedEntities en un término específico

    # 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}
    

Pasos siguientes

• API REST de Mapa de datos de Microsoft Purview
• Soporte técnico al cliente de Microsoft