Terhubung dengan mongosh

Pelajari cara membuat database Firestore dengan kompatibilitas MongoDB dan menghubungkannya dengan alat mongosh.

Sebelum memulai

  1. Di konsol Google Cloud , buka halaman pemilih project.

    Buka pemilih project

  2. Pilih atau buat Google Cloud project.

    Peran yang diperlukan untuk memilih atau membuat project

    • Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
    • Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

  3. Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

  4. Pastikan Anda memiliki peran berikut di project: Cloud Datastore Owner

    Memeriksa peran

    1. Di konsol Google Cloud , buka halaman IAM.

      Buka IAM
    2. Pilih project.

    3. Di kolom Akun utama, temukan semua baris yang mengidentifikasi Anda atau grup yang Anda ikuti. Untuk mengetahui grup mana saja yang Anda ikuti, hubungi administrator Anda.

    4. Untuk semua baris yang menentukan atau menyertakan Anda, periksa kolom Peran untuk melihat apakah daftar peran menyertakan peran yang diperlukan.

    Memberikan peran

    1. Di konsol Google Cloud , buka halaman IAM.

      Buka IAM
    2. Pilih project.
    3. Klik Grant access.

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

    5. Klik Pilih peran, lalu telusuri peran.
    6. Untuk memberikan peran tambahan, klik Add another role, lalu tambahkan tiap peran tambahan.
    7. Klik Simpan.
  5. Menginstal alat mongosh

Membuat database Firestore dengan 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 selesai diinisialisasi, konsol akan membuka Firestore Studio untuk database Anda.

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

String koneksi bergantung pada UID database (yang dihasilkan 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 kepada pengguna.

  1. Di konsol Google Cloud , buka halaman Databases.

    Buka Databases

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

Sambungkan 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&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

Langkah berikutnya