DataStore
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
Vedi Data Stores .
Sommario
Proprietà
Metodi
Recupera la versione della chiave specificata.
- ListKeysAsync(prefix : string,pageSize : number,cursor : string,excludeDeleted : bool):DataStoreKeyPages
Restituisce un oggetto DataStoreKeyPages per l'elenco attraverso le chiavi di un Negoziodi dati.
- ListVersionsAsync(key : string,sortDirection : Enum.SortDirection,minDate : number,maxDate : number,pageSize : number):DataStoreVersionPages
Elenca tutte le versioni di una chiave.
Elimina permanentemente la versione specificata di una chiave.
Restituisce il valore di una chiave in un determinato store di dati e un'esempioDataStoreKeyInfo .
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Aumenta il valore di una chiave di un importo fornito (entrambi devono essere interi).
Rimuove la chiave specificata mentre conserva anche una versione accessibile.
Imposta il valore del data store per la chiave specificata.
Aggiorna il valore di una chiave con un nuovo valore dalla funzione richiamata specificata.
Proprietà
Metodi
GetVersionAsync
Questa funzione recupera la versione chiave specificata nonché un'esempioDataStoreKeyInfo . Un identificatore della versione può essere trovato attraverso DataStore:ListVersionsAsync() o alternativamente essere l'identificatore restituito da GlobalDataStore:SetAsync() .
Parametri
Nome chiave per il quale sono richiesti informazioni sulla versione. Se DataStoreOptions.AllScopes è impostato su true quando si accede al data store attraverso DataStoreService:GetDataStore(), questo nome chiave deve essere aggiunto con lo scopo originale come in "scope/key" .
Numero della versione per la quale sono richieste informazioni sulla versione.
Restituzioni
Il valore della chiave alla versione specificata e un'istanza DataStoreKeyInfo che include il numero di versione, la data e l'ora in cui la versione è stata creata e le funzioni per recuperare UserIds e le metadati.
ListKeysAsync
Questa funzione restituisce un oggetto DataStoreKeyPages per l'elenco attraverso le chiavi di un Negoziodi dati. Accetta un parametro opzionale prefix per localizzare solo le chiavi le cui parti iniziano con il prefisso fornito.
Se DataStoreOptions.AllScopes è impostato su true quando si accede al data store attraverso DataStoreService:GetDataStore(), le chiavi vengono restituite con tutti gli scopi come prefissi.
Parametri
(Opzionale) Prefisso da utilizzare per localizzare le chiavi.
(Opzionale) Numero massimo di oggetti possibili che possono essere restituiti.
(Facoltativo) Cursor per continuare l'iterazione.
(Opzionale) Escludi i chiavi eliminati dal essere restituiti.
Quando è abilitato ListKeys controlla fino a 512 chiavi. Se tutte le chiavi controllate vengono eliminate, restituirà un elenco vuoto con un cursore per continuare l'iterazione.
Restituzioni
Un'istanza DataStoreKeyPages che elenca le chiavi come DataStoreKey istanze.
ListVersionsAsync
Questa funzione elenca le versioni della chiave specificata in ordine ascendente o discendente specificato da un Enum.SortDirection parametro. Può filtrare opzionalmente le versioni restituite in base al minimo e massimo timestamp.
Parametri
Nome chiave per le versioni da elencare. Se DataStoreOptions.AllScopes è impostato su true quando si accede al data store attraverso DataStoreService:GetDataStore(), questo nome chiave deve essere aggiunto con lo scopo originale come in "scope/key".
Lista gli elementi in ordine ascendente o discendente.
timestamp in millisecondi di Unix dopo cui le versioni dovrebbero essere elencate.
timestamp in millisecondi fino a cui le versioni dovrebbero essere elencate.
Numero di oggetti da restituire in ogni pagina.
Restituzioni
Un'istanza DataStoreVersionPages che elenca tutte le versioni della chiave come DataStoreObjectVersionInfo istanze.
Campioni di codice
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
Questa funzione elimina permanentemente la versione specificata di una chiave. I identificatori della versione possono essere troati attraverso DataStore:ListVersionsAsync() .
A differenza di GlobalDataStore:RemoveAsync() , questa funzione non crea una nuova versione "tombstone" e il valore rimosso non può essere recuperato in seguito.
Parametri
Nome della chiave per la quale una versione deve essere rimossa. Se DataStoreOptions.AllScopes è impostato su true quando si accede al data store attraverso DataStoreService:GetDataStore(), questo nome della chiave deve essere aggiunto con lo scopo originale come in "scope/key".
Numero di versione della chiave da Rimuovere.