How/When does DataStorePages load data? (OrderedDataStore:GetSortedAsync())

[Meta_Maxim (Max)]

The docs were missing a few details I was wondering:
Calling OrderedDataStore:GetSortedAsync() returns a DataStorePages object, which returns a single page of data, but more can be loaded with DataStorePages:AdvanceToNextPageAsync()…

When exactly is the data for pages loaded? Does Roblox perform a datastore get request each time DataStorePages:AdvanceToNextPageAsync() is called?
Can I cache the DataStorePages object and advance it later, or will that return outdated data?
Does AdvanceToNextPageAsync have any limits?

[kingerman88]

@Blocky_Max

When exactly is the data for pages loaded? Does Roblox perform a datastore get request each time DataStorePages:AdvanceToNextPageAsync() is called?

That’s a really good question, I’m pretty sure it does NOT call a datastore request each time.
It is a type of Page Instance, if it did call the datastores then surely it would exceed datastore limits and be warned/listed in the Datastore Limits

---

@Blocky_Max

Can I cache the DataStorePages object and advance it later, or will that return outdated data?

yes it will probably return outdated data

---

@Blocky_Max

Does AdvanceToNextPageAsync have any limits?

Well it yields, although I’m not entirely sure on this one.