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

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

قاعدة بيانات (default)

إذا كان تطبيقك لا يتطلب قواعد بيانات متعددة، استخدِم قاعدة بيانات (default).

في حال عدم تحديد قاعدة بيانات، تتصل مكتبات عملاء Cloud Firestore وGoogle Cloud CLI بقاعدة بيانات (default) تلقائيًا.

الأدوار المطلوبة

لإنشاء قواعد البيانات وإدارتها، تحتاج إلى دور Owner أو Datastore Owner إدارة الهوية والوصول. وتمنح هذه الأدوار الأذونات المطلوبة.

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

لإدارة قواعد البيانات، تحتاج إلى الأذونات التالية:

• إنشاء قاعدة بيانات: 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 حرفًا كحدّ أقصى
• يجب ألا يكون معرّفًا فريدًا عالميًا أو يشبه معرّفًا فريدًا عالميًا. على سبيل المثال، لا تستخدِم معرّفًا مثل f47ac10b-58cc-0372-8567-0e02b2c3d479.

في حال حذف قاعدة بيانات، لا يمكنك إعادة استخدام رقم تعريف قاعدة البيانات على الفور إلا بعد 5 دقائق.

حماية الحذف

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

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

استخدِم Firebase CLI لنشر 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

ضبط أذونات الوصول إلى كل قاعدة بيانات

يمكنك استخدام شروط إدارة الهوية والوصول لضبط أذونات الوصول على مستوى كل قاعدة بيانات. تستخدِم الأمثلة التالية واجهة سطر أوامر Google Cloud لمنح إذن وصول مشروط لقاعدة بيانات واحدة أو أكثر. يمكنك أيضًا تحديد شروط إدارة الهوية وإمكانية الوصول في Google Cloud Console.

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

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) إذا كانت تحتوي على أي بيانات بحث في Google App Engine. يُرجى استخدام index delete api لحذف بيانات البحث في "إحصاءات Google للأعمال الإلكترونية". إذا حذفت مؤخرًا بيانات "بحث Google للأعمال الإلكترونية"، قد يكون هناك فترة انتظار قبل أن تتمكّن من حذف قاعدة البيانات.
• لا يمكنك حذف قاعدة بيانات (default) إذا كانت تحتوي على أي عناصر مجموعات بيانات. يُرجى استخدام Blobstore delete api لحذف بيانات Blobstore. يمكنك التحقّق مما إذا كانت قاعدة بيانات (default) تحتوي على بيانات Blobstore من خلال تنفيذ طلب البحث التالي باستخدام لغة GQL في وحدة تحكّم Google Cloud: SELECT * FROM __BlobInfo__.
• لا يمكنك إعادة استخدام معرّف قاعدة بيانات إلا بعد مرور 5 دقائق على عملية الحذف.
• لا تتوافق الإصدار 1 من Cloud Function مع قواعد بيانات Firestore المُسمّاة. يُرجى استخدام عوامل تشغيل Cloud Firestore (الجيل الثاني) لضبط الأحداث لقواعد البيانات المُسمّاة.
• قد تتوقف الإصدار 1 من عوامل تشغيل وظائف Firestore وعوامل تشغيل أحداث Firestore عن العمل بعد حذف قاعدة البيانات، حتى إذا تم إنشاء قاعدة بيانات جديدة بالاسم نفسه.

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

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