DataStore
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
Ayrıca bakın Veri Depoları.
Özet
Özellikler
Yöntemler
Belirlenen anahtar versiyonunu alır.
- ListKeysAsync(prefix : string,pageSize : number,cursor : string,excludeDeleted : bool):DataStoreKeyPages
Bir veri depolarının mağazaarasında listelenen bir DataStoreKeyPages nesneyi iade eder.
- ListVersionsAsync(key : string,sortDirection : Enum.SortDirection,minDate : number,maxDate : number,pageSize : number):DataStoreVersionPages
Bir anahtarın tüm versiyonlarını sayar.
anahtarbelirli sürümünü kalıcı olarak siler.
Bir anahtarın değerini belirli bir veri depolarında ve bir DataStoreKeyInfo durumiade eder.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Bir anahtarın değerini sağlanan miktar ile artırır (her ikisi de sayı olmalıdır).
Erişilebilir bir versiyonu korurken belirli anahtarı da kaldırır.
Veritabanının belirlenen anahtar için değerini ayarlar.
Bir anahtarın değerini yeni bir değerle belirlenen çağrı işlevinden alır.
Özellikler
Yöntemler
GetVersionAsync
Bu işlev, belirlenen anahtar versiyonunu ve bir DataStoreKeyInfo istemcisi için de alır. Bir versiyon belirleyici, DataStore:ListVersionsAsync() veya alternatif olarak GlobalDataStore:SetAsync() ile gönderilen olabilir.
Parametreler
Versiyon bilgisi istendiği için versiyon bilgisi istendiği anahtar kayıdı. Eğer Class.DataStoreOptions.AllScopes``Class.DataStoreService:GetDataStore() ile veri depolarına erişildiğinde, bu anahtar kayıdının orijinal kaydıyla birleştirilmesi gerekir. " scope / key"deki kayıdın başlığı.
Versiyon bilgisi istenen anahtarın sürüm numarası.
Dönüşler
Anahtarın belirlenen versiyonundaki değeri ve bir DataStoreKeyInfo istemcisi, versiyon numarası, oluşturulma tarihi ve saati ve işlevleri toplar. Metadatayı geri almak için UserIds ve metadatayı almak için işlevleri.
ListKeysAsync
Bu işlev, bir veri mağazaanahtarları arasında listelenen bir DataStoreKeyPages nesneyi iade eder. Bir seçenek prefix parçasını kabul eder ve sadece sağlanan özellikle başlayan isimleri olan anahtarları listeler.
Eğer DataStoreOptions.AllScopes , veri depolarına erişim sağlayan DataStoreService:GetDataStore() ile etkinleştirildiğinde, anahtarlar tüm alanlar olarak geri dönecektir.
Parametreler
(Opcional) Bir anahtarı bulmak için kullanılan özel bir tane.
(Opcional) Geri verilebilecek maksimum öğe sayısı.
(isteğe bağlı) Kısayol, itmeyi sürdürmek için.
(Opcional) Silinen anahtarların dönüşünü engelle.
ListKeys etkinleştirildiğinde yaklaşık 512 anahtar kontrol edilir. Eğer kontrol edilen tüm anahtarlar silinirse, it will return an empty list with a cursor to continue iteration.
Dönüşler
Anahtarları DataStoreKeyPages olarak listeleyen bir DataStoreKey istemcisi.
ListVersionsAsync
Bu işlev, bir Enum.SortDirection parametresi tarafından belirlenmiş olan anahtarın versiyonlarını yükseltme veya düşürme sırasında belirten sıralama şeklinde listeler. Minimum ve maksimum tarih aralığını seçen minimum ve maksimum tarih aralığını seçen versiyonları gösterebilir.
Parametreler
Sürümleri listeleyecek anahtar ismi. DataStoreOptions.AllScopes , aşağıdaki DataStoreService:GetDataStore() aracılığıyla erişim için Class.DataStore olarak ayarlandığında, bu anahtar ismi, " scope / key" olarak kaydedilmiş olmalıdır.
Yükseleniyor veya düşüyor sıralama düzenini belirtir.
Versiyonların sıralanmasından önce milisaniye olarak Unix zaman damgası.
Versiyonların listelenmesine kadar milisaniye olarak Unix zaman damgası.
Her sayfada iade edilecek öğelerin sayısı.
Dönüşler
Tüm versiyonların anahtarını DataStoreVersionPages olarak listeleyen bir DataStoreObjectVersionInfo istemcisi.
Kod Örnekleri
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
Bu işlev, bir anahtarın belirli sürümünü kalıcı olarak siler. Versiyon belirleyicileri DataStore:ListVersionsAsync() aracılığıyla bulunabilir.
Class.GlobalDataStore:RemoveAsync() ile aynı değildir, bu işlev yeni bir "mezar taşı" versiyonu oluşturmaz ve kaldırılan değer daha sonra alınamaz.
Parametreler
Kaldırılacak versiyon için anahtar ismi. DataStoreOptions.AllScopes , aşağıdaki DataStoreService:GetDataStore() ile erişim sağlandığında doğru olarak ayarlandığında, bu anahtar ismi kapsayıcı olmalıdır.
Kaldırılacak anahtarın versiyon numarası.