Mengelola Firestore dengan konsol

Mengelola Firestore dengan konsol

Anda dapat mengelola Firestore melalui tindakan berikut di konsol Google Cloud:

• Melihat, membuat kueri, menambahkan, mengedit, dan menghapus data.
• Mengelola indeks.

Catatan: Untuk mengelola Aturan Keamanan, gunakan Firebase console.

Melihat Data

Anda dapat melihat semua data Firestore di konsol Google Cloud. Dari penampil data Firestore, klik dokumen atau koleksi untuk membuka data yang berada di dalam item tersebut.

1. Di konsol Google Cloud, buka halaman Databases.

   Buka Databases

2. Pilih database yang diperlukan dari daftar database.

3. Di menu navigasi, klik Firestore Studio.

Membuka jalur tertentu

Untuk membuka dokumen atau koleksi di jalur tertentu, gunakan tombol Edit jalur :

Dokumen ancestor yang tidak ada

Sebuah dokumen dapat ada bahkan jika satu atau beberapa ancestor-nya tidak ada. Misalnya, dokumen di jalur /mycoll/mydoc/mysubcoll/mysubdoc dapat ada meskipun dokumen ancestor /mycoll/mydoc tidak ada. Penampil data Firestore menampilkan dokumen ancestor yang tidak ada sebagai berikut:

• Pada daftar dokumen dalam koleksi, ID dokumen dari dokumen ancestor yang tidak ada akan dicetak miring.
• Di panel informasi dokumen ancestor yang tidak ada, penampil data menunjukkan bahwa dokumen tersebut tidak ada.

Peringatan: Meskipun dokumen ancestor yang tidak ada muncul di console, dokumen tersebut tidak muncul dalam kueri dan snapshot. Anda harus membuat dokumen tersebut untuk memasukkannya ke dalam hasil kueri.

Data filter

Anda dapat memfilter dokumen dalam koleksi berdasarkan nilai kolom dan kondisi ==, !-, >, >=, <, <=, in, not-in, array-contains, array-contains-any. Misalnya, Anda hanya dapat menampilkan dokumen dengan nilai kolom firstname sama dengan Sam. Untuk menerapkan filter koleksi:

1. Klik tombol filter di samping ID koleksi:

   

2. Dari menu Tambahkan filter, pilih kolom dokumen, kondisi filter, dan urutan pengurutan.

   

3. Klik Terapkan.

Untuk menghapus filter koleksi, buka menu yang sama dan klik Hapus filter.

Data kueri

Anda dapat membuat kueri untuk dokumen di tab Query Builder di halaman Firestore Studio.

1. Di konsol Google Cloud, buka halaman Databases.

   Buka Databases

2. Pilih database yang diperlukan dari daftar database.

3. Di menu navigasi, klik Firestore Studio.

4. Klik tab Builder Kueri.

5. Pilih query scope.

   Pilih Collection untuk membuat kueri satu koleksi. Di kolom teks, masukkan jalur ke koleksi.

   Pilih Grup koleksi untuk membuat kueri semua koleksi dengan ID yang sama. Di kolom Collection group, masukkan ID grup koleksi.

   Tabel ini akan otomatis menampilkan dokumen dari koleksi atau grup koleksi yang ditentukan.

6. Klik Add to query untuk memfilter kumpulan dokumen yang ditampilkan. Secara default, Builder Kueri menambahkan klausa WHERE. Anda dapat mengubah klausa ini menggunakan menu drop-down dan kolom teks atau mengubahnya ke salah satu klausa yang tersedia. Untuk terus membuat kueri yang lebih kompleks, klik Add to query.

   Untuk menghapus klausa kueri, klik tombol clear . Untuk menghapus semua klausa kueri, klik Clear.

   Catatan: Kueri harus memenuhi persyaratan dan batasan Firestore untuk kueri. Jika tidak, kueri akan gagal dan halaman akan menampilkan error yang menjelaskan alasan kueri gagal.

7. Klik Run untuk mengambil hasil dari database Anda.

   

Tips: Kueri yang Anda jalankan disimpan di histori browser. Selama sesi, Anda dapat maju dan mundur dalam browser untuk mengakses kueri terbaru. Anda dapat mem-bookmark kueri yang ingin sering diakses atau dibagikan kepada orang lain.

Persyaratan dan batasan kueri

Saat Anda menggunakan Query Builder, perhatikan persyaratan dan batasan berikut untuk kueri.

• Semua kueri harus didukung oleh satu indeks lagi. Jika tidak dapat menemukan indeks untuk mendukung kueri, indeks akan menampilkan error yang berisi link untuk membuat indeks yang diperlukan.

  

• Klausa ORDER BY harus cocok dengan kolom dalam klausa WHERE dan memiliki urutan yang sama. Secara default, hasil diurutkan berdasarkan ID dokumen. Jika Anda memfilter berdasarkan kolom lain dengan apa pun selain kesetaraan (==), tambahkan klausa ORDER BY untuk kolom tersebut.

  

• Klausa kueri rentang (<, <=, >, >=) dan tidak sama dengan (!=, not-in) harus memfilter kolom yang sama.

Untuk batasan lainnya, lihat Batasan kueri.

Mengelola data

Di Firestore, Anda menyimpan data dalam dokumen dan mengatur dokumen ke dalam koleksi. Sebelum Anda mulai menambahkan data, pelajari model data Firestore lebih lanjut.

Anda dapat menambahkan, mengedit, dan menghapus dokumen dan koleksi dari Firebase console. Untuk mengelola data Anda dari konsol GCP, buka halaman Firestore Studio:

1. Di konsol Google Cloud, buka halaman Databases.

   Buka Databases

2. Pilih database yang diperlukan dari daftar database.

3. Di menu navigasi, klik Firestore Studio.

Catatan: Operasi baca, tulis, dan hapus yang dilakukan di konsol turut diperhitungkan dalam penggunaan Firestore Anda.

Tambahkan data

1. Klik Mulai Koleksi.
2. Masukkan ID koleksi. Masukkan ID dokumen. Firestore akan membuat ID dokumen, tetapi Anda dapat menimpa untuk ID dokumen tertentu. Tambahkan kolom untuk data dalam dokumen Anda.
3. Klik Simpan. Koleksi dan dokumen baru Anda muncul di penampil data.
4. Untuk menambahkan lebih banyak dokumen ke dalam koleksi, klik Tambahkan Dokumen.

Mengedit data

1. Klik pada koleksi untuk melihat dokumennya, lalu klik pada dokumen untuk melihat kolom dan subkoleksinya.
2. Klik pada kolom untuk mengedit nilainya. Untuk menambahkan kolom atau subkoleksi ke dokumen yang dipilih, klik Tambahkan Kolom atau Mulai Koleksi.

Menghapus data

Anda dapat menghapus dokumen atau koleksi dari penampil data.

Catatan: Dalam beberapa kasus, menghapus dokumen dalam jumlah besar dapat menyebabkan penampil data memuat dengan lambat atau menampilkan error waktu tunggu habis. Hal ini berlaku untuk operasi penghapusan yang dilakukan melalui penampil data dan di tempat lain.

Untuk menghapus koleksi:

1. Pilih koleksi yang ingin dihapus.
2. Klik ikon menu di bagian atas kolom dokumen, lalu klik Hapus koleksi.

Untuk menghapus dokumen:

1. Pilih dokumen yang ingin dihapus.
2. Klik ikon menu di bagian atas kolom rincian dokumen. Pilih Delete document atau Delete document fields.

Menghapus sebuah dokumen akan menghapus semua data bertingkat dalam dokumen tersebut, termasuk subkoleksi yang ada.

Menghapus kolom dokumen tidak akan menghapus subkoleksinya. Meskipun kosong, dokumen masih ada dan dapat muncul dalam hasil kueri.

Untuk menghapus kolom tertentu dalam dokumen:

1. Pilih dokumen untuk melihat kolomnya.
2. Klik ikon hapus di samping kolom yang ingin dihapus.

Mengelola Aturan Keamanan Firestore

Anda dapat melihat Aturan Keamanan Firestore dari konsol Google Cloud. Untuk mengedit atau menghapus kumpulan aturan, aktifkan Firebase, dan gunakan Firebase CLI atau Firebase console.

Mengaktifkan Firebase

Untuk mengedit Aturan Keamanan Firestore, Anda harus mengaktifkan Firebase untuk project Google Cloud. Jika Firebase tidak diaktifkan, Anda dapat mengaktifkan Firebase dari halaman Security Rules:

Fitur Aturan Keamanan Firestore terintegrasi erat dengan Firebase Auth dan Firebase SDK (platform Web, Android, Apple). Untuk mengetahui informasi selengkapnya tentang Firebase dan Firestore, lihat memulai Firebase.

Melihat Aturan Keamanan

Untuk melihat Aturan Keamanan Firestore dari konsol Google Cloud, buka halaman Security Rules:

1. Di konsol Google Cloud, buka halaman Databases.

   Buka Databases

2. Pilih database yang diperlukan dari daftar database.

3. Di menu navigasi, klik Security Rules.

Mengedit Aturan Keamanan

Untuk mengedit atau menghapus Aturan Keamanan Firestore, gunakan Firebase CLI atau Firebase console. Di Firebase console, buka tab Rules di bagian Firestore. Pelajari cara menyiapkan dan menyesuaikan aturan lebih lanjut.

Mengelola indeks

Untuk membuat indeks baru untuk kueri dan mengelola indeks yang sudah ada dari Firebase console, buka tab Indeks di bagian Firestore. Pelajari cara mengelola indeks lebih lanjut.