Auf dieser Seite erfahren Sie, wie Sie mithilfe der Spanner-Clientbibliotheken die Standardkonfiguration für Zeitüberschreitungen überschreiben und eine Wiederholungsrichtlinie konfigurieren.
Die Clientbibliotheken verwenden die Standardeinstellungen für Zeitlimits und Wiederholungsversuche, die in den folgenden Konfigurationsdateien definiert sind.
- spanner_grpc_service_config.json
- spanner_admin_instance_grpc_service_config.json
- spanner_admin_database_grpc_service_config.json
In den Konfigurationsdateien beträgt das Standardzeitlimit für Vorgänge, die kurze Zeit in Anspruch nehmen, z. B. CreateSession
, 30 Sekunden. Für längere Vorgänge wie Abfragen oder Lesevorgänge gilt ein Standardzeitlimit von 3.600 Sekunden. Wir empfehlen, diese Standardeinstellungen zu verwenden. Sie können jedoch bei Bedarf in Ihrer Anwendung eine benutzerdefinierte Zeitüberschreitungs- oder Wiederholungsrichtlinie festlegen.
Wenn Sie das Zeitlimit ändern möchten, legen Sie den tatsächlichen Zeitraum fest, in dem die Anwendung auf das Ergebnis wartet.
Konfigurieren Sie keine Wiederholungsrichtlinie, die aggressiver als die Standardeinstellung ist, da zu viele Wiederholungsversuche das Back-End überlasten und Ihre Anfragen drosseln könnten.
In jedem Snippet ist eine Wiederholungsrichtlinie mit den folgenden Eigenschaften definiert:
- Die anfängliche oder Startwartezeit, bevor die Anfrage wiederholt wird.
- Eine maximale Verspätung.
- Ein Multiplikator, der mit der vorherigen Wartezeit zur Berechnung der nächsten Wartezeit bis zum Erreichen des Maximums verwendet wird.
- Eine Reihe von Fehlercodes für Wiederholungsvorgänge.
Im folgenden Beispiel wird ein Zeitlimit von 60 Sekunden für den jeweiligen Vorgang festgelegt.
Wenn der Vorgang länger dauert als dieses Zeitlimit, schlägt er mit dem Fehler DEADLINE_EXCEEDED
fehl.
Wenn der Vorgang mit dem Fehlercode UNAVAILABLE
fehlschlägt, z. B. bei einem vorübergehenden Netzwerkproblem, wird der Vorgang wiederholt. Der Client wartet 500 ms, bevor er den ersten Wiederholungsversuch startet. Wenn der erste Wiederholungsversuch fehlschlägt, wartet der Client 1,5 × 500 ms = 750 ms, bevor der zweite Wiederholungsversuch gestartet wird. Diese Wiederholungsverzögerung erhöht sich, bis der Vorgang entweder erfolgreich abgeschlossen ist oder die maximale Wiederholungsverzögerung von 16 Sekunden erreicht hat. Der Vorgang schlägt mit dem Fehler DEADLINE_EXCEEDED
fehl, wenn die Gesamtzeit für den Vorgang das Zeitlimit von 60 Sekunden überschreitet.