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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  // Optional
  delete_protection_state = 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 متصل می‌شوند. برای ایجاد یک کلاینت متصل به یک پایگاه داده با نام، شناسه پایگاه داده را هنگام نمونه سازی مشتری تنظیم کنید.

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

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

gcloud firestore databases list

firebase firestore:databases:list

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

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

gcloud firestore databases describe --database=DATABASE_ID

firebase firestore:databases:get DATABASE_ID

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

gcloud firestore databases delete --database=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 خاص است. به عنوان مثال، alice@example.com .
• 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 خاص است. به عنوان مثال، alice@example.com .
• DATABASE_ID : شناسه پایگاه داده.
• TITLE : عنوان اختیاری برای عبارت.
• DESCRIPTION : شرح اختیاری عبارت.

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

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

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

• PROJECT_ID : شناسه پروژه شما
• EMAIL : یک آدرس ایمیل که نشان دهنده یک حساب Google خاص است. به عنوان مثال، alice@example.com .

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

معیارهای 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 ممکن است پس از حذف پایگاه داده از کار بیفتند، حتی اگر پایگاه داده جدیدی با همین نام ایجاد شود.

بعدش چی

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