مدیریت پایگاه های داده

این صفحه نحوه ایجاد، به روز رسانی و حذف پایگاه داده های Cloud Firestore را شرح می دهد. شما می توانید چندین پایگاه داده Cloud Firestore در هر پروژه ایجاد کنید. می‌توانید از پایگاه‌های اطلاعاتی متعدد برای راه‌اندازی محیط‌های تولید و آزمایش، جداسازی داده‌های مشتری و منطقه‌بندی داده‌ها استفاده کنید.

پایگاه داده (default)

اگر برنامه شما به چندین پایگاه داده نیاز ندارد، از پایگاه داده (default) استفاده کنید.

اگر پایگاه داده را مشخص نکنید، کتابخانه های سرویس گیرنده Cloud Firestore و Google Cloud CLI به طور پیش فرض به پایگاه داده (default) متصل می شوند.

شما می توانید از سهمیه رایگان فقط با پایگاه داده (default) استفاده کنید.

نقش های مورد نیاز

برای ایجاد و مدیریت پایگاه های داده، به نقش Owner یا Datastore Owner Identity and Access Management نیاز دارید. این نقش ها مجوزهای لازم را می دهند.

مجوزهای مورد نیاز

برای مدیریت پایگاه های داده، به مجوزهای زیر نیاز دارید:

• ایجاد پایگاه داده: datastore.databases.create
• پیکربندی پایگاه داده را بخوانید: datastore.databases.getMetadata
• پایگاه داده را پیکربندی کنید: datastore.databases.update
• دیتابیس را حذف کنید: datastore.databases.delete

یک پایگاه داده ایجاد کنید

برای ایجاد پایگاه داده از یکی از روش های زیر استفاده کنید:

کنسول

1. در کنسول Firebase ، به صفحه Firestore Database بروید.

   به پایگاه داده Firestore بروید

2. اگر این اولین پایگاه داده شما است، روی افزودن پایگاه داده کلیک کنید.
3. در غیر این صورت، روی (پیش‌فرض) و سپس افزودن پایگاه داده کلیک کنید.
4. پایگاه داده خود را پیکربندی کنید شناسه پایگاه داده را وارد کنید. یک مکان را انتخاب کنید. روی ایجاد پایگاه داده کلیک کنید.

gcloud

از دستور gcloud firestore databases create استفاده کنید.

gcloud firestore databases create \
--database=DATABASE_ID \
--location=LOCATION \
--type=DATABASE_TYPE \
[--delete-protection]

موارد زیر را جایگزین کنید:

• DATABASE_ID : شناسه پایگاه داده معتبر .
• LOCATION : نام چند منطقه یا منطقه Cloud Firestore .
• DATABASE_TYPE : یا firestore-native برای حالت Native یا datastore-mode برای حالت Datastore.

--delete-protection یک پرچم اختیاری برای فعال کردن حفاظت حذف است. تا زمانی که این تنظیم را غیرفعال نکنید، نمی‌توانید پایگاه داده‌ای را که محافظت از حذف فعال است حذف کنید. این تنظیم به طور پیش فرض غیرفعال است.

Firebase CLI

firebase firestore:databases:create DATABASE_ID \
--location=LOCATION \
[--delete-protection DELETE_PROTECTION_ENABLEMENT]

موارد زیر را جایگزین کنید:

• DATABASE_ID : شناسه پایگاه داده معتبر .
• LOCATION : نام چند منطقه یا منطقه Cloud Firestore .
• DELETE_PROTECTION_ENABLEMENT : یا ENABLED یا DISABLED .
پایگاه داده ایجاد شده همیشه در حالت Firestore Native است.

--delete-protection یک آرگومان اختیاری برای فعال کردن حفاظت حذف است. تا زمانی که این تنظیم را غیرفعال نکنید، نمی‌توانید پایگاه داده‌ای را که محافظت از حذف فعال است حذف کنید. این تنظیم به طور پیش فرض غیرفعال است.

Terraform

resource "google_firestore_database" "database" {
  project     = "project-id"
  name        = DATABASE_ID
  location_id = LOCATION
  type        = DATABASE_TYPE

  // Optional
  delete_protection_state = DELETE_PROTECTION_STATE
}

موارد زیر را جایگزین کنید:

• DATABASE_ID : شناسه پایگاه داده معتبر .
• LOCATION : نام چند منطقه یا منطقه Cloud Firestore .
• DATABASE_TYPE : یا FIRESTORE_NATIVE برای حالت Native یا DATASTORE_MODE برای حالت Datastore.
• DELETE_PROTECTION_ENABLEMENT : یا DELETE_PROTECTION_ENABLED یا DELETE_PROTECTION_DISABLED .

delete_protection_state یک آرگومان اختیاری برای فعال کردن حفاظت حذف است. تا زمانی که این تنظیم را غیرفعال نکنید، نمی‌توانید پایگاه داده‌ای را که محافظت از حذف فعال است حذف کنید. این تنظیم به طور پیش فرض غیرفعال است.

شناسه پایگاه داده

شناسه های پایگاه داده معتبر شامل (default) و شناسه هایی هستند که با موارد زیر مطابقت دارند:

• فقط شامل حروف، اعداد و کاراکترهای خط فاصله ( - ) است.
• حروف باید کوچک باشند.
• کاراکتر اول باید یک حرف باشد.
• آخرین کاراکتر باید یک حرف یا عدد باشد.
• حداقل 4 کاراکتر
• حداکثر 63 کاراکتر.
• نباید UUID یا شبیه UUID باشد. به عنوان مثال، از شناسه ای مانند f47ac10b-58cc-0372-8567-0e02b2c3d479 استفاده نکنید.

اگر پایگاه داده ای را حذف کنید، نمی توانید بلافاصله پس از 5 دقیقه از شناسه پایگاه داده دوباره استفاده کنید.

حفاظت را حذف کنید

برای جلوگیری از حذف تصادفی پایگاه داده، از حفاظت حذف استفاده کنید. تا زمانی که محافظت حذف را غیرفعال نکنید، نمی‌توانید پایگاه داده‌ای را که محافظت حذف فعال است حذف کنید. حفاظت حذف به طور پیش فرض غیرفعال است. هنگام ایجاد پایگاه داده می‌توانید حفاظت حذف را فعال کنید یا می‌توانید پیکربندی پایگاه داده را برای فعال کردن حفاظت حذف به‌روزرسانی کنید .

Cloud Firestore Security Rules برای پایگاه داده خود تنظیم کنید

از Firebase CLI برای استقرار Cloud Firestore Security Rules در هر یک از پایگاه های داده خود استفاده کنید. به راهنمای مدیریت و استقرار Cloud Firestore Security Rules مراجعه کنید.

دسترسی به یک پایگاه داده با نام با کتابخانه مشتری

یک پایگاه داده با نام شامل هر پایگاه داده ای است که نامی ندارد (default) . به طور پیش‌فرض، Firebase SDK و Google API Client Libraries در یک پروژه به پایگاه داده (default) Cloud Firestore متصل می‌شوند. برای ایجاد یک کلاینت متصل به یک پایگاه داده با نام، شناسه پایگاه داده را هنگام نمونه سازی مشتری تنظیم کنید.

توجه: برای کار با چندین پایگاه داده، حتماً به جدیدترین Firebase Client SDK و Google API Client Libraries به روز رسانی کنید.

فهرست پایگاه های داده

از یکی از روش های زیر برای فهرست کردن پایگاه های داده خود استفاده کنید:

کنسول

در کنسول Google Cloud، به صفحه پایگاه داده بروید.

به پایگاه داده ها بروید

توجه: می‌توانید پایگاه داده‌های خود را در کنسول Google Cloud مشاهده و فهرست کنید. می‌توانید پایگاه داده (default) را با استفاده از کنسول Google Cloud ایجاد کنید، اما باید از Google Cloud CLI یا روش دیگری برای ایجاد یک پایگاه داده با نام استفاده کنید. برای حذف پایگاه داده از Google Cloud CLI استفاده کنید .

gcloud

از دستور gcloud firestore databases list برای فهرست کردن تمامی پایگاه های داده پروژه خود استفاده کنید.

gcloud firestore databases list

Firebase CLI

از دستور firebase firestore:databases:list برای فهرست کردن تمام پایگاه های داده پروژه خود استفاده کنید.

firebase firestore:databases:list

مشاهده جزئیات پایگاه داده

برای مشاهده جزئیات یک پایگاه داده، از یکی از روش های زیر استفاده کنید:

gcloud

از دستور gcloud firestore databases describe استفاده کنید:

gcloud firestore databases describe --database=DATABASE_ID

Firebase CLI

از دستور firebase firestore:databases:get استفاده کنید:

firebase firestore:databases:get DATABASE_ID

DATABASE_ID با شناسه پایگاه داده جایگزین کنید.

پیکربندی پایگاه داده را به روز کنید

برای به روز رسانی تنظیمات پیکربندی یک پایگاه داده، از دستور gcloud firestore databases update استفاده کنید. از این دستور برای تغییر برای فعال یا غیرفعال کردن محافظت حذف استفاده کنید.

تنظیمات حفاظت حذف را به روز کنید

برای فعال کردن محافظت از حذف در پایگاه داده، از دستور gcloud firestore databases update با پرچم --delete-protection استفاده کنید. به عنوان مثال:

gcloud

gcloud firestore databases update --database=DATABASE_ID --delete-protection

DATABASE_ID با شناسه پایگاه داده جایگزین کنید.

برای غیرفعال کردن حفاظت حذف در پایگاه داده، از دستور gcloud firestore databases update با پرچم --no-delete-protection استفاده کنید. به عنوان مثال:

gcloud

gcloud firestore databases update --database=DATABASE_ID --no-delete-protection

DATABASE_ID با شناسه پایگاه داده جایگزین کنید.

دیتابیس را حذف کنید

برای حذف پایگاه داده، از کنسول یا ابزار خط فرمان استفاده کنید.

اگر تنظیمات حفاظت حذف در پایگاه داده فعال باشد، ابتدا باید حفاظت حذف را غیرفعال کنید .

اگر پایگاه داده حاوی داده های جستجوی App Engine یا موجودیت های حباب باشد، ابتدا باید آن داده ها را حذف کنید.

حذف یک پایگاه داده به طور خودکار هیچ عامل Eventarc برای آن پایگاه داده حذف نمی کند. ماشه تحویل رویدادها را متوقف می کند اما تا زمانی که ماشه را حذف نکنید به وجود خود ادامه می دهد.

کنسول

1. در کنسول Firebase ، به صفحه Firestore Database بروید.

   به پایگاه داده Firestore بروید

2. در تب Data، در بالای نمای جدول داده برای پایگاه داده، روی کلیک کنید، سپس Delete database را انتخاب کنید.
3. برای حذف پایگاه داده دستورالعمل ها را دنبال کنید.

gcloud

از دستور «حذف پایگاه‌داده‌های firestore gcloud» استفاده کنید.

gcloud firestore databases delete --database=DATABASE_ID

برای حذف، DATABASE_ID با شناسه پایگاه داده جایگزین کنید.

مجوزهای دسترسی به هر پایگاه داده را پیکربندی کنید

می توانید از شرایط مدیریت هویت و دسترسی برای پیکربندی مجوزهای دسترسی در سطح هر پایگاه داده استفاده کنید. مثال‌های زیر از Google Cloud CLI برای اختصاص دسترسی مشروط به یک یا چند پایگاه داده استفاده می‌کنند. همچنین می‌توانید شرایط IAM را در کنسول Google Cloud تعریف کنید .

سیاست های موجود IAM را مشاهده کنید

gcloud projects get-iam-policy PROJECT_ID

PROJECT_ID روی شناسه پروژه خود تنظیم کنید.

اجازه دسترسی به پایگاه داده

gcloud projects add-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' \
--condition='expression=resource.name=="projects/PROJECT_ID/databases/DATABASE_ID",title=TITLE,description=DESCRIPTION'

موارد زیر را تنظیم کنید:

• PROJECT_ID : شناسه پروژه شما
• EMAIL : یک آدرس ایمیل که نشان دهنده یک حساب Google خاص است. به عنوان مثال، [e-mail] .
• DATABASE_ID : شناسه پایگاه داده.
• TITLE : عنوان اختیاری برای عبارت.
• DESCRIPTION : شرح اختیاری عبارت.

اجازه دسترسی به همه به جز یک پایگاه داده

gcloud projects add-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' \
--condition='expression=resource.name!="projects/PROJECT_ID/databases/DATABASE_ID",title=TITLE,description=DESCRIPTION'

موارد زیر را تنظیم کنید:

• PROJECT_ID : شناسه پروژه شما
• EMAIL : یک آدرس ایمیل که نشان دهنده یک حساب Google خاص است. به عنوان مثال، [e-mail] .
• DATABASE_ID : شناسه پایگاه داده.
• TITLE : عنوان اختیاری برای عبارت.
• DESCRIPTION : شرح اختیاری عبارت.

خط‌مشی‌ها را برای یک عضو و نقش مشخص حذف کنید

gcloud projects remove-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' --all

موارد زیر را تنظیم کنید:

• PROJECT_ID : شناسه پروژه شما
• EMAIL : یک آدرس ایمیل که نشان دهنده یک حساب Google خاص است. به عنوان مثال، [e-mail] .

مانیتورینگ ابری

معیارهای Cloud Firestore تحت دو منبع نظارت شده گزارش می شوند.

• firestore.googleapis.com/Database
• firestore_instance (میراث)

می‌توانید با مراجعه به firestore.googleapis.com/Database معیارهای انبوه را در سطح پایگاه داده بررسی کنید. معیارهای گزارش شده تحت firestore_instance در سطح پروژه جمع می شوند.

محدودیت ها

• شما می توانید حداکثر 100 پایگاه داده در هر پروژه داشته باشید. برای درخواست افزایش تا این حد می توانید با پشتیبانی تماس بگیرید .
• اگر پایگاه داده (default) خود حاوی داده‌های جستجوی GAE باشد، نمی‌توانید آن را حذف کنید. لطفاً از index delete api برای حذف داده های جستجوی GAE استفاده کنید. اگر اخیراً داده های جستجوی GAE را حذف کرده اید، ممکن است قبل از اینکه بتوانید پایگاه داده را حذف کنید یک دوره انتظار وجود دارد.
• اگر پایگاه داده (default) خود حاوی موجودیت‌های لکه‌ای باشد، نمی‌توانید آن را حذف کنید. لطفاً از Blobstore delete api برای حذف داده های Blobstore استفاده کنید. می‌توانید با اجرای عبارت GQL زیر در کنسول Google Cloud بررسی کنید که آیا پایگاه داده (default) شما دارای داده‌های Blobstore است: SELECT * FROM __BlobInfo__ .
• تا 5 دقیقه پس از حذف نمی‌توانید از شناسه پایگاه داده استفاده مجدد کنید.
• Cloud Function v1 از پایگاه داده های Firestore Named پشتیبانی نمی کند. لطفاً از Cloud Firestore Triggers (نسل دوم) برای پیکربندی رویدادها برای پایگاه‌های داده نام‌گذاری شده استفاده کنید.
• فعال‌کننده‌های تابع Firestore v1 و راه‌اندازهای رویداد Firestore ممکن است پس از حذف پایگاه داده از کار بیفتند، حتی اگر پایگاه داده جدیدی با همین نام ایجاد شود.

بعدش چی

• داده ها را اضافه کنید
• داده ها را دریافت کنید
• داده ها را حذف کنید