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 library ke file dependensi aplikasi Anda.

    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 untuk Java mencakup server pengembangan lokal untuk menguji aplikasi Anda di komputer. Server pengembangan lokal mengemulasikan lingkungan runtime Java App Engine dan semua layanannya, termasuk mode Datastore.

    Server pengembangan menghasilkan konfigurasi untuk indeks mode Datastore yang diperlukan aplikasi Anda, yang ditentukan dari kueri yang dijalankannya saat Anda mengujinya.

    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.