데이터 저장소 보기 Data Stores.
요약
메서드
지정된 키 버전을 검색합니다.
- ListKeysAsync(prefix : string,pageSize : number,cursor : string,excludeDeleted : bool):DataStoreKeyPages
데이터 스토어 상점열거를 위한 DataStoreKeyPages 개체를 반환합니다.
- ListVersionsAsync(key : string,sortDirection : Enum.SortDirection,minDate : number,maxDate : number,pageSize : number):DataStoreVersionPages
모든 키의 모든 버전을 열거합니다.
키의 지정된 버전을 영구적으로 삭제합니다.
지정된 데이터 저장소의 키 값과 DataStoreKeyInfo 인스턴스를 반환합니다.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
지정된 값으로 키의 값을 증가시킵니다(둘 다 정수여야 함).
액세스 가능한 버전을 유지하면서 지정된 키를 제거합니다.
지정된 키에 대한 데이터 저장소의 값을 설정합니다.
지정된 콜백 함수에서 새로운 값을 사용하여 키의 값을 업데이트합니다.
속성
메서드
GetVersionAsync
이 함수는 지정된 키 버전과 DataStoreKeyInfo 인스턴스를 검색합니다. 버전 식별자는 DataStore:ListVersionsAsync() 또는 또는 GlobalDataStore:SetAsync()를 통해 찾을 수 있습니다.
매개 변수
버전 정보가 요청되는 키 이름입니다. DataStoreOptions.AllScopes 가 DataStoreService:GetDataStore()를 통해 액세스할 때 KeyName 가 원래 범위와 함께 지정되어 있으면 이 키 이름은 2> scope/key2>에 대해 원래 범위와 함께 지정되어야 합니다.
버전 정보가 요청된 키의 버전 번호입니다.
반환
지정된 버전의 키의 값과 버전이 생성된 날짜, 시간 및 기능을 포함하는 DataStoreKeyInfo 인스턴스와 함께 버전 번호, 날짜 및 시간을 포함하는 함수를 검색하여 메타데이터를 검색합니다.
ListKeysAsync
이 함수는 데이터 스토어의 키를 열거하기 위해 DataStoreKeyPages 개체를 반환합니다. 선택적 prefix 매개 변수를 사용하여 제공된 상점시작하는 키만 찾습니다.
Class.DataStoreOptions.AllScopes 가 DataStoreService:GetDataStore() 를 통해 액세스할 때 트루로 설정되면 키가 모든 스코프로 반환됩니다.
매개 변수
(옵션)) 키를 찾는 데 사용할 접두사.
(옵션) 반환할 수 있는 최대 아이템 수.
(옵션) 커서를 사용하여 반복을 계속합니다.
(옵션) 삭제된 키가 반환되지 않도록 합니다.
ListKeys가 활성화되면 키가 최대 512개까지 확인됩니다. 모든 확인된 키가 삭제되면 커서로 비어 있는 목록을 반환하여 항목 번호를 계속 진행합니다.
반환
열 키가 DataStoreKeyPages 인스턴스로 열거된 키 목록입니다.
ListVersionsAsync
이 함수는 Enum.SortDirection 매개 변수에 의해 올라가거나 내려지는 순서로 지정된 키의 버전을 열거합니다. 최소 및 최대 버전을 필터링할 수 있습니다.
매개 변수
목록에 나열할 버전의 키 이름입니다. DataStoreOptions.AllScopes 가 Class.DataStoreService:GetDataStore() 를 통해 액세스할 때 설정되면 이 키 이름은 원래 범위와 함께 시작해야 합니다. 이 키 이름은 "범위/키"에 나타납니다.
열거형 순서를 오름차순으로 지정합니다.
버전이 나열되는 밀리초 단위의 유니크스 타임스탬프.
버전 목록에 나열될 때까지 밀리초 단위의 Unix 타임스탬프입니다.
각 페이지에 반환할 아이템 수입니다.
반환
모든 버전의 키를 열거하는 Class.DataStoreVersionPages 인스턴스.
코드 샘플
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
이 함수는 키의 지정된 버전을 영구적으로 삭제합니다. 버전 식별자는 DataStore:ListVersionsAsync() 를 통해 찾을 수 있습니다.
Class.GlobalDataStore:RemoveAsync() 과는 달리, 이 함수는 새로운 "tombstone" 버전을 생성하지 않으며 제거된 값은 나중에 검색할 수 없습니다.
매개 변수
버전이 제거될 버전의 키 이름입니다. DataStoreOptions.AllScopes 가 DataStoreService:GetDataStore() 를 통해 액세스할 때 설정되면 이 키 이름은 원래 범위와 함께 시작해야 합니다.
제거할 키의 버전 번호입니다.