DataStore

วิธีการ

GetVersionAsync(key : string,version : string):Tuple
ผลตอบแทน
Recupera a versão de chave especificada.
GetVersionAtTimeAsync(key : string,timestamp : number):Tuple
ผลตอบแทน
Recupera a versão da chave que estava atual em um determinado momento.
ListKeysAsync(prefix : string,pageSize : number,cursor : string,excludeDeleted : bool):DataStoreKeyPages
ผลตอบแทน
Retorna um objeto DataStoreKeyPages para listar através das chaves de um armazenamento de dados.
ListVersionsAsync(key : string,sortDirection : Enum.SortDirection,minDate : number,maxDate : number,pageSize : number):DataStoreVersionPages
ผลตอบแทน
Contém todas as versões de uma chave.
RemoveVersionAsync(key : string,version : string):void
ผลตอบแทน
Exclui permanentemente a versão especificada de uma chave.

วิธีการรับทอดมาจากGlobalDataStore

GetAsync(key : string,options : DataStoreGetOptions):Tuple
ผลตอบแทน
กลับค่าของกุญแจในคลังข้อมูลที่กำหนดและ DataStoreKeyInfo ริงค์
IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
ผลตอบแทน
เพิ่มมูลค่าของกุญแจโดยจำนวนเงินที่กำหนด (ทั้งสองต้องเป็นตัวเลข)
RemoveAsync(key : string):Tuple
ผลตอบแทน
ลบรหัสที่ระบุโดยให้รักษารุ่นที่เข้าถึงได้
SetAsync(key : string,value : Variant,userIds : Array,options : DataStoreSetOptions):Variant
ผลตอบแทน
ตั้งค่าค่าเก็บข้อมูลสำหรับกุญแจที่กำหนด
UpdateAsync(key : string,transformFunction : function):Tuple
ผลตอบแทน
คีย์

อีเวนต์

คุณสมบัติ

วิธีการ

GetVersionAsync

ผลตอบแทน

Essa função recupera a versão da chave especificada, bem como uma instância DataStoreKeyInfo. Um identificador de versão pode ser encontrado através de DataStore:ListVersionsAsync() ou alternativamente ser o identificador retornado por GlobalDataStore:SetAsync().

พารามิเตอร์

key: string

Nome da chave para a qual a informação da versão é solicitada. Se DataStoreOptions.AllScopes estiver definido como verdadeiro ao acessar o armazenamento de dados através de DataStoreService:GetDataStore(), este nome de chave deve ser anexado ao escopo original como em "escopo/chave".

version: string

Número da versão da chave para a qual as informações de versão são solicitadas.

ส่งค่ากลับ

O valor da chave na versão especificada e uma instância DataStoreKeyInfo que inclui o número de versão, data e hora que a versão foi criada e funções para recuperar UserIds e metadados.

GetVersionAtTimeAsync

ผลตอบแทน

Essa função recupera a versão da chave que estava atual em um determinado momento, bem como uma instância DataStoreKeyInfo.

พารามิเตอร์

key: string

timestamp: number

O tempo de marca de Unix em milisegundos para a qual a versão solicitada estava atual. Deve ser maior que zero. Não deve ser maior que dez minutos no futuro.

ส่งค่ากลับ

O valor da chave que estava atual na hora especificada e uma instância DataStoreKeyInfo que inclui o número de versão, data e hora que a versão foi criada e funções para recuperar UserIds e metadados. nil se nenhuma versão estava atual na hora solicitada.

ตัวอย่างโค้ด

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

DataStoreKeyPages

ผลตอบแทน

Essa função retorna um objeto DataStoreKeyPages para listar através das chaves de um armazenamento de dados. Ela aceita um parâmetro opcional prefix para localizar apenas chaves cujos nomes começam com o prefixo fornecido.

Se DataStoreOptions.AllScopes estiver definido como verdadeiro ao acessar o armazenamento de dados através de DataStoreService:GetDataStore(), as chaves serão retornadas com todos os scopes como prefixos.

พารามิเตอร์

prefix: string

(Opcional) Prefixo para usar para localizar chaves.

ค่าเริ่มต้น: ""

pageSize: number

(Opcional) Número de itens a serem retornados em cada página. Se nenhum valor for dado, o motor envia um valor padrão de 0 para o serviço de armazenamento de dados, que por sua vez padrão para 50 itens por página.

ค่าเริ่มต้น: 0

cursor: string

(Opcional) Cursor para continuar a iteração.

ค่าเริ่มต้น: ""

excludeDeleted: bool

(Opcional) Excluir chaves excluídas de serem retornadas.

Quando ativado, ListKeys verificará até 512 chaves. Se todas as chaves verificadas forem excluídas, ele retornará uma lista vazia com um cursor para continuar a iteração.

ค่าเริ่มต้น: false

ส่งค่ากลับ

DataStoreKeyPages

Uma instância DataStoreKeyPages que lista as chaves como DataStoreKey instâncias.

ListVersionsAsync

DataStoreVersionPages

ผลตอบแทน

Essa função lista as versões da chave especificada em ordem crescente ou decrescente, especificadas por um parâmetro Enum.SortDirection. Ele pode filtrar opcionalmente as versões retornadas por tempo mínimo e máximo.

พารามิเตอร์

key: string

Nome da chave para as versões listadas. Se DataStoreOptions.AllScopes estiver definido como verdadeiro ao acessar o armazenamento de dados através de DataStoreService:GetDataStore(), este nome de chave deve ser anexado ao escopo original como em "escopo/chave".

sortDirection: Enum.SortDirection

(Opcional) Lista de itens que especificam a ordem de classificação ascendente ou descendente.

ค่าเริ่มต้น: "Ascending"

minDate: number

(Opcional) Data de sincronização de Unix em milisegundos após a qual as versões devem ser listadas.

ค่าเริ่มต้น: 0

maxDate: number

(Opcional) Data de sincronização do tempo em milisegundos até o qual as versões devem ser listadas.

ค่าเริ่มต้น: 0

pageSize: number

ค่าเริ่มต้น: 0

ส่งค่ากลับ

DataStoreVersionPages

Uma instância DataStoreVersionPages que lista todas as versões da chave como instâncias DataStoreObjectVersionInfo .

ตัวอย่างโค้ด

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

void

ผลตอบแทน

Essa função exclui permanentemente a versão especificada de uma chave. Os identificadores de versão podem ser encontrados através de DataStore:ListVersionsAsync() .

Ao contrário de GlobalDataStore:RemoveAsync(), esta função não cria uma nova versão "tombstone" e o valor removido não pode ser recuperado mais tarde.

พารามิเตอร์

key: string

Nome da chave para a qual uma versão será removida. Se DataStoreOptions.AllScopes for definido como verdadeiro ao acessar o armazenamento de dados através de DataStoreService:GetDataStore(), este nome de chave deve ser precedido com o escopo original como em "escopo/chave".

version: string

Número da versão da chave para remover.

ส่งค่ากลับ

void

คุณสมบัติ รับทอดมาจาก GlobalDataStore

อีเวนต์