คำขอที่คุณส่งไปยังเก็บข้อมูลข้อมูลอาจล้มเหลวเนื่องจากการเชื่อมต่อที่ไม่ดีหรือปัญหาอื่น ๆ เพื่อจัดการข้อผิดพลาดและการส่งข้อความกลับด้วยรหัสผิดพลาดให้ข้อมูลเก็บข้อมูลใน Global.LuaGl
อ้างอิงรหัสผิดพลาด
| รหัสข้อผิดพลาด | ชื่อข้อผิดพลาด | ข้อความผิดพลาด | โน้ต | |
|---|---|---|---|---|
| 101 | KeyNameEmpty | ชื่อคีย์ไม่สามารถว่างเปล่าได้ | ตรวจสอบว่าการป้อนรหัสในหน้าเก็บข้อมูลเป็นสตริงว่างหรือไม่ | |
| 102 | KeyNameLimit | ชื่อคีย์เกินขีดจำกัด 50 ตัวอักษร | ตรวจสอบว่าการป้อนรหัสในหน้าเก็บข้อมูลส่งผลเกิน 50 หรือไม่ | |
| 103 | ValueNotAllowed | ไม่สามารถอนุญาต X ใน DataStore ได้ | การอัปเดตที่ไม่สมบูรณ์กลับค่าของประเภท X | |
| 104 | CantStoreValue | ไม่สามารถเก็บ X ใน DataStore | ฟังก์ชัน update กลับค่าของประเภท X ที่ไม่ได้เรียงลำดับ | |
| 105 | ValueTooLarge | ค่าตัวซีเรียลเกินขีดจำกัด X | หากคุณกำหนดค่าด้วย SetAsync() หรือ UpdateAsync() ความยาวของค่าจะไม่สามารถเกินขนาด X เพื่อตรวจสอบความยาวข | |
| 106 | MaxValueInvalid | MaxValue ต้องเป็นตัวเลข | หากคุณกำลังส่งค่าสูงสุดไปยัง GetSortedAsync() สำหรับ OrderedDataStore ให้เป็นตัวเลข | |
| 106 | MinValueInvalid | MinValue ต้องเป็นตัวเลข | หากคุณกำลังส่งค่าตัวน้อยไปยัง GetSortedAsync() สำหรับ OrderedDataStore ให้เป็นตัวเลข | |
| 106 | PageSizeGreater | PageSize ต้องอยู่ภายในช่วงที่กำหนดไว้ | ขนาดหน้าอย่างน้อยสำหรับ OrderedDataStore คือ 1 | |
| 106 | PageSizeLesser | PageSize ต้องอยู่ภายในช่วงที่กำหนดไว้ | ขนาดหน้าสูงสุดสำหรับ OrderedDataStore คือ 100 | |
| 107 | MinMaxOrderInvalid | MaxValue ต้องใหญ่กว่าหรือเท่ากับ MinValue | ค่าสูงสุดจะต้องใหญ่กว่าหรือเท่ากับค่าต่ำสุดสำหรับ GetSortedAsync() | |
| 301 | GetAsyncThrottle | GetAsync คำขอถูกทิ้ง คำขอถูกคัดกรอง แต่คิวยืนหนึ่งเต็ม | Class.GlobalDataStore:GetAsync()|GetAsync() ได้รับคำขอเกินขนาดของคิวสูงสุดและ Roblox ไม่สามารถประมวลผลคำขอได้ในปัจจุบันผ่านผลิตภาพ | |
| 302 | SetAsyncThrottle | SetAsync คำขอถูกทิ้ง คำขอถูกคัดกรอง แต่คิวยืนหนึ่งเต็ม | SetAsync() คำขอมีขนาดเกินขีดจำกัดของคิวสูงสุด และ Roblox ไม่สามารถประมวลผลคำขอได้ในปัจจุบันผ่านผลิตภัณฑ์ | |
| 303 | IncreAsyncThrottle | IncrementAsync คำขอถูกทิ้ง คำขอถูกคัดกรอง แต่คิวยืนหนึ่งเต็ม | IncrementAsync() คำขอมีขนาดเกินขีดจำกัดการแสดงผลและ Roblox ไม่สามารถประมวลผลคำขอได้ในปัจจุบันผ่านความเร็ว | |
| 304 | UpdateAsyncThrottle | UpdateAsync คำขอถูกทิ้ง คำขอถูกคัดกรอง แต่คิวยืนหนึ่งเต็ม | UpdateAsync() คำขอมีขนาดเกินขีดจำกัดของคิวสูงสุด และ Roblox ไม่สามารถประมวลผลคำขอได้ในปัจจุบันผ่านผลิตภัณฑ์ | |
| 304 | TransformThrottle | UpdateAsync คำขอถูกทิ้ง คำขอถูกคัดกรอง แต่คิวยืนหนึ่งเต็ม | UpdateAsync() คำขอมีขนาดเกินขีดจำกัดของคิวสูงสุด และ Roblox ไม่สามารถประมวลผลคำขอได้ในปัจจุบันผ่านผลิตภัณฑ์ | |
| 305 | GetSortedThrottle | GetSorted คำขอถูกทิ้ง คำขอถูกคัดกรอง แต่คิวยืนหนึ่งเต็ม | GetSortedAsync() คำขอมีขนาดเกินขีดจำกัดสูงสุดของคิวและ Roblox ไม่สามารถประมวลผลคำขอได้ในปัจจุบันผ่านผลิตภาพ | |
| 306 | RemoveAsyncThrottle | RemoveAsync คำขอถูกทิ้ง คำขอถูกคัดกรอง แต่คิวยืนหนึ่งเต็ม | RemoveAsync() คำขอมีขนาดเกินขีดจำกัดการแสดงผลและ Roblox ไม่สามารถประมวลผลคำขอได้ในปัจจุบันผ่านความเร็ว | |
| 401 | DataModelNoAccess | คำขอล้มเหลว DataModel ไม่สามารถใช้งานได้ในขณะที่ประสบการณ์กำลังปิดลง | DataModel ไม่ได้รับการเริ่มต้นเพราะประสบการณ์กำลังปิดลง | |
| 402 | LuaWebSrvsNoAccess | คำขอล้มเหลว LuaWebService ไม่สามารถใช้งานได้ในขณะที่ปิดประสบการณ์ | LuaWebService ไม่ได้รับการเริ่มต้นเนื่องจากประสบการณ์กำลังปิดลง | |
| 403 | StudioAccessToApisNotAllowed | ไม่สามารถเขียนไปยัง DataStore จาก Studio ได้เพราะการเขียนโค้ดนี้ไม่สามารถใช้งานได้ | การเข้าถึง API ต้องเปิดใช้งานเพื่อให้ใช้ Data Stores ใน Studio | |
| 404 | InternalError | OrderedDataStore ไม่มีอยู่จริง | ไม่พบ OrderedDataStore ที่เกี่ยวข้องกับคำขอนี้ นี่อาจเป็นสัญญาณของความเสียหายของข้อมูล | |
| 501 | InternalError | ไม่สามารถวิเคราะห์ตอบสนองได้เนื่องจากข้อมูลอาจเสียหาย | เซิร์ฟเวอร์ไม่สามารถประมวลผลตอบกลับสู่คำขอของคุณได้ นี่อาจเป็นสัญญาณของความเสียหายข้อมูล | |
| 502 | RequestRejected | API Services ปฏิเสธคำขอด้วยข้อผิดพลาด X | เกิดข้อผิดพลาด X ขึ้นเมื่อประมวลผลบนเซิร์ฟเวอร์ Roblox โปรดลองอีกครั้งในภายหลัง | |
| 503 | InternalError | คำขอเก็บข้อมูลสำเร็จ แต่ไม่พบกุญแจ | ไม่พบรหัสที่ร้องขอ นี่อาจเป็นสัญญาณของความเสียหายข้อมูล | |
| 504 | InternalError | คำขอเก็บข้อมูลสำเร็จ แต่การตอบกลับไม่ได้รูปแบบอย่างถูกต้อง | เซิร์ฟเวอร์ไม่สามารถประมวลผลตอบกลับสู่คำขอของคุณได้ นี่อาจเป็นสัญญาณของความเสียหายข้อมูล | |
| 505 | InternalError | OrderedDataStore คำขอสำเร็จ แต่การตอบกลับไม่ได้รับการแปรรูปอย่างถูกต้อง | เซิร์ฟเวอร์ไม่สามารถวิเคราะห์การตอบสนองต่อคำขอ OrderedDataStore ของคุณได้ นี่อาจเป็นสัญญาณของความเสียหายข้อมูล | |
| 509 | OperationNotAllowed | การดำเนินงานของ Data Store ถูกปิดใช้งานในขณะที่ทำงานบน RCC ส่วนบุคคลเพื่อป้องกันความเสียหายของข้อมูลที่อาจเกิดขึ้น | การเขียนข้อมูลจะถูกบล็อกในช่อง RCC ส่วนตัว | |
| 511 | AttributeSizeTooLarge | ขนาดลำดับลำดับเมทาดาต้าเกินขีดจำกัด X | ขนาดของตัวแทนจําลองขนาดจะเกินขีดจํากัดของ X ค่า X จะเป็นไดนามิก หากขนาดเปลี่ยนแปลง ค่า X จะเปลี่ยนแปลง | |
| 512 | UserIdLimitExceeded | UserID ขนาดเกินขีดจำกัด X | ความยาวของแท็กชื่อผู้ใช้ที่ให้โดยผู้ใช้เกินขีดจำกัดของ X | |
| 513 | AttributeFormatError | รูปแบบ userId ไม่ถูกต้อง | ID ผู้ใช้ที่ให้ไม่ใช่ตัวเลข | |
| 513 | AttributeFormatError | รูปแบบข้อมูลละครอันตราไม่ถูกต้อง | ข้อมูลรายการไม่ใช่ตาราง | |
| GetVersionAsyncThrottle | GetVersionAsync คำขอถูกทิ้ง คำขอถูกคัดกรอง | Class.DataStore:GetVersionAsync()|GetVersionAsync() ได้รับคำขอเกินขนาดของคิวสูงสุดและ Roblox ไม่สามารถประมวลผลคำขอได้ในปัจจุบันผ่านผลิตภาพการผลิต | ||
| ListDataStoresAsyncThrottle | ListDataStoresAsync คำขอถูกทิ้ง คำขอถูกปิดการจราจร | ListDataStoresAsync() | ||
| ListKeysAsyncThrottle | ListKeysAsync คำขอถูกทิ้ง คำขอถูกคัดกรอง | ListKeysAsync() คำขอมีขนาดเกินขีดจำกัดความจุสูงสุดของคิว และ Roblox ไม่สามารถประมวลผลคำขอได้ในปัจจุบันผ่านผลิตภัณฑ์ | ||
| ListVersionsAsyncThrottle | ListVersionsAsync คำขอถูกทิ้ง คำขอถูกคัดกรอง | ListVersionsAsync() คำขอมีขนาดเกินขีดจำกัดความจุสูงสุด และ Roblox ไม่สามารถประมวลผลคำขอได้ในปัจจุบันผ่านความสามารถในการประมวลผลได้สูงสุด | ||
| RemoveVersionAsyncThrottle | RemoveVersionAsync คำขอถูกทิ้ง คำขอถูกคัดกรอง | RemoveVersionAsync() |
รหัสข้อผิดพลาดเซิร์ฟเวอร์
| ชื่อข้อผิดพลาด | ข้อความผิดพลาด | โน้ต |
|---|---|---|
| DatastoreThrottled | อัตราคำขอเกินขีดจำกัดสูงสุดสำหรับ datastore | มีคําขอมากเกินไปที่ส่งไปยัง Data Store เดียว |
| InternalServerError | เกิดข้อผิดพลาดของเซิร์ฟเวอร์ภายใน | ข้อผิดพลาดบางครั้งในเซิร์ฟเวอร์ Roblox ลองอีกครั้ง โดยทั่วไปแล้วข้อผิดพลาดนี้จะเกิดขึ้นกับค่ากลับสูง |
| InvalidPlace | สถานที่ที่ให้นั้นไม่ถูกต้อง | ไม่มีรหัสจักรวาลสำหรับสถานที่ ลองอีกครั้งในภายหลัง |
| InvalidTarget | เป้าหมายที่กำหนดไว้ไม่ถูกต้อง | ชื่อรุ่นของ Data Store เกินขีดจำกัด 50 ตัวอักษร |
| InvalidUniverse | จักรวาลที่ให้มีไม่ถูกต้อง | ไม่มีรหัสสถานที่ที่ตรงกันสำหรับจักรวาล ลองอีกครั้งในภายหลัง |
| InvalidUserIds | รหัสผู้ใช้ที่ให้มีรูปแบบที่ไม่ถูกต้อง | ไม่สามารถประมวลผลรหัสผู้ใช้ได้ |
| KeyThrottled | อัตราคำขอเกินขีดจำกัดสูงสุดสำหรับกุญแจ | อัตราคำขอเกินอัตราคำขอสูงสุดที่อนุญาตสำหรับกุญแจเดียว |
| KeyNotFound | รหัสที่ร้องขอไม่มีอยู่ | รหัสไม่ถูกต้อง |
| N/A | ไม่มีหน้าที่จะก้าวไป | ข้อผิดพลาดนี้เกิดขึ้นเมื่อคุณเรียก Pages:AdvanceToNextPageAsync() ในหน้าสุดท้าย |
ข้อจํากัด
รุ่นข้อมูลมี ขีดจำกัด หากประสบการณ์เกินขีดจำกัดเหล่านี้ บริการจะปรับปรุงการใช้เก็บข้อมูลของประสบการณ์โดยอัตโนมัติและสร้างคำขอใหม่ในหนึ่งในคิวต่อไปนี้:
- ชุด
- ตั้งค่า
- รับ
- สั่งซื้อรับ
คำขอในคิวจะได้รับการจัดการตามลำดับที่ได้รับ หากตัวแปรคำขอยังคงอยู่ในคิว คำขอจะยังคงปรากฏขึ้นเรื่อย ๆ จนกว่าคำขอนั้นจะได้รับการจัดการ หากสโมสรข้อมูลถูกจำกัด คำขอจะถูกปรับให้เ
แต่ละคิวมีขีดจำกัด 30 คำขอ เมื่อขีดจำกัดของคิวถึง คำขอจะล้มเหลวด้วยรหัสผิดพลาดในช่วง 301-306 ระบุว่าคำขอถูกทิ้งไปทั้งหมด
ข้อจํากัดเซิร์ฟเวอร์
แต่ละเซิร์ฟเวอร์ได้รับการอนุญาตให้เก็บข้อมูลสถานที่บางอย่างตามประเภทคำขอและจำนวนผู้ใช้ ใช้ GetRequestBudgetForRequestType() เพื่อยืนยันจำนวนข้อมูลที่เก็บได้ในแต่
| ประเภทคำขอ | ฟังก์ชัน | คำขอต่อนาที |
|---|---|---|
| รับ | GetAsync() | 60 + จํานวนผู้เล่น × 10 |
| ตั้งค่า (จํากัดการแชร์ระหว่างฟังก์ชันทั้งหมดที่ระบุ) | Class.GlobalDataStore:SetAsync()|SetAsync()``Class.GlobalDataStore:IncrementAsync()|IncrementAsync()``Class.GlobalDataStore:UpdateAsync()|UpdateAsync() 0> Class.GlobalDataStore:RemoveAsync()|RemoveAsync()0> | 60 + จํานวนผู้เล่น × 10 |
| ได้รับการเรียงลำดับ | GetSortedAsync() | 5 + จํานวนผู้เล่น × 2 |
| รับเวอร์ชัน | GetVersionAsync() | 5 + จํานวนผู้เล่น × 2 |
| รายการ | Class.DataStoreService:ListDataStoresAsync()|ListDataStoresAsync()``Class.DataStore:ListKeysAsync()|ListKeysAsync()``Class.DataStore:ListVersionsAsync()|ListVersionAsync() | 5 + จํานวนผู้เล่น × 2 |
| ลบ | RemoveVersionAsync() | 5 + จํานวนผู้เล่น × 2 |
ข้อจํากัดข้อมูล
ระเบียบันทึกข้อมูลจำกัดจำนวนข้อมูลที่ใช้ต่อการเข้าถึง
ชื่อเก็บข้อมูล, ชื่อกุญแจ และ ขอบเขต ต้องอยู่ภายใต้ความยาวตัวอักษรบางตัว ใช้ string.len() เพื่อตรวจสอบความยาวของพวกเขา
ข้อมูล (มูลค่ากุญแจ) ยังถูกเก็บไว้เป็นสตริง, พิมพ์คุณสามารถตรวจสอบขนาดของข้อมูลด้วยคุณสมบัติ JSONEncode() ซึ่งแปลงข้อมูล Lua เป็นตาราง
| ส่วนประกอบ | จำนวนสูงสุดของตัวอักษร |
|---|---|
| ชื่อ Data Store | 50 |
| ชื่อกุญแจ | 50 |
| สเก็ต | 50 |
| ข้อมูล (มูลค่าหลัก) | 4,194,304 คีย์ |
ข้อจํากัดของข้อมูล
จํากัดจํานวนตัวอักษรในคําอธิบายของผู้ใช้
| ส่วนประกอบ | จำนวนสูงสุดของตัวอักษร |
|---|---|
| ชื่อกุญแจ | 50 |
| มูลค่า | 250 |
| คู่สมุดค่า | 300 |
ไม่มีขีดจำกัดสำหรับจำนวนคู่ของค่าตัวอักษรทั้งหมด แต่ขนาดรวมไม่สามารถเกิน 300 ตัวอักษรได้
ข้อจํากัดการผลิต
การจำกัดการผลิตต่อพื้นที่เก็บข้อมูลทำให้แน่ใจว่าประสิทธิภาพจะเป็นไปตามที่ดีที่สุดในเซิร์ฟเวอร์ Roblox แต่ละอัน แต่ละขีดจำกัดใช้ได้กับทุกคีย์ในทุกเซิร์ฟเวอร์ในประสบการณ์และรีเฟรชในเวลาที่ผ่านมา
Roblox ตรวจสอบการใช้โควตที่เกี่ยวข้องกับกุญแจในช่วง 60 วินาทีที่ผ่านมา หากการใช้งานรวมถึงคำขอปัจจุบันอยู่ในขีดจำกัดการผ่าน คำขอจะได้รับการอนุมัติ หากการใช้งานเกินขีดจำกัด คำขอจะถ
| ประเภทคำขอ | จํากัด |
|---|---|
| อ่าน | 25 MB ต่อนาที |
| เขียน | 4 MB ต่อนาที |
สำหรับทุกคำขอ, Roblox จะทำงานผ่านไปยังกิโลบาทถัดไป เช่น, หากคุณเขียน 800 บาทและ 1.2 KB ในสองคำขอ, Roblox จะนับเป็น 3 KB ทั้งหมดผ่าน (1 KB และ 2 KB ตามลำดับ)