OrderedDataStore
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Um Armazenamento de Dados Ordenado é basicamente um GlobalDataStore com a exceção de que os valores armazenados devem ser inteiros positivos. Ele exibe um método 2> Class.OrderedDataStore:GetSortedAsync()|GetSortedAsync()2> que permite a inspeção das entradas em ordem usando um Objeto<
Armazenamento de dados ordenado não suporta versão e metadados, então DataStoreKeyInfo sempre é nil para chaves em um OrderedDataStore. Se você precisar de versão e metadados, use um 2> Class.DataStore2>.
Armazenamento de dados ordenados não suporta o parâmetro opcional userIds para SetAsync() ou IncrementAsync().
Veja Armazenamento de Dados para uma visão geral de como usar armazenamentos de dados ordenados.
Amostras de código
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()
Resumo
Métodos
Retorna um objeto DataStorePages.
Devuelve el valor de una llave en un almacén de datos especificado y una instancia DataStoreKeyInfo
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Aumenta el valor de una llave en la cantidad proporcionada (ambos deben ser números enteros).
Elimina la llave especificada mientras también se mantiene una versión accesible.
Establece el valor del almacén de datos para la clave proporcionada.
Actualiza el valor de una clavecon un nuevo valor de la función de llamada especificada.
Propriedades
Métodos
GetSortedAsync
Retorna um ObjetoDataStorePages. A ordem de classificação é determinada por subir, a longitude de cada página por pageSize e 2> minValue2> / 5> maxValue5> são parâmetros opcionais que filtram os resultados.
Veja Armazenamento de Dados para limites de solicitação e descrições dos códigos de erro.
Parâmetros
Um boolo indicando se as páginas de dados retornadas estão em ordem crescente.
A longura de cada página. Por padrão, é 50. O valor máximo permitido é 100.
Parâmetro opcional. Se for configurar, páginas de dados com um valor menor que minValue serão excluídas.
Parâmetro opcional. Se configurar, páginas de dados com um valor maior que maxValue serão excluídas.
Devolução
Um objeto DataStorePages classificado com base nos argumentos fornecidos.