DataStore
*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
データストアを参照してください データストア。
概要
方法
指定されたキーバージョンを取得します。
- ListKeysAsync(prefix : string,pageSize : number,cursor : string,excludeDeleted : bool):DataStoreKeyPages
データストアのキーを通じて列挙するための DataStoreKeyPages オブジェクトを返します。
- ListVersionsAsync(key : string,sortDirection : Enum.SortDirection,minDate : number,maxDate : number,pageSize : number):DataStoreVersionPages
キーのすべてのバージョンを数えます。
指定されたバージョンのキーを永久に削除します。
指定されたデータストアのキーの値と DataStoreKeyInfo インスタンスを返します。
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
提供された値により、キーの値を増加させます (両方とも整数でなければなりません)。
アクセス可能なバージョンを保持しながら指定されたキーを削除します。
指定されたキーのデータストアの値を設定します。
指定されたコールバック関数から、キーの値を新しい値で更新します。
プロパティ
方法
GetVersionAsync
この関数は、指定されたキーバージョンと、DataStoreKeyInfo インスタンスを取得します。バージョン識別子は、DataStore:ListVersionsAsync() または、GlobalDataStore:SetAsync() を通じて見つけることができます。
パラメータ
バージョン情報がリクエストされるキーの名前です。DataStoreOptions.AllScopes が DataStoreService:GetDataStore() を通じてアクセスするときに、このキー名はオリジナルのスコープと一緒に付けられます。
バージョン情報がリクエストされるキーのバージョン番号。
戻り値
指定されたバージョンのキーの値と、DataStoreKeyInfo インスタンス、バージョンが作成された日時、および関数を含む、UserIds とメタデータを取り戻す機能。
ListKeysAsync
この関数は、データストアのキーを枚挙するための DataStoreKeyPages オブジェクトを返します。 オプションの prefix パラメーターを受け入れて、提供されたプレフィックスで名前が開始するキーのみを見つけます。
Class.DataStoreOptions.AllScopes が DataStoreService:GetDataStore() を通じてデータストアにアクセスされたときに、すべてのスコープがプレフィックスとして返されます。
パラメータ
(オプション)) キーを見つけるのに使用するプレフィックス。
(オプション)) 最大で返すことのできるアイテムの数。
(オプション) カーソルを押し続けると、イテレーションを続行します。
(オプション)) 削除されたキーを返されないようにします。
有効にすると ListKeys は最大 512 個のキーをチェックします。すべてのチェックされたキーが削除されると、カーソルで空のリストを返し、イテレーションを続行します。
戻り値
Class.DataStoreKeyPages インスタンス で、キーを DataStoreKey インスタンスで枚挙します。
ListVersionsAsync
この関数は、Enum.SortDirection パラメーターによって指定されたキーのバージョンを、上昇または下降の順序で列挙します。最小および最大のタイムスタンプをオプションでフィルターによってフィルターによってフィルターによってフィルターによってフィルターによってフィルターによってフィルターによってフィルターによってフィルターによってフィルターによってフィルター
パラメータ
リストされるバージョンのキー名。DataStoreOptions.AllScopes が DataStoreService:GetDataStore() を通じてアクセスすると、このキー名は「scope」の原始スコープに追加されなければなりません。
列の順序を指定する列表を指定します。
Unix のタイムスタンプをミリ秒単位で取得し、バージョンをリストに追加する必要があります。
バージョンがリストされるまでのミリ秒単位の UNIX タイマー。
各ページで返すアイテムの数。
戻り値
Class.DataStoreVersionPages インスタンスは、DataStoreObjectVersionInfo インスタンスとして、キーのすべてのバージョンを列挙します。
コードサンプル
local DataStoreService = game:GetService("DataStoreService")
local experienceStore = DataStoreService:GetDataStore("PlayerExperience")
local time = DateTime.fromUniversalTime(2020, 10, 09, 01, 42)
local listSuccess, pages = pcall(function()
return experienceStore:ListVersionsAsync("User_1234", nil, time.UnixTimestampMillis)
end)
if listSuccess then
local items = pages:GetCurrentPage()
for key, info in pairs(items) do
print("Key:", key, "; Version:", info.Version, "; Created:", info.CreatedTime, "; Deleted:", info.IsDeleted)
end
endRemoveVersionAsync
この関数は、指定されたバージョンのキーを永久に削除します。バージョン識別子は、DataStore:ListVersionsAsync() を通じて見つけることができます。
Class.GlobalDataStore:RemoveAsync() とは、新しい "tombstone" バージョンを作成しません。削除された値は、後で取り戻すことはできません。
パラメータ
バージョンが削除されるバージョンのキー名。如果 DataStoreOptions.AllScopes が DataStoreService:GetDataStore() を通じてアクセスしたとき、このキー名は「スコープ/キー」でオリジナルのスコープと一緒に付けられる必要があります。
削除するキーのバージョン番号。