DataStore

Tampilkan yang Tidak Digunakan Lagi

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Tidak Dapat Dibuat
Tidak Direplikasi

Lihat Toko Data.

Rangkuman

Metode

Metode diwarisi dari GlobalDataStore

Properti

Metode

GetVersionAsync

Hasil

Fungsi ini memulihkan versi kunci yang ditentukan serta instansi DataStoreKeyInfo .Pengidentifikasi versi dapat ditemukan melalui DataStore:ListVersionsAsync() atau alternatifnya adalah identifikasi yang dikembalikan oleh GlobalDataStore:SetAsync() .

Parameter

key: string

Nama kunci untuk versi informasi yang diminta.Jika DataStoreOptions.AllScopes diatur ke benar saat mengakses penyimpanan data melalui DataStoreService:GetDataStore(), nama kunci ini harus diikuti dengan cakupan asli seperti dalam "scope/key".

Nilai Default: ""
version: string

Nomor versi kunci untuk mana informasi versi diminta.

Nilai Default: ""

Memberikan nilai

Nilai kunci pada versi yang ditentukan dan instansi DataStoreKeyInfo yang termasuk nomor versi, tanggal dan waktu versi dibuat, dan fungsi untuk mengambil UserIds dan metadata.

GetVersionAtTimeAsync

Hasil

Fungsi ini memulihkan versi kunci yang saat ini pada waktu tertentu serta instansi DataStoreKeyInfo .

Parameter

key: string

Nama kunci untuk versi informasi yang diminta.Jika DataStoreOptions.AllScopes diatur ke benar saat mengakses penyimpanan data melalui DataStoreService:GetDataStore(), nama kunci ini harus diikuti dengan cakupan asli seperti dalam "scope/key".

Nilai Default: ""
timestamp: number

timestamp Unix dalam milidetik di mana versi yang diminta saat ini.Harus lebih besar dari nol.Tidak boleh lebih dari sepuluh menit di masa depan.

Nilai Default: ""

Memberikan nilai

Nilai kunci yang saat ini pada waktu yang ditentukan dan instansi DataStoreKeyInfo yang mencakup nomor versi, tanggal dan waktu versi dibuat, dan fungsi untuk mengambil UserIds dan metadata.nil jika tidak ada versi yang tersedia saat ini pada waktu yang diminta.

Contoh Kode

The following code sample retrieves data store key versions using timestamps.

Retrieving DataStore Versions by Time

local DataStoreService = game:GetService("DataStoreService")
local dataStore = DataStoreService:GetDataStore("DataStore")
local key = "key-123"
function setData(data)
local success, result = pcall(function()
dataStore:SetAsync(key, data)
end)
if not success then
warn(result)
end
end
function getVersionAtTime(timestamp)
local success, result, keyInfo = pcall(function()
return dataStore:GetVersionAtTimeAsync(key, timestamp.UnixTimestampMillis)
end)
if success then
if result == nil then
print("No version found at time")
else
print(result, keyInfo.Version)
end
else
warn(result)
end
end
-- Previously ran at 2024/12/02 6:00 UTC
setData("version 1")
-- Previously ran at 2024/12/02 9:00 UTC
setData("version 2")
-- Prints "No version found at time"
local time1 = DateTime.fromUniversalTime(2024, 12, 02, 05, 00)
getVersionAtTime(time1)
-- Prints "version 1 <version>"
local time2 = DateTime.fromUniversalTime(2024, 12, 02, 07, 00)
getVersionAtTime(time2)
-- Prints "version 2 <version>"
local time3 = DateTime.fromUniversalTime(2024, 12, 02, 10, 00)
getVersionAtTime(time3)

ListKeysAsync

Hasil

Fungsi ini mengembalikan objek DataStoreKeyPages untuk menguraikan melalui kunci penyimpanan data.Ini menerima parameter opsional prefix untuk hanya menemukan kunci yang namanya dimulai dengan prefiks yang disediakan.

Jika DataStoreOptions.AllScopes diatur ke benar saat mengakses penyimpanan data melalui DataStoreService:GetDataStore(), kunci akan dikembalikan dengan semua scope sebagai prefiks.

Parameter

prefix: string

(Opsi) Prefix untuk digunakan untuk menemukan kunci.

Nilai Default: ""
pageSize: number

(Opsi) Jumlah item yang akan dikembalikan di setiap halaman.Jika tidak ada nilai yang diberikan, mesin mengirim nilai default 0 ke layanan web penyimpanan data, yang pada gilirannya default ke 50 item per halaman.

Nilai Default: 0
cursor: string

(Opsi) Cursor untuk melanjutkan iterasi.

Nilai Default: ""
excludeDeleted: boolean

(Opsi) Hapus kunci yang dihapus dari dikembalikan.

Saat diaktifkan, ListKeys akan memeriksa hingga 512 kunci.Jika semua tombol terverifikasi dihapus maka akan mengembalikan daftar kosong dengan kursor untuk melanjutkan iterasi.

Nilai Default: false

Memberikan nilai

Sebuah instansi DataStoreKeyPages yang mencantumkan kunci sebagai instansi DataStoreKey.

ListVersionsAsync

Hasil

Fungsi ini mencantumkan versi kunci yang ditentukan dalam urutan menaik atau menurun yang ditentukan oleh parameter Enum.SortDirection .Ini dapat opsional memfilter versi yang dikembalikan dengan waktu paling sedikit dan paling maksimal.

Parameter

key: string

Nama kunci untuk versi yang akan dicantumkan.Jika DataStoreOptions.AllScopes diatur ke benar saat mengakses penyimpanan data melalui DataStoreService:GetDataStore(), nama kunci ini harus diikuti dengan cakupan asli seperti dalam "scope/key".

Nilai Default: ""
sortDirection: Enum.SortDirection

(Opsi) Enum menentukan urutan urutan naik atau turun.

Nilai Default: "Ascending"
minDate: number

(Opsi) Tanda tanggal Unix dalam milidetik setelah itu versi harus dicantumkan

Nilai Default: 0
maxDate: number

(Opsi) Tanda waktu Unix dalam milidetik hingga versi harus dicantumkan.

Nilai Default: 0
pageSize: number

(Opsi) Jumlah item yang akan dikembalikan di setiap halaman.Jika tidak ada nilai yang diberikan, mesin mengirim nilai default 0 ke layanan web penyimpanan data, yang pada gilirannya default ke 1024 item per halaman.

Nilai Default: 0

Memberikan nilai

Sebuah instansi DataStoreVersionPages yang mencantumkan semua versi kunci sebagai DataStoreObjectVersionInfo instansi.

Contoh Kode

The following code sample retrieves all versions after a specified starting time, sorted in ascending order.

Retrieving DataStore Versions With A Date Filter

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
end

RemoveVersionAsync

()
Hasil

Fungsi ini secara permanen menghapus versi kunci yang ditentukan. Pengidentifikasi versi dapat ditemukan melalui DataStore:ListVersionsAsync() .

Tidak seperti GlobalDataStore:RemoveAsync() , fungsi ini tidak membuat versi "batu makam" baru dan nilai yang dihapus tidak dapat dipulihkan nanti.

Parameter

key: string

Nama kunci untuk versi yang akan dihapus.Jika DataStoreOptions.AllScopes diatur ke benar saat mengakses penyimpanan data melalui DataStoreService:GetDataStore(), nama kunci ini harus diikuti dengan cakupan asli seperti dalam "scope/key".

Nilai Default: ""
version: string

Nomor versi kunci untuk dihapus.

Nilai Default: ""

Memberikan nilai

()

Acara