Menyimpan dan membuat kueri data di Firestore dalam mode Datastore

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 Google Cloud konsol.

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.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

• 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 kustom 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 dalam project yang sama.

   Pilih salah satu opsi database:

   • Firestore dalam Mode Native

     Direkomendasikan untuk aplikasi seluler dan web. Untuk mulai menggunakan 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 berlaku untuk database mode Datastore dan aplikasi App Engine untuk project Google Cloud Anda.

   Peringatan: Setelah membuat database, Anda tidak dapat mengubah lokasinya.

   Klik Create database. Setelah database Anda selesai diinisialisasi, konsolGoogle Cloud akan mengarahkan Anda ke halaman Entitas Datastore.

Menyimpan data

1. Buka halaman Entity Datastore di konsol Google Cloud .

   Buka halaman Entitas

   Halaman ini memungkinkan Anda menyimpan, membuat kueri, 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 ID utama 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:

   

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

Anda baru saja menyimpan data di database.

Menjalankan kueri

Database mode Datastore mendukung kueri data menurut jenis atau menurut Google Query Language (GQL). Petunjuk di bawah akan memandu Anda menggunakan keduanya untuk membuat kueri database.

Menjalankan kueri jenis

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

Hasil kueri menampilkan entitas Task yang Anda buat.

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

1. Klik Tambahkan klausa kueri.
2. Di menu drop-down, pilih WHERE, done, ==, boolean, dan false.
3. Klik Run. Hasilnya menunjukkan entity Task yang Anda buat karena nilai done-nya adalah false.
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 Run query.

Hasil kueri menampilkan entitas Task yang Anda buat.

Tips

Editor kueri GQL mendukung pelengkapan otomatis untuk jenis: Saat Anda perlu mengetik nama jenis, tekan Ctrl+Spasi untuk melihat daftar jenis yang tersedia. Hingga 300 jenis yang diurutkan menurut abjad dapat muncul dalam daftar. Untuk pencocokan jenis yang lebih baik, ketik satu atau beberapa karakter.

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

1. Jalankan kueri seperti SELECT * FROM Task WHERE done=false. Perhatikan bahwa Task dan done peka huruf besar/kecil. Hasilnya menunjukkan entity Task yang Anda buat, karena nilai done-nya adalah false.
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 menurut jenis dan pastikan Task adalah jenis yang dipilih.
2. Klik Hapus untuk menghapus semua klausa kueri.
3. Pilih entitas Task yang Anda buat.
4. Klik Hapus, lalu konfirmasi bahwa Anda ingin menghapus entity Task. Bergantung pada ukuran jendela browser, Hapus mungkin ada di menu Tindakan lainnya. Setelah dihapus, entitas akan dihapus secara permanen dari database Anda.

Selesai, Anda telah menyelesaikan panduan memulai ini.

Langkah berikutnya

• Pelajari lebih lanjut Kueri Datastore.
• Pelajari lebih lanjut database mode Datastore.