شروع به کار با نسخه Firestore Standard بااستفاده از کتابخانه‌های کارخواه سرور

این شروع سریع به شما نشان می‌دهد که چگونه نسخه Firestore Enterprise را راه‌اندازی کنید، داده اضافه کنید، سپس داده‌هایی را که به‌تازگی اضافه کرده‌اید در کنسول Firebase بااستفاده از کتابخانه‌های کارخواه سرور برای C#‎،‏ Go،‏ Java،‏ Node.js،‏ PHP،‏ Python، و Ruby مشاهده کنید.

از این کتابخانه‌های کارخواه برای راه‌اندازی محیط‌های سرور ممتاز با دسترسی کامل به پایگاه داده‌تان استفاده کنید.

ایجاد پایگاه داده Cloud Firestore

  1. اگر قبلاً این کار را نکرده‌اید، پروژه Firebase ایجاد کنید: در کنسول Firebase، روی افزودن پروژه کلیک کنید، سپس دستورالعمل‌های روی صفحه را دنبال کنید تا پروژه Firebase ایجاد کنید یا سرویس‌های Firebase را به پروژه Google Cloud موجود اضافه کنید.

  2. در پانل سمت راست، به پایگاه‌های داده و فضای ذخیره‌سازی > Firestore بروید.

  3. روی ایجاد پایگاه داده کلیک کنید.

  4. مکانی برای پایگاه داده‌تان انتخاب کنید.

    اگر نمی‌توانید مکانی را انتخاب کنید، «مکان منابع پیش‌فرض Google Cloud» پروژه‌تان قبلاً تنظیم شده است. برخی‌از منابع پروژه شما (مثل نمونه پیش‌فرض Cloud Firestore) وابستگی مکانی مشترکی دارند، و مکان آن‌ها را می‌توان درطول ایجاد پروژه یا هنگام راه‌اندازی سرویس دیگری که این وابستگی مکانی را دارد تنظیم کرد.

  5. حالت شروع را برای Cloud Firestore Security Rules انتخاب کنید:

    حالت آزمایشی

    برای شروع کار با کتابخانه‌های کارخواه وب و تلفن همراه مناسب است، اما به همه اجازه می‌دهد داده‌هایتان را بخوانند و بازنویسی کنند. پس‌از آزمایش، حتماً بخش ایمن‌سازی داده‌ها را مرور کنید.

    برای شروع کار با وب، پلاتفرم‌های Apple، یا کیت توسعه نرم‌افزار Android، حالت آزمایش را انتخاب کنید.

    حالت تولید

    همه خواندن‌ها و نوشتن‌ها را از کلاینت‌های وب و تلفن همراه رد می‌کند. سرورهای برنامه اصالت‌سنجی‌شده شما (C#‎،‏ Go،‏ Java،‏ Node.js،‏ PHP،‏ Python، یا Ruby) همچنان می‌توانند به پایگاه داده شما دسترسی داشته باشند.

    برای شروع کار با کتابخانه کارخواه سرور C#‎،‏ Go،‏ Java،‏ Node.js،‏ PHP،‏ Python، یا Ruby، حالت تولید را انتخاب کنید.

    مجموعه اولیه Cloud Firestore Security Rules برای پایگاه داده پیش‌فرض Cloud Firestore شما اعمال خواهد شد. اگر چندین پایگاه داده برای پروژه‌تان ایجاد کنید، می‌توانید برای هر پایگاه داده Cloud Firestore Security Rules مستقر کنید.

  6. روی ایجاد کردن کلیک کنید.

وقتی Cloud Firestore را فعال می‌کنید، میانای برنامه‌سازی کاربردی نیز در مدیر میانای برنامه‌سازی کاربردی Cloud فعال می‌شود.

راه‌اندازی محیط توسعه نرم‌افزار

وابستگی‌های لازم و کتابخانه‌های مشتری را به برنامه‌تان اضافه کنید.

جاوا
  1. افزودن Firebase Admin SDK به برنامه:
    • بااستفاده از Gradle:
      implementation 'com.google.firebase:firebase-admin:9.11.0'
    • استفاده از Maven:
      <dependency>
        <groupId>com.google.firebase</groupId>
        <artifactId>firebase-admin</artifactId>
        <version>9.11.0</version>
      </dependency>
           
  2. دستورالعمل‌های زیر را برای مقداردهی اولیه Cloud Firestore با اطلاعات اعتباری مناسب در محیط خود دنبال کنید.
پایتون
  1. افزودن Firebase Admin SDK به برنامه Python:
    pip install --upgrade firebase-admin
  2. دستورالعمل‌های زیر را برای مقداردهی اولیه Cloud Firestore با اطلاعات اعتباری مناسب در محیط خود دنبال کنید.
Node.js
  1. Firebase Admin SDK را به برنامه‌تان اضافه کنید:
    npm install firebase-admin --save
  2. دستورالعمل‌های زیر را برای مقداردهی اولیه Cloud Firestore با اعتبارنامه‌های مناسب در محیط خود دنبال کنید.
رفتن
  1. افزودن Firebase Admin SDK به برنامه Go:
    go get firebase.google.com/go
  2. دستورالعمل‌های زیر را برای مقداردهی اولیه Cloud Firestore با اطلاعات اعتباری مناسب در محیط خود دنبال کنید.
PHP
  1. کتابخانه‌های کارخواه سرور Cloud Firestore (Java،‏ Node.js،‏ Python،‏ Go،‏ PHP،‏ C#‎، و Ruby) از اعتبارنامه‌های پیش‌فرض برنامه Google برای اصالت‌سنجی استفاده می‌کنند.
    • برای اصالت‌سنجی از محیط توسعه نرم‌افزار، متغیر محیطی GOOGLE_APPLICATION_CREDENTIALS را طوری تنظیم کنید که به فایل کلید حساب سرویس JSON اشاره کند. می‌توانید فایل کلید را در صفحه اطلاعات کاربری کنسول API ایجاد کنید.
      export GOOGLE_APPLICATION_CREDENTIALS="path/to/your/keyfile.json"
    • در محیط تولید، اگر برنامه‌تان را در App Engine یا Compute Engine بااستفاده از همان پروژه‌ای که برای Cloud Firestore استفاده می‌کنید اجرا کنید، نیازی به اصالت‌سنجی ندارید. درغیراین‌صورت، حساب سرویس راه‌اندازی کنید.
  2. افزونه gRPC را برای PHP نصب و فعال کنید. برای استفاده از کتابخانه کارخواه به آن نیاز خواهید داشت.
  3. کتابخانه Cloud Firestore PHP را به برنامه‌تان اضافه کنید:
    composer require google/cloud-firestore
Ruby
  1. کتابخانه‌های کارخواه سرور Cloud Firestore (Java،‏ Node.js،‏ Python،‏ Go،‏ PHP،‏ C#‎، و Ruby) از اعتبارنامه‌های پیش‌فرض برنامه Google برای اصالت‌سنجی استفاده می‌کنند.
    • برای اصالت‌سنجی از محیط توسعه نرم‌افزار، متغیر محیطی GOOGLE_APPLICATION_CREDENTIALS را طوری تنظیم کنید که به فایل کلید حساب سرویس JSON اشاره کند. می‌توانید فایل کلید را در صفحه اطلاعات کاربری کنسول API ایجاد کنید.
      export GOOGLE_APPLICATION_CREDENTIALS="path/to/your/keyfile.json"
    • در محیط تولید، اگر برنامه‌تان را در App Engine یا Compute Engine بااستفاده از همان پروژه‌ای که برای Cloud Firestore استفاده می‌کنید اجرا کنید، نیازی به اصالت‌سنجی ندارید. درغیراین‌صورت، حساب سرویس راه‌اندازی کنید.
  2. کتابخانه Cloud Firestore Ruby را در Gemfile به برنامه‌تان اضافه کنید:
    gem "google-cloud-firestore"
  3. وابستگی‌ها را از Gemfile بااستفاده از موارد زیر نصب کنید:
    bundle install

(اختیاری) نمونه‌سازی و آزمایش با Firebase Local Emulator Suite

برای توسعه‌دهندگان تلفن همراه، قبل‌از صحبت درباره نحوه نوشتن و خواندن برنامه‌تان از Cloud Firestore، بیایید مجموعه‌ای از ابزارها را معرفی کنیم که می‌توانید برای نمونه‌سازی و آزمایش عملکرد Cloud Firestore استفاده کنید: Firebase Local Emulator Suite. اگر درحال امتحان کردن مدل‌های داده مختلف، بهینه‌سازی قوانین امنیتی، یا تلاش برای یافتن مقرون‌به‌صرفه‌ترین روش برای تعامل با پس‌بک هستید، توانایی کار کردن به‌صورت محلی بدون استقرار خدمات زنده می‌تواند ایده بسیار خوبی باشد.

شبیه‌ساز Cloud Firestore بخشی از Local Emulator Suite است که به برنامه شما امکان می‌دهد با محتوا و پیکربندی پایگاه داده شبیه‌سازی‌شده شما، و همچنین به‌صورت اختیاری با منابع پروژه شبیه‌سازی‌شده شما (توابع، پایگاه‌های داده دیگر، و قوانین امنیتی) تعامل داشته باشد.

استفاده از شبیه‌ساز Cloud Firestore فقط چند مرحله دارد:

  1. افزودن یک خط کد به پیکربندی آزمایشی برنامه‌تان برای اتصال به شبیه‌ساز.
  2. از ریشه دایرکتوری پروژه محلی شما، درحال اجرای firebase emulators:start.
  3. برقراری تماس از کد نمونه اولیه برنامه‌تان بااستفاده از کیت توسعه نرم‌افزار پلاتفرم Cloud Firestore طبق معمول.

راهنمای گام‌به‌گام دقیقی شامل Cloud Firestore و Cloud Functions دردسترس است. همچنین باید نگاهی به Local Emulator Suite مقدمه بیندازید.

مقداردهی اولیه Cloud Firestore

نمونه‌ای از Cloud Firestore را مقداردهی اولیه کنید:

جاوا
کیت توسعه نرم‌افزار Cloud Firestore بسته به محیط شما به روش‌های مختلفی مقداردهی اولیه می‌شود. رایج‌ترین روش‌ها در زیر آمده است. برای مرجع کامل، مقداردهی اولیه کیت توسعه نرم‌افزار سرپرست را ببینید.
  • مقداردهی اولیه در Google Cloud
    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();
  • مقداردهی اولیه در سرور خودتان

    برای استفاده از Firebase Admin SDK در سرور خودتان، از حساب سرویس استفاده کنید.

    به IAM & admin (مدیریت هویت و دسترسی و سرپرست) > Service accounts (حساب‌های سرویس) در کنسول Google Cloud بروید. کلید خصوصی جدیدی ایجاد کنید و فایل JSON را ذخیره کنید. سپس از این فایل برای مقداردهی اولیه کیت توسعه نرم‌افزار استفاده کنید:

    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 بسته به محیط شما به روش‌های مختلفی مقداردهی اولیه می‌شود. رایج‌ترین روش‌ها در زیر آمده است. برای مرجع کامل، مقداردهی اولیه کیت توسعه نرم‌افزار سرپرست را ببینید.
  • مقداردهی اولیه در Google Cloud
    import firebase_admin
    from firebase_admin import firestore
    
    # Application Default credentials are automatically created.
    app = firebase_admin.initialize_app()
    db = firestore.client()

    از اطلاعات اعتباری پیش‌فرض برنامه موجود نیز می‌توان برای مقداردهی اولیه کیت توسعه نرم‌افزار استفاده کرد.

    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()
  • مقداردهی اولیه در سرور خودتان

    برای استفاده از Firebase Admin SDK در سرور خودتان، از حساب سرویس استفاده کنید.

    به IAM & admin (مدیریت هویت و دسترسی و سرپرست) > Service accounts (حساب‌های سرویس) در کنسول Google Cloud بروید. کلید خصوصی جدیدی ایجاد کنید و فایل JSON را ذخیره کنید. سپس از این فایل برای مقداردهی اولیه کیت توسعه نرم‌افزار استفاده کنید:

    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()
  • Python

    کیت توسعه نرم‌افزار Cloud Firestore بسته به محیط شما به روش‌های مختلفی مقداردهی اولیه می‌شود. رایج‌ترین روش‌ها در زیر آمده است. برای مرجع کامل، مقداردهی اولیه کیت توسعه نرم‌افزار سرپرست را ببینید.
  • مقداردهی اولیه در Google Cloud
    import firebase_admin
    from firebase_admin import firestore_async
    
    # Application Default credentials are automatically created.
    app = firebase_admin.initialize_app()
    db = firestore_async.client()

    از اطلاعات اعتباری پیش‌فرض برنامه موجود نیز می‌توان برای مقداردهی اولیه کیت توسعه نرم‌افزار استفاده کرد.

    import firebase_admin
    from firebase_admin import credentials
    from firebase_admin import firestore_async
    
    # Use the application default credentials.
    cred = credentials.ApplicationDefault()
    
    firebase_admin.initialize_app(cred)
    db = firestore_async.client()
  • مقداردهی اولیه در سرور خودتان

    برای استفاده از Firebase Admin SDK در سرور خودتان، از حساب سرویس استفاده کنید.

    به IAM & admin (مدیریت هویت و دسترسی و سرپرست) > Service accounts (حساب‌های سرویس) در کنسول Google Cloud بروید. کلید خصوصی جدیدی ایجاد کنید و فایل JSON را ذخیره کنید. سپس از این فایل برای مقداردهی اولیه کیت توسعه نرم‌افزار استفاده کنید:

    import firebase_admin
    from firebase_admin import credentials
    from firebase_admin import firestore_async
    
    # Use a service account.
    cred = credentials.Certificate('path/to/serviceAccount.json')
    
    app = firebase_admin.initialize_app(cred)
    
    db = firestore_async.client()
  • Node.js
    کیت توسعه نرم‌افزار Cloud Firestore بسته به محیط شما به روش‌های مختلفی مقداردهی اولیه می‌شود. رایج‌ترین روش‌ها در زیر آمده است. برای مرجع کامل، مقداردهی اولیه کیت توسعه نرم‌افزار سرپرست را ببینید.
    • مقداردهی اولیه در Cloud Functions
      const { initializeApp, applicationDefault, cert } = require('firebase-admin/app');
      const { getFirestore, Timestamp, FieldValue, Filter } = require('firebase-admin/firestore');
      initializeApp();
      
      const db = getFirestore();
      
    • مقداردهی اولیه در Google Cloud
      const { initializeApp, applicationDefault, cert } = require('firebase-admin/app');
      const { getFirestore, Timestamp, FieldValue, Filter } = require('firebase-admin/firestore');
      initializeApp({
        credential: applicationDefault()
      });
      
      const db = getFirestore();
    • مقداردهی اولیه در سرور خودتان

      برای استفاده از Firebase Admin SDK در سرور خودتان (یا هر محیط Node.js دیگر)، از حساب سرویس استفاده کنید. در کنسول Google Cloud، به IAM و سرپرست > حساب‌های سرویس بروید. کلید خصوصی جدیدی ایجاد کنید و فایل JSON را ذخیره کنید. سپس از این فایل برای مقداردهی اولیه کیت توسعه نرم‌افزار استفاده کنید:

      const { initializeApp, applicationDefault, cert } = require('firebase-admin/app');
      const { getFirestore, Timestamp, FieldValue, Filter } = require('firebase-admin/firestore');
      const serviceAccount = require('./path/to/serviceAccountKey.json');
      
      initializeApp({
        credential: cert(serviceAccount)
      });
      
      const db = getFirestore();
      
    رفتن
    کیت توسعه نرم‌افزار Cloud Firestore بسته به محیط شما به روش‌های مختلفی مقداردهی اولیه می‌شود. رایج‌ترین روش‌ها در زیر آمده است. برای مرجع کامل، مقداردهی اولیه کیت توسعه نرم‌افزار سرپرست را ببینید.
  • مقداردهی اولیه در Google Cloud
    import (
      "log"
    
      firebase "firebase.google.com/go"
      "google.golang.org/api/option"
    )
    
    // Use the application default credentials
    ctx := context.Background()
    conf := &firebase.Config{ProjectID: projectID}
    app, err := firebase.NewApp(ctx, conf)
    if err != nil {
      log.Fatalln(err)
    }
    
    client, err := app.Firestore(ctx)
    if err != nil {
      log.Fatalln(err)
    }
    defer client.Close()
  • مقداردهی اولیه در سرور خودتان

    برای استفاده از Firebase Admin SDK در سرور خودتان، از حساب سرویس استفاده کنید.

    به IAM & admin (مدیریت هویت و دسترسی و سرپرست) > Service accounts (حساب‌های سرویس) در کنسول Google Cloud بروید. کلید خصوصی جدیدی ایجاد کنید و فایل JSON را ذخیره کنید. سپس از این فایل برای مقداردهی اولیه کیت توسعه نرم‌افزار استفاده کنید:

    import (
      "log"
    
      firebase "firebase.google.com/go"
      "google.golang.org/api/option"
    )
    
    // Use a service account
    ctx := context.Background()
    sa := option.WithCredentialsFile("path/to/serviceAccount.json")
    app, err := firebase.NewApp(ctx, nil, sa)
    if err != nil {
      log.Fatalln(err)
    }
    
    client, err := app.Firestore(ctx)
    if err != nil {
      log.Fatalln(err)
    }
    defer client.Close()
  • PHP

    PHP

    برای کسب اطلاعات بیشتر درباره نصب و ایجاد کارخواه Cloud Firestore، به کتابخانه‌های کارخواه Cloud Firestore مراجعه کنید.

    use Google\Cloud\Firestore\FirestoreClient;
    
    /**
     * Initialize Cloud Firestore with default project ID.
     */
    function setup_client_create(string $projectId = null)
    {
        // Create the Cloud Firestore client
        if (empty($projectId)) {
            // The `projectId` parameter is optional and represents which project the
            // client will act on behalf of. If not supplied, the client falls back to
            // the default project inferred from the environment.
            $db = new FirestoreClient();
            printf('Created Cloud Firestore client with default project ID.' . PHP_EOL);
        } else {
            $db = new FirestoreClient([
                'projectId' => $projectId,
            ]);
            printf('Created Cloud Firestore client with project ID: %s' . PHP_EOL, $projectId);
        }
    }
    سی شارپ

    سی شارپ

    برای کسب اطلاعات بیشتر درباره نصب و ایجاد کارخواه Cloud Firestore، به کتابخانه‌های کارخواه Cloud Firestore مراجعه کنید.

    FirestoreDb db = FirestoreDb.Create(project);
    Console.WriteLine("Created Cloud Firestore client with project ID: {0}", project);
    Ruby
    require "google/cloud/firestore"
    
    # The `project_id` parameter is optional and represents which project the
    # client will act on behalf of. If not supplied, the client falls back to the
    # default project inferred from the environment.
    firestore = Google::Cloud::Firestore.new project_id: project_id
    
    puts "Created Cloud Firestore client with given project ID."

    افزودن داده‌ها

    Cloud Firestore داده‌ها را در «اسناد» ذخیره می‌کند که در «مجموعه‌ها» ذخیره می‌شوند. Cloud Firestore مجموعه‌ها و اسناد را به‌طور ضمنی در اولین باری که داده‌ها را به سند اضافه می‌کنید ایجاد می‌کند. نیازی نیست به‌طور صریح مجموعه یا سند ایجاد کنید.

    بااستفاده از کد نمونه زیر، مجموعه و سند جدیدی ایجاد کنید.

    جاوا
    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());
    پایتون
    doc_ref = db.collection("users").document("alovelace")
    doc_ref.set({"first": "Ada", "last": "Lovelace", "born": 1815})

    Python

    doc_ref = db.collection("users").document("alovelace")
    await doc_ref.set({"first": "Ada", "last": "Lovelace", "born": 1815})
    Node.js
    const docRef = db.collection('users').doc('alovelace');
    
    await docRef.set({
      first: 'Ada',
      last: 'Lovelace',
      born: 1815
    });
    رفتن
    _, _, err := client.Collection("users").Add(ctx, map[string]interface{}{
    	"first": "Ada",
    	"last":  "Lovelace",
    	"born":  1815,
    })
    if err != nil {
    	log.Fatalf("Failed adding alovelace: %v", err)
    }
    PHP

    PHP

    برای کسب اطلاعات بیشتر درباره نصب و ایجاد کارخواه Cloud Firestore، به کتابخانه‌های کارخواه Cloud Firestore مراجعه کنید.

    $docRef = $db->collection('samples/php/users')->document('alovelace');
    $docRef->set([
        'first' => 'Ada',
        'last' => 'Lovelace',
        'born' => 1815
    ]);
    printf('Added data to the lovelace document in the users collection.' . PHP_EOL);
    سی شارپ
    DocumentReference docRef = db.Collection("users").Document("alovelace");
    Dictionary<string, object> user = new Dictionary<string, object>
    {
        { "First", "Ada" },
        { "Last", "Lovelace" },
        { "Born", 1815 }
    };
    await docRef.SetAsync(user);
    Ruby
    doc_ref = firestore.doc "#{collection_path}/alovelace"
    
    doc_ref.set(
      {
        first: "Ada",
        last:  "Lovelace",
        born:  1815
      }
    )
    
    puts "Added data to the alovelace document in the users collection."

    اکنون سند دیگری به مجموعه users اضافه کنید. توجه داشته باشید که این سند شامل یک جفت کلید-مقدار (نام میانی) است که در سند اول ظاهر نمی‌شود. اسناد موجود در مجموعه می‌توانند حاوی مجموعه‌های مختلفی از اطلاعات باشند.

    جاوا
    DocumentReference docRef = db.collection("users").document("aturing");
    // Add document data with an additional field ("middle")
    Map<String, Object> data = new HashMap<>();
    data.put("first", "Alan");
    data.put("middle", "Mathison");
    data.put("last", "Turing");
    data.put("born", 1912);
    
    ApiFuture<WriteResult> result = docRef.set(data);
    System.out.println("Update time : " + result.get().getUpdateTime());
    پایتون
    doc_ref = db.collection("users").document("aturing")
    doc_ref.set({"first": "Alan", "middle": "Mathison", "last": "Turing", "born": 1912})

    Python

    doc_ref = db.collection("users").document("aturing")
    await doc_ref.set(
        {"first": "Alan", "middle": "Mathison", "last": "Turing", "born": 1912}
    )
    Node.js
    const aTuringRef = db.collection('users').doc('aturing');
    
    await aTuringRef.set({
      'first': 'Alan',
      'middle': 'Mathison',
      'last': 'Turing',
      'born': 1912
    });
    رفتن
    _, _, err = client.Collection("users").Add(ctx, map[string]interface{}{
    	"first":  "Alan",
    	"middle": "Mathison",
    	"last":   "Turing",
    	"born":   1912,
    })
    if err != nil {
    	log.Fatalf("Failed adding aturing: %v", err)
    }
    PHP

    PHP

    برای کسب اطلاعات بیشتر درباره نصب و ایجاد کارخواه Cloud Firestore، به کتابخانه‌های کارخواه Cloud Firestore مراجعه کنید.

    $docRef = $db->collection('samples/php/users')->document('aturing');
    $docRef->set([
        'first' => 'Alan',
        'middle' => 'Mathison',
        'last' => 'Turing',
        'born' => 1912
    ]);
    printf('Added data to the aturing document in the users collection.' . PHP_EOL);
    سی شارپ
    DocumentReference docRef = db.Collection("users").Document("aturing");
    Dictionary<string, object> user = new Dictionary<string, object>
    {
        { "First", "Alan" },
        { "Middle", "Mathison" },
        { "Last", "Turing" },
        { "Born", 1912 }
    };
    await docRef.SetAsync(user);
    Ruby
    doc_ref = firestore.doc "#{collection_path}/aturing"
    
    doc_ref.set(
      {
        first:  "Alan",
        middle: "Mathison",
        last:   "Turing",
        born:   1912
      }
    )
    
    puts "Added data to the aturing document in the users collection."

    داده‌ها خوانده شد

    از نمایشگر داده در کنسول Firebase استفاده کنید تا به‌سرعت تأیید کنید که داده‌ها را به Cloud Firestore اضافه کرده‌اید.

    همچنین می‌توانید از روش «get» برای بازیابی کل مجموعه استفاده کنید.

    جاوا
    // 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"));
    }
    پایتون
    users_ref = db.collection("users")
    docs = users_ref.stream()
    
    for doc in docs:
        print(f"{doc.id} => {doc.to_dict()}")

    Python

    users_ref = db.collection("users")
    docs = users_ref.stream()
    
    async for doc in docs:
        print(f"{doc.id} => {doc.to_dict()}")
    Node.js
    const snapshot = await db.collection('users').get();
    snapshot.forEach((doc) => {
      console.log(doc.id, '=>', doc.data());
    });
    رفتن
    iter := client.Collection("users").Documents(ctx)
    for {
    	doc, err := iter.Next()
    	if err == iterator.Done {
    		break
    	}
    	if err != nil {
    		log.Fatalf("Failed to iterate: %v", err)
    	}
    	fmt.Println(doc.Data())
    }
    PHP

    PHP

    برای کسب اطلاعات بیشتر درباره نصب و ایجاد کارخواه Cloud Firestore، به کتابخانه‌های کارخواه Cloud Firestore مراجعه کنید.

    $usersRef = $db->collection('samples/php/users');
    $snapshot = $usersRef->documents();
    foreach ($snapshot as $user) {
        printf('User: %s' . PHP_EOL, $user->id());
        printf('First: %s' . PHP_EOL, $user['first']);
        if (!empty($user['middle'])) {
            printf('Middle: %s' . PHP_EOL, $user['middle']);
        }
        printf('Last: %s' . PHP_EOL, $user['last']);
        printf('Born: %d' . PHP_EOL, $user['born']);
        printf(PHP_EOL);
    }
    printf('Retrieved and printed out all documents from the users collection.' . PHP_EOL);
    سی شارپ
    CollectionReference usersRef = db.Collection("users");
    QuerySnapshot snapshot = await usersRef.GetSnapshotAsync();
    foreach (DocumentSnapshot document in snapshot.Documents)
    {
        Console.WriteLine("User: {0}", document.Id);
        Dictionary<string, object> documentDictionary = document.ToDictionary();
        Console.WriteLine("First: {0}", documentDictionary["First"]);
        if (documentDictionary.ContainsKey("Middle"))
        {
            Console.WriteLine("Middle: {0}", documentDictionary["Middle"]);
        }
        Console.WriteLine("Last: {0}", documentDictionary["Last"]);
        Console.WriteLine("Born: {0}", documentDictionary["Born"]);
        Console.WriteLine();
    }
    Ruby
    users_ref = firestore.col collection_path
    users_ref.get do |user|
      puts "#{user.document_id} data: #{user.data}."
    end

    مراحل بعدی

    دانشتان را با موضوعات زیر عمیق‌تر کنید: