DataStoreService

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.Es ist möglich, dass automatische Wiederholungsversuche in Zukunft wieder aktiviert werden.

Diese Funktion erstellt eine DataStore.Subsequente Aufrufe dieser Methode mit demselben Namen/Umfang werden dasselbe Objekt zurückgeben.

Die Verwendung des scope Parameters wird Operationen auf diesen Bereich beschränken, indem der Bereich automatisch vor den Schlüsseln in allen auf dem Storedurchgeführten Operationen angefügt wird.Diese Funktion akzeptiert auch eine optionale DataStoreOptions Instanz, die Optionen für die Aktivierung von AllScopes enthält.Siehe Versionsierung, Listen und Zwischenspeicherung für Details zum Umfang.

Parameter

Rückgaben

Diese Funktion gibt die Standard-GlobalDataStore zurück.Wenn du stattdessen auf einen bestimmten benannten Datenstore zugreifen möchtest, solltest du die GetDataStore().

Beachten Sie, dass die von dieser Funktion zurückgegebene DataStore immer den Umfang u verwendet. Siehe Datenbanken für Details zum Umfang.

Rückgaben

local DataStoreService = game:GetService("DataStoreService")

local GlobalDataStore = DataStoreService:GetGlobalDataStore()

print(GlobalDataStore.Name)

Diese Methode gibt eine OrderedDataStore zurück, ähnlich wie die Methode GetDataStore() mit GlobalDataStores funktioniert.Subsequente Aufrufe dieser Methode mit demselben Namen/Umfang werden dasselbe Objekt zurückgeben.

Parameter

Rückgaben

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()

Diese Funktion gibt die Anzahl der Datenlagernanfragen zurück, die der aktuelle Ort aufgrund der angegebenen Enum.DataStoreRequestType machen kann.Alle Anfragen, die dieses Budget überschreiten, werden gedrosselt.Die Überwachung und Anpassung der Häufigkeit von Datenlagersanfragen mit dieser Funktion wird empfohlen.

Parameter

Rückgaben

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

Gibt ein DataStoreListingPages-Objekt zurück, um durch alle Datenstores des Erlebnisses zu durchsuchen.Es akzeptiert einen optionalen prefix Parameter, um nur Datenstores zu finden, deren Namen mit dem angegebenen Präfix beginnen.

Nur Datenbanken, die mindestens ein Objekt enthalten, werden über diese Funktion aufgelistet.

Parameter

Rückgaben