از این راهنما برای درک محدودیتهای Cloud Firestore استفاده کنید، و برای توضیح کامل و دقیق هزینههای Cloud Firestore ، از جمله مواردی که باید مراقب آنها باشید، قیمتگذاری Cloud Firestore را ببینید.
استفاده خود را نظارت کنید
برای نظارت بر استفاده از Cloud Firestore ، برگه Cloud Firestore Usage را در کنسول Firebase باز کنید. از داشبورد برای سنجش میزان استفاده خود در دوره های زمانی مختلف استفاده کنید.
استفاده دقیق در کنسول Google Cloud
هنگامی که یک پروژه Firebase ایجاد می کنید، یک پروژه Google Cloud نیز ایجاد می کنید. صفحات Cloud Firestore API Quotas و App Engine Quotas در کنسول Google Cloud اطلاعات استفاده و سهمیه Cloud Firestore را دنبال میکنند.
سهمیه رایگان
Cloud Firestore سهمیه رایگانی را ارائه می دهد که به شما امکان می دهد بدون هزینه با پایگاه داده (default)
خود شروع کنید. مقادیر سهمیه رایگان در زیر ذکر شده است. اگر به سهمیه بیشتری نیاز دارید، باید صورتحساب پروژه Google Cloud خود را فعال کنید .
سهمیه ها روزانه اعمال می شوند و در حدود نیمه شب به وقت اقیانوس آرام بازنشانی می شوند.
فقط پایگاه داده (default)
برای سهمیه رایگان واجد شرایط است.
ردیف آزاد | سهمیه |
---|---|
داده های ذخیره شده | 1 گیگابایت |
سند خوانده می شود | 50000 در روز |
سند می نویسد | 20000 در روز |
سند حذف می شود | 20000 در روز |
انتقال داده های خروجی | 10 گیگابایت در ماه |
عملیات و ویژگی های زیر شامل استفاده رایگان نمی شود. برای استفاده از این ویژگی ها باید صورتحساب را فعال کنید:
- استفاده از پایگاه های داده نامگذاری شده (غیر پیش فرض).
- TTL حذف می کند
- داده های PITR
- پشتیبان گیری از داده ها
- عملیات بازیابی
برای اطلاعات بیشتر در مورد نحوه صورتحساب این ویژگیها، به قیمتگذاری فضای ذخیرهسازی مراجعه کنید.
محدودیت های استاندارد
جداول زیر محدودیت هایی را که برای Cloud Firestore اعمال می شود نشان می دهد. اینها محدودیتهای سختی هستند، مگر اینکه خلاف آن ذکر شده باشد.
پایگاه های داده
محدود کنید | جزئیات |
---|---|
حداکثر تعداد پایگاه داده در هر پروژه | 100 برای درخواست افزایش تا این حد می توانید با پشتیبانی تماس بگیرید . |
مجموعه ها، اسناد و زمینه ها
محدود کنید | جزئیات |
---|---|
محدودیت در شناسه های مجموعه |
|
حداکثر عمق زیر مجموعه ها | 100 |
محدودیت در شناسه اسناد |
|
حداکثر اندازه برای نام سند | 6 کیلو بایت |
حداکثر اندازه برای یک سند | 1 مگابایت (1,048,576 بایت) |
محدودیت در نام فیلدها |
|
حداکثر اندازه نام یک فیلد | 1500 بایت |
محدودیت در مسیرهای میدانی |
` ) شروع و به پایان می رسد. به عنوان مثال، foo.`x&y` به فیلد x&y اشاره دارد که در زیر فیلد foo قرار گرفته است. برای ساختن نام فیلد با کاراکتر بکتیک، از کاراکتر بکتیک با کاراکتر بکتیک ( \ ) فرار کنید. برای راحتی، میتوانید با عبور دادن مسیر فیلد بهعنوان یک شی FieldPath از نامهای فیلد نقلقول شده اجتناب کنید ( به عنوان مثال، به FieldPath جاوا اسکریپت مراجعه کنید ). |
حداکثر اندازه یک مسیر میدان | 1500 بایت |
حداکثر اندازه یک مقدار فیلد | 1 مگابایت - 89 بایت (1,048,487 بایت) |
حداکثر عمق فیلدها در یک نقشه یا آرایه | 20 فیلدهای نقشه و آرایه یک سطح به عمق کلی یک شی اضافه می کنند. به عنوان مثال، شی زیر دارای عمق کل سه سطح است:
|
می نویسد و معامله می کند
علاوه بر این محدودیتها، باید بهترین شیوههای طراحی برای مقیاس را نیز مشاهده کنید.
محدود کنید | جزئیات |
---|---|
حداکثر اندازه درخواست API | 10 مگابایت |
محدودیت زمانی برای معامله | 270 ثانیه، با زمان انقضا 60 ثانیه بیکار |
شاخص ها
محدودیت های زیر برای نمایه های تک فیلدی و نمایه های ترکیبی اعمال می شود:
محدود کنید | جزئیات |
---|---|
حداکثر تعداد نمایه های ترکیبی برای یک پایگاه داده |
|
حداکثر تعداد تنظیمات تک فیلد برای یک پایگاه داده |
پیکربندی سطح یک فیلد میتواند شامل چندین پیکربندی برای یک فیلد باشد. به عنوان مثال، یک معافیت نمایه سازی تک فیلد و یک خط مشی TTL در همان فیلد به عنوان یک پیکربندی فیلد برای حد مجاز محسوب می شود. |
حداکثر تعداد ورودی های فهرست برای هر سند | 40000 تعداد ورودیهای فهرست مجموع موارد زیر برای یک سند است:
برای اینکه ببینید چگونه Cloud Firestore یک سند و مجموعهای از نمایهها را به ورودیهای فهرست تبدیل میکند، به این مثال تعداد ورودی فهرست مراجعه کنید. |
حداکثر تعداد فیلدها در یک نمایه ترکیبی | 100 |
حداکثر اندازه یک ورودی شاخص | 7.5 کیلو بایت برای مشاهده نحوه محاسبه اندازه ورودی فهرست Cloud Firestore ، به اندازه ورودی فهرست مراجعه کنید. |
حداکثر مجموع اندازه های ورودی های فهرست یک سند | 8 مگابایت اندازه کل مجموع موارد زیر برای یک سند است: |
حداکثر اندازه یک مقدار فیلد نمایه شده | 1500 بایت مقادیر فیلد بیش از 1500 بایت کوتاه شده است. پرس و جوهایی که شامل مقادیر فیلد کوتاه شده هستند ممکن است نتایج متناقضی را ارائه دهند. |
زمان برای زندگی (TTL)
محدود کنید | جزئیات |
---|---|
حداکثر تعداد تنظیمات تک فیلد برای یک پایگاه داده |
پیکربندی سطح یک فیلد میتواند شامل چندین پیکربندی برای یک فیلد باشد. به عنوان مثال، یک معافیت نمایه سازی تک فیلد و یک خط مشی TTL در همان فیلد به عنوان یک پیکربندی فیلد برای حد مجاز محسوب می شود. |
صادرات/واردات
محدودیت های زیر برای عملیات واردات و صادرات مدیریت شده اعمال می شود:
محدود کنید | جزئیات |
---|---|
حداکثر تعداد کل درخواستهای صادرات و واردات برای یک پروژه در هر دقیقه مجاز است | 20 |
حداکثر تعداد صادرات و واردات همزمان | 50 |
حداکثر تعداد فیلترهای شناسه مجموعه برای درخواستهای صادرات و واردات | 100 |
قوانین امنیتی
محدود کنید | جزئیات |
---|---|
حداکثر تعداد فراخوانی exists() ، get() و getAfter() در هر درخواست |
تجاوز از هر یک از محدودیت ها منجر به خطای رد مجوز می شود. برخی از تماسهای دسترسی به اسناد ممکن است در حافظه پنهان باشند، و تماسهای ذخیرهشده در حافظه پنهان در محدودیتها حساب نمیشوند. |
حداکثر عمق بیانیه match تو در تو | 10 |
حداکثر طول مسیر، در بخشهای مسیر، در مجموعهای از عبارات match تودرتو مجاز است | 100 |
حداکثر تعداد متغیرهای ثبت مسیر در مجموعه ای از عبارات match تودرتو مجاز است | 20 |
حداکثر عمق فراخوانی تابع | 20 |
حداکثر تعداد آرگومان های تابع | 7 |
حداکثر تعداد اتصالات متغیر let در هر تابع | 10 |
حداکثر تعداد فراخوانی های تابع بازگشتی یا چرخه ای | 0 (مجاز نیست) |
حداکثر تعداد عبارات ارزیابی شده در هر درخواست | 1000 |
حداکثر اندازه یک مجموعه قوانین | مجموعه قوانین باید از دو محدودیت اندازه تبعیت کند:
|
هزینه ها را مدیریت کنید
برای کمک به جلوگیری از هزینه های غیرمنتظره در صورتحساب خود، بودجه و هشدارهای ماهانه تنظیم کنید.
یک بودجه ماهانه تعیین کنید
برای ردیابی هزینه های Cloud Firestore خود، یک بودجه ماهانه در کنسول Google Cloud ایجاد کنید. بودجه استفاده شما را محدود نمیکند، اما میتوانید هشدارهایی را تنظیم کنید تا زمانی که به هزینههای برنامهریزی شده خود برای ماه نزدیک میشوید یا از آن فراتر میروید، به شما اطلاع میدهند.
برای تنظیم بودجه، به بخش Billing در کنسول Google Cloud بروید و برای حساب Cloud Billing خود بودجه ایجاد کنید. میتوانید از تنظیمات پیشفرض هشدار استفاده کنید یا هشدارها را برای ارسال اعلانها در درصدهای مختلف بودجه ماهانه خود تغییر دهید.
درباره تنظیم بودجه و هشدارهای بودجه بیشتر بیاموزید.