إدارة قواعد البيانات

توضّح هذه الصفحة كيفية إنشاء قواعد بيانات Cloud Firestore وتعديلها وحذفها. يمكنك إنشاء قواعد بيانات Cloud Firestore متعدّدة لكل مشروع. يمكنك استخدام قواعد بيانات متعددة لإعداد بيئات الإنتاج والاختبار، وعزل بيانات العملاء، وتحديد مناطق البيانات.

الأدوار والأذونات المطلوبة

لإنشاء قواعد البيانات وإدارتها، ستحتاج إلى دور "إدارة الهوية وإمكانية الوصول" التالي:

• مالك Cloud Datastore (roles/datastore.owner)

يمنح هذا الدور الأذونات التالية التي تحتاجها لإنشاء قواعد البيانات وإدارتها:

• إنشاء قاعدة بيانات: datastore.databases.create
• قراءة إعدادات قاعدة البيانات: datastore.databases.getMetadata
• ضبط قاعدة بيانات: datastore.databases.update
• حذف قاعدة بيانات: datastore.databases.delete
• استنساخ قاعدة بيانات: datastore.databases.clone

إنشاء قاعدة بيانات

لإنشاء قاعدة بيانات، استخدِم إحدى الطرق التالية:

firebase firestore:databases:create DATABASE_ID \n--location=LOCATION \n[--edition EDITION] \n[--firestore-data-access FIRESTORE_ACCESS] \n[--realtime-updates REALTIME_UPDATES] \n[--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
}

رقم تعريف قاعدة البيانات

يجب أن يتوافق معرّف قاعدة البيانات الصالح مع القواعد التالية:

• يجب تضمين الأحرف والأرقام والواصلات (-) فقط.
• يجب أن تكون الأحرف صغيرة.
• يجب أن يكون الحرف الأول حرفًا.
• يجب أن يكون الحرف الأخير حرفًا أو رقمًا.
• يجب ألّا يقلّ عدد الأحرف عن 4.
• 63 حرفًا كحدّ أقصى
• يجب ألا يكون معرّفًا فريدًا عالميًا (UUID) أو يشبهه. على سبيل المثال، لا تستخدِم معرّفًا مثل f47ac10b-58cc-0372-8567-0e02b2c3d479.

هناك استثناء واحد لهذه القواعد: سيتم إنشاء قاعدة بيانات باسم (default) في الإصدار العادي إذا لم تُدخل معرّفًا بنفسك.

يُرجى العِلم أنّه بعد حذف قاعدة بيانات، لا يمكنك إعادة استخدام معرّفها لمدة 5 دقائق تقريبًا.

حذف الحماية

استخدِم ميزة "الحماية من الحذف" لمنع حذف قاعدة بيانات عن طريق الخطأ. لا يمكنك حذف قاعدة بيانات تم تفعيل ميزة "الحماية من الحذف" فيها إلا بعد إيقاف هذه الميزة. تكون ميزة "الحماية من الحذف" غير مفعَّلة تلقائيًا. يمكنك تعديل إعدادات قاعدة البيانات من أجل تفعيل ميزة "الحماية من الحذف" أو إيقافها.

إعداد Cloud Firestore Security Rules لقواعد البيانات

استخدِم واجهة سطر الأوامر (CLI) في Firebase لنشر Cloud Firestore Security Rules في كل قاعدة بيانات. يُرجى الرجوع إلى دليل إدارة Cloud Firestore Security Rules ونشره.

الوصول إلى قاعدة بيانات مُسمّاة باستخدام مكتبة برامج

تتضمّن قاعدة البيانات المُعنوَنة أي قاعدة بيانات لا تحمل الاسم (default). بشكل تلقائي، تتصل حِزم تطوير البرامج (SDK) لمنصة Firebase ومكتبات عملاء Google API بقاعدة بيانات (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

استنساخ قاعدة بيانات

يمكنك استنساخ قاعدة بيانات حالية في طابع زمني محدّد إلى قاعدة بيانات جديدة:

• قاعدة البيانات المستنسَخة هي قاعدة بيانات جديدة سيتم إنشاؤها في الموقع نفسه الذي توجد فيه قاعدة البيانات المصدر.

  لإنشاء نسخة طبق الأصل، يستخدم Cloud Firestore بيانات الاسترداد في نقطة زمنية (PITR) لقاعدة البيانات المصدر. تتضمّن قاعدة البيانات المستنسَخة جميع البيانات والفهارس.

• بشكلٍ تلقائي، سيتم تشفير قاعدة البيانات المستنسَخة بالطريقة نفسها التي يتم بها تشفير قاعدة البيانات المصدر، وذلك باستخدام تشفير Google التلقائي أو تشفير CMEK. يمكنك تحديد نوع تشفير مختلف أو استخدام مفتاح مختلف لتشفير CMEK.

• يتم تحديد الطابع الزمني بدقة دقيقة واحدة ويشير إلى نقطة زمنية في الماضي، في الفترة المحددة في نافذة الاستعادة في نقطة زمنية معيّنة:

  • إذا كانت ميزة PITR مفعَّلة لقاعدة بياناتك، يمكنك اختيار أي دقيقة في آخر 7 أيام (أو أقل إذا تم تفعيل ميزة PITR قبل أقل من 7 أيام).
  • إذا لم تكن ميزة 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/(default)' \
--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'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--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 لمنح إذن وصول مشروط لقاعدة بيانات واحدة أو أكثر. يمكنك أيضًا تحديد شروط "إدارة الهوية وإمكانية الوصول" في وحدة تحكّم Google Cloud.

عرض سياسات "إدارة الهوية وإمكانية الوصول" الحالية

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 Monitoring

يتم تسجيل مقاييس Cloud Firestore ضمن موردَين مراقَبَين.

• firestore.googleapis.com/Database
• ‫firestore_instance(قديمة)

يمكنك فحص المقاييس المجمّعة على مستوى قاعدة البيانات من خلال الاطّلاع على firestore.googleapis.com/Database. يتم تجميع المقاييس التي يتم تسجيلها ضمن firestore_instance على مستوى المشروع.

القيود

• يمكنك إنشاء 100 قاعدة بيانات كحدّ أقصى لكل مشروع. يمكنك التواصل مع فريق الدعم لطلب زيادة هذا الحدّ.
• لا يمكنك حذف قاعدة بيانات "(default)" إذا كانت تحتوي على أي بيانات بحث في GAE. استخدِم واجهة برمجة التطبيقات لحذف الفهرس لحذف بيانات البحث في GAE. إذا حذفت مؤخرًا بيانات GAE Search، قد تكون هناك فترة انتظار قبل أن تتمكّن من حذف قاعدة البيانات.
• لا يمكنك حذف قاعدة بيانات "(default)" إذا كانت تحتوي على أي كيانات blob. استخدِم واجهة برمجة التطبيقات لحذف Blobstore لحذف بيانات Blobstore. يمكنك التحقّق مما إذا كانت قاعدة بيانات "(default)" تحتوي على بيانات Blobstore من خلال تشغيل طلب البحث التالي في GQL في وحدة تحكّم Google Cloud: SELECT * FROM __BlobInfo__.
• لا يمكنك إعادة استخدام معرّف قاعدة بيانات إلا بعد مرور 5 دقائق على عملية الحذف.
• لا يتوافق الإصدار الأول من Cloud Function مع قواعد بيانات Firestore المُسمّاة. استخدِم مشغّلات Cloud Firestore (الجيل الثاني) لضبط الأحداث لقواعد البيانات المُسمّاة.
• قد تتوقف مشغّلات وظائف Firestore v1 ومشغّلات أحداث Firestore عن العمل بعد حذف قاعدة البيانات، حتى إذا تم إنشاء قاعدة بيانات جديدة بالاسم نفسه.

الخطوات التالية

• إضافة بيانات
• الحصول على البيانات
• حذف البيانات