Menggunakan Cloud Firestore dalam Mode Datastore

Firestore adalah database dokumen NoSQL yang dibangun untuk penskalaan otomatis, performa tinggi, dan kemudahan pengembangan aplikasi. Ini adalah versi terbaru Datastore dan memperkenalkan beberapa peningkatan pada Datastore.

Karena Firestore dalam mode Datastore yang dioptimalkan untuk kasus penggunaan server dan untuk App Engine, sebaiknya gunakan Firestore dalam mode Datastore untuk database yang akan digunakan terutama oleh aplikasi App Engine. Firestore dalam mode Native paling berguna untuk kasus penggunaan notifikasi real-time dan seluler. Untuk mengetahui informasi selengkapnya tentang mode Firestore, lihat Memilih antara Mode Native dan mode Datastore.

Menggunakan mode Datastore dengan App Engine

Untuk menggunakan mode Datastore dengan App Engine:

  1. Jika belum melakukannya, buat database lalu pilih Firestore dalam mode Datastore.

    Anda dapat menggunakan database Datastore yang sudah ada dengan aplikasi App Engine. Database yang sudah ada ini akan otomatis di-upgrade ke Firestore dalam mode Datastore.

    1. Di aplikasi Anda, deklarasikan Datastore sebagai dependensi dengan menambahkan google/cloud-datastore ke file composer.json aplikasi Anda dan menjalankan composer install dari direktori aplikasi Anda. Pelajari composer lebih lanjut.

    2. Gunakan Library Klien Google Cloud untuk membaca dan menulis entity serta membuat kueri data.

    Mengonfigurasi indeks

    Mode Datastore menggunakan indeks untuk setiap kueri yang dibuat aplikasi Anda. Indeks diperbarui setiap kali entity berubah, sehingga hasilnya dapat ditampilkan dengan cepat saat aplikasi membuat kueri.

    Mode Datastore secara otomatis membuat indeks properti tunggal untuk digunakan dengan jenis kueri yang sederhana. Untuk kueri kompleks yang mencakup beberapa properti, Anda harus mengonfigurasi indeks komposit di file index.yaml aplikasi.

    Server pengembangan App Engine akan memperbarui file index.yaml Anda dengan indeks komposit yang diperlukan untuk menjalankan pengujian. Demikian pula, emulator mode Datastore dapat membuat indeks saat Anda menjalankan pengujian.

    Anda juga dapat menambahkan indeks ke file index.yaml aplikasi secara manual jika tidak menjalankan pengujian lokal atau pengujian tidak menyertakan kueri yang kompleks.

    Menetapkan izin database

    Secara default, aplikasi Anda memiliki semua izin yang diperlukan untuk membaca dan menulis ke mode Datastore dan database Firestore di project Google Cloud.

    Untuk mengelola izin ini, setiap aplikasi App Engine menggunakan akun layanan default yang memberikan akses baca dan tulis penuh ke mode Datastore dan database Firestore dalam project yang sama dengan aplikasi. Anda dapat mengubah izin akses dari akun layanan default, tetapi aplikasi Anda dapat kehilangan akses kecuali jika Anda menetapkan peran IAM dengan izin yang diperlukan.

    Untuk mengetahui informasi tentang cara mengizinkan pengguna, aplikasi, atau project lain mengakses database, lihat Mengakses database.

    Menggunakan emulator mode Datastore untuk pengujian lokal

    Google Cloud CLI menyertakan emulator dari lingkungan mode untuk mode Datastore produksi secara lokal. Anda dapat menggunakan emulator untuk mengembangkan dan menguji aplikasi secara lokal. Selain itu, emulator dapat membantu Anda membuat indeks untuk instance mode dari mode Datastore produksi Anda dan menghapus indeks yang tidak diperlukan.

    Jika menggunakan server pengembangan lokal App Engine untuk menguji aplikasi, Anda dapat memastikan bahwa server akan menggunakan emulator mode Datastore dengan menetapkan tanda --support_datastore_emulator=true saat memulai server.

    Jika Anda menggunakan emulator mode Datastore, dev_appserver akan menampilkan:

    ... Using Cloud Datastore Emulator.

    Harga, kuota, dan batas

    Mode Datastore menawarkan kuota gratis dengan batas harian. Akun berbayar menawarkan penyimpanan tak terbatas, operasi baca, dan tulis. Informasi selengkapnya tersedia di halaman Kuota Datastore.