بدء استخدام إصدار Firestore Enterprise باستخدام مكتبات برامج الخادم والعميل

يوضّح لك هذا الدليل السريع كيفية إعداد Cloud Firestore وإضافة البيانات، ثم استخدام العمليات الأساسية أو عمليات خطوط النقل للاستعلام عن البيانات التي أضفتها للتو في الـ Firebase باستخدام مكتبات برامج الخادم للغة Java وNode.js وPython.

استخدِم مكتبات برامج الخادم هذه لإعداد بيئات خادم مميزة تتمتّع بإمكانية الوصول الكامل إلى قاعدة بياناتك.

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

1. إذا لم يسبق لك ذلك، أنشئ مشروعًا على Firebase: في الـ Firebase وحدة تحكّم، انقر على إضافة مشروع، ثم اتّبِع التعليمات الظاهرة على الشاشة لإنشاء مشروع على Firebase أو لـ إضافة خدمات Firebase إلى مشروع حالي على Google Cloud.

2. افتح مشروعك في وحدة تحكّم Firebase. في اللوحة اليمنى، وسِّع إنشاء، ثم انقر على قاعدة بيانات Firestore.

3. انقر على إنشاء قاعدة بيانات.

4. اختَر مؤسسة لوضع قاعدة البيانات.

5. اختَر Firestore في الوضع الأصلي لوضع العملية، الذي يتيح العمليات الأساسية وعمليات خطوط النقل.

6. اختَر موقعًا جغرافيًا لقاعدة بياناتك.

7. اختَر وضعًا أوليًا لـ Cloud Firestore Security Rules:

   وضع الاختبار

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

   للبدء في استخدام حزمة تطوير البرامج (SDK) للويب أو منصات Apple أو Android، اختَر وضع الاختبار.

   وضع الإنتاج

   يؤدي هذا الوضع إلى رفض جميع عمليات القراءة والكتابة من برامج الخادم للأجهزة الجوّالة والويب. سيظل بإمكان خوادم التطبيقات التي تم التحقّق من هويتها (Node.js وPython وJava) الوصول إلى قاعدة بياناتك.

   ستنطبق المجموعة الأولية من Cloud Firestore Security Rules على قاعدة بيانات Cloud Firestore التلقائية. إذا أنشأت قواعد بيانات متعددة لمشروعك، يمكنك نشر Cloud Firestore Security Rules لكل قاعدة بيانات.

8. انقر على إنشاء.

عند تفعيل Cloud Firestore، يتم أيضًا تفعيل واجهة برمجة التطبيقات في Cloud API Manager.

إعداد بيئة التطوير

أضِف التبعيات ومكتبات برامج الخادم المطلوبة إلى تطبيقك.

تهيئة Cloud Firestore

هيِّئ مثيلاً من Cloud Firestore

import firebase_admin
from firebase_admin import firestore

# Application Default credentials are automatically created.
app = firebase_admin.initialize_app()
db = firestore.client()
firestore.py

import firebase_admin
from firebase_admin import credentials
from firebase_admin import firestore

# Use the application default credentials.
cred = credentials.ApplicationDefault()

firebase_admin.initialize_app(cred)
db = firestore.client()
firestore.py

import firebase_admin
from firebase_admin import credentials
from firebase_admin import firestore

# Use a service account.
cred = credentials.Certificate('path/to/serviceAccount.json')

app = firebase_admin.initialize_app(cred)

db = firestore.client()
firestore.py

import com.google.auth.oauth2.GoogleCredentials;
import com.google.cloud.firestore.Firestore;

import com.google.firebase.FirebaseApp;
import com.google.firebase.FirebaseOptions;

// Use the application default credentials
GoogleCredentials credentials = GoogleCredentials.getApplicationDefault();
FirebaseOptions options = new FirebaseOptions.Builder()
    .setCredentials(credentials)
    .setProjectId(projectId)
    .build();
FirebaseApp.initializeApp(options);

Firestore db = FirestoreClient.getFirestore();

import com.google.auth.oauth2.GoogleCredentials;
import com.google.cloud.firestore.Firestore;

import com.google.firebase.FirebaseApp;
import com.google.firebase.FirebaseOptions;

// Use a service account
InputStream serviceAccount = new FileInputStream("path/to/serviceAccount.json");
GoogleCredentials credentials = GoogleCredentials.fromStream(serviceAccount);
FirebaseOptions options = new FirebaseOptions.Builder()
    .setCredentials(credentials)
    .build();
FirebaseApp.initializeApp(options);

Firestore db = FirestoreClient.getFirestore();

إضافة البيانات باستخدام العمليات الأساسية

لاستكشاف العمليات الأساسية وعمليات خطوط النقل للاستعلام عن البيانات، أضِف بيانات إلى قاعدة بياناتك باستخدام العمليات الأساسية.

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

أنشئ مجموعة ومستندًا جديدَين باستخدام نموذج الرمز البرمجي التالي.

const docRef = db.collection('users').doc('alovelace');

await docRef.set({
  first: 'Ada',
  last: 'Lovelace',
  born: 1815
});
index.js

DocumentReference docRef = db.collection("users").document("alovelace");
// Add document data  with id "alovelace" using a hashmap
Map<String, Object> data = new HashMap<>();
data.put("first", "Ada");
data.put("last", "Lovelace");
data.put("born", 1815);
//asynchronously write data
ApiFuture<WriteResult> result = docRef.set(data);
// ...
// result.get() blocks on response
System.out.println("Update time : " + result.get().getUpdateTime());
Quickstart.java

doc_ref = db.collection("users").document("alovelace")
doc_ref.set({"first": "Ada", "last": "Lovelace", "born": 1815})
snippets.py

قراءة البيانات باستخدام العمليات الأساسية

استخدِم أداة عرض البيانات في وحدة تحكّم Firebase للتأكّد بسرعة من أنّك أضفت بيانات إلى Cloud Firestore.

يمكنك أيضًا استخدام طريقة "get" لاسترداد المجموعة بأكملها.

const snapshot = await db.collection('users').get();
snapshot.forEach((doc) => {
  console.log(doc.id, '=>', doc.data());
});
index.js

users_ref = db.collection("users")
docs = users_ref.stream()

for doc in docs:
    print(f"{doc.id} => {doc.to_dict()}")
snippets.py

// asynchronously retrieve all users
ApiFuture<QuerySnapshot> query = db.collection("users").get();
// ...
// query.get() blocks on response
QuerySnapshot querySnapshot = query.get();
List<QueryDocumentSnapshot> documents = querySnapshot.getDocuments();
for (QueryDocumentSnapshot document : documents) {
  System.out.println("User: " + document.getId());
  System.out.println("First: " + document.getString("first"));
  if (document.contains("middle")) {
    System.out.println("Middle: " + document.getString("middle"));
  }
  System.out.println("Last: " + document.getString("last"));
  System.out.println("Born: " + document.getLong("born"));
}
Quickstart.java

قراءة البيانات باستخدام عمليات خطوط النقل

يمكنك الآن مقارنة تجربة الاستعلام عن خطوط النقل بتجربة الاستعلام الأساسية.

const readDataPipeline = db.pipeline()
  .collection("users");

// Execute the pipeline and handle the result
try {
  const querySnapshot = await readDataPipeline.execute();
  querySnapshot.results.forEach((result) => {
    console.log(`${result.id} => ${result.data()}`);
  });
} catch (error) {
    console.error("Error getting documents: ", error);
}
test.firestore.js

pipeline = client.pipeline().collection("users")
for result in pipeline.execute():
    print(f"{result.id} => {result.data()}")
firestore_pipelines.py

Pipeline pipeline = firestore.pipeline().collection("users");
ApiFuture<Pipeline.Snapshot> future = pipeline.execute();
for (com.google.cloud.firestore.PipelineResult result : future.get().getResults()) {
  System.out.println(result.getId() + " => " + result.getData());
}
// or, asynchronously
pipeline.execute(
    new ApiStreamObserver<com.google.cloud.firestore.PipelineResult>() {
      @Override
      public void onNext(com.google.cloud.firestore.PipelineResult result) {
        System.out.println(result.getId() + " => " + result.getData());
      }

      @Override
      public void onError(Throwable t) {
        System.err.println(t);
      }

      @Override
      public void onCompleted() {
        System.out.println("done");
      }
    });
PipelineSnippets.java

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

تعمَّق في معرفتك بالعمليات الأساسية وعمليات خطوط النقل من خلال المواضيع التالية:

• تأكَّد من أنّك على دراية بالاختلافات بين العمليات الأساسية وعمليات مسار التعلّم
• مزيد من المعلومات عن الاستعلام باستخدام العمليات الأساسية
• مزيد من المعلومات عن الاستعلام باستخدام عمليات مسار التعلّم.