DataStoreService

Veraltete anzeigen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Nicht erstellbar
Dienst
Nicht repliziert

DataStoreService stellt Methoden bereit, um GlobalDataStore und OrderedDataStore Objekte zu erhalten.Datenspeicher können nur von Spielservern aufgerufen werden, sodass du nur DataStoreService innerhalb eines Script oder eines ModuleScript, das von einem Script verwendet wird, zugreifen kannst.

Siehe Datenspeicher für einen umfassenden Leitfaden über Datenstruktur, Management, Fehlerbehandlung usw.

Code-Beispiele

This code sample prints the request budget for all data store request types.

DataStore Budget

local DataStoreService = game:GetService("DataStoreService")
for _, enumItem in pairs(Enum.DataStoreRequestType:GetEnumItems()) do
print(enumItem.Name, DataStoreService:GetRequestBudgetForRequestType(enumItem))
end

Zusammenfassung

Eigenschaften

  • Nicht repliziert
    Lokale Nutzersicherheit
    Parallel lesen

    Legt fest, ob Datenlagersfunktionen automatisch erneut versuchen sollen oder nicht.DataStoreService respektiert diese Eigenschaft nicht, weil automatisches Wiederholen aufgrund technischer Gründe deaktiviert wurde.Daher musst du Systeme implementieren, um Operationen erneut auszuführen.

Methoden

Eigenschaften

AutomaticRetry

Nicht repliziert
Lokale Nutzersicherheit
Parallel lesen

Methoden

GetDataStore

Parameter

name: string
Standardwert: ""
scope: string
Standardwert: "global"
options: Instance
Standardwert: "nil"

Rückgaben

GetGlobalDataStore


Rückgaben

Code-Beispiele

Get GlobalDataStore Instance

local DataStoreService = game:GetService("DataStoreService")
local GlobalDataStore = DataStoreService:GetGlobalDataStore()
print(GlobalDataStore.Name)

GetOrderedDataStore

Parameter

name: string
Standardwert: ""
scope: string
Standardwert: "global"

Rückgaben

Code-Beispiele

OrderedDataStore Basics

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()
-- The data in 'topTen' is stored with the index being the index on the page
-- For each item, 'data.key' is the key in the OrderedDataStore and 'data.value' is the value
for rank, data in ipairs(topTen) do
local name = data.key
local points = data.value
print(name .. " is ranked #" .. rank .. " with " .. points .. "points")
end
-- Potentially load the next page...
--pages:AdvanceToNextPageAsync()
end
-- Create some data
pointsStore:SetAsync("Alex", 55)
pointsStore:SetAsync("Charley", 32)
pointsStore:SetAsync("Sydney", 68)
-- Display the top ten players
printTopTenPlayers()

GetRequestBudgetForRequestType

Parameter

Standardwert: ""

Rückgaben

Code-Beispiele

Druckanforderungs-Budget drucken

local DataStoreService = game:GetService("DataStoreService")
local globalStore = DataStoreService:GetGlobalDataStore()
local function printBudget()
local budget = DataStoreService:GetRequestBudgetForRequestType(Enum.DataStoreRequestType.SetIncrementAsync)
print("Current set/increment budget:", 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

Angehalten

Parameter

prefix: string
Standardwert: ""
pageSize: number
Standardwert: 0
cursor: string
Standardwert: ""

Rückgaben

Events