DataStore
*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.
Zobacz magazyny danych .
Podsumowanie
Metody
Odzyskuje określoną wersję klucza.
- ListKeysAsync(prefix : string,pageSize : number,cursor : string,excludeDeleted : bool):DataStoreKeyPages
Zwraca obiekt DataStoreKeyPages do wyszukiwania poprzez klucze sklepdanych.
- ListVersionsAsync(key : string,sortDirection : Enum.SortDirection,minDate : number,maxDate : number,pageSize : number):DataStoreVersionPages
Liczy wszystkie wersje klucza.
Permanentnie usuwa określoną wersję klucza.
Zwraca wartość klucza w określonym przechowywaniu danych i instancję DataStoreKeyInfo.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Zwiększa wartość klucza o podanych liczbie (obie muszą być liczbami całkowitymi).
Usuwa określony klucz, zachowując jednocześnie dostępną wersję.
Ustawia wartość magazynu danych dla podanego klucza.
Aktualizuje wartość klucza z nową wartością z określonej funkcji zwrotnej.
Właściwości
Metody
GetVersionAsync
Funkcja ta odczytuje określoną wersję klucza, wraz z instancją DataStoreKeyInfo. Można znaleźć identyfikator wersji poprzez DataStore:ListVersionsAsync() lub alternatywnie identyfikator zwrócony przez Class.GlobalDataStore:SetAsync() .
Parametry
Nazwa klucza dla której informacje o wersji są wymagane. Jeśli DataStoreOptions.AllScopes został ustawiony na prawdę podczas dostępu do magazynu danych poprzez DataStoreService:GetDataStore(), ten klucz musi być zapisany z oryginalnym zakresem, jak w " scope / key".
Liczba wersji klucza, dla którego informacje o wersji są wymagane.
Zwroty
Wartość klucza w określonej wersji i instancji DataStoreKeyInfo, która zawiera numer wersji, datę i czas utworzenia wersji i funkcje do odzyskiwania UserIds i metadanych.
ListKeysAsync
Funkcja ta zwraca obiekt DataStoreKeyPages dla listy poprzez klucze w sklepdanych. Występuje opcjonalny parametr prefix tylko do lokalizacji kluczy, których nazwa zaczyna się od podanego przedrostu.
Jeśli DataStoreOptions.AllScopes został ustawiony na prawdę podczas dostępu do DataStoreService:GetDataStore(), klucze zostaną zwrócone z wszystkimi składnikami jako flagi.
Parametry
(Opcjonalne) Prefix do użycia do lokalizacji kluczy.
(Opcjonalne) Maksymalna liczba możliwych przedmiotów, która może zostać zwrócona.
(Opcjonalne) Kursorek, aby kontynuować cykl.
(Opcjonalne) Wyklucz usunięte klucze z powrotu.
Gdy włączone, ListKeys sprawdzi do 512 kluczy. Jeśli wszystkie sprawdzone klucze zostaną usunięte, to zwróci pustą listę z kurorem, aby kontynuować cykl.
Zwroty
Przykład DataStoreKeyPages instancji, która wymienia klucze jako DataStoreKey instancji.
ListVersionsAsync
Funkcja ta wymienia wersje klucza wskazanego w górnym lub dolnym porządku określonym przez parametr Enum.SortDirection. Może opcjonalnie filtrować wersje zwrócone w minimalnej i maksymalnej daty czasu.
Parametry
Nazwa klucza dla wersji do listy. Jeśli DataStoreOptions.AllScopes został ustawiony na prawdę, gdy uzyskujesz dostęp do magazynu danych poprzez DataStoreService:GetDataStore(), ten klucz musi być zapisany z oryginalnym zakresem, jak w " scope / key".
Lista Sortowania - określa kolejność sortowania w górę lub w dół.
Timestamp UNIX w milisekundach po tym, jakie wersje powinny być wymienione.
Unixowy czas działania milisekundowy do którego należy lista wersji.
Liczba pozycji do zwrócenia na każdej stronie.
Zwroty
Instancja DataStoreVersionPages, która열istuje wszystkie wersje klucza jako DataStoreObjectVersionInfo instancje.
Przykłady kodu
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
Funkcja ta trwale usuwa określoną wersję klucza. Identyfikatory wersji można znaleźć poprzez DataStore:ListVersionsAsync() .
W przeciwieństwie do GlobalDataStore:RemoveAsync() , ta funkcja nie tworzy nowej wersji "tombstone" i usunięty wartość nie może być odzyskana później.
Parametry
Nazwa klucza dla której ma być usunięta wersja. Jeśli DataStoreOptions.AllScopes został ustawiony na prawdę podczas dostępu do magazynu danych poprzez DataStoreService:GetDataStore(), ten klucz musi być zapisany z oryginalnym zakresem, jak w " scope/key".
Liczba wersji klucza do usuwać, wyjmować.