DataStore
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
Siehe Datenspeicher.
Zusammenfassung
Methoden
Rufe die angegebene Schlüsselversion ab.
- ListKeysAsync(prefix : string,pageSize : number,cursor : string,excludeDeleted : bool):DataStoreKeyPages
Kehrt ein DataStoreKeyPages Objekt für die Liste durch Schlüssel eines Datenstores zurück.
- ListVersionsAsync(key : string,sortDirection : Enum.SortDirection,minDate : number,maxDate : number,pageSize : number):DataStoreVersionPages
Enumeriert alle Versionen eines Schlüssels.
Löscht dauerhaft die angegebene Version eines Schlüssels.
Kehre den Wert eines Schlüssels in einem bestimmten Daten-Store und einer DataStoreKeyInfo Instanz zurück.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Erhöht den Wert eines Schlüssels um die angegebene Menge (beide müssen Zahlen sein).
Entfernt den angegebenen Schlüssel, während eine zugängliche Version beibehalten wird.
Setzt den Wert des Datenspeichers für den angegebenen Schlüssel.
Aktualisiert den Wert eines Schlüssels mit einem neuen Wert aus der angegebenen Rückruffunktion.
Eigenschaften
Methoden
GetVersionAsync
Diese Funktion ruft die angegebene Schlüsselversion sowie eine DataStoreKeyInfo Instanz ab. Ein Version Identifikator kann durch DataStore:ListVersionsAsync() oder alternativ durch die zurückgegebene Version identifiziert werden durch GlobalDataStore:SetAsync().
Parameter
Name der Schlüssel für die Version-Info wird angefordert. Wenn DataStoreOptions.AllScopes auf wahr gesetzt wurde, wenn Sie auf den Daten-Store über Class.DataStoreService:GetDataStore() aufrufen, muss dieser Schlüsselname mit dem ursprünglichen Zoom verbunden sein, wie in " scope/key".
Die Version der Schlüssel, für die die Version-Info angefordert wird.
Rückgaben
Der Wert der Schlüssel bei der angegebenen Version und eine DataStoreKeyInfo Instanz, die die Versionnummer, den Zeitpunkt und die Zeitpunkt der Erstellung der Version und Funktionen zum Wiederrufen von UserIds und Metadaten enthält.
ListKeysAsync
Diese Funktion gibt ein DataStoreKeyPages Objekt für die Liste durch Schlüssel eines Datenstores zurück, um durch Schlüssel zu durchsuchen. Es akzeptiert einen optionalen prefix-Parameter, um nur Schlüssel zu liste, deren Namen mit dem angegebenen Prefix beginnen.
Wenn DataStoreOptions.AllScopes auf wahr gesetzt wurde, wenn Sie auf den Datenspeicher über Class.DataStoreService:GetDataStore() zugreifen, werden alle Schlüssel als Präfixe zurückgegeben.
Parameter
(Optional) Präfix zum Verwenden für das Finden von Schlüsseln.
(Optional) Maximale Anzahl von möglichen zurückgegebenen Artikeln.
(Optional) Cursor zum Fortfahren der Iteration.
(Optional) Schließe die gelöschten Schlüssel aus, die zurückgegeben werden.
Wenn aktiviert, überprüft ListKeys bis zu 512 Schlüssel. Wenn alle überprüften Schlüssel gelöscht sind, wird eine leere Liste mit einem Cursor zurückgegeben, um die Iteration fortzusetzen.
Rückgaben
Eine DataStoreKeyPages Instanz, die die Schlüssel als DataStoreKey Instanzennummern listet.
ListVersionsAsync
Diese Funktion zählt die Versionen des angegebenen Schlüssels in aufsteigender oder absteigender Reihenfolge, die von einem Enum.SortDirection-Parameter angegeben. Es kann optionale Optionen verwenden, um die zurückgegebenen Versionen nach Minimum und Maximum Time戳 zu filtern.
Parameter
Schlüsselname für die Versionen, die aufgelistet werden. Wenn DataStoreOptions.AllScopes auf wahr gesetzt wurde, wenn Sie auf den Datenserver über Zugriff auf DataStoreService:GetDataStore() zugreifen, muss dieser Schlüsselname mit dem ursprünglichen Zoom verknüpft sein, wie in " scope/key".
Enumerische Spezifikation der Sortierung aufsteigend oder absteigend.
Unix-Timestamp in Millisekunden nach dem, der die Versionen aufgeführt werden sollen.
Unix-Timestamp in Millisekunden bis zu welchem die Versionen aufgeführt werden sollen.
Anzahl der Gegenstände, die auf jeder Seite zurückgegeben werden.
Rückgaben
Eine DataStoreVersionPages Instanz, die alle Versionen des Schlüssels als DataStoreObjectVersionInfo Instanzen zählt.
Code-Beispiele
local DataStoreService = game:GetService("DataStoreService")
local experienceStore = DataStoreService:GetDataStore("PlayerExperience")
local time = DateTime.fromUniversalTime(2020, 10, 09, 01, 42)
local listSuccess, pages = pcall(function()
return experienceStore:ListVersionsAsync("User_1234", nil, time.UnixTimestampMillis)
end)
if listSuccess then
local items = pages:GetCurrentPage()
for key, info in pairs(items) do
print("Key:", key, "; Version:", info.Version, "; Created:", info.CreatedTime, "; Deleted:", info.IsDeleted)
end
endRemoveVersionAsync
Diese Funktion löscht die angegebene Version eines Schlüssels dauerhaft. Versionierungsidentifikatoren können über DataStore:ListVersionsAsync() gefunden werden.
Anders als GlobalDataStore:RemoveAsync() , erstellt diese Funktion keine neue "Tombstone"-Version und der entfernte Wert kann nicht später abgerufen werden.
Parameter
Name der Schlüsselversion, die entfernt werden soll. Wenn DataStoreOptions.AllScopes auf wahr gesetzt wurde, wenn Sie auf den Datenserver über DataStoreService:GetDataStore() zugreifen, muss dieser Schlüsselname mit dem ursprünglichen Zoom gesetzt sein, wie in " scope/key".
Versionsnummer des Schlüssels zum entfernen.