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 Ordenados é essencialmente um GlobalDataStore com a exceção de que os valores armazenados devem ser inteiros positivos .Ela expõe um método GetSortedAsync() que permite a inspeção das entradas em ordem ordenada usando um ObjetoDataStorePages.
Armazenamentos de dados ordenados não suportam versões e metadados, então DataStoreKeyInfo é sempre nil para chaves em um OrderedDataStore .Se você precisar de Suportea versões e metadados, use um DataStore .
Armazenamentos de dados ordenados não suportam o parâmetro opcional userIds para SetAsync() ou IncrementAsync().
Veja Armazenamentos de Dados para uma visão geral sobre o uso de armazenamentos de dados ordenados.
Amostras de código
This code sample demonstrates usage of an OrderedDataStore and pages.
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
- GetSortedAsync(ascending : boolean,pagesize : number,minValue : Variant,maxValue : Variant):DataStorePages
Retorna um ObjetoDataStorePages de retorno.
Retorna o valor de uma chave em um armazenamento de dados especificado e uma instância DataStoreKeyInfo .
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Aumenta o valor de uma chave pelo valor fornecido (ambos devem ser inteiros).
Remove a chave especificada enquanto também mantém uma versão acessível.
Define o valor do armazenamento de dados para a chave dada.
Atualiza o valor de uma chave com um novo valor da função de chamada especificada.
Propriedades
Métodos
GetSortedAsync
Retorna um ObjetoDataStorePages de retorno.A ordem de classificação é determinada por ascendente , a comprimento de cada página por tamanho da página e minValue / maxValue são parâmetros opcionais que filtram os resultados.
Veja Armazenamentos de Dados para limites de solicitações e descrições dos códigos de erro.
Parâmetros
Um booleano que indica se as páginas de dados retornadas estão em ordem crescente.
O comprimento de cada página. Por padrão, é 50. O valor máximo permitido é 100.
Parâmetro opcional. Se configurar, páginas de dados com um valor inferior a 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 ordenado DataStorePages baseado nos argumentos fornecidos.