DataStoreService
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
DataStoreService stellt Methoden bereit, um GlobalDataStore und OrderedDataStore Objekte zu erhalten.Datenspeicher können nur von Spielservern aufgerufen werden, sodass du nur DataStoreService innerhalb eines Script oder eines ModuleScript, das von einem Script verwendet wird, zugreifen kannst.
Siehe Datenspeicher für einen umfassenden Leitfaden über Datenstruktur, Management, Fehlerbehandlung usw.
Code-Beispiele
This code sample prints the request budget for all data store request types.
local DataStoreService = game:GetService("DataStoreService")
for _, enumItem in pairs(Enum.DataStoreRequestType:GetEnumItems()) do
print(enumItem.Name, DataStoreService:GetRequestBudgetForRequestType(enumItem))
end
Zusammenfassung
Eigenschaften
Legt fest, ob Datenlagersfunktionen automatisch erneut versuchen sollen oder nicht.DataStoreService respektiert diese Eigenschaft nicht, weil automatisches Wiederholen aufgrund technischer Gründe deaktiviert wurde.Daher musst du Systeme implementieren, um Operationen erneut auszuführen.
Methoden
Erstellt eine DataStore.
Gibt den Storezurück.
Holen Sie sich ein OrderedDataStore, gegeben einen Namen und optionale Reichweite.
Gibt die Anzahl der Anfragen zurück, die durch den angegebenen eingebengestellt werden können.
Gibt ein DataStoreListingPages-Objekt zurück, um durch alle Datenstores des Erlebnisses zu durchsuchen.
Eigenschaften
AutomaticRetry
Methoden
GetDataStore
Parameter
Rückgaben
GetGlobalDataStore
Rückgaben
Code-Beispiele
local DataStoreService = game:GetService("DataStoreService")
local GlobalDataStore = DataStoreService:GetGlobalDataStore()
print(GlobalDataStore.Name)
GetOrderedDataStore
Parameter
Rückgaben
Code-Beispiele
local DataStoreService = game:GetService("DataStoreService")
local pointsStore = DataStoreService:GetOrderedDataStore("Points")
local function printTopTenPlayers()
local isAscending = false
local pageSize = 10
local pages = pointsStore:GetSortedAsync(isAscending, pageSize)
local topTen = pages:GetCurrentPage()
-- The data in 'topTen' is stored with the index being the index on the page
-- For each item, 'data.key' is the key in the OrderedDataStore and 'data.value' is the value
for rank, data in ipairs(topTen) do
local name = data.key
local points = data.value
print(name .. " is ranked #" .. rank .. " with " .. points .. "points")
end
-- Potentially load the next page...
--pages:AdvanceToNextPageAsync()
end
-- Create some data
pointsStore:SetAsync("Alex", 55)
pointsStore:SetAsync("Charley", 32)
pointsStore:SetAsync("Sydney", 68)
-- Display the top ten players
printTopTenPlayers()
GetRequestBudgetForRequestType
Parameter
Rückgaben
Code-Beispiele
local DataStoreService = game:GetService("DataStoreService")
local globalStore = DataStoreService:GetGlobalDataStore()
local function printBudget()
local budget = DataStoreService:GetRequestBudgetForRequestType(Enum.DataStoreRequestType.SetIncrementAsync)
print("Current set/increment budget:", budget)
end
for i = 1, 5 do
local key = "key" .. i
local success, err = pcall(function()
globalStore:SetAsync(key, true)
end)
if success then
printBudget()
else
print(err)
end
end