OrderedDataStore
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
Un almacén de datos ordenados es esencialmente un GlobalDataStore con la excepción de que los valores almacenados deben ser enteros positivos .Explica un método GetSortedAsync() que permite la inspección de las entradas en orden alfabético utilizando un objeto DataStorePages.
Las tiendas de datos ordenadas no admiten versiones y metadatos, por lo que DataStoreKeyInfo siempre es nil para las claves en un OrderedDataStore .Si necesita Soportede versiones y metadatos, utilice un DataStore .
Las tiendas de datos ordenadas no admiten el parámetro opcional userIds para SetAsync() o IncrementAsync().
Vea Almacenes de datos para obtener una visión general sobre el uso de almacenes de datos ordenados.
Muestras 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()Resumen
Métodos
- GetSortedAsync(ascending : boolean,pagesize : number,minValue : Variant,maxValue : Variant):DataStorePages
Devuelve un objeto DataStorePages de regreso.
Devuelve el valor de una clave en un almacén de datos especificado y una instancia DataStoreKeyInfo .
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Incrementa el valor de una clave por la cantidad proporcionada (ambos deben ser enteros).
Elimina la clave especificada mientras mantiene una versión accesible.
Establece el valor del almacén de datos para la clave dada.
Actualiza el valor de una clave con un nuevo valor de la función de llamada especificada.
Propiedades
Métodos
GetSortedAsync
Devuelve un objeto DataStorePages de regreso.El orden de clasificación se determina por ascendente , la longitud de cada página por tamaño de página y minValue / maxValue son parámetros opcionales que filtran los resultados.
Vea Almacenes de datos para los límites de solicitud y las descripciones de los códigos de error.
Parámetros
Un booleano que indica si las páginas de datos devueltas están en orden ascendente.
La longitud de cada página. Por defecto es 50. El valor máximo permitido es 100.
Parámetro opcional. Si se establecer, las páginas de datos con un valor inferior a minValue serán excluidas.
Parámetro opcional. Si se establecer, las páginas de datos con un valor mayor que maxValue serán excluidas.
Devuelve
Un objeto ordenado DataStorePages basado en los argumentos proporcionados.