DataStore
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Resumo
Métodos
Recupera la versión de la llave especificada.
- ListKeysAsync(prefix : string,pageSize : number,cursor : string,excludeDeleted : bool):DataStoreKeyPages
Class.DataStoreKeyPages objeto que devuelve un objeto de Class.DataStoreKeyPages para enumerar a través de las llaves de un tiendade datos.
- ListVersionsAsync(key : string,sortDirection : Enum.SortDirection,minDate : number,maxDate : number,pageSize : number):DataStoreVersionPages
Enumerar todas las versiones de una clave.
Elimina permanentemente la versión especificada de una clave.
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
GetVersionAsync
Esta función recupera la versión especificada de la llave, así como una instancia DataStoreKeyInfo . Un identificador de versión se puede encontrar a través de DataStore:ListVersionsAsync() o alternativamente el identificador devuelto por GlobalDataStore:SetAsync() .
Parâmetros
Nombre de la clave para la cual se solicitan las informaciones de la versión. Si DataStoreOptions.AllScopes estaba configurado como verdadero al acceder a la tienda de datos a través de DataStoreService:GetDataStore(), este nombre de la clave debe estar prependido con el alcance original como en " scope/key".
Número de versión de la llave para la que se solicita la información de la versión.
Devolução
El valor de la llave en la versión especificada y una instancia de DataStoreKeyInfo que incluye el número de versión, la fecha y el tiempo de creación de la versión y las funciones para recuperar UserIds y el metadato.
ListKeysAsync
Esta función返回一个 DataStoreKeyPages objeto para enumerar a través de las llaves de un tiendade datos. Acepta un parámetro prefix opcional para encontrar sólo las llaves cuyos nombres comienzan con el prefijo proporcionado.
Si DataStoreOptions.AllScopes fue establecido como verdadero al acceder a la tienda de datos a través de DataStoreService:GetDataStore(), las llaves se devolverán con todos los escenarios como prefijos.
Parâmetros
(Opcional) Prefijo para usar para localizar claves.
(Opcional) Número máximo de artículos posibles que se pueden devolver.
(Opcional) Cursor para continuar la iteración.
(Opcional)) Excluya las llaves eliminadas de ser devueltas.
Cuando esté habilitado, ListKeys verificará hasta 512 claves. Si se eliminan todas las claves verificadas, entonces se devolverá una lista vacía con un cursor para continuar con la iteración.
Devolução
Una instancia de DataStoreKeyPages que enumera las llaves como DataStoreKey instancias.
ListVersionsAsync
Esta función enumera las versiones de la llave especificada en orden ascendente o descendente especificado por un parámetro Enum.SortDirection . Puede filtrar opcionalmente las versiones devueltas por el menor y máximo tiempo de marcado.
Parâmetros
Nombre de la clave para las versiones para listar. Si DataStoreOptions.AllScopes fue establecido como verdadero al acceder a la tienda de datos a través de DataStoreService:GetDataStore(), este nombre de la clave debe prependerse con el alcance original como en " scope / key".
Lista de elementos que especifica el orden de clasificación ascendente o descendente.
Marca de tiempo Unix en milisegundos después de la cual se deben listar las versiones.
Tiempo de sincronización de Unix en milisegundos hasta la cual las versiones deberían estar listadas.
Número de artículos que se devolverán en cada página.
Devolução
Una instancia de DataStoreVersionPages que enumera todas las versiones de la llave como DataStoreObjectVersionInfo instancias.
Amostras de código
local DataStoreService = game:GetService("DataStoreService")
local experienceStore = DataStoreService:GetDataStore("PlayerExperience")
local time = DateTime.fromUniversalTime(2020, 10, 09, 01, 42)
local listSuccess, pages = pcall(function()
return experienceStore:ListVersionsAsync("User_1234", nil, time.UnixTimestampMillis)
end)
if listSuccess then
local items = pages:GetCurrentPage()
for key, info in pairs(items) do
print("Key:", key, "; Version:", info.Version, "; Created:", info.CreatedTime, "; Deleted:", info.IsDeleted)
end
endRemoveVersionAsync
Esta función elimina permanentemente la versión especificada de una clave. Los identificadores de versión se pueden encontrar a través de DataStore:ListVersionsAsync() .
A diferencia de GlobalDataStore:RemoveAsync() , esta función no crea una nueva versión de "tombstone" y el valor eliminado no se puede recuperar más tarde.
Parâmetros
Nombre de la clave para la cual se desea eliminar una versión. Si DataStoreOptions.AllScopes fue establecido como cierto al acceder a la tienda de datos a través de DataStoreService:GetDataStore(), este nombre de la clave debe prependerse con el alcance original como en " scope/key".
Número de versión de la llave para eliminar.