Freigeben über

Problembehandlung bei Ausnahmen für Microsoft Purview Data Map API-Anforderungstimeouts

Gilt für Microsoft Purview Data Map API das HTTP 408-Anforderungstimeout zurückgegeben hat.

Schritte zur Problembehandlung

Die folgende Liste enthält bekannte Muster und Lösungen für Anforderungstimeoutausnahmen.

Wenn er nicht mit Ihrem Fall übereinstimmt oder der Fehler nach dem Anwenden der Lösung nicht behoben werden kann, wenden Sie sich mit dem gesamten Anforderungsverlauf an den Microsoft-Kundensupport .

Timeout zum Auflisten aller Glossare

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

Diese API gibt standardmäßig alle Glossare zusammen mit allen Begriffen/Kategorien unter diesen Glossaren zurück. Wenn es 1000 Glossare gibt, hat jedes Glossar 1000 Begriffe und 1000 Kategorien, es gibt 1000 Glossare mit 1000 * (1000 Begriffe + 1000 Kategorien) zurück.

  • Die Größe aller verwandten Begriffe/Kategorien kann zu groß sein, um sie innerhalb einer angemessenen Dauer über eine einzelne API abzurufen. Verwenden Sie den Abfrageparameter ignoreTermsAndCategories=true , um die Gesamtanzahl der Serverlasten zu reduzieren und die Antwortgröße für die Netzwerkübertragung zu verkleinern. Wenn Begriffe/Kategorien weiterhin benötigt werden, können Sie sie mit den folgenden APIs kombinieren, um sie abzurufen.

    • Auflisten von Begriffen unter einem bestimmten Glossar

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

    • Auflisten von Kategorien unter einem bestimmten Glossar

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

  • Die Größe der gesamten Glossaranzahl kann zu groß sein, um innerhalb einer angemessenen Dauer über eine einzelne API abzurufen. Verwenden Sie abfrageparameter limit und offset mit kleiner Paginierungsgröße, um Glossare seite für Seite abzurufen.

Timeout, um ein Glossar mit detaillierten Informationen zu erhalten

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

Diese API gibt standardmäßig das Glossar zusammen mit allen Begriffen/Kategorien im Glossar zurück.

  • Die Größe aller verwandten Begriffe/Kategorien kann zu groß sein, um sie innerhalb einer angemessenen Dauer über eine einzelne API abzurufen. Es wird empfohlen, die folgenden APIs zu verwenden, um eine bessere Paginierungserfahrung zu erzielen.

    • Abrufen eines bestimmten Glossars

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

    • Auflisten von Begriffen unter einem bestimmten Glossar

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

    • Auflisten von Kategorien unter einem bestimmten Glossar

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

Timeout zum Auflisten aller Begriffe unter einem bestimmten Glossar

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

Standardmäßig gibt diese API alle Begriffe im Glossar zurück.

  • Die Größe aller Begriffe im Glossar kann zu groß sein, um sie innerhalb einer angemessenen Dauer über eine einzelne API abzurufen. Verwenden Sie Abfrageparameter limit und offset mit kleiner Paginierungsgröße, um Begriffe seite für Seite aufzulisten.

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

Timeout zum Abrufen eines einzelnen Begriffs

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

Diese API gibt standardmäßig den Begriff zusammen mit allen Beziehungen zurück. Beispiel: assignedEntities, über-/untergeordnete Begriffe.

  • Die Größe von assignedEntities für den Begriff kann zu groß sein, um innerhalb einer angemessenen Dauer über eine einzelne API abzurufen. Verwenden Sie den Abfrageparameter excludeRelationshipTypes , um die assignedEntities-Beziehung zu ignorieren, die als Antwort aufgerufen wird AtlasGlossarySemanticAssignment . Verwenden Sie dann eine andere dedizierte API, um assignedEntities mit Paginierung abzurufen.

    • Abrufen eines bestimmten Begriffs

      # 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 unter einem bestimmten Begriff auflisten

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

Nächste Schritte