عمليات Core لإضافة البيانات والاستعلام عنها الموضّحة في هذه الصفحة هي نفسها العمليات المتاحة في Firestore Standard. إذا كنت معتادًا على استخدام إصدار Firestore Standard، يمكنك إضافة البيانات والاستعلام عنها في Firestore Enterprise بالطريقة نفسها.
يسرّنا أن تجرّب عمليات Pipeline، ولكن يجب أن تكون على دراية بالعمليات الأساسية في هذه النسخة التجريبية:
- ستستخدم عمليات الإضافة الأساسية لتعبئة البيانات خلال فترة المعاينة.
- يمكنك استخدام "العمليات الأساسية" للحصول على دعم في الوقت الفعلي وبلا إنترنت، تمامًا كما هو الحال في "الإصدار العادي". لا تتوفّر إمكانات الوقت الفعلي وبلا إنترنت لطلبات البحث في مسار البيانات بعد.
إضافة بيانات إلى Firestore باستخدام العمليات الأساسية
تتيح العمليات الأساسية إضافة البيانات والاستعلام عنها. عمليات مسار البيانات مخصّصة فقط للاستعلام عن البيانات. لذلك، بالنسبة إلى أنشطة المعاينة، ستستخدم عمليات Core لملء قاعدة البيانات الجديدة المتوافقة مع "خطوط الإنتاج".
للتذكير، الطريقتان الأساسيتان لكتابة البيانات في Core هما set() وadd(). ويُعدّ فهم الفرق بينهما أمرًا أساسيًا لإدارة مستنداتك بفعالية.
يمكنك التفكير في هذه العمليات بالطريقة التالية:
set(): استخدِم هذه السمة عندما تريد تحديد معرّف المستند بنفسك. إذا كان مستند بهذا المعرّف متوفّرًا من قبل، ستستبدلهset()بالكامل ما لم تستخدم خيار الدمج. إذا لم يكن متوفّرًا، ستنشئهset().add(): استخدِم هذه الطريقة عندما تريد أن ينشئ Firestore تلقائيًا معرّفًا فريدًا للمستند الجديد. ويكون ذلك مفيدًا عند إضافة مستندات إلى مجموعة وليس لديك معرّف طبيعي لاستخدامه.
للحصول على دليل شامل حول إضافة المستندات وتعديلها، بما في ذلك كيفية التعامل مع الكائنات المتداخلة والمصفوفات والطوابع الزمنية للخادم، يُرجى الرجوع إلى المستندات الرسمية حول إضافة البيانات إلى Cloud Firestore.
قراءة البيانات من Firestore باستخدام عمليات Core
يتم استرداد البيانات من Firestore باستخدام دوال العمليات الأساسية تمامًا كما هو الحال في إصدار Firestore Standard، بما في ذلك إتاحة التعديلات في الوقت الفعلي وإمكانات الاستخدام بلا إنترنت.
هناك عدة طرق لاسترداد بياناتك:
- الحصول على مستند مرة واحدة: أبسط طريقة لقراءة البيانات هي جلب مستند أو نتيجة طلب بحث مرة واحدة.
- الاستماع إلى التعديلات في الوقت الفعلي: يمكنك ضبط أداة استماع على مستند أو طلب بحث لتلقّي التعديلات في الوقت الفعلي عند تغيُّر البيانات.
- خيارات المصدر: بالنسبة إلى التطبيقات التي تتضمّن إمكانات بلا إنترنت، يمكنك تحديد ما إذا كنت تريد استرداد البيانات من الخادم أو ذاكرة التخزين المؤقت المحلية أو السماح لحزمة SDK بتحديد ذلك.
لمزيد من المعلومات حول تنفيذ طلبات البحث البسيطة والمركّبة، وترتيب البيانات والحدّ منها، والعمل مع الكائنات المخصّصة، راجِع المستندات التفصيلية حول الحصول على البيانات باستخدام Cloud Firestore.