エラーコードと制限

データストアに行うクエリーは、接続性が悪いなどの理由で失敗する可能性があります。エラーコードでエラーを処理し、データストア関数を pcall() でラップすることで、エラーを処理し、メッセージをエラーコードで返すことができます。

エラーコード参照

サーバーエラーコード

制限

データモデルには 制限 があります。エクスペリエンスがこれらの制限を超えると、サービスは自動的にエクスペリエンスのデータストア使用量を制限し、将来のリクエストを次のキューの 1 つに配置します：

• セット
• オーダーされ設定するセット
• 取得する
• オーダー済みの取得

キューにあるリクエストは、受信された順序で処理されます。呼び出される関数は、リクエストがまだキューにある間、続けて生成されます。データストアのキーが制限されている場合は、リクエストはキューに入れられますが、一時的にスキップされます。

各キューには 30 個のリクエストの制限があります。キューの上限に到達すると、301-306の範囲内のエラーコードでリクエストが失敗し、リクエストが完全にドロップされることを示すエラーコードが表示されます。

サーバーの制限

各サーバーには、リクエストタイプとユーザー数に基づいてデータストアリクエストをすることができます。 GetRequestBudgetForRequestType() を使用して、現在の場所が行うことができるデータストアリクエストの数を確認します。

データの制限

データストアは、エントリごとに使用できるデータの量を制限します。

データストア名、キー名、および スコープ は、すべて特定の文字列の長さでなければなりません。Use string.len() を使用して、長さを確認します。

データ (キーバリュー) は、最初のタイプにかかわらず、文字列としても保存されます。JSONEncode() 機能を使用して、Lua データをJSON テーブルに変換できます。

メタデータ限定

ユーザー定義メタデータにおける文字数の制限。

スループットの制限

通常、Roblox サーバーでは、パフォーマンスが最高の状態に保たれます。各限度は、エクスペリエンス全体のすべてのサーバーで適用され、時間の経過とともに更新されます。

Roblox は、最後の 60 秒間にキーに関連するクエーストの使用を調べます。使用、例え現在のリクエストを含めて、は通過量の制限内にあります。リクエストが承認されると、使用が制限を超えるとリクエストが拒否されます。