Codici di errore e limiti del data store

Le richieste che effettui ai data store possono fallire a causa di una connessione scadente o di altri problemi. Per gestire gli errori e restituire messaggi con un codice di errore, avvolgi le funzioni del data store in pcall().

Una chiamata di scrittura fallita, come UpdateAsync(), significa che il server di gioco non ha ricevuto una risposta positiva. Non garantisce sempre che la scrittura sul backend non sia avvenuta. In alcuni scenari di errore, lo stato finale della scrittura potrebbe essere sconosciuto per il chiamante fino a quando non viene verificato con una lettura successiva senza cache.

Riferimento ai codici di errore

Codici di errore del server

Limiti

I modelli di dati hanno limiti. Se un'esperienza supera questi limiti, il servizio limita automaticamente l'uso del data store dell'esperienza e fa sì che le richieste future siano inserite in una delle seguenti code:

• Imposta
• Imposta ordinata
• Ottieni
• Ottieni ordinato

Le richieste in una coda vengono gestite nell'ordine in cui vengono ricevute. La funzione chiamata continua a yield finché la sua richiesta è ancora in coda. Se la chiave del data store stesso è limitata, la richiesta è inserita in una coda ma viene saltata temporaneamente.

Ogni coda ha un limite di 30 richieste. Quando il limite di una coda è raggiunto, le richieste falliscono con un codice di errore nell'intervallo 301-306, che indica che le richieste sono state completamente scartate.

Limiti di accesso

I data store sono soggetti a limiti sia a livello di esperienza che a livello di server. I limiti a livello di esperienza scalano con il numero totale di utenti concorrenti nell'esperienza, mentre i limiti a livello di server sono configurabili e devono essere utilizzati come strumento dal creatore.

Limiti di esperienza

Ogni esperienza è consentita a un certo numero di richieste al data store in base al tipo di data store, al tipo di richiesta e al numero di utenti concorrenti. Per ogni tipo di data store e tipo di richiesta, il limite è condiviso tra tutte le funzioni elencate.

Nota che UpdateAsync() consuma sia dal budget di richieste di lettura che da quello di scrittura. Una singola chiamata decrementerà entrambi i limiti.

Data store standard

Data store ordinati

Limiti del server

Ogni server ha un limite di velocità configurabile per ogni tipo di richiesta, basato sul numero di giocatori in quel server. I server ricevono un'improvvisa quantità di budget di richiesta aggiuntivo quando vengono creati per la prima volta. Usa GetRequestBudgetForRequestType() per confermare il numero di richieste al data store che il server corrente può effettuare in un dato momento.

Questi limiti sono configurabili dal creatore utilizzando SetRateLimitForRequestType(). Utilizzando questa API, un creatore può configurare i propri limiti di velocità per i data store per ogni tipo di richiesta.

I seguenti limiti di velocità predefiniti si applicano se l'API non viene chiamata:

Data store standard

Data store ordinati

Limiti dei dati

I data store limitano la quantità di dati che possono essere utilizzati per voce.

Il nome del data store, il nome della chiave e scopo devono tutti rientrare in una certa lunghezza di caratteri. Usa string.len() per controllare la loro lunghezza.

I dati (valore della chiave) sono anche memorizzati come stringa, indipendentemente dal loro tipo iniziale. Puoi controllare la dimensione dei dati con la funzione JSONEncode(), che converte i dati Luau in una tabella JSON serializzata.

Limiti dei metadati

Limiti al numero di caratteri nei metadati definiti dall'utente.

Limiti di throughput

I limiti di throughput per chiave garantiscono che le prestazioni siano ottimali sui server Roblox. Ogni limite si applica a ciascuna singola chiave su tutti i server in un'esperienza e si rinnova nel tempo.

Roblox esamina l'uso della quota associata alla chiave negli ultimi 60 secondi. Se l'uso, includendo la richiesta attuale, è entro il limite di throughput, la richiesta è approvata. Se l'uso supera il limite, la richiesta viene negata.

Oltre ai limiti di throughput sopra indicati, Roblox organizza i dati in partizioni in base a uno schema interno. Di conseguenza, quando il server backend riceve un volume elevato di richieste allo stesso data store, può risultare in un'ulteriore limitazione. Indipendentemente dalla causa, il throttling si manifesta come errori DatastoreThrottled o KeyThrottled, a seconda che sia stato superato il limite di throughput per un singolo data store o per una chiave. Questi messaggi di errore si applicano sia ai data store ordinati che a quelli standard.

Limiti di archiviazione

In futuro, per fornire un'esperienza di archiviazione scalabile e stabile, i data store implementeranno un limite di archiviazione a livello di esperienza sul tuo utilizzo di archiviazione.

Questo limite sarà la somma di un limite di base per ciascuna delle tue esperienze e un limite per utente basato sul numero di utenti a vita nella tua esperienza. Un utente a vita è qualsiasi utente che ha partecipato alla tua esperienza almeno una volta.

Il limite di archiviazione sarà calcolato utilizzando la formula Limite totale di archiviazione della versione più recente = 100 MB + 1 MB * conteggio utenti a vita.

Qualsiasi chiave che elimini o sostituisci, anche se ancora accessibile tramite API di versione, non conta per l'utilizzo di archiviazione della tua esperienza. Tuttavia, interi data store eliminati tramite il metodo Open Cloud DeleteDataStore continuano a contare per il tuo utilizzo di archiviazione per la durata del loro periodo di elaborazione di 30 giorni, fino a quando non vengono eliminati permanentemente.