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.

  2. Gunakan Cloud NDB)

    untuk membuat, mengambil, dan mengelola entity dalam database mode Datastore Anda.

Jika Anda berencana untuk mengupgrade aplikasi Python 2 ke Python 3, Anda memiliki beberapa opsi:

  • Jika aplikasi Python 2 Anda menggunakan App Engine NDB untuk berinteraksi dengan Datastore, sebaiknya migrasikan ke Cloud NDB, bukan library klien mode Datastore. karena yang pertama memberikan pengalaman pengguna yang jauh lebih mirip.

  • Anda juga dapat memilih untuk mentransfer aplikasi Python 2 yang menggunakan App Engine NDB ke Python 3 terlebih dahulu, kemudian bermigrasi ke Cloud NDB. Untuk mempelajari cara mengakses App Engine NDB di Python 3, lihat halaman Mengakses layanan paket App Engine untuk Python 3.

Untuk referensi tambahan serta contoh migrasi dari aplikasi webapp Python 2 menggunakan App Engine NDB ke aplikasi Python 3 Flask yang setara dengan App Engine NDB yang diaktifkan, lihat halaman layanan paket Python 3.

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.

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.