DataStoreInfo

概览

字段	值
Kind	Data · 数据 Data
Realm	server

DataStoreInfo 是 DataStoreService 列表接口返回的集合信息条目，包含集合名称、类型、创建/更新时间、键数量、占用大小和删除状态。

适用场景

在服务端管理脚本中列出普通 DataStore 或 OrderedDataStore 集合时，读取每个集合的元信息用于巡检、迁移或清理。

使用要点

先调用 DataStoreService:ListDataStoresAsync 或 ListOrderedDataStoresAsync 获得 DataStoreInfoPages，再从 pages:GetCurrentPage() 返回的数组中读取 DataStoreInfo 条目。

注意事项

DataStoreInfo 不可直接构造，DataStoreInfo.New(...) 与 DataStoreInfo(...) 都无法生成有效实例，只能来自 ListDataStoresAsync 或 ListOrderedDataStoresAsync 的分页结果。它表示查询时刻的集合快照，生命周期随宿主分页结果，不宜长期缓存后当作实时状态使用。CreatedTime 与 UpdatedTime 为毫秒时间戳，KeyCount 与 Size 属于集合层面的统计值，不能替代对具体键的读写操作。

代码示例

读取 DataStoreInfo 条目

-- @runtime server
local DataStoreService = game:GetService('DataStoreService')
local Task = game:GetService('Task')

Task:Spawn(function()
    local pages = DataStoreService:ListDataStoresAsync('', 10)
    for _, info in ipairs(pages:GetCurrentPage()) do
        print('集合:', info.DataStoreName)
        print('类型:', info.DataStoreType, '键数量:', info.KeyCount, '大小:', info.Size)
    end
end)

属性 (7)

Name	类型	默认值	说明
DataStoreName	String	""	DataStoreInfo 的 DataStoreName 属性为字符串类型，表示这条集合信息所对应的数据存储集合名称，是该集合在数据存储服务中的标识。
DataStoreType	Int	1	DataStoreInfo 的 DataStoreType 属性为整型，表示这条集合信息对应的集合类型，按公开说明取值为 1（普通集合）或 2（有序集合）。
CreatedTime	Int	0	DataStoreInfo 的 CreatedTime 属性为整型毫秒时间戳，表示该数据存储集合的创建时间。
UpdatedTime	Int	0	DataStoreInfo 的 UpdatedTime 属性为整型毫秒时间戳，表示该数据存储集合最近一次更新的时间。
KeyCount	Int	0	DataStoreInfo 的 KeyCount 属性为整型，表示该数据存储集合中包含的键数量。
Size	Int	0	DataStoreInfo 的 Size 属性为整型，表示该数据存储集合占用的数据大小，单位为字节。
IsDeleted	Bool	false	DataStoreInfo 的 IsDeleted 属性为布尔值，表示这条集合信息对应的数据存储集合是否已被删除。