golang.org/x/time/rate
Utiliser le limiteur de débit
golang.org/x/time/rate est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Go Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Go Academy comprend 4 leçons au total.
Le package rate
golang.org/x/time/rate fournit un limiteur de seau de jetons prêt pour la production avec Limiter. C'est le choix standard pour limiter le débit en Go.
- Implémentation éprouvée
- Méthodes Allow, Wait et Reserve
- Compatible avec les contextes
Créer un limiteur
rate.NewLimiter reçoit un débit (jetons par seconde) et une taille de rafale. rate.Limit est un float64 représentant le nombre d'événements par seconde.
limiter := rate.NewLimiter(rate.Limit(10), 5)rate.Every
Si vous raisonnez en intervalles plutôt qu'en débits par seconde, rate.Every convertit une durée en débit. Un événement toutes les 200 ms équivaut à cinq par seconde.
limiter := rate.NewLimiter(rate.Every(200*time.Millisecond), 1)Allow
Allow indique si un jeton est disponible immédiatement. Il renvoie vrai et consomme un jeton, ou renvoie immédiatement faux. Utilisez-le pour rejeter les requêtes excédentaires.
if !limiter.Allow() {
fmt.Println("rejected: too many requests")
return
}Wait
Wait bloque jusqu'à ce qu'un jeton soit disponible ou que le contexte soit annulé. Il convient parfaitement lorsque vous souhaitez réguler le travail plutôt que l'abandonner.
if err := limiter.Wait(ctx); err != nil {
return err
}
doWork()Reserve
Reserve renvoie une Reservation indiquant combien de temps attendre. Appelez Delay() pour connaître cette attente, et Cancel() si vous décidez de ne pas continuer.
r := limiter.Reserve()
if !r.OK() {
return
}
time.Sleep(r.Delay())Remarque : package externe
Le package rate ne fait pas partie de la bibliothèque standard : il nécessite donc go get golang.org/x/time/rate et un module. Les extraits qui l'importent sont donnés à titre d'illustration et ne sont pas exécutés directement ici.
Un équivalent exécutable avec la bibliothèque standard
Comme le package rate est externe, voici une boucle de régulation utilisant la bibliothèque standard et imitant Wait au moyen d'une impulsion toutes les 200 ms.
package main
import (
"fmt"
"time"
)
func main() {
tick := time.NewTicker(200 * time.Millisecond)
defer tick.Stop()
for i := 0; i < 4; i++ {
<-tick.C
fmt.Println("processed event", i)
}
}Ajuster à l'exécution
Vous pouvez modifier les limites à la volée avec SetLimit et SetBurst. C'est pratique lorsqu'un rechargement de configuration ou une réponse 429 du service en amont vous indique de ralentir.
limiter.SetLimit(rate.Limit(20))
limiter.SetBurst(10)Limiteurs par client
Conservez une table de correspondance entre la clé du client et *rate.Limiter, protégée par un mutex. Créez un limiteur lors de la première requête pour cette clé, puis réutilisez-le pour les requêtes suivantes.
func getLimiter(m map[string]*rate.Limiter, key string) *rate.Limiter {
if l, ok := m[key]; ok {
return l
}
l := rate.NewLimiter(rate.Limit(5), 10)
m[key] = l
return l
}Intergiciel HTTP
Enveloppez les gestionnaires afin que chaque requête appelle d'abord Allow(). Si le résultat est false, répondez avec le code HTTP 429 Trop de requêtes. Il s'agit de la limitation canonique du débit côté serveur.
Vérification rapide
Testez vos connaissances sur le paquet rate.
Récapitulatif
Vous avez appris à utiliser golang.org/x/time/rate :
- NewLimiter(rate, burst) crée le compartiment
- rate.Every convertit un intervalle en débit
- Allow rejette, Wait régule le rythme et Reserve indique le délai
- SetLimit et SetBurst permettent un réglage à l'exécution
- Une table par client et HTTP 429 pour les serveurs
Questions Fréquemment Posées
La leçon « golang.org/x/time/rate » est-elle gratuite ?
Oui — le texte complet de « golang.org/x/time/rate » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Go Academy, passe à CoddyKit PRO. Le cours Go Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « golang.org/x/time/rate » ?
Utiliser le limiteur de débit Tu pratiques Go Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Go Academy ?
Aucune expérience préalable n'est requise. Go Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.
Combien de temps prend la leçon « golang.org/x/time/rate » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Go Academy ?
Oui. Chaque leçon Go Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Concept du seau de jetons
- golang.org/x/time/rate
- Limitation des goroutines
- Temporisation progressive et nouvelle tentative