DataStore
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
Xem Kho dữ liệu .
Tóm Tắt
Phương Pháp
Lấy ra phiên bản chìa khóa được chỉ định.
- ListKeysAsync(prefix : string,pageSize : number,cursor : string,excludeDeleted : bool):DataStoreKeyPages
Điều khiển trả lại một DataStoreKeyPages đối tượng để đếm thông qua các chìa khóa của một cấu cửa hàngdữ liệu.
- ListVersionsAsync(key : string,sortDirection : Enum.SortDirection,minDate : number,maxDate : number,pageSize : number):DataStoreVersionPages
Đếm tất cả các phiên bản của một chìa khóa.
Xóa vĩnh viễn bản chất của một chìa khóa.
Trả lại giá trị của một chìa khóa trong một lưu trữ dữ liệu được xác định và một DataStoreKeyInfo ví dụ / trường hợp.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Tăng giá trị của một chìa khóa bằng số lượng cung cấp (cả hai phải là số lượng).
Loại bỏ chìa khóa được chỉ định trong khi giữ một phiên bản truy cập được.
Điều chỉnh giá trị của cửa hàng dữ liệu cho giá trị đã được cung chìa khóa.
Cập nhật giá trị của một chìa khóa bằng một giá trị mới từ hàm chuỗi đã định.
Thuộc Tính
Phương Pháp
GetVersionAsync
Hàm này lấy lại phiên bản chìa khóa được chỉ định cũng như một DataStoreKeyInfo ví dụ / trường hợp. Một identifier phiên bản có thể được tìm thấy thông qua DataStore:ListVersionsAsync() hoặc alternatively là identifier được trả lại bởi GlobalDataStore:SetAsync().
Tham Số
Tên của chìa khóa mà thông tin phiên bản được yêu cầu. Nếu DataStoreOptions.AllScopes được đặt thành true khi truy cập vào cơ sở dữ liệu thông qua DataStoreService:GetDataStore(), tên của chìa khóa này phải được kết hợp với phạm vi của n
Số phiên bản của chìa khóa mà thông tin phiên bản được yêu cầu.
Lợi Nhuận
Giá trị của chìa khóa ở phiên bản được xác định và một DataStoreKeyInfo instância bao gồm số phiên bản, ngày và thời gian mà phiên bản đã được tạo, và các chức năng để lấy lại UserIds và métadữ liệu.
ListKeysAsync
Hàm này trả về một DataStoreKeyPages đối tượng để quản lý thông qua các chìa khóa của một cấu hình dữ liệu. Nó chấp nhận một prefix đơn vị tùy chỉnh để chỉ định chỉ những khóa có tên bắt đầu bằng cấu hình dữ liệu cung cấp.
Nếu DataStoreOptions.AllScopes được đặt để true khi truy cập vào cửa hàng dữ liệu thông qua DataStoreService:GetDataStore() , các chìa khóa sẽ được trả lại với tất cả các scopes như các hàm.
Tham Số
(Tùy chọn)) Dùng để tìm kiếm các ký tự.
(Tùy chọn) Số lượng tối đa các mục có thể được trả lại.
(Bắt buộc) Cursor để tiếp tục lặp.
(Tùy chọn) Loại bỏ các ký tự đã xóa khỏi bị trả lại.
Khi bật ListKeys sẽ kiểm tra tối đa 512 các khóa. Nếu tất cả các khóa đã được xóa thì nó sẽ trả lại một danh sách trống với một cursor để tiếp tục lặp.
Lợi Nhuận
Một DataStoreKeyPages instance đếm các chìa khóa như DataStoreKey instances.
ListVersionsAsync
Hàm này liệt kí các phiên bản của chìa khóa đó trong một trình tự dưới tăng hoặc giảm theo thứ tự đã định bởi một Enum.SortDirection tham số. Nó có thể lọc các phiên bản trả lại bằng thời gian tối thiểu và tối đa.
Tham Số
Tên chìa khóa cho các phiên bản để list. If DataStoreOptions.AllScopes được đặt to true when accessing the data store through DataStoreService:GetDataStore() , this key name must be prepended with the original scope as in " scope/key".
Danh sách đặt hạng theo thứ tự lên hoặc xuống.
Dấu hiệu Unix sau một mili giây sau đó, các phiên bản sẽ được liệt kê.
Dấu hiệu Unix trong mili giây lên đến mà các phiên bản nên được liệt kê.
Số lượng các mặt hàng để trả lại trong mỗi trang.
Lợi Nhuận
Một DataStoreVersionPages instância nói trên tất cả các phiên bản của chìa khóa như DataStoreObjectVersionInfo instância.
Mẫu mã
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
Hành động này xóa vĩnh viễn phiên bản được đặt của một chìa khóa. Các biến tính phiên bản có thể được tìm thấy thông qua DataStore:ListVersionsAsync() .
Ngoài ra, GlobalDataStore:RemoveAsync() , hàm này không tạo ra một phiên bản "tombstone" mới và giá trị đã xóa không thể được lấy lại sau.
Tham Số
Tên của chìa khóa mà một phiên bản nào đó sẽ được xóa. Nếu DataStoreOptions.AllScopes được đặt thành true khi truy cập vào cơ sở dữ liệu thông qua DataStoreService:GetDataStore(), tên của chìa khóa này phải được kết hợp với nguyên
Số phiên bản của chìa khóa để xóa.