DataStoreService

Veri depolama işlevlerinin otomatik olarak yeniden denemesi gerektiğini veya gerektiğinden daha az kayıp vermeyi ayarlar.

DataStoreService bu özelliğe saygınız çünkü teknik nedenlerden dolayı otomatik yeniden deneme işlemleri devre dışı. Bu nedenle, operasyonların yeniden denemes için kendiniz için sistemleri uygulamanız gerekir. Bu gelecekte otomatik yeniden denemesi tekrar etkinleştirilebilir.

Bu işlev, sağlanan isim ve kapsayla bir DataStore instansı oluşturur. Bu yöntemle aynı isim/kapsayla olan sonraki çağrılar aynı nesneyi iade eder.

scope parametresini kullanmak, kaynakların tüm işlemlerinde kaynağı oluşturma işlemlerine otomatik olarak önleyerek kaynağı tüm işlemlerde kullanılabilir hale getirir. Bu işlev ayrıca, kaynağın etkinleştirilmesi için DataStoreOptions

Parametreler

Dönüşler

Bu işlev, varsayılan GlobalDataStore 'i döndürür. Eğer özel bir adlandırılmış veri depolarına erişmek istiyorsanız, GetDataStore() işlevini kullanmalısınız.

Dönüşler

local DataStoreService = game:GetService("DataStoreService")

local GlobalDataStore = DataStoreService:GetGlobalDataStore()

print(GlobalDataStore.Name)

Bu yöntem bir OrderedDataStore , GetDataStore() ile aynı şekilde işlem yaptığı gibi döndürür. Subsequent calls to this method with the same name/scope will return the same object.

Parametreler

Dönüşler

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

Bu işlev, mevcut yerin Enum.DataStoreRequestType ile belirlenen veri depolama isteklerinin sayısını döndürür. Bu bütçeyi aşan istekler, sınırlandırılabilir. Veri depolama isteklerinin frekansını izlemek ve ayarlamak bu işlevi kullanıyor.

Parametreler

Dönüşler

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

Tüm deneyimin veri depoları arasında listelenmek için bir DataStoreListingPages nesne döndürür. Bir seçenek prefix parçasını kabul eder ve sadece ismi belirlenen depoları bulmak için bir başlangıç parametresi kabul eder.

En az bir nesne içeren sadece veri depoları bu işlev aracılığıyla listelenir.

Parametreler

Dönüşler