GlobalDataStore

Diese Funktion gibt die neueste Werte des angegebenen Schlüssels und eine DataStoreKeyInfo Instanz zurück. Wenn der Schlüssel nicht existiert oder wenn die neueste Version als gelöscht markiert ist, werden beide Werte nil zurückgegeben.

Schlüssel werden lokal für 4 Sekunden nach der ersten gelesenzwischengespeichert. Ein Class.GlobalDataStore:GetAsync() -Aufruf innerhalb dieser 4 Sekunden gibt einen Wert aus demCache zurück. Änderungen des Schlüssels durch Class.GlobalDataStore:SetAsync() oder Class.GlobalDataStore:UpdateAsync() geben sofort und wieder starten den 4-Sekunden-Timer.

Um eine bestimmte Version zu erhalten, wie eine Version vor der neuesten, verwenden Sie DataStore:GetVersionAsync() .

Parameter

Rückgaben

Diese Funktion erhöht den Wert eines Schlüssels um die angegebene Menge (beide müssen Zahlen sein).

OrderedDataStore unterstützt keine Versionierung, so dass das Aufrufen dieser Methode auf einer OrderedDataStore-Schlüssel das aktuelle Wert mit dem erhöhten Wert überschreiben wird und frühere Versionen unzugänglich machen wird.

Parameter

Rückgaben

Diese Funktion markiert den angegebenen Schlüssel als gelöscht, indem eine neue "Grabstein"-Version des Schlüssels erstellt wird. Vorher gibt sie die neueste Version vor dem Entfernen zurück.

Nachdem ein Schlüssel über diese Funktion entfernt wird, GlobalDataStore:GetAsync() Anrufe für den Schlüssel werden zurückgegeben, nil . Ältere Versionen des Schlüssels bleiben über DataStore:ListVersionsAsync() und 1> Class.DataStore:GetVersionAsync()1> zugänglich, unter der Annahme, dass sie nicht abgelaufen sind.

OrderedDataStore unterstützt keine Versionierung, so dass das Aufrufen von Class.GlobalDataStore:RemoveAsync()|RemoveAsync() auf einer Class.OrderedDataStore-Taste dauerhaft gelöscht wird.

Entfernte Objekte werden nach 30 Tagen permanent gelöscht.

Wenn die vorherigen Werte über GlobalDataStore:RemoveAsync() oder DataStore:RemoveVersionAsync() gelöscht wurden, gibt die Funktion nil , 1> nil1> für den Wert und 4> Class.DataStoreKeyInfo4> für den Schlüssel zurück.

Parameter

Rückgaben

Diese Funktion setzt den neuesten Wert, UserIds , und Metadaten für den angegebenen Schlüssel.

Die Werte in Daten-Stores sind versioniert, was bedeutet, dass GlobalDataStore:SetAsync() jedes Mal, wenn es aufgerufen wird, eine neue Version erstellt. Vorherige Versionen können über DataStore:ListVersionsAsync() / DataStore:GetVersionAsync() für bis zu 30 Tage aufgerufen werden, um sie dauerhaft zu löschen.

OrderedDataStore unterstützt keine Versionierung, so dass das Aufrufen dieser Methode auf einer OrderedDataStore-Schlüssel die aktuelle Werte überschreibt und frühere Versionen unzugänglich macht.

Metadaten- Definitionen müssen immer mit einem Wert aktualisiert werden, auch wenn es keine Änderungen an dem aktuellen Wert gibt; sonst wird der aktuelle Wert verloren.

Jede Zeichenkette, die in einem Daten-Store gespeichert wird, muss gültig sein UTF-8. In UTF-8 werden Werte größer als 127 ausschließlich für die Encodierung mehr-Byte-Codepoints verwendet, so dass ein einzelnes Byte größer als 127 nicht gültig UTF-8 ist und der GlobalDataStore:SetAsync() Versuch fehlschlägt.

Setzen vs. Update

GlobalDataStore:SetAsync() ist am besten für eine schnelle Aktualisierung eines bestimmten Schlüssels, und es zählt nur gegen das Schreiblimit. jedoch kann es Datenkonsistenz verursachen, wenn zwei Server versuchen, den gleichen Schlüssel gleichzeitig zu aktualisieren. GlobalDataStore:UpdateAsync()

Parameter

Rückgaben

Diese Funktion ruft den Wert und die Metadaten eines Schlüssels aus dem Daten-Store ab und aktualisiert ihn mit einem neuen Wert, der durch die angegebene Rückruffunktion festgelegt wird. Wenn die Rückruffunktion nil gibt, wird die Schreib操作 abgebrochen und der Wert bleibt unverändert.

Wenn das Update erfolgreich ist, wird eine neue Version des Wertes erstellt und die vorherigen Versionen über DataStore:ListVersionsAsync() und DataStore:GetVersionAsync() zugänglich bleiben.

OrderedDataStore unterstützt keine Versionierung, so dass das Aufrufen dieser Funktion auf einer OrderedDataStore-Schlüssel die aktuelle Werte überschreiben und frühere Versionen unzugänglich machen wird.

In Fällen, in denen ein anderer Spielserver den Schlüssel in der kurzen Zeit zwischen der Abrufung des Schlüsselwertes und dem Festlegen des Schlüsselwertes aktualisiert, ruft die Funktion erneut auf, das Ergebnis des vorherigen Aufrufs zu verwerfen. Die Funktion wird so oft aufgerufen, bis die Daten gespeichert werden, <a href="/reference/engine/datastores/update-

Jede Zeichenkette, die in einem Daten-Store gespeichert wird, muss gültig sein UTF-8. In UTF-8 werden Werte größer als 127 ausschließlich für die Encodierung mehr-Byte-Codepoints verwendet, so dass ein einzelnes Byte größer als 127 nicht gültig UTF-8 ist und die Class.GlobalDataStore:UpdateAsync() -Versuche, die einzelnen Bytes größer als 127 sind, fehl

Setzen vs. Update

GlobalDataStore:SetAsync() ist am besten für eine schnelle Aktualisierung eines bestimmten Schlüssels, und es zählt nur gegen das Schreiblimit. jedoch kann es Datenkonsistenz verursachen, wenn zwei Server versuchen, den gleichen Schlüssel gleichzeitig zu aktualisieren. GlobalDataStore:UpdateAsync()

Rückruf-Funktion

Die Rückruf-Funktion akzeptiert zwei Argumente:

• Aktueller Wert des Schlüssels vor dem Update.
• DataStoreKeyInfo Instanz, die die neuesten Versioneninformationen enthält (dieses Argument kann ignoriert werden, wenn keine Metadaten verwendet werden).

Darum gibt die Rückruhr函数 bis zu drei Werte zurück:

• Der neue Wert für den Schlüssel.
• Ein Array von UserIds mit dem Schlüssel zu verknüpfen. DataStoreKeyInfo:GetUserIds() sollte zurückgegeben werden, es sei denn, die bestehenden IDs werden geändert; sonst werden alle bestehenden IDs zurückgesetzt.
• Eine Lua-Tabelle, die Metadaten enthält, mit denen sich der Schlüssel verknüpfen kann. DataStoreKeyInfo:GetMetadata() sollte zurückgegeben werden, es sei denn, die vorhandenen Metadaten werden geändert; sonst werden alle vorhandenen Metadaten zurückgesetzt.

Wenn der Rückruf stattdessen nil zurückgibt, wird der aktuelle Server aufhören, sich um den Schlüssel zu aktualisieren.

Die Rückruf-Funktion kann nicht liefern, also nicht include Calls wie task.wait() .

Parameter

Rückgaben