データストアマネージャーを使用すると、クリエイターハブでデータストア、そのキーエントリ、およびストレージ使用量を直接ブラウズおよび監視できます。
データストアマネージャーにアクセスする
ゲームのオーナーまたはグループ所有のゲームのグループオーナーであれば、デフォルトでデータストアマネージャーに完全にアクセスできます。
グループのメンバーにデータストアマネージャーへのアクセスを許可するには、次のいずれかの権限を付与できます:
- データストアを表示 は、クリエイターハブのデータストアマネージャーページを表示できます。
- データストアを編集 は、キーを削除できます。
- データストアを削除 は、データストアを削除できます。
- バーチャル空間を編集 は、データストアマネージャーのすべての機能に完全にアクセスできます。
データストアマネージャーにアクセスするには:
- クリエイターダッシュボードでゲームを選択します。
- 設定 > データストアマネージャーに移動します。
データストアマネージャーページの概要セクションには、データストアの合計サイズとストレージ制限が含まれています。合計サイズは、ゲーム内のすべての既存のキーによって消費されるバイト数を合計することで計算され、ストレージ制限はゲームの生涯ユーザー数に基づいて計算されます。ストレージ制限に関する詳細は、制限を参照してください。
合計サイズがストレージ制限を超えると、推定月額コストが概要に表示され、クォータを超えた使用の影響の推定値が示されます。ストレージ消費を削減するためのヒントについては、ベストプラクティスを参照してください。
データストアとキーを表示する
ゲームに100以上のデータストアがある場合、データストアリストにデータストアのサイズとキーの数は表示されません。
データストアリストには、ゲーム内のすべてのデータストアの名前、サイズ、およびキーの数が表示されます。このリストは、検索バーにプレフィックスを入力することでフィルタリングできます。
各特定のデータストアをさらに詳しく調べるには、次のことができます:
- データストアリストからデータストアを選択して、そのデータストア内のすべてのキーのリストを表示します。
- 検索バーにプレフィックスを入力してキーのリストをフィルタリングします。プレフィックスはスコープ名で始まる必要があります。
- キーエントリを選択して、そのキーの値、メタデータ、バージョン履歴、ステータス、および最終更新日時を表示します。
- キーエントリとバージョンの両方を選択し、バージョンを比較をクリックして、現在のキーエントリバージョンと選択したバージョンを比較します。
- キーの以前のバージョンを選択し、元に戻すをクリックしてそのバージョンに戻ります。これを行うには、編集権限が必要です。以前のバージョンに戻すと、リストが条件付きで更新され、以前に選択したバージョンの値で新しいバージョンが書き込まれます。
データストアとキーを削除する
データストアを永久に削除するためにスケジュールすると、バックエンドキャッシュが期限切れになった後、エントリの読み取りまたは書き込みの試行は失敗します。バックエンドサービスのキャッシュのため、削除されたデータストアからエントリを読み取る試行は、削除後最大24時間成功し続ける可能性があり、エントリの書き込みの試行は数分間成功し続ける可能性があります。
データストアまたはキーを永久に削除するためにスケジュールするには:
- クリエイターダッシュボードでゲームを選択します。
- 左側のナビゲーションで、設定 > データストアマネージャーに移動します。
- 削除したいアイテムの隣にあるアクションメニューをクリックします。
- 削除のマークをクリックします。
データストアまたはキーを削除してから実際にそのアイテムが削除されるまでの間にはクールダウン期間があります。このクールダウン期間中に、削除を元に戻してアイテムを通常の状態に復元できます。
データストアを復元するには、復元したいデータストアの隣にあるアクションメニューをクリックし、次に復元をクリックするか、Open Cloud APIからUndeleteDataStoreメソッドを呼び出します。
キーを復元するには、エンジンAPIからUpdateAsyncメソッドを呼び出すか、Open Cloud APIからUpdateDataStoreEntryメソッドを呼び出します。