Menggunakan Firestore Studio untuk edisi Standard

Menggunakan Firestore Studio untuk edisi Standard

Anda dapat mengelola edisi Standard Firestore melalui tindakan berikut di konsolGoogle Cloud :

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

Lihat data

Anda dapat melihat semua data edisi Firestore Standard di konsol Google Cloud . Dari penampil data edisi Firestore Standard, klik dokumen atau koleksi untuk membuka data bertingkat 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 induk yang tidak ada

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

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

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

Memfilter data

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 kumpulan, 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 Pembuat Kueri.

5. Pilih query scope.

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

   Pilih Collection group 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, Pembuat 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 edisi Firestore Standard 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 Anda. Selama sesi, Anda dapat maju dan mundur dalam browser untuk mengakses kueri terbaru. Anda dapat memberi bookmark pada kueri yang ingin sering Anda akses 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 atau beberapa indeks. 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.

Kelola data

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

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 edisi Standar Firestore Anda.

Tambahkan data

1. Klik Mulai Koleksi.
2. Masukkan ID koleksi. Masukkan ID dokumen. Edisi Standar Firestore akan membuat ID dokumen, tetapi Anda dapat mengganti 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.

Edit 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 mengelola dan men-deploy Aturan Keamanan Firestore langsung di konsol Google Cloud . Editor aturan tersedia untuk Firestore dalam mode Native di edisi Standard dan Enterprise.

Menggunakan Google Cloud console

Catatan: Konsol Google Cloud tidak mendukung deployment Aturan Keamanan Firestore ke database (default). Untuk mengelola aturan untuk database (default), gunakan Firebase console atau Firebase CLI.

Izin yang diperlukan

Untuk mengelola dan men-deploy aturan keamanan di konsol Google Cloud , Anda memerlukan izin IAM berikut:

• firebaserules.releases.create
• firebaserules.releases.delete
• firebaserules.releases.update
• firebaserules.rulesets.create
• firebaserules.rulesets.delete
• firebaserules.rulesets.list
• firebaserules.rulesets.test (diperlukan untuk menggunakan simulator aturan)

Untuk men-deploy aturan di konsol Google Cloud :

1. Di konsol Google Cloud , buka halaman Databases.

   Buka Databases

2. Klik ID database yang ingin Anda kelola.

3. Di menu navigasi, klik Security.

4. Klik tab Firestore Rules.

5. Di editor aturan, lihat aturan Anda. Untuk mengedit, klik Set aturan baru atau Kloning set aturan, lalu ubah aturan Anda.

6. Klik Publikasikan untuk men-deploy perubahan Anda.

Anda juga dapat melihat kumpulan aturan sebelumnya di linimasa dan meng-clone atau memulihkannya.

Mengaktifkan Firebase

Untuk mengedit Aturan Keamanan Firestore database (default) menggunakan Firebase console atau Firebase CLI, Anda harus mengaktifkan Firebase untuk project Google Cloud Anda. Jika Firebase belum diaktifkan, Anda dapat mengaktifkannya dari halaman Security di konsol Google Cloud :

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

Mengelola indeks

Untuk membuat indeks baru untuk kueri dan mengelola indeks yang ada dari Firebase console, buka Databases & Storage > Firestore > tab Indexes. Pelajari cara mengelola indeks lebih lanjut.