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

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

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

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

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

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

حذف الحماية

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

إعداد قواعد أمان Cloud Firestore لقواعد البيانات

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

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

تتضمن قاعدة البيانات المُعنونة أي قاعدة بيانات لا تحمل اسم (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 أو كيانات الكائن الثنائي الكبير (blob)، يجب عليك حذف تلك البيانات أولاً.

لا يؤدي حذف قاعدة بيانات إلى حذف أي قاعدة تلقائيًا مشغِّلات Eventarc لقاعدة البيانات هذه. تشير رسالة الأشكال البيانية توقف عرض الأحداث ولكنها تستمر في التواجد حتى حذف العامل المشغِّل.

gcloud firestore databases delete --database=DATABASE_ID

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

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

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

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

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

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