Cloud Firestore را با کنسول Firebase مدیریت کنید

هنگام استفاده از کنسول Firebase می توانید اقدامات زیر را در Cloud Firestore انجام دهید:

• مشاهده، افزودن، ویرایش و حذف داده ها.
• Cloud Firestore Security Rules ایجاد و به روز کنید.
• فهرست ها را مدیریت کنید
• نظارت بر استفاده

مشاهده داده ها

می‌توانید تمام داده‌های Cloud Firestore خود را در کنسول Firebase مشاهده کنید. از برگه Cloud Firestore Data ، روی یک سند یا مجموعه کلیک کنید تا داده های تو در تو در آن مورد باز شود.

یک مسیر مشخص را باز کنید

برای باز کردن یک سند یا مجموعه در یک مسیر خاص، از دکمه ویرایش مسیر create :

فیلتر کردن اسناد در مجموعه

برای فیلتر کردن اسناد لیست شده در یک مجموعه، از دکمه لیست فیلتر filter_list استفاده کنید.

اسناد اجدادی موجود نیست

یک سند می تواند وجود داشته باشد حتی اگر یک یا چند اجداد آن وجود نداشته باشند. به عنوان مثال، سند در مسیر /mycoll/mydoc/mysubcoll/mysubdoc می‌تواند وجود داشته باشد حتی اگر سند اجدادی /mycoll/mydoc وجود نداشته باشد. نمایشگر داده Cloud Firestore سند اجدادی را که وجود ندارد را به صورت زیر نمایش می دهد:

• در فهرست اسناد مجموعه، شناسه مدارک اسناد اجدادی که وجود ندارند ، مورب هستند.
• در پانل اطلاعات یک سند اجدادی که وجود ندارد، بیننده داده به عدم وجود سند اشاره می کند.

داده های پرس و جو

می توانید اسناد را در برگه Query builder صفحه Cloud Firestore Data جستجو کنید.

1. به صفحه Cloud Firestore Data بروید

2. روی تب Query builder کلیک کنید.

3. محدوده پرس و جو را انتخاب کنید.

   برای پرس و جو از یک مجموعه واحد، مجموعه را انتخاب کنید. در قسمت متن، مسیری به مجموعه وارد کنید.

   گروه مجموعه را انتخاب کنید تا همه مجموعه‌ها را با یک شناسه پرس و جو کنید. در قسمت گروه مجموعه ، شناسه گروه مجموعه را وارد کنید.

   جدول به طور خودکار اسنادی را از مجموعه یا گروه مجموعه مشخص شده نمایش می دهد.

4. برای فیلتر کردن مجموعه اسناد برگشتی، روی Add to Query کلیک کنید. به طور پیش فرض، Query Builder یک عبارت WHERE اضافه می کند. می توانید این بند را با استفاده از قسمت های کشویی و متنی تغییر دهید یا به یکی از بندهای موجود دیگر تغییر دهید. برای ادامه ساخت پرس و جوهای پیچیده تر، روی افزودن به پرس و جو کلیک کنید.

   برای حذف یک عبارت جستجو، روی دکمه حذف آن cancel کلیک کنید. برای حذف تمام بندهای پرس و جو، روی پاک کردن کلیک کنید.

5. برای بازیابی نتایج از پایگاه داده خود روی Run کلیک کنید.

الزامات و محدودیت های پرس و جو

همانطور که از Query Builder استفاده می کنید، الزامات و محدودیت های زیر را برای پرس و جوها در نظر داشته باشید.

• همه پرس و جوها باید توسط یک یا چند نمایه پشتیبانی شوند. اگر پایگاه داده نتواند نمایه ای برای پشتیبانی از پرس و جو پیدا کند، خطایی را برمی گرداند که حاوی پیوندی برای ساخت ایندکس مورد نیاز است.

• بندهای ORDER BY باید با فیلدهای بندهای WHERE مطابقت داشته باشند و به همان ترتیب باشند. به طور پیش فرض، نتایج بر اساس شناسه سند مرتب می شوند. اگر با هر فیلد دیگری با چیزی غیر از برابری ( == ) فیلتر می کنید، یک عبارت ORDER BY برای آن فیلد اضافه کنید.

• عبارت های پرس و جو محدوده ( < , <= , > , >= ) و مساوی ( != , not-in ) باید همه در یک فیلد فیلتر شوند.

برای محدودیت‌های بیشتر، محدودیت‌های پرس و جو را ببینید.

مدیریت داده ها

در Cloud Firestore ، داده ها را در اسناد ذخیره می کنید و اسناد خود را در مجموعه ها سازماندهی می کنید. قبل از شروع به افزودن داده، درباره مدل داده Cloud Firestore اطلاعات بیشتری کسب کنید.

می توانید اسناد و مجموعه ها را از کنسول Firebase اضافه، ویرایش و حذف کنید. برای مدیریت داده های خود، تب Data را در بخش Cloud Firestore باز کنید:

داده ها را اضافه کنید

1. روی افزودن مجموعه کلیک کنید، سپس نام مجموعه خود را وارد کرده و روی Next کلیک کنید.
2. شناسه سند خاصی را وارد کنید یا روی شناسه خودکار کلیک کنید، سپس فیلدهایی را برای داده‌های سند خود اضافه کنید.
3. روی ذخیره کلیک کنید. مجموعه و سند جدید شما در نمایشگر داده ظاهر می شود.
4. برای افزودن اسناد بیشتر به مجموعه، روی افزودن سند کلیک کنید.

ویرایش داده ها

1. روی یک مجموعه کلیک کنید تا اسناد آن را مشاهده کنید، سپس روی یک سند کلیک کنید تا فیلدها و زیر مجموعه های آن را مشاهده کنید.
2. روی یک فیلد کلیک کنید تا مقدار آن را ویرایش کنید. برای افزودن فیلدها یا زیر مجموعه‌ها به سند انتخابی، روی افزودن فیلد یا افزودن مجموعه کلیک کنید.

داده ها را حذف کنید

برای حذف یک مجموعه:

1. مجموعه ای را که می خواهید حذف کنید انتخاب کنید.
2. روی نماد منو در بالای ستون اسناد کلیک کنید، سپس روی حذف مجموعه کلیک کنید.

برای حذف یک سند یا تمام فیلدهای آن:

1. سندی را که می خواهید حذف کنید انتخاب کنید.
2. روی نماد منو در بالای ستون جزئیات سند کلیک کنید. حذف سند یا حذف فیلدهای سند را انتخاب کنید.

با حذف یک سند، تمام داده های تودرتو در آن سند، از جمله هر مجموعه فرعی، حذف می شود. با این حال، حذف فیلدهای یک سند، مجموعه های فرعی آن را حذف نمی کند.

برای حذف یک فیلد خاص در یک سند:

1. سند را برای مشاهده فیلدهای آن انتخاب کنید.
2. روی نماد حذف در کنار فیلدی که می‌خواهید حذف کنید کلیک کنید.

Cloud Firestore Security Rules مدیریت کنید

برای افزودن، ویرایش و حذف Cloud Firestore Security Rules از کنسول Firebase، به تب Rules در بخش Cloud Firestore بروید. درباره تنظیم و سفارشی کردن قوانین بیشتر بیاموزید.

فهرست ها را مدیریت کنید

برای ایجاد نمایه‌های جدید برای پرسش‌های خود و مدیریت فهرست‌های موجود از کنسول Firebase، به تب Indexes در بخش Cloud Firestore بروید. درباره مدیریت ایندکس ها بیشتر بیاموزید.

نظارت بر استفاده

برای نظارت بر استفاده از Cloud Firestore ، برگه Cloud Firestore Usage را در کنسول Firebase باز کنید. از داشبورد برای سنجش میزان استفاده خود در دوره های زمانی مختلف استفاده کنید.