Panduan memulai: Membuat database dan terhubung ke database tersebut

Pelajari cara membuat Firestore dengan database kompatibilitas MongoDB dan terhubung ke database tersebut dengan alat mongosh.

Sebelum memulai

  1. In the Google Cloud console, go to the project selector page.

    Go to project selector

  2. Select or create a Google Cloud project.

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Make sure that you have the following role or roles on the project: roles/datastore.owner

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Buka IAM
    2. Pilih project.
    3. Klik Berikan akses.

    4. Di kolom New principals, masukkan ID pengguna Anda. Ini biasanya adalah alamat email untuk Akun Google.

    5. Di daftar Pilih peran, pilih peran.
    6. Untuk memberikan peran tambahan, klik Tambahkan peran lain, lalu tambahkan setiap peran tambahan.
  5. Menginstal alat mongosh

Membuat Firestore dengan database kompatibilitas MongoDB dan mengambil string koneksi

Di konsol Google Cloud, buat database edisi Firestore Enterprise baru. Firestore dengan kompatibilitas MongoDB memerlukan edisi Firestore Enterprise:

  1. Di konsol Google Cloud, buka halaman Databases.

    Buka Databases

  2. Klik Create a Firestore Database.
  3. Masukkan ID database.
  4. Pilih Edisi Enterprise.
  5. Pilih lokasi untuk database Anda.

  6. Klik Create database.

    Setelah database menyelesaikan inisialisasi, konsol akan membuka Firestore Studio untuk database Anda.

  7. Di bagian Menghubungkan ke Firestore menggunakan alat MongoDB eksternal, salin string koneksi.

    String koneksi bergantung pada UID database (yang dibuat sistem) dan lokasi database:

    UID.LOCATION.firestore.goog

Membuat pengguna untuk autentikasi SCRAM

Di konsol Google Cloud, buat pengguna database baru dan tetapkan izin Identity and Access Management pengguna.

  1. Di konsol Google Cloud, buka halaman Databases.

    Buka Databases

  2. Pilih database dari daftar database.
  3. Di menu navigasi, klik Auth.
  4. Klik Add User.
  5. Masukkan nama pengguna.
  6. Pilih peran Identity and Access Management untuk pengguna.
  7. Klik buat. Database akan membuat pengguna dan menampilkan sandi yang dihasilkan pengguna kepada Anda. Salin dan simpan sandi ini. Anda tidak akan dapat mengambil sandi ini nanti..

Menghubungkan menggunakan mongosh

Gunakan string koneksi, nama pengguna, dan sandi untuk terhubung ke database Anda, jalankan mongosh secara lokal dengan opsi konfigurasi berikut.

mongosh 'mongodb://USERNAME:PASSWORD@CONNECTION_STRING:443/DATABASE_ID?loadBalanced=true&authMechanism=SCRAM-SHA-256&authMechanismProperties=ENVIRONMENT:gcp,TOKEN_RESOURCE:FIRESTORE&tls=true&retryWrites=false'

Ganti kode berikut:

  • USERNAME: nama pengguna database yang Anda buat.
  • PASSWORD: sandi yang dihasilkan untuk pengguna database yang Anda buat.
  • CONNECTION_STRING: string koneksi database.
  • DATABASE_ID: ID database

Setelah terhubung, Anda dapat membuat dan membaca data, misalnya:

db.pages.insertOne({ message: "Hello World!"})
db.pages.find({})
exit

Pembersihan

Untuk membersihkan resource yang digunakan di halaman ini, hapus pengguna database dan hapus database.

Menghapus pengguna database

Hapus pengguna database untuk menghapus pengguna dan izin Pengelolaan Akses dan Identitas yang ditetapkan.

  1. Di konsol Google Cloud, buka halaman Databases.

    Buka Databases

  2. Pilih database dari daftar database.
  3. Di menu navigasi, klik Auth.
  4. Klik Tindakan di kolom Tindakan untuk pengguna yang ingin Anda hapus. Klik Hapus pengguna. Dialog akan muncul.
  5. Konfirmasi penghapusan, lalu klik Hapus.
  6. Dialog akan menampilkan link ke halaman IAM. Klik link tersebut untuk menghapus izin yang ditetapkan kepada pengguna database.

  7. Cari baris yang berisi akun utama yang aksesnya ingin Anda cabut. Kemudian, klik Edit akun utama di baris tersebut.

    Akun utama untuk pengguna database yang Anda buat menggunakan format penamaan berikut:

    principal://firestore.googleapis.com/projects/PROJECT_NUMBER/name/databases/DATABASE_ID/userCreds/USER_ID
  8. Klik tombol Hapus untuk peran yang ingin Anda cabut, lalu klik Simpan.

Menghapus database

Selesaikan langkah-langkah berikut untuk menghapus database:

  1. Di konsol Google Cloud, buka halaman Databases.

    Buka Databases

  2. Klik View more di kolom Actions untuk database yang ingin Anda hapus. Klik Hapus. Dialog akan muncul.

  3. Pada dialog Delete database?, konfirmasi penghapusan dengan mengetikkan ID database di kolom teks. Klik Delete. Konsol akan memberi tahu Anda apakah operasi berhasil atau gagal.

    Jika operasi gagal, lihat detail database dan pastikan perlindungan penghapusan dinonaktifkan. Untuk menonaktifkan perlindungan penghapusan, lihat bagian Memperbarui setelan perlindungan penghapusan.

Langkah berikutnya