DataStoreService

Define se as funções de armazenamento de dados devem tentar automaticamente ou não.

DataStoreService não respeita essa propriedade porque o tente automático foi desativado por razões técnicas. Portanto, você deve implementar sistemas para tentar operações de novo. É possível que o tente automático seja ativado novamente no futuro.

Essa função cria uma instância DataStore com o nome e escopo fornecidos. Chamadas subsequentes a esse método com o mesmo nome/escopo retornarão o mesmo objeto.

Usar o parâmetro scope restreará as operações para esse alcance automaticamente ao prender o alcance às chaves em todas as operações feitas no armazenamento de dados. Essa função também aceita uma instância opcional de Class.DataStoreOptions que inclui opções para habilitar Class.DataStoreOptions.AllScopes|AllScopes . Veja Armazenamentos de dados</

Parâmetros

Devolução

Essa função retorna o padrão Class.GlobalDataStore . Se você quiser acessar um armazenamento de dados específico chamado dado, você deve usar a função Class.DataStoreService:GetDataStore() .

Devolução

local DataStoreService = game:GetService("DataStoreService")

local GlobalDataStore = DataStoreService:GetGlobalDataStore()

print(GlobalDataStore.Name)

Este método retorna um OrderedDataStore, semelhante ao modo como GetDataStore() faz com GlobalDataStores . Chamadas subsequentes a este método com o mesmo nome/espectro retornarão o mesmo objeto.

Parâmetros

Devolução

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

Essa função retorna o número de solicitações de armazenamento de dados que o local atual pode fazer com base no Enum.DataStoreRequestType dado. Quaisquer solicitações feitas que excedam esse orçamento estão sujeitas a restrição. Monitorar e ajustar a frequência de solicitações de armazenamento de dados usando essa função é recomendado.

Parâmetros

Devolução

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

Retorna um objeto DataStoreListingPages para listar através de todos os armazenamentos de dados da experiência. Ele aceita um parâmetro opcional prefix para localizar apenas armazenamentos de dados cujos nomes começam com o prefixo fornecido.

Apenas armazenamento de dados contendo pelo menos um objeto será listado via essa função.

Parâmetros

Devolução