Menyimpan dan membuat kueri data di Firestore dalam mode Datastore

Halaman ini menunjukkan cara menyimpan dan membuat kueri data di Firestore dalam mode Datastore menggunakan konsol Google Cloud.

Sebelum memulai

  • Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

  • Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

    •

  • Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

    •

  • Jika Anda bukan pemilik project, akun Anda memerlukan izin berikut untuk menyelesaikan panduan memulai ini:

    • Akun Anda memerlukan peran Pemilik Datastore yang berisi izin datastore.databases.create yang diperlukan untuk membuat instance mode Datastore.
    • Mode Datastore memerlukan aplikasi App Engine yang aktif. Jika project tidak memiliki aplikasi, panduan memulai ini akan membuatkannya untuk Anda. Dalam hal ini, Anda memerlukan izin appengine.applications.create. Pemilik project dapat menetapkan izin ini dengan peran khusus IAM.

Buat database

  1. Untuk membuat instance database baru, buka bagian Datastore di konsol Google Cloud:
    Buka halaman Datastore

  2. Pilih mode database.

    Saat membuat database Firestore baru, Anda memiliki opsi untuk menggunakan Firestore dalam Mode Native atau mode Datastore. Anda tidak dapat menggunakan kedua mode tersebut dalam proyek yang sama.

    Pilih dari salah satu opsi database:

    • Firestore dalam Mode Native

      Direkomendasikan untuk aplikasi seluler dan web. Untuk memulai Firestore, lanjutkan di Panduan Memulai Firestore.

    • Firestore dalam Mode Datastore

      Direkomendasikan untuk arsitektur aplikasi dengan server backend.

    Untuk panduan selengkapnya tentang cara memilih mode database dan perbandingan fitur demi fitur, lihat memilih antara Mode Native dan Mode Datastore.

  3. Pilih lokasi database. Mode Datastore mendukung lokasi multi-region dan regional.

    Lokasi multi-region memaksimalkan ketersediaan dan ketahanan. Lokasi regional menawarkan latensi tulis yang lebih rendah. Untuk mempelajari jenis lokasi lebih lanjut, lihat Lokasi mode Datastore. Lokasi ini berlaku untuk database mode Datastore dan aplikasi App Engine untuk project Google Cloud Anda.

    Klik Buat database. Setelah database selesai melakukan inisialisasi, konsol Google Cloud akan mengarahkan Anda ke halaman Entity Datastore.

Menyimpan data

  1. Buka halaman Entity Datastore di Konsol Google Cloud.

    Buka halaman Entitas

    Halaman ini memungkinkan Anda menyimpan, mengkueri, memperbarui, dan menghapus data.

  2. Klik Buat entity.

  3. Di halaman Create an entity, gunakan [default] untuk Namespace.

  4. Ketik Task di kolom Kind. Biarkan Key identifier yang ditetapkan ke nilai default Numeric ID (auto-generated).

  5. Di bagian Properti, gunakan tombol Tambahkan properti untuk menambahkan properti berikut:

    Nama Jenis Nilai Terindeks
    deskripsi String Pelajari Datastore.
    dibuat Tanggal dan waktu (tanggal hari ini) ✓
    done Boolean Salah ✓
    Halaman pembuatan Anda sekarang akan terlihat seperti ini:

    Jendela pembuatan entity dengan berbagai properti yang ditetapkan

  6. Klik Create. Konsol menampilkan entity Task yang baru saja Anda buat.

Anda baru saja menyimpan data dalam database Anda!

Menjalankan kueri

Database mode Datastore mendukung pembuatan kueri data berdasarkan jenis atau berdasarkan Bahasa Kueri Google (GQL). Petunjuk di bawah ini akan memandu Anda menggunakan keduanya untuk membuat kueri database.

Menjalankan kueri jenis

  1. Klik Kueri menurut jenis.
  2. Pilih Task sebagai jenis.

Hasil kueri menampilkan entity Task yang Anda buat.

Selanjutnya, tambahkan klausa kueri untuk membatasi hasil pada entity yang memenuhi kriteria tertentu:

  1. Klik Tambahkan klausa kueri.
  2. Dalam daftar dropdown, pilih WHERE, done, ==, boolean, dan false.
  3. Klik Run. Hasilnya menunjukkan entity Task yang Anda buat karena nilai done-nya adalah false. Kueri jenis dengan filter diterapkan
  4. Sekarang ubah klausa kueri menjadi WHERE, done, ==, boolean, dan true. Klik Run. Hasilnya tidak menyertakan entity Task yang Anda buat karena nilai done-nya bukan true.

Menjalankan kueri GQL

  1. Klik Kueri menurut GQL.
  2. Masukkan SELECT * FROM Task sebagai kueri. Perhatikan bahwa Task peka huruf besar/kecil.
  3. Klik Jalankan kueri.

Hasil kueri menampilkan entity Task yang Anda buat.

Tambahkan filter kueri untuk membatasi hasil ke entity yang memenuhi kriteria tertentu:

  1. Jalankan kueri seperti SELECT * FROM Task WHERE done=false. Perlu diperhatikan bahwa Task dan done peka huruf besar/kecil. Hasilnya menampilkan entity Task yang Anda buat, karena nilai done-nya adalah false. Kueri GQL dengan filter yang diterapkan
  2. Sekarang jalankan kueri seperti SELECT * FROM Task WHERE done=true. Hasilnya tidak menyertakan entity Task yang Anda buat karena nilai done-nya bukan true.

Pembersihan

  1. Klik Query by type dan pastikan Task adalah jenis yang dipilih.
  2. Klik Hapus untuk menghapus klausa kueri.
  3. Pilih entity Task yang Anda buat.
  4. Klik Delete, lalu konfirmasi bahwa Anda ingin menghapus entity Task. Bergantung pada ukuran jendela browser, Delete mungkin ada di bawah menu More actions. Setelah dihapus, entity akan dihapus secara permanen dari database Anda.

Selesai. Anda telah menyelesaikan panduan memulai ini.

Langkah selanjutnya