Anfragen, die Sie an Datenlagern stellen, können aufgrund schlechter Verbindung oder anderer Probleme fehlschlagen.Um Fehler zu behandeln und Fehlermeldungen mit einem Codeszurückzugeben, schließe Datenlagersfunktionen in pcall() ein.
Fehlercode-Referenz
| Codes | Fehlername | Nachricht | Anmerkungen | |
|---|---|---|---|---|
| 101 | KeyNameEmpty | Der Schlüsselname darf nicht leer sein. | Überprüfe, ob die Eingabe des Schlüssels in die Datenlagernfunktion eine leere Stringist. | |
| 102 | KeyNameLimit | Der Schlüsselname überschreitet das 50-Zeichen-Limit. | Überprüfe, ob die Eingabe des Schlüssels in die Datenlagernfunktion die Länge von 50 überschreitet. | |
| 103 | ValueNotAllowed | Kann nicht X in DataStore zulassen. | Eine schlechte Update-Funktion gab einen Wert vom Typ X zurück. | |
| 104 | CantStoreValue | Kann nicht X in DataStore. | Die Aktualisierungsfunktion gab einen Wert vom Typ X zurück, der nicht serialisiert wurde. | |
| 105 | ValueTooLarge | Serialisierter Wert überschreitet das Limit X. | Wenn du einen Wert mit SetAsync() oder UpdateAsync() festlegst, kann die serielle Länge des Werts die Größe X nicht überschreiten.Um die seriell verlängerte Länge der Daten zu überprüfen, verwende JSONEncode(). | |
| 106 | MaxValueInvalid | MaxValue muss eine ganzzahligsein. | Wenn du einen maximalen Wert auf GetSortedAsync() für ein OrderedDataStore überträgst, muss er ein ganzzahligsein. | |
| 106 | MinValueInvalid | MinValue muss eine ganzzahligsein. | Wenn du einen Mindestwert auf GetSortedAsync() für ein OrderedDataStore überträgst, muss er ein ganzzahligsein. | |
| 106 | PageSizeGreater | PageSize muss sich innerhalb einer vordefinierten reichweite befinden. | Die minimale Seitengröße für eine OrderedDataStore ist 1. | |
| 106 | PageSizeLesser | PageSize muss sich innerhalb einer vordefinierten reichweite befinden. | Die maximale Seitengröße für eine OrderedDataStore ist 100. | |
| 107 | MinMaxOrderInvalid | MaxValue muss größer als oder gleich MinValue sein. | Der maximale Wert muss größer oder gleich dem Mindestwert für GetSortedAsync() sein. | |
| 301 | GetAsyncThrottle | GetAsync Anfrage abgebrochen. Die Anfrage wurde gedrosselt, aber die Warteschlange war voll. | GetAsync() Anfrage hat die maximale Warteschlangengröße überschritten und Roblox kann die Anfragen bei der aktuellen Auslastung nicht verarbeiten. | |
| 302 | SetAsyncThrottle | SetAsync Anfrage abgebrochen. Die Anfrage wurde gedrosselt, aber die Warteschlange war voll. | SetAsync() Anfrage hat die maximale Warteschlangengröße überschritten und Roblox kann die Anfragen bei der aktuellen Auslastung nicht verarbeiten. | |
| 303 | IncreAsyncThrottle | IncrementAsync Anfrage abgebrochen. Die Anfrage wurde gedrosselt, aber die Warteschlange war voll. | IncrementAsync() Anfrage hat die maximale Warteschlangengröße überschritten und Roblox kann die Anfragen bei der aktuellen Auslastung nicht verarbeiten. | |
| 304 | UpdateAsyncThrottle | UpdateAsync Anfrage abgebrochen. Die Anfrage wurde gedrosselt, aber die Warteschlange war voll. | UpdateAsync() Anfrage hat die maximale Warteschlangengröße überschritten und Roblox kann die Anfragen bei der aktuellen Auslastung nicht verarbeiten. | |
| 304 | TransformThrottle | UpdateAsync Anfrage abgebrochen. Die Anfrage wurde gedrosselt, aber die Warteschlange war voll. | UpdateAsync() Anfrage hat die maximale Warteschlangengröße überschritten und Roblox kann die Anfragen bei der aktuellen Auslastung nicht verarbeiten. | |
| 305 | GetSortedThrottle | GetSorted Anfrage abgebrochen. Die Anfrage wurde gedrosselt, aber die Warteschlange war voll. | GetSortedAsync() Anfrage hat die maximale Warteschlangengröße überschritten und Roblox kann die Anfragen bei der aktuellen Auslastung nicht verarbeiten. | |
| 306 | RemoveAsyncThrottle | RemoveAsync Anfrage abgebrochen. Die Anfrage wurde gedrosselt, aber die Warteschlange war voll. | RemoveAsync() Anfrage hat die maximale Warteschlangengröße überschritten und Roblox kann die Anfragen bei der aktuellen Auslastung nicht verarbeiten. | |
| 401 | DataModelNoAccess | Anfrage fehlgeschlagen. DataModel ist während des Abschaltens der Erfahrung nicht zugänglich. | DataModel ist nicht initialisiert, weil das erlebnis heruntergefahren wird. | |
| 402 | LuaWebSrvsNoAccess | Anfrage fehlgeschlagen. LuaWebService ist während des Abschaltens der Erfahrung nicht zugänglich. | LuaWebService ist nicht initialisiert, weil das erlebnis heruntergefahren wird. | |
| 403 | StudioAccessToApisNotAllowed | Kann nicht auf DataStore aus dem Studio geschrieben werden, weil der API-Zugriff nicht aktiviert ist. | Der API-Zugriff muss aktiv sein, um Datenstores in Studio zu verwenden. | |
| 404 | InternalError | OrderedDataStore existiert nicht. | Die mit dieser Anfrage verbundene OrderedDataStore wurde nicht gefunden. Dies könnte ein Zeichen für Datenkorruption sein. Versuchen Sie es später erneut. | |
| 501 | InternalError | Kann die Antwort nicht analysieren, weil die Daten beschädigt sein könnten. | Der Server konnte die Antwort auf deine Anfrage nicht parsen. Dies könnte ein Zeichen für Datenkorruption sein. Versuche es später erneut. | |
| 502 | RequestRejected | API-Dienste lehnten die Anfrage mit Fehler X ab. | Fehler X ist beim Verarbeiten auf Roblox-Servern aufgetreten. Versuche es später erneut. | |
| 503 | InternalError | Die Datenbankanforderung war erfolgreich, aber der Schlüssel wurde nicht gefunden. | Der angeforderte Schlüssel wurde im Datenlagern nicht gefunden. Dies könnte ein Zeichen für Datenkorruption sein. Versuche es später erneut. | |
| 504 | InternalError | Die Datenlagersuche war erfolgreich, aber die Antwort wurde nicht richtig formatiert. | Der Server konnte die Antwort auf deine Anfrage nicht parsen. Dies könnte ein Zeichen für Datenkorruption sein. Versuche es später erneut. | |
| 505 | InternalError | OrderedDataStore anfrage war erfolgreich, die antwort wurde jedoch nicht korrekt formatiert. | Der Server konnte die Antwort auf deine OrderedDataStore Anfrage nicht parsen. Dies könnte ein Zeichen für Datenkorruption sein. Versuche es später erneut. | |
| 509 | OperationNotAllowed | Datenspeicheroperationen werden blockiert, während sie auf einem persönlichen RCC ausgeführt werden, um eine mögliche Datenkorruption zu verhindern. | Datenspeicher-Schreiben werden auf privaten RCC-Kanälen blockiert. | |
| 511 | AttributeSizeTooLarge | Die Metadaten-Attributgröße überschreitet die X Grenze. | Die serisierte Metadatengröße überschreitet das Limit von X. Der Wert X ist dynamisch. Wenn sich die Größe ändert, ändert sich auch der Wert. | |
| 512 | UserIdLimitExceeded | UserID Größe überschreitet X Limit. | Die Länge des von dem Benutzer bereitgestellten Arrays von Benutzer-IDs überschreitet das Limit von X. | |
| 513 | AttributeFormatError | Attribut userId Format ist ungültig. | Die angegebene Benutzer-ID ist keine Zahl. | |
| 513 | AttributeFormatError | Das Attribut-Metadatenformat ist ungültig. | Die Metadaten sind keine Tabelle. | |
| GetVersionAsyncThrottle | GetVersionAsync Anfrage abgebrochen.Anfrage wurde gedrosselt.: | GetVersionAsync() Die Anfrage hat die maximale Warteschlangengröße überschritten und Roblox kann die Anfragen derzeit nicht verarbeiten. | ||
| GetVersionAtTimeAsyncThrottle | GetVersionAtTimeAsync Anfrage abgebrochen.Anfrage wurde gedrosselt.: | GetVersionAtTimeAsync() Die Anfrage hat die maximale Warteschlangengröße überschritten und Roblox kann die Anfragen derzeit nicht verarbeiten. | ||
| ListDataStoresAsyncThrottle | ListDataStoresAsync Anfrage abgebrochen.Anfrage wurde gedrosselt.: | ListDataStoresAsync() Die Anfrage hat die maximale Warteschlangengröße überschritten und Roblox kann die Anfragen derzeit nicht verarbeiten. | ||
| ListKeysAsyncThrottle | ListKeysAsync Anfrage abgebrochen.Anfrage wurde gedrosselt.: | ListKeysAsync() Die Anfrage hat die maximale Warteschlangengröße überschritten und Roblox kann die Anfragen derzeit nicht verarbeiten. | ||
| ListVersionsAsyncThrottle | ListVersionsAsync Anfrage abgebrochen.Anfrage wurde gedrosselt.: | ListVersionsAsync() Die Anfrage hat die maximale Warteschlangengröße überschritten und Roblox kann die Anfragen derzeit nicht verarbeiten. | ||
| RemoveVersionAsyncThrottle | RemoveVersionAsync Anfrage abgebrochen.Anfrage wurde gedrosselt.: | RemoveVersionAsync() Die Anfrage hat die maximale Warteschlangengröße überschritten und Roblox kann die Anfragen derzeit nicht verarbeiten. | ||
| InvalidTimestamp | Der Zeitpunkt muss positiv sein und nicht mehr als zehn Minuten in der Zukunft liegen.: | Der Zeitstempel, der an übergeben wurde, war ungültig. |
Serverfehlercodes
| Fehlername | Nachricht | Anmerkungen |
|---|---|---|
| DatastoreThrottled | Die Anforderungsrate überschreitet das zulässige Maximum für die datastore. | Zu viele Anfragen wurden an einen einzigen Datenspeicher gesendet. |
| InternalServerError | Ein interner Serverfehler ist aufgetreten. | Gelegentlicher Fehler auf Roblox-Servern. Versuche es erneut, idealerweise mit exponentiellem Rückgang. |
| InvalidPlace | Der angegebene Ort ist ungültig. | Keine passende Universitäts-ID für den Ort. Versuche es später erneut. |
| InvalidTarget | Das angegebene Ziel ist ungültig. | Der Name des Datenspeichers, der bestellt wurde, überschreitet das Limit von 50 Zeichen. |
| InvalidUniverse | Das bereitgestellte Universum ist ungültig. | Keine passende Platz-ID für das Universum. Versuche es später erneut. |
| InvalidUserIds | Die bereitgestellten Benutzer-IDs haben ein ungültiges Format. | Fehler beim Parsern von Benutzer-IDs. |
| KeyThrottled | Die Anforderungsrate überschreitet das zulässige Maximum für den Schlüssel. | Die Anforderungsrate überschreitet die maximale erlaubte Anforderungsrate für einen einzelnen Schlüssel. |
| KeyNotFound | Der angeforderte Schlüssel existiert nicht. | Der Schlüssel existiert nicht. |
| N/A | Keine Seiten, auf die vorzudringen. | Dieser Fehler tritt auf, wenn du auf der letzten Seite Pages:AdvanceToNextPageAsync() aufrufst. |
Grenzen
Datenmodelle haben Einschränkungen .Wenn ein Erlebnis diese Grenzen überschreitet, schränkt der Dienst die Datenbanknutzung des Erlebnisses automatisch ein und verursacht, dass zukünftige Anfragen in eine der folgenden Warteschlangen gestellt werden:
- Festlegen
- Bestelltes festlegen
- Abrufen
- Bestellte Abholung
Anfragen in einer Warteschlange werden in der Reihenfolge bearbeitet, in der sie empfangen werden.Die aufgerufene Funktion gibt weiter Aus, solange ihre Anfrage noch in der Warteschlange ist.Wenn der Schlüssel des Datenspeichers selbst gedrosselt wird, wird die Anfrage in einer Warteschlange platziert, wird aber vorübergehend übersprungen.
Jede Warteschlange hat ein Limit von 30 Anfragen.Wenn das Limit einer Warteschlange erreicht wird, scheitern Anfragen mit einem Fehlercode im Bereich 301-306, was darauf hinweist, dass die Anfragen vollständig abgefallen sind.
Servergrenzen
Jeder Server darf eine bestimmte Anzahl von Datenlagernanfragen auf der Grundlage des Anforderungstyps und der Anzahl der Benutzer zulassen.Verwende GetRequestBudgetForRequestType(), um die Anzahl der Datenlagernanfragen zu bestätigen, die der aktuelle Ort stellen kann.
| eingeben | Funktionen | Anfragen pro Minute |
|---|---|---|
| Abrufen | GetAsync() | 60 + numSpieler × 10 |
| Festlegen (Limit wird unter allen aufgelisteten Funktionen geteilt) | Class.GlobalDataStore:SetAsync()|SetAsync()``Class.GlobalDataStore:IncrementAsync()|IncrementAsync()``Class.GlobalDataStore:UpdateAsync()|UpdateAsync()``Class.GlobalDataStore:RemoveAsync()|RemoveAsync() | 60 + numSpieler × 10 |
| Sortieren erhalten | GetSortedAsync() | 5 + numSpieler × 2 |
| Version abrufen | Class.DataStore:GetVersionAsync()|GetVersionAsync()``Class.DataStore:GetVersionAtTimeAsync()|GetVersionAtTimeAsync() | 5 + numSpieler × 2 |
| Zur Liste | Class.DataStoreService:ListDataStoresAsync()|ListDataStoresAsync()``Class.DataStore:ListKeysAsync()|ListKeysAsync()``Class.DataStore:ListVersionsAsync()|ListVersionAsync() | 5 + numSpieler × 2 |
| Entfernen | RemoveVersionAsync() | 5 + numSpieler × 2 |
Datengrenzen
Datenspeicher beschränken, wie viel Daten pro Eintrag verwendet werden können.
Der Name des Datenspeichers, der Schlüsselname und der Umfang müssen alle unter einer bestimmten Zeichenlänge liegen. Verwende string.len(), um ihre Länge zu überprüfen.
Die Daten (Schlüsselwert) werden auch als String gespeichert, unabhängig von ihrem ursprünglichen eingeben.Du kannst die Größe der Daten mit der JSONEncode()-Funktion überprüfen, die Luau-Daten in einen serisierten JSON-Tabel umwandelt.
| Bestandteil | Maximale Anzahl von Zeichen |
|---|---|
| Name des Datenspeichers | 50 |
| Schlüsselname | 50 |
| Bereich | 50 |
| Daten (Schlüsselwert) | 4,194,304 pro schlüssel |
Metadatenbeschränkungen
Begrenzungen der Anzahl der Zeichen im benutzerdefinierten Metadaten.
| Bestandteil | Maximale Anzahl von Zeichen |
|---|---|
| Schlüsselname | 50 |
| Wert | 250 |
| Schlüssel-Wertepaare | 300 |
Es gibt keine Begrenzung der Gesamtzahl der Schlüssel-Wert-Paare, aber die Gesamtgröße darf nicht mehr als 300 Zeichen betragen.
Durchsatzgrenzen
Per-Key-Durchsatzgrenzen stellen sicher, dass die Leistung auf Roblox-Servern optimal ist.Jedes Limit gilt für jeden einzelnen Schlüssel auf allen Servern in einem Erlebnis und aktualisiert sich im Laufe der Zeit.
Roblox untersucht die Verwendung von Quote, die mit dem Schlüssel in den letzten 60 Sekunden verbunden ist.Wenn die Nutzung, einschließlich der aktuellen Anfrage, innerhalb des Durchsatzlimits liegt, wird die Anfrage genehmigt.Wenn die Nutzung das Limit überschreitet, wird die Anfrage abgelehnt.
| eingeben | Begrenzung |
|---|---|
| Lesen | 25 MB pro Minute |
| Schreiben | 4 MB pro Minute |
Für jede Anfrage durchläuft Roblox die Bandbreite bis zum nächsten Kilobyte.Wenn du beispielsweise 800 Bytes und 1,2 MB in zwei Anfragen schreibst, zählt Roblox das als 3 KB Gesamtdurchsatz (jeweils 1 KB und 2 KB).
Speichergrenzen
Derzeit gibt es keine erzwungenen Speichergrenzen für Datenlagern.