ایجاد و مدیریت پایگاه‌های داده

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

استفاده از سطح رایگان

Cloud Firestore سطح رایگان ارائه می‌دهد که به شما امکان می‌دهد بدون هزینه شروع کنید.

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

قبل از شروع

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

1. اگر قبلاً این کار را نکرده‌اید، پروژه Firebase ایجاد کنید: در کنسول Firebase، روی افزودن پروژه کلیک کنید، سپس دستورالعمل‌های روی صفحه را برای ایجاد پروژه Firebase یا افزودن سرویس‌های Firebase به پروژه Google Cloud موجود دنبال کنید.

2. نقش‌های مناسب «مدیریت هویت و دسترسی‌ها» را طبق روشی که در بخش بعدی توضیح داده شده است اختصاص دهید.

نقش‌های الزامی

برای ایجاد و مدیریت پایگاه‌های داده، به نقش «مدیریت هویت و دسترسی‌ها» Owner یا Datastore Owner نیاز دارید. این نقش‌ها اجازه‌های لازم را اعطا می‌کنند.

مجوزهای لازم

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

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

ایجاد پایگاه داده

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

gcloud firestore databases create \
--database=DATABASE_ID \
--location=LOCATION \
--edition=enterprise \
--enable-firestore-data-access \
--enable-realtime-updates

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

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

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

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

حذف محافظت

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

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

فهرست کردن پایگاه‌های داده

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

gcloud firestore databases list

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

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

gcloud firestore databases describe --database=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 را با شناسه پایگاه داده جایگزین کنید.

حذف پایگاه داده

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

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

gcloud firestore databases delete --database=DATABASE_ID

همسانه‌سازی پایگاه داده

می‌توانید پایگاه داده موجود را در مُهر زمان انتخابی در پایگاه داده جدیدی شبیه‌سازی کنید:

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

  برای ایجاد کلون، Cloud Firestore از داده‌های بازیابی نقطه‌زمانی (PITR) پایگاه داده منبع استفاده می‌کند. پایگاه داده کلون‌شده شامل همه داده‌ها و نمایه‌ها است.

• به‌طور پیش‌فرض، پایگاه داده کلون‌شده به همان روش پایگاه داده منبع، بااستفاده از رمزگذاری پیش‌فرض Google یا رمزگذاری CMEK، رمزگذاری خواهد شد. می‌توانید نوع رمزگذاری دیگری را مشخص کنید یا از کلید دیگری برای رمزگذاری CMEK استفاده کنید.

• مُهر زمان دارای دانه‌بندی یک دقیقه‌ای است و نقطه‌ای از زمان را در گذشته مشخص می‌کند، در دوره‌ای که توسط پنجره PITR تعریف شده است:

  • اگر PITR برای پایگاه داده شما فعال باشد، می‌توانید هر دقیقه‌ای را در ۷ روز گذشته انتخاب کنید (یا کمتر، اگر PITR کمتر از ۷ روز پیش فعال شده باشد).
  • اگر «بازیابی نقطه‌زمانی» فعال نباشد، می‌توانید هر دقیقه‌ای را در ساعت گذشته انتخاب کنید.
  • می‌توانید اولین مُهر زمان قابل‌انتخاب را در شرح پایگاه داده‌تان بررسی کنید.

gcloud firestore databases clone \
--source-database='SOURCE_DATABASE' \
--snapshot-time='PITR_TIMESTAMP' \
--destination-database='DESTINATION_DATABASE_ID'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/example-source-db' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db' \
--tags=key1=value1,key2=value2

gcloud firestore databases clone \
--source-database='projects/example-project/databases/example-source-db' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db' \
--encryption-type='customer-managed-encryption' \
--kms-key-name='projects/example-project/locations/us-central1/keyRings/example-key-ring/cryptoKeys/example-key'

firebase firestore:databases:clone \
'SOURCE_DATABASE' \
'DESTINATION_DATABASE' \
--snapshot-time 'PITR_TIMESTAMP' \

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

می‌توانید از شرایط مدیریت هویت و دسترسی برای پیکربندی اجازه‌های دسترسی در سطح هر پایگاه داده استفاده کنید. مثال‌های زیر از 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: نشانی ایمیلی که نشان‌دهنده حساب خاصی است. برای مثال، 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: نشانی ایمیلی که نشان‌دهنده حساب خاصی است. برای مثال، 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: نشانی ایمیلی که نشان‌دهنده حساب خاصی است. برای مثال، alice@example.com.

محدودیت‌ها

می‌توانید حداکثر ۱۰۰ پایگاه داده در هر پروژه داشته باشید. برای درخواست افزایش این حد، می‌توانید با پشتیبانی تماس بگیرید.

حالا چه می‌شود

• شروع سریع: ایجاد پایگاه داده و اتصال به آن را اجرا کنید.
• درباره تفاوت‌های رفتاری بیشتر بدانید.
• درباره سنجه‌های Cloud Monitoring برای Cloud Firestore بیشتر بدانید.