DataStoreService

Définit si les fonctions de stockage des données devraient automatiquement réessayer ou non.

DataStoreService ne respecte pas cette propriété car la réessayer automatique a été désactivée en raison de raisons techniques. Par conséquent, vous devez implémenter des systèmes pour réessayer des opérations vous-même. Il est possible que la réessayer automatique soit à nouveau activée dans le futur.

Cette fonction crée une instance DataStore avec le nom et la portée fournis. Les appels suivants à cette méthode avec le même nom/portée retourneront le même objet.

L'utilisation du paramètre scope restreindra les opérations à ce scope en automatiquement suspendant le scope aux clés dans toutes les opérations effectuées sur le data boutique. Cette fonction accepte également une instance facultative DataStoreOptions qui inclut des options pour activer AllScopes. Voir 1> Data Stores1> pour plus de détails sur le

Paramètres

Retours

Cette fonction renvoie le GlobalDataStore par défaut. Si vous souhaitez accéder à un nommé stock de données spécifique, vous devriez utiliser la fonction GetDataStore().

Retours

local DataStoreService = game:GetService("DataStoreService")

local GlobalDataStore = DataStoreService:GetGlobalDataStore()

print(GlobalDataStore.Name)

Cette méthode renvoie un OrderedDataStore, similaire à la façon dont GetDataStore() fait avec GlobalDataStores. Les appels suivants à cette méthode avec le même nom/scope renverront le même objet.

Paramètres

Retours

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()

Cette fonction renvoie le nombre de demandes de stockage de données que le lieu actuel peut faire en fonction du Enum.DataStoreRequestType donné. Toutes les demandes faites qui dépassent ce budget sont soumises à un ralentissement. Le suivi et l'ajustement de la fréquence des demandes de stockage en utilisant cette fonction sont recommandés.

Paramètres

Retours

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

Retourne un objet DataStoreListingPages pour l'indexer dans tous les magasins de données de l'expérience. Il accepte un paramètre facultatif prefix pour ne localiser que les magasins de données dont les noms commencent par le préfixe fourni.

Seuls les magasins de données contenant au moins un objet seront listés via cette fonction.

Paramètres

Retours