Roblox DataStore Bütçe ve Kısıtlama Optimizasyonu: Önbellek ve Oturum Güvenliği

Büyüyen Roblox oyunlarında en sık karşılaşılan sorun "DataStore request was added to queue and dropped" hatasıdır. Her altın kazanımında veya envanter değişiminde GetAsync veya SetAsync çağırmak bütçeyi tüketir ve veri kaybına yol açar.

Bu rehber, prodüksiyon mimarilerini inceler: anlık istek bütçesi takibi, kirli bayrak (dirty flag) tabanlı bellek önbelleği, üstel geri çekilme ile UpdateAsync yeniden deneme döngüleri ve oturum kilitleme mekanizmaları.

1. Roblox DataStore Bütçe Sınırları ve İstek Pencereleri

Roblox, sunucudaki oyuncu sayısına göre katı sınırlar uygular:

• GetAsync Bütçesi: Tüm anahtarlar için dakikada 60 + (oyuncuSayisi * 10) istek.
• SetAsync / UpdateAsync Bütçesi: Dakikada 60 + (oyuncuSayisi * 10) yazma isteği.
• 6 Saniyelik Yazma Beklemesi: Aynı anahtara 6 saniye dolmadan yeniden yazmak isteğin düşmesine yol açar.
• Yük Sınırı: Anahtar başına en fazla 4.194.304 karakter (4MB).

2. Bellek İçi Oturum Önbelleği ve Dirty Flag Deseni

Büyük ölçekli oyunlar için temel veri mimarisi:

• Girişte Yükle, Çıkışta Kaydet: Oyuncu bağlandığında tek bir okuma yapın ve profili sunucu RAM'inde tutun.
• Bellekte Hızlı Güncelleme: Para ve eşya değişiklikleri yalnızca yerel Lua tablosunu günceller; API bütçesi harcanmaz.
• Periyodik Akıllı Kayıt: 120-180 saniyede bir yalnızca değişen (dirty) profilleri kademeli olarak kaydedin.
• BindToClose Güvenliği: Sunucu kapanışında tüm verileri game:BindToClose() ile paralel olarak kaydedin.

3. Production Implementation Architecture

-- Safe DataStore Write with Exponential Backoff and Budget Check
local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")
local PlayerDataStore = DataStoreService:GetDataStore("PlayerCore_v1")

local MAX_RETRIES = 3
local BASE_DELAY = 1.5

local function safeUpdateAsync(key, transformFunc)
    local budget = DataStoreService:GetRequestBudgetForRequestType(Enum.DataStoreRequestType.UpdateAsync)
    if budget < 5 then
        warn("[DataStore] Throttling warning: Low budget for UpdateAsync (" .. tostring(budget) .. ")")
    end
    
    local success, result
    local attempts = 0
    
    repeat
        attempts = attempts + 1
        success, result = pcall(function()
            return PlayerDataStore:UpdateAsync(key, transformFunc)
        end)
        
        if not success then
            local delayTime = BASE_DELAY * (2 ^ (attempts - 1)) + math.random() * 0.5
            warn("[DataStore] Attempt " .. attempts .. " failed: " .. tostring(result) .. ". Retrying in " .. string.format("%.2f", delayTime) .. "s")
            task.wait(delayTime)
        end
    until success or attempts >= MAX_RETRIES
    
    return success, result
end

4. Oturum Kilitleme (Session Locking) ve Eşya Kopyalama Önleme

Hızlı sunucu geçişlerinde (server hop) oluşan açıkları engelleme:

• Server Hop Açığı: Eski sunucu kaydetmeden yeni sunucuya geçildiğinde eski verinin yüklenmesi.
• Oturum Kilidi: Veri yüklendiğinde sunucunun JobId bilgisini kaydetmek.
• Kilidin Açılmasını Bekleme: Yeni sunucu önceki sunucunun kaydetmesini bekler.
• ProfileService Tercihi: Topluluk standardı kütüphane ile oturum kilitlemeyi güvenle otomatikleştirmek.

5. Şema Geçişi ve Canlı Sürüm Yönetimi

Oyun güncellemelerinde veri bütünlüğünü koruma:

• Sürüm Başlığı: _SchemaVersion alanı ile yapı değişikliklerini izleme.
• Otomatik Varsayılan Ekleme: Yeni alanları eski oyuncu profillerine otomatik tamamlama.
• Geriye Uyumluluk: Eski alanları aşamalı olarak temizleme.

Frequently Asked Questions