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 zeigt Methoden für das Abrufen von GlobalDataStore und OrderedDataStore Objekten. Data-Stores können nur von Spiel-Servern aufgerufen werden, so dass Sie nur 0> Class.DataStoreService0> innerhalb eines <

Siehe Datenspeicherplätze für eine umfassende Anleitung zu Datenstruktur, Verwaltung, Fehlerbehandlung usw.

Code-Beispiele

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
    Parallel lesen

    Setzt, ob Daten-Store-Funktionen automatisch erneut versuchen sollen, oder nicht. DataStoreService respektiert diese Eigenschaft nicht, da das automatische erneut versuchen aufgrund technischer Gründe deaktiviert wurde. Daher müssen Sie Systeme für das Wiederholen von Operationen selbst implementieren.

Methoden

Eigenschaften

AutomaticRetry

Nicht repliziert
Parallel lesen
Lokale Nutzersicherheit

Setzt, ob Daten-Store-Funktionen automatisch erneut versucht werden sollen oder nicht.

DataStoreService respektiert diese Eigenschaft nicht, da das automatische Wiederholen aufgrund technischer Gründe deaktiviert wurde. Daher musst du Systeme für das Wiederholen von Operationen selbst implementieren. Es ist möglich, dass das automatische Wiederholen in der Zukunft erneut aktiviert wird.

Methoden

GetDataStore

Diese Funktion erstellt eine DataStore Instanz mit dem angegebenen Namen und Speicherbereich. Aufeinanderfolgende Aufrufe dieses Methods mit dem gleichen Namen/Speicherbereich geben dieselben Objekte zurück.

Die Verwendung des scope-Parameters wird die Operationen auf dieses Speicherlimit beschränken, indem die Zoom-Anpassung automatisch auf alle Operationen auf dem Datenstores ausgeführt wird. Diese Funktion akzeptiert auch eine optionale DataStoreOptions -Instanz, die Optionen für die Aktivierung von AllScopes enthält. Siehe 1>Datenspe

Parameter

name: string

Name des Store.

scope: string

(Optional) Ein String, der das Ziel angeben.

Standardwert: "global"
options: Instance

(Optional) A DataStoreOptions Instanz, um experimentelle Funktionen und V2-API-Funktionen zu aktivieren.

Standardwert: "nil"

Rückgaben

Eine DataStore Instanz mit angegebenem Namen und optionalem Umfang.

GetGlobalDataStore

Diese Funktion gibt das Standard GlobalDataStore zurück. Wenn Sie auf einen bestimmten namen -Datenspeicher zugreifen möchten, sollten Sie die Funktion GetDataStore() verwenden.


Rückgaben

Code-Beispiele

Get GlobalDataStore Instance

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

GetOrderedDataStore

Diese Methode gibt ein OrderedDataStore zurück, ähnlich wie die Art und Weise, wie GetDataStore() mit GlobalDataStores macht. Aufeinanderfolgende Aufrufe dieser Methode mit demselben Namen/Skala werden das gleiche Objekt zurückgeben.

Parameter

name: string
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

Diese Funktion gibt die Anzahl der Datenstores an, die der aktuelle Ort basierend auf der angegebenen Enum.DataStoreRequestType machen kann. Alle Anfragen, die diese Budget überschreiten, unterliegen der Drosselung. Die Überwachung und Anpassung der Frequenz der Datenstores mit dieser Funktion ist empfohlen.

Parameter


Rückgaben

Code-Beispiele

Print Request Budget

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

Gibt ein DataStoreListingPages-Objekt zurück, um durch alle Erlebniszu listieren. Es akzeptiert ein optionales prefix-Parameter, um nur auf Datenstores zuzugreifen, deren Namen mit dem angegebenen Präfix beginnen.

Nur Daten, die mindestens ein Objekt enthalten, werden über diese Funktion aufgelistet.

Parameter

prefix: string

(Optional) Präfix, um Datenstores zu zählen, die mit dem angegebenen Präfix beginnen.

Standardwert: ""
pageSize: number

(Optional) Anzahl der Elemente, die in jede Seite zurückgegeben werden sollen. Standardmäßig sind 32.

Standardwert: 0
cursor: string

(Optional) Cursor zum Fortfahren der Iteration.

Standardwert: ""

Rückgaben

DataStoreListingPages Instanz, die DataStoreInfo Instanzen enthält, die Details wie Name, Erstellungszeit und Zeit der letzten Aktualisierung bereitstellen.

Ereignisse