Drosselung

Microsoft Fabric verwendet Drosselung, um optimale Leistung und Zuverlässigkeit zu gewährleisten. Fabric beschränkt die Anzahl der API-Aufrufe innerhalb eines Zeitfensters pro Benutzer, sodass ein Aufrufer nur eine bestimmte Anzahl von Aufrufen in einem bestimmten Zeitraum ausführen kann.

Einschränkungsrichtlinien werden sowohl für den API-Aufrufer als auch für die API selbst durchgeführt. Dies bedeutet, dass Fabric die Anzahl der Aufrufe begrenzt, die ein bestimmter Aufrufer für eine bestimmte API ausführen kann.

Einschränkungsmeldung

Wenn die Einschränkung auftritt, gibt Fabric einen HTTP-Statuscode 429 (Zu viele Anforderungen) zurück. Fabric gibt aus zwei unterschiedlichen Gründen einen 429-Statuscode zurück, der jeweils durch einen anderen errorCode Im Antworttext identifiziert wird:

Überprüfen Sie den errorCode Wert in der Antwort, um zu bestimmen, welche Bedingung aufgetreten ist und wie reagiert werden soll.

Rate limit exceeded (RequestBlocked)

Wenn ein Benutzer viele Anforderungen sendet, die einen vordefinierten Grenzwert während eines Zeitfensters überschreiten, drosselt Fabric weitere Anforderungen dieses Benutzers für einen kurzen Zeitraum.

In diesem Fall gibt Fabric einen HTTP-Statuscode 429 (Zu viele Anforderungen) mit einem Retry-After HTTP-Header in der Antwort zurück, der angibt, wie viele Sekunden die aufrufende Anwendung warten soll, bevor der Aufruf erneut ausgeführt wird. Der Antworttext verwendet den RequestBlocked Fehlercode:

{
    "errorCode": "RequestBlocked",
    "message": "Request is blocked by the upstream service until: 2/18/2026 10:45:04 PM (UTC)"
}

Wenn Sie diesen Fehler erhalten, warten Sie auf die im Retry-After Header angegebene Dauer, bevor Sie die Anforderung erneut versuchen.

Der folgende Screenshot zeigt ein Antwortbeispiel, das vorschlägt, dass der Benutzer 55 Sekunden wartet, bevor er den Anruf erneut versucht.

Screenshot eines HTTP-Antwortheaders.

Kapazitätslimit überschritten (CapacityLimitExceeded)

Fabric gibt auch einen HTTP-Statuscode 429 (Zu viele Anforderungen) zurück, wenn die Fabric Kapazität Ihrer Organisation ihre Grenzwerte überschritten hat. Im Gegensatz zur Zinsbegrenzung wird diese Einschränkung nicht durch die Anzahl der API-Aufrufe verursacht, die ein bestimmter Aufrufer vorgibt. Stattdessen tritt es auf, wenn die für Ihre Kapazität verbrauchten Compute (Kapazitätseinheiten) die Grenzwerte der erworbenen Fabric-SKU überschreitet. Der Antworttext verwendet den CapacityLimitExceeded Fehlercode:

{
    "errorCode": "CapacityLimitExceeded",
    "message": "Your organization's Fabric compute capacity has exceeded its limits. Try again later."
}

Wenn Sie diese Fehlermeldung erhalten, versuchen Sie es später erneut. Da diese Einschränkung von der Gesamtberechnung abhängt, die von Ihrer Kapazität verbraucht wird, anstatt von Ihrer individuellen Anforderungsrate, ist es unwahrscheinlich, dass die Wiederholung sofort erfolgreich ist, bis die Berechnungsauslastung der Kapazität in ihren Grenzen zurückfällt. Wenn dieser Fehler häufig auftritt, erwägen Sie, Ihre Fabric Kapazität hochzuskalieren oder zu skalieren. Weitere Informationen zu Kapazitätseinheiten, SKUs und dazu, wie Fabric Kapazität verbraucht wird, finden Sie unter Planen der Kapazitätsgröße.

Überlegungen und Einschränkungen

Jeder Fabric-Administrator und der zentrale öffentliche API-Aufruf werden gedrosselt.

Verwandte Inhalte

  • Last updated on