DataStoreKeyInfo

DataStoreKeyInfo : Instance

Overview

데이터 저장소에서 특정 키의 버전 정보를 담고 있는 객체입니다.

GlobalDataStore의 GetAsync와 UpdateAsync 메서드를 호출하면, 이 객체가 반환되어 해당 키가 어떤 버전 상태였는지 확인할 수 있습니다.

Properties

CreatedTime

number

해당 객체가 만들어진 날짜와 시간을 나타내는 속성입니다.

Unix Epoch(1970-01-01 00:00:00 UTC)부터 경과한 시간을 밀리초 단위로 표현합니다.

Code Samples

local DataStoreService = game:GetService("DataStoreService") 
local GoldStore = DataStoreService:GetDataStore("PlayerGold")

local success, errorMessageOrLoadValue, keyInfo = pcall(function()
    return GoldStore:GetAsync(player.UserId)
end)

if not success then
    print("errorMessage : ", errorMessageOrLoadValue)
else
    local loadValue = errorMessageOrLoadValue
    local createdTime = keyInfo.CreatedTime
    local version = keyInfo.Version
    local updatedTime = keyInfo.UpdatedTime
end

UpdatedTime

double

해당 객체가 수정된 날짜와 시간을 나타내는 속성입니다.

Unix Epoch(1970-01-01 00:00:00 UTC)부터 경과한 시간을 밀리초 단위로 표현합니다.

Code Samples

local DataStoreService = game:GetService("DataStoreService") 
local GoldStore = DataStoreService:GetDataStore("PlayerGold")

local success, errorMessageOrLoadValue, keyInfo = pcall(function()
    return GoldStore:GetAsync(player.UserId)
end)

if not success then
    print("errorMessage : ", errorMessageOrLoadValue)
else
    local loadValue = errorMessageOrLoadValue
    local createdTime = keyInfo.CreatedTime
    local version = keyInfo.Version
    local updatedTime = keyInfo.UpdatedTime
end

Version

string

해당 객체가 가진 개별 버전을 구분하도록 설계된 고유 식별자입니다.

Code Samples

local DataStoreService = game:GetService("DataStoreService") 
local GoldStore = DataStoreService:GetDataStore("PlayerGold")

local success, errorMessageOrLoadValue, keyInfo = pcall(function()
    return GoldStore:GetAsync(player.UserId)
end)

if not success then
    print("errorMessage : ", errorMessageOrLoadValue)
else
    local loadValue = errorMessageOrLoadValue
    local createdTime = keyInfo.CreatedTime
    local version = keyInfo.Version
    local updatedTime = keyInfo.UpdatedTime
end

Methods

GetMetaData

해당 객체가 가진 부가 정보(메타데이터)를 반환합니다.

Parameters

Return

Dictionary	키-값 형태의 부가 정보(메타데이터)입니다.

Code Samples

local DataStoreService = game:GetService("DataStoreService") 
local GoldStore = DataStoreService:GetDataStore("PlayerGold")

local success, errorMessageOrLoadValue, keyInfo = pcall(function()
    return GoldStore:GetAsync(player.UserId)
end)

if not success then
    print("errorMessage : ", errorMessageOrLoadValue)
else
    local loadValue = errorMessageOrLoadValue
    local metadata = keyInfo:GetMetadata()
    
    print(metadata)
end

GetUserIds

해당 객체가 가진 사용자 ID 배열을 반환합니다.

Parameters

Return

Array	사용자 ID 배열입니다.

Code Samples

local DataStoreService = game:GetService("DataStoreService") 
local GoldStore = DataStoreService:GetDataStore("PlayerGold")

local success, errorMessageOrLoadValue, keyInfo = pcall(function()
    return GoldStore:GetAsync(player.UserId)
end)

if not success then
    print("errorMessage : ", errorMessageOrLoadValue)
else
    local loadValue = errorMessageOrLoadValue
    local userIds = keyInfo:GetUserIds()
    
    print(userIds)
end

Events