Aprenda
Classe do mecanismo
DataStoreService
Não criável
Serviço
Não replicado

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.


Amostras de código
Orçamento do DataStore
local DataStoreService = game:GetService("DataStoreService")
for _, enumItem in pairs(Enum.DataStoreRequestType:GetEnumItems()) do
-- Imprime o nome do item e o orçamento da solicitação para o tipo de solicitação
print(enumItem.Name, DataStoreService:GetRequestBudgetForRequestType(enumItem))
end

Referência API
Métodos
GetDataStore
Recursos: DataStore
DataStoreService:GetDataStore(
name:string, scope:string, options:Instance
Parâmetros
name:string
scope:string
Valor Padrão: "global"
options:Instance
Valor Padrão: "nil"
Devolução

GetGlobalDataStore
Recursos: DataStore
DataStoreService:GetGlobalDataStore():DataStore
Devolução
Amostras de código
Obter Instância GlobalDataStore
local DataStoreService = game:GetService("DataStoreService")
local GlobalDataStore = DataStoreService:GetGlobalDataStore()
print(GlobalDataStore.Name)

GetOrderedDataStore
Recursos: DataStore
DataStoreService:GetOrderedDataStore(
name:string, scope:string
Parâmetros
name:string
scope:string
Valor Padrão: "global"
Devolução
Amostras de código
Fundamentos do OrderedDataStore
local DataStoreService = game:GetService("DataStoreService")
local pointsStore = DataStoreService:GetOrderedDataStore("Points")
local function printTopTenPlayers()
local isAscending = false
local pageSize = 10
local pages = pointsStore:GetSortedAsync(isAscending, pageSize)
local topTen = pages:GetCurrentPage()
-- Os dados em 'topTen' são armazenados com o índice sendo o índice na página
-- Para cada item, 'data.key' é a chave no OrderedDataStore e 'data.value' é o valor
for rank, data in ipairs(topTen) do
local name = data.key
local points = data.value
print(name .. " está classificado como #" .. rank .. " com " .. points .. " pontos")
end
-- Potencialmente carregar a próxima página...
--pages:AdvanceToNextPageAsync()
end
-- Criar alguns dados
pointsStore:SetAsync("Alex", 55)
pointsStore:SetAsync("Charley", 32)
pointsStore:SetAsync("Sydney", 68)
-- Exibir os dez melhores jogadores
printTopTenPlayers()

GetRequestBudgetForRequestType
Recursos: DataStore
DataStoreService:GetRequestBudgetForRequestType(requestType:Enum.DataStoreRequestType):number
Parâmetros
Devolução
Amostras de código
Imprimir Orçamento de Requisição
local DataStoreService = game:GetService("DataStoreService")
local globalStore = DataStoreService:GetGlobalDataStore()
local function printBudget()
local budget = DataStoreService:GetRequestBudgetForRequestType(Enum.DataStoreRequestType.SetIncrementAsync)
print("Orçamento atual de set/increment:", budget)
end
for i = 1, 5 do
local key = "key" .. i
local success, err = pcall(function()
globalStore:SetAsync(key, true)
end)
if success then
printBudget()
else
print(err)
end
end

ListDataStoresAsync
Rendimentos
Recursos: DataStore
DataStoreService:ListDataStoresAsync(
prefix:string, pageSize:number, cursor:string
Parâmetros
prefix:string
pageSize:number
Valor Padrão: 0
cursor:string

SetRateLimitForRequestType
Recursos: DataStore
DataStoreService:SetRateLimitForRequestType(
requestType:Enum.DataStoreRequestType, baseLimit:number, perPlayerLimit:number
):()
Parâmetros
baseLimit:number
perPlayerLimit:number
Devolução
()
Amostras de código
Definir Limites de Taxa
local MigrateScript = require(script.Parent.MigrateScript)
local DataStoreService = game:GetService("DataStoreService")
DataStoreService:SetRateLimitForRequestType(Enum.DataStoreRequestType.StandardRead, 1000, 0)
DataStoreService:SetRateLimitForRequestType(Enum.DataStoreRequestType.StandardWrite, 2000, 0) -- duas gravações, então precisa do dobro do limite do get
DataStoreService:SetRateLimitForRequestType(Enum.DataStoreRequestType.StandardList, 100, 0)
DataStoreService:SetRateLimitForRequestType(Enum.DataStoreRequestType.StandardRemove, 1000, 0)
local sourceStore = DataStoreService:GetDataStore("ds_to_migrate")
local destinationStore1 = DataStoreService:GetDataStore("ds_destination_1")
local destinationStore2 = DataStoreService:GetDataStore("ds_destination_2")
-- Helper para aguardar o orçamento
local function waitForBudget(requestType)
while (DataStoreService:GetRequestBudgetForRequestType(requestType) <= 0) do
task.wait(1)
end
end
waitForBudget(Enum.DataStoreRequestType.StandardList)
local success, pages = pcall(function()
return sourceStore:ListKeysAsync()
end)
if success then
while true do
local items = pages:GetCurrentPage()
for _, item in ipairs(items) do
-- 1. Buscar dados da Fonte
waitForBudget(Enum.DataStoreRequestType.StandardRead)
local getSuccess, value = pcall(function()
return sourceStore:GetAsync(item.KeyName)
end)
if getSuccess and value ~= nil then
-- 2. Migrar dados para Destinos
waitForBudget(Enum.DataStoreRequestType.StandardWrite)
local setSuccess, err = pcall(function()
destinationStore1:SetAsync(item.KeyName, MigrateScript.Migrate1(value))
end)
if setSuccess then
print("Migrado com sucesso chave para o destino 1: " .. item.KeyName)
else
warn("Falhou ao migrar chave para o destino 1: " .. item.KeyName .. " - " .. tostring(err))
end
waitForBudget(Enum.DataStoreRequestType.StandardWrite)
local setSuccess, err = pcall(function()
destinationStore2:SetAsync(item.KeyName, MigrateScript.Migrate2(value))
end)
if setSuccess then
print("Migrado com sucesso chave para o destino 2: " .. item.KeyName)
else
warn("Falhou ao migrar chave para o destino 2: " .. item.KeyName .. " - " .. tostring(err))
end
-- 3. Excluir dados da fonte
waitForBudget(Enum.DataStoreRequestType.StandardRemove)
local deleteSuccess, err = pcall(function()
sourceStore:RemoveAsync(item.KeyName)
end)
if deleteSuccess then
print("Excluído com sucesso chave da fonte: " .. item.KeyName)
else
warn("Falhou ao excluir chave da fonte: " .. item.KeyName .. " - " .. tostring(err))
end
else
warn("Falhou ao buscar chave da fonte: " .. item.KeyName)
end
end
if pages.IsFinished then break end
-- 3. Avançar Página
waitForBudget(Enum.DataStoreRequestType.StandardList)
local nextSuccess = pcall(function()
pages:AdvanceToNextPageAsync()
end)
if not nextSuccess then
warn("Falhou ao avançar para a próxima página.")
break
end
end
print("Processo de migração completo.")
else
warn("Falhou ao listar chaves.")
end

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.