Mengelola Firestore dengan konsol

Mengelola Firestore dengan konsol

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

• Melihat, mengajukan 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 Database

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 yang nilai kolom firstname sama dengan Sam. Untuk menerapkan filter koleksi:

1. Klik tombol filter di samping ID koleksi:

   

2. Dari menu Add filters, pilih kolom dokumen, kondisi filter, dan tata urutan.

   

3. Klik Apply.

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 Database

2. Pilih database yang diperlukan dari daftar database.

3. Di menu navigasi, klik Firestore Studio.

4. Klik tab Query Builder.

5. Pilih cakupan kueri.

   Pilih Koleksi 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 Grup koleksi, masukkan ID grup koleksi.

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

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

   Untuk menghapus klausa kueri, klik tombol hapus . Untuk menghapus semua klausa kueri, klik Hapus.

   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 Jalankan untuk mengambil hasil dari database Anda.

   

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

Persyaratan dan batasan kueri

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

• Semua kueri harus didukung oleh satu indeks lainnya. Jika tidak dapat menemukan indeks untuk mendukung kueri, database akan menampilkan error yang berisi link untuk membangun 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 Database

2. Pilih database yang diperlukan dari daftar database.

3. Di menu navigasi, klik Firestore Studio.

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

Menambahkan data

1. Klik Mulai Koleksi.
2. Masukkan ID koleksi. Masukkan ID dokumen. Firestore akan menghasilkan ID dokumen, tetapi Anda dapat menimpanya 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 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 Pengumpulan.

Menghapus data

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 Hapus dokumen atau Hapus kolom dokumen.

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 tersebut 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, lalu 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 Aturan Keamanan:

Fitur Aturan Keamanan Firestore terintegrasi erat dengan Firebase Auth dan Firebase SDK (platform Web, Android, Apple). Untuk mengetahui informasi lebih lanjut mengenai Firebase dan Firestore, baca bagian memulai Firebase.

Lihat Aturan Keamanan

Untuk melihat Aturan Keamanan Firestore dari Google Cloud Console, buka halaman Aturan Keamanan:

1. Di konsol Google Cloud, buka halaman Databases.

   BUka Database

2. Pilih database yang diperlukan dari daftar database.

3. Di menu navigasi, klik Security Rules.

Edit 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 lebih lanjut cara menyiapkan dan menyesuaikan aturan.

Mengelola indeks

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