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
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud 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 membuatnya untuk Anda. Dalam hal ini, Anda memerlukan
izin
appengine.applications.create
. Pemilik project dapat menetapkan izin ini dengan peran khusus IAM.
- Akun Anda memerlukan
peran Pemilik Datastore
yang berisi izin
Buat database
Untuk membuat instance database baru, buka bagian Datastore di konsol Google Cloud:
Buka halaman DatastorePilih mode database.
Saat membuat database Firestore baru, Anda memiliki opsi untuk menggunakan Firestore dalam Native Mode atau mode Datastore. Anda tidak dapat menggunakan kedua mode dalam project 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-per-fitur, lihat memilih antara Mode Native dan Mode Datastore.
-
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 Datastore Entities.
Menyimpan data
Buka halaman Entity Datastore di konsol Google Cloud.
Halaman ini memungkinkan Anda menyimpan, membuat kueri, memperbarui, dan menghapus data.
Klik Buat entity.
Di halaman Create an entity, gunakan
[default]
untuk Namespace.Ketik
Task
di kolom Kind. Biarkan ID kunci ditetapkan ke nilai defaultNumeric ID (auto-generated)
.Di bagian Properties, gunakan tombol Add property untuk menambahkan properti berikut:
Nama Jenis Nilai Terindeks deskripsi String Pelajari Datastore. dibuat Tanggal dan waktu (tanggal hari ini) ✓ done Boolean Salah ✓ Klik Create. Konsol akan 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 Google Query Language (GQL). Petunjuk di bawah ini akan memandu Anda menggunakan keduanya untuk membuat kueri database.
Menjalankan kueri jenis
- Klik Kueri menurut jenis.
- Pilih
Task
sebagai jenis.
Hasil kueri menampilkan entitas Task
yang Anda buat.
Selanjutnya, tambahkan klausa kueri untuk membatasi hasil ke entity yang memenuhi kriteria tertentu:
- Klik Tambahkan klausa kueri.
- Di menu drop-down, pilih
WHERE
,done
,==
, boolean, dan false. - Klik Run. Hasilnya menunjukkan entity
Task
yang Anda buat karena nilaidone
-nya adalahfalse
. - Sekarang, ubah klausa kueri menjadi
WHERE
,done
,==
, boolean, dan true. Klik Run. Hasilnya tidak menyertakan entityTask
yang Anda buat, karena nilaidone
-nya bukantrue
.
Menjalankan kueri GQL
- Klik Kueri menurut GQL.
- Masukkan
SELECT * FROM Task
sebagai kueri. Perhatikan bahwaTask
peka huruf besar/kecil. - Klik Run query.
Hasil kueri menampilkan entitas Task
yang Anda buat.
Tambahkan filter kueri untuk membatasi hasil ke entity yang memenuhi kriteria tertentu:
- Jalankan kueri seperti
SELECT * FROM Task WHERE done=false
. Perhatikan bahwaTask
dandone
peka huruf besar/kecil. Hasilnya menunjukkan entityTask
yang Anda buat, karena nilaidone
-nya adalahfalse
. - Sekarang jalankan kueri seperti
SELECT * FROM Task WHERE done=true
. Hasilnya tidak menyertakan entityTask
yang Anda buat, karena nilaidone
-nya bukantrue
.
Pembersihan
- Klik Kueri menurut jenis dan pastikan
Task
adalah jenis yang dipilih. - Klik Hapus untuk menghapus klausa kueri.
- Pilih entitas
Task
yang telah Anda buat. - Klik Hapus, lalu konfirmasi bahwa Anda ingin menghapus entity
Task
. Bergantung pada ukuran jendela browser, Hapus mungkin berada di bagian menu Tindakan lainnya . Setelah dihapus, entitas akan dihapus secara permanen dari database Anda.
Selesai, Anda telah menyelesaikan quickstart ini.
Langkah selanjutnya
- Pelajari Kueri Datastore lebih lanjut.
- Pelajari database mode Datastore lebih lanjut.