View a markdown version of this page

Memulai dengan Amazon DocumentDB - Amazon DocumentDB
PrasyaratLangkah 1: Buat clusterLangkah 2: Hubungkan ke cluster AndaLangkah 3: Sisipkan dan kueri dataLangkah 4: Jelajahi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memulai dengan Amazon DocumentDB

Ada banyak cara untuk terhubung dan memulai dengan Amazon DocumentDB. Panduan ini adalah cara tercepat, paling sederhana, dan termudah bagi pengguna untuk mulai menggunakan database dokumen kami yang kuat. Panduan ini digunakan AWS CloudShell untuk menghubungkan dan menanyakan cluster Amazon DocumentDB Anda langsung dari Konsol Manajemen AWS. Pelanggan baru yang memenuhi syarat untuk Tingkat AWS Gratis dapat menggunakan Amazon DocumentDB dan secara CloudShell gratis. Jika AWS CloudShell lingkungan atau cluster Amazon DocumentDB menggunakan sumber daya di luar tingkat gratis, Anda akan dikenakan AWS tarif normal untuk sumber daya tersebut. Panduan ini akan membantu Anda memulai dengan Amazon DocumentDB dalam waktu kurang dari lima menit.

catatan

Petunjuk dalam panduan ini khusus untuk membuat dan menghubungkan ke cluster berbasis instance Amazon DocumentDB di mana Amazon DocumentDB dan tersedia. AWS CloudShell

Topik

Prasyarat

Sebelum membuat klaster Amazon DocumentDB pertama, Anda harus melakukan hal berikut:

Buatlah akun Amazon Web Services (AWS)

Sebelum Anda dapat mulai menggunakan Amazon DocumentDB, Anda harus memiliki akun Amazon Web Services (AWS). AWS Akun ini gratis. Anda hanya membayar untuk layanan dan sumber daya yang Anda gunakan.

Jika Anda tidak memilikinya Akun AWS, selesaikan langkah-langkah berikut untuk membuatnya.

Untuk mendaftar Akun AWS

  1. Buka https://portal.aws.amazon.com/billing/signup.

  2. Ikuti petunjuk online.

    Bagian dari prosedur pendaftaran melibatkan menerima panggilan telepon atau pesan teks dan memasukkan kode verifikasi pada keypad telepon.

    Saat Anda mendaftar Akun AWS, sebuah Pengguna root akun AWS dibuat. Pengguna root memiliki akses ke semua Layanan AWS dan sumber daya di akun. Sebagai praktik terbaik keamanan, tetapkan akses administratif ke pengguna, dan gunakan hanya pengguna root untuk melakukan tugas yang memerlukan akses pengguna root.

Siapkan izin AWS Identity and Access Management (IAM) yang diperlukan.

Akses untuk mengelola sumber daya Amazon DocumentDB seperti cluster, instance, dan grup parameter cluster memerlukan kredentif yang AWS dapat digunakan untuk mengotentikasi permintaan Anda. Untuk informasi selengkapnya, lihat Manajemen Identitas dan Akses untuk Amazon DocumentDB.

  1. Di bilah pencarian Konsol Manajemen AWS, masukkan IAM dan pilih IAM di menu tarik-turun yang muncul.

  2. Setelah Anda berada di konsol IAM, pilih Pengguna dari panel navigasi.

  3. Pilih nama pengguna Anda.

  4. Pilih Tambahkan izin.

  5. Pilih Lamp irkan kebijakan secara langsung.

  6. Ketik AmazonDocDBFullAccess di bilah pencarian dan pilih itu setelah muncul di hasil pencarian.

  7. Pilih Berikutnya.

  8. Pilih Tambahkan izin.

catatan

AWS Akun Anda menyertakan VPC default di setiap Wilayah. Jika Anda memilih untuk menggunakan Amazon VPC, selesaikan langkah-langkah dalam topik Buat Amazon VPC di Panduan Pengguna Amazon VPC.

Langkah 1: Buat cluster

Pada langkah ini Anda akan membuat cluster Amazon DocumentDB.

  1. Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di https://console.aws.amazon.com/docdb.

  2. Di konsol manajemen Amazon DocumentDB, di bawah Klaster, pilih Buat.

    Dasbor Cluster Kosong dengan opsi untuk membuat cluster baru dan mengelola sumber daya.

  3. Pada halaman Create Amazon DocumentDB cluster, di bagian Cluster type, pilih Instance-based cluster (ini adalah opsi default).

    Pemilihan tipe cluster dengan opsi Cluster Berbasis Instance disorot dan kedua jenis cluster dijelaskan.
    catatan

    Pilihan lain dalam kategori ini adalah cluster elastis. Untuk mempelajari selengkapnya tentang cluster elastis Amazon DocumentDB, lihat Menggunakan Amazon DocumentDB Elastic Cluster

  4. Di bagian konfigurasi Cluster:

    1. Untuk pengidentifikasi Cluster, masukkan nama unik, sepertimydocdbcluster. Perhatikan bahwa konsol akan mengubah semua nama cluster menjadi huruf kecil terlepas dari bagaimana mereka dimasukkan.

    2. Untuk versi Mesin, pilih 5.0.0.

    Formulir konfigurasi untuk cluster database dengan bidang untuk pengenal dan versi mesin.

  5. Di bagian Konfigurasi penyimpanan Cluster, pilih Amazon DocumentDB Standard (ini adalah opsi default).

    Pemilihan jenis penyimpanan dengan opsi Amazon DocumentDB Standard disorot dan kedua jenis penyimpanan dijelaskan.
    catatan

    Pilihan lain dalam kategori ini adalah Amazon DocumentDB I/O-Optimized. Untuk mempelajari lebih lanjut tentang salah satu opsi, lihat Konfigurasi penyimpanan cluster Amazon DocumentDB

  6. Di bagian konfigurasi Instance:

    1. Untuk kelas instance DB, pilih kelas yang dioptimalkan memori (termasuk kelas r) (ini default).

      Opsi contoh lainnya adalah NVMe-backed kelas. Untuk mempelajari selengkapnya, lihat NVMe-backed contoh.

    2. Untuk kelas Instance, pilih db.t3.medium. Ini memenuhi syarat untuk uji coba AWS gratis.

    3. Untuk Jumlah instance, pilih 1 instance. Memilih satu instans membantu meminimalkan biaya. Jika ini adalah sistem produksi, kami sarankan Anda menyediakan tiga instance untuk ketersediaan tinggi.

    Formulir konfigurasi untuk instance database dengan bidang untuk kelas instance DB, kelas instance yang didukung, dan jumlah instance.

  7. Di bagian Konektivitas, tinggalkan pengaturan default Jangan sambungkan ke sumber daya komputasi EC2.

    Pengaturan konektivitas untuk database dengan opsi untuk menghubungkan atau tidak terhubung ke sumber daya komputasi EC2.

  8. Di bagian Otentikasi, masukkan nama pengguna untuk pengguna utama, lalu pilih Dikel ola sendiri. Masukkan kata sandi, lalu konfirmasikan.

    Jika Anda memilih Man aged in AWS Secrets Manager, lihat Manajemen kata sandi dengan Amazon DocumentDB dan AWS Secrets Manager untuk informasi selengkapnya.

    Pemilihan jenis otentikasi dengan AWS Secrets Manager opsi Terkelola disorot dan kedua jenis otentikasi dijelaskan.

  9. Biarkan semua opsi lain sebagai default dan pilih Buat cluster.

Amazon DocumentDB sekarang menyediakan klaster Anda, dan penyelesaian proses ini dapat memakan waktu hingga beberapa menit.

catatan

Untuk informasi tentang nilai status cluster, lihat Nilai status cluster di bagian Memantau Amazon DocumentDB.

Langkah 2: Hubungkan ke cluster Anda

Hubungkan ke cluster Amazon DocumentDB Anda menggunakan AWS CloudShell.

  1. Di konsol manajemen Amazon DocumentDB, di bawah Clu ster, cari cluster yang Anda buat. Pilih cluster Anda dengan mengklik kotak centang di sebelahnya.

    Antarmuka manajemen cluster Amazon DocumentDB menampilkan cluster regional dengan detail instans utama

  2. Pilih Hu bungkan ke cluster (yang berada di sebelah menu tarik - turun Tindakan). Tombol ini diaktifkan hanya setelah Anda mengklik kotak centang di sebelah cluster Anda, dan status cluster regional dan instans utama ditampilkan sebagai Ter sedia. L CloudShell ayar perintah Run muncul.

  3. Di bidang Nama lingkungan baru, masukkan nama unik, seperti “uji” dan pilih Buat dan jalankan. Detail lingkungan VPC secara otomatis dikonfigurasi untuk database Amazon DocumentDB Anda.

    Cluster cluster CloudShell Jalankan layar perintah meminta nama lingkungan baru

  4. Saat diminta, masukkan kata sandi yang Anda buat di Langkah 1: Buat cluster Amazon DocumentDB (sub-langkah 7).

    L CloudShell ayar cluster meminta kata sandi pengguna

    Setelah Anda memasukkan kata sandi dan permintaan Anda menjadirs0 [direct: primary] <env-name>>, Anda berhasil terhubung ke cluster Amazon DocumentDB Anda.

catatan

Untuk informasi pemecahan masalah, lihat Memecahkan Masalah Amazon DocumentDB.

Langkah 3: Sisipkan dan kueri data

Sekarang setelah Anda terhubung ke klaster, Anda dapat menjalankan beberapa kueri untuk mengenali penggunaan basis data dokumen.

  1. Untuk memasukkan satu dokumen, masukkan hal berikut ini:

    db.collection.insertOne({"hello":"DocumentDB"})

    Anda mendapatkan output berikut ini:

    {
  acknowledged: true,
  insertedId: ObjectId('673657216bdf6258466b128c')
}

  2. Anda dapat membaca dokumen yang Anda tulis dengan perintah findOne() (karena hanya mengembalikan satu dokumen). Masukkan yang berikut ini:

    db.collection.findOne()

    Anda mendapatkan output berikut ini:

    { "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" }

  3. Untuk mengajukan beberapa kueri lagi, pertimbangkan kasus penggunaan profil game. Pertama, masukkan beberapa entri ke dalam koleksi berjudul profiles. Masukkan yang berikut ini:

    db.profiles.insertMany([{ _id: 1, name: 'Matt', status: 'active', level: 12, score: 202 }, 
      { _id: 2, name: 'Frank', status: 'inactive', level: 2, score: 9 }, 
      { _id: 3, name: 'Karen', status: 'active', level: 7, score: 87 }, 
      { _id: 4, name: 'Katie', status: 'active', level: 3, score: 27 }
])

    Anda mendapatkan output berikut ini:

    { acknowledged: true, insertedIds: { '0': 1, '1': 2, '2': 3, '3': 4 } }

  4. Gunakan perintah find() untuk mengembalikan semua dokumen dalam koleksi profil. Masukkan berikut ini:

    db.profiles.find()

    Anda akan mendapatkan output yang akan cocok dengan data yang Anda ketik di Langkah 3.

  5. Gunakan kueri untuk satu dokumen dengan menggunakan filter. Masukkan yang berikut ini:

    db.profiles.find({name: "Katie"})

    Anda mendapatkan output berikut ini:

    { "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}

  6. Sekarang mari kita coba untuk menemukan profil dan memodifikasinya dengan menggunakan perintah findAndModify. Kami akan memberi pengguna Matt tambahan 10 poin dengan kode berikut:

    db.profiles.findAndModify({
        query: { name: "Matt", status: "active"},
        update: { $inc: { score: 10 } }
    })

    Anda mendapatkan output berikut (perhatikan bahwa skornya belum meningkat):

    {
    [{_id : 1, name : 'Matt', status: 'active', level: 12, score: 202}]

  7. Anda dapat memverifikasi bahwa skornya telah berubah dengan kueri berikut:

    db.profiles.find({name: "Matt"})

    Anda mendapatkan output berikut ini:

    { "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 212 }

Langkah 4: Jelajahi

Selamat! Anda telah berhasil menyelesaikan panduan Memulai untuk cluster berbasis instance Amazon DocumentDB.

Apa selanjutnya? Pelajari cara memanfaatkan basis data ini sepenuhnya dengan beberapa fitur populernya:

catatan

Cluster yang Anda buat dari latihan memulai ini akan terus menghasilkan biaya kecuali Anda menghapusnya. Untuk mengetahui petunjuknya, lihat Menghapus Klaster Amazon DocumentDB.