View a markdown version of this page

Memulai dengan cluster elastis Amazon DocumentDB - Amazon DocumentDB

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

Memulai dengan cluster elastis Amazon DocumentDB

Bagian memulai ini memandu Anda tentang bagaimana Anda dapat membuat dan menanyakan cluster elastis pertama Anda.

Ada banyak cara untuk terhubung dan memulai dengan Amazon DocumentDB. Prosedur berikut 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 Anda atau cluster elastis 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 5 menit.

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.

  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 AmazonDocDBElasticFullAccess 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 elastis

Pada bagian ini kami menjelaskan cara membuat cluster elastis baru, menggunakan Konsol Manajemen AWS atau AWS CLI dengan instruksi berikut.

Using the Konsol Manajemen AWS

Untuk membuat konfigurasi cluster elastis menggunakan Konsol Manajemen AWS:

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

  2. Di Amazon DocumentDB Management Console, di bawah Cluster, pilih Buat.

    Tabel cluster elastis tidak menunjukkan cluster sebagai titik awal.
  3. Pada halaman Create Amazon DocumentDB cluster, di bagian Cluster type, pilih Elastic cluster.

    Dialog tipe cluster elastis menampilkan pilihan Instance-based cluster dan cluster elastis.
  4. Di bagian Konfigurasi, konfigurasikan yang berikut ini:

    1. Di bidang Nama cluster, masukkan pengidentifikasi cluster unik (mengikuti persyaratan penamaan di bawah bidang).

    2. Di bidang Shard count, masukkan jumlah pecahan yang Anda inginkan di cluster Anda. Jumlah maksimum pecahan per cluster adalah 32.

      catatan

      Dua node akan digunakan untuk setiap pecahan. Kedua node akan memiliki kapasitas shard yang sama.

    3. Di bidang jumlah instance Shard, pilih jumlah instance replika yang ingin Anda kaitkan dengan setiap pecahan. Jumlah maksimum instance shard adalah 16, dengan penambahan 1. Semua instance replika memiliki kapasitas pecahan yang sama seperti yang didefinisikan di bidang berikut. Untuk tujuan pengujian, nilai default 2 harus cukup.

      catatan

      Jumlah instance replika berlaku untuk semua pecahan dalam cluster elastis. Nilai hitungan instance shard 1 berarti ada satu instance penulis, dan setiap instance tambahan adalah replika yang dapat digunakan untuk membaca dan meningkatkan ketersediaan. Untuk tujuan pengujian, nilai default 2 harus cukup.

    4. Di bidang Kapasitas Shard, pilih jumlah CPU virtual (vCPU) yang ingin Anda kaitkan dengan setiap instans shard. Jumlah maksimum vCPU per instance shard adalah 64. Nilai yang diizinkan adalah 2, 4, 8, 16, 32, 64. Untuk tujuan pengujian, nilai default 2 harus cukup.

    5. Di bidang Virtual Private Cloud (VPC), pilih VPC dari daftar dropdown.

    6. Untuk Subnets dan grup keamanan VPC, Anda dapat menggunakan default atau memilih tiga subnet pilihan Anda dan hingga tiga grup keamanan VPC (minimal satu).

    Dialog konfigurasi cluster elastis menampilkan bidang yang dapat dikonfigurasi.
  5. Di bagian Otentikasi, masukkan string yang mengidentifikasi nama login pengguna utama di bidang Nama Pengguna.

    Di bidang Kata Sandi, masukkan kata sandi unik yang sesuai dengan instruksi, lalu konfirmasikan.

    Bagian otentikasi yang mencakup bidang input untuk nama pengguna dan kata sandi.
  6. Di bagian Enkripsi, pertahankan pengaturan default (Kunci Default).

    Secara opsional, Anda dapat memasukkan AWS KMS key ARN yang Anda buat. Untuk informasi selengkapnya, lihat Enkripsi data diam untuk cluster elastis Amazon DocumentDB.

    penting

    Enkripsi harus diaktifkan untuk cluster elastis.

  7. Di bagian Cadangan, edit bidang sesuai dengan persyaratan cadangan Anda. Untuk tujuan pengujian, Anda dapat mempertahankan pengaturan default.

    Tangkapan layar dialog Cadangan menunjukkan langkah-langkah untuk mengkonfigurasi jendela cadangan cluster.
    1. Periode retensi cadangan—Dalam daftar, pilih jumlah hari untuk menyimpan backup otomatis klaster ini sebelum menghapusnya.

    2. Jendela backup—Atur waktu harian dan durasi yang akan digunakan oleh Amazon DocumentDB untuk membuat backup dari klaster ini.

      1. Pilih Pilih jendela jika Anda ingin mengonfigurasi waktu dan durasi saat backup dibuat.

        Waktu mulai—Pada daftar pertama, pilih jam waktu mulai (UTC) untuk memulai pencadangan otomatis. Dalam daftar kedua, pilih menit dari jam pilihan Anda untuk memulai backup otomatis.

        Durasi—Dalam daftar, pilih jumlah jam yang akan dialokasikan untuk membuat cadangan otomatis.

      2. Pilih Tidak ada preferensi jika Anda ingin Amazon DocumentDB memilih waktu dan durasi saat cadangan dibuat.

  8. Di bagian Pemeliharaan, pilih hari, waktu, dan durasi saat modifikasi atau patch diterapkan ke cluster Anda. Untuk tujuan pengujian, Anda dapat mempertahankan pengaturan default.

    Bagian pemeliharaan menunjukkan opsi jendela pemeliharaan.
  9. Pilih Buat klaster.

Cluster elastis sekarang disediakan. Ini bisa memakan waktu hingga beberapa menit untuk menyelesaikannya. Anda dapat terhubung ke cluster Anda ketika status cluster elastis ditampilkan sebagai Ter sedia dalam daftar Cluster.

Using the AWS CLI

Untuk membuat cluster elastis menggunakan AWS CLI, gunakan create-cluster operasi dengan parameter berikut:

  • --cluster-name—Wajib. Nama saat ini dari cluster skala elastis seperti yang dimasukkan selama pembuatan atau terakhir dimodifikasi.

  • --shard-capacity—Wajib. Jumlah vCPU yang ditetapkan untuk setiap pecahan. Maksimal 64. Nilai yang diizinkan adalah 2, 4, 8, 16, 32, 64.

  • --shard-count—Wajib. Jumlah pecahan yang ditetapkan ke cluster. Maksimal adalah 32.

  • --shard-instance-count—Opsional. Jumlah instance replika yang berlaku untuk semua pecahan di cluster ini. Maksimal 16.

  • --admin-user-name—Wajib. Nama pengguna yang terkait dengan pengguna admin.

  • --admin-user-password—Wajib. Kata sandi yang terkait dengan pengguna admin.

  • --auth-type—Wajib. Jenis otentikasi yang digunakan untuk menentukan di mana mengambil kata sandi yang digunakan untuk mengakses cluster elastis. Jenis yang valid adalah PLAIN_TEXT atauSECRET_ARN.

  • --vpc-security-group-ids—Opsional. Konfigurasikan daftar grup keamanan EC2 VPC untuk dikaitkan dengan cluster ini.

  • --preferred-maintenance-window—Opsional. Konfigurasikan rentang waktu mingguan di mana pemeliharaan sistem dapat terjadi, dalam Waktu Terkoordinasi Universal (UTC).

    Formatnya adalah:ddd:hh24:mi-ddd:hh24:mi. Hari yang berlaku (ddd): Senin, Sel, Rabu, Kamis, Jumat, Sabtu, Minggu

    Defaultnya adalah jendela 30 menit yang dipilih secara acak dari blok waktu 8 jam untuk setiap Wilayah Layanan Web Amazon, yang terjadi pada hari acak dalam seminggu.

    Jendela minimal 30 menit.

  • --kms-key-id—Opsional. Konfigurasikan pengenal kunci KMS untuk cluster terenkripsi.

    Pengidentifikasi kunci KMS adalah Amazon Resource Name (ARN) untuk kunci en AWS KMS kripsi. Jika Anda membuat cluster menggunakan akun Amazon Web Services yang sama yang memiliki kunci enkripsi KMS yang digunakan untuk mengenkripsi cluster baru, Anda dapat menggunakan alias kunci KMS alih-alih ARN untuk kunci enkripsi KMS.

    Jika kunci enkripsi tidak ditentukan dalam KmsKeyId dan jika StorageEncrypted parameternya benar, Amazon DocumentDB menggunakan kunci enkripsi default Anda.

  • --preferred-backup-window—Opsional. Rentang waktu pilihan harian di mana backup otomatis dibuat. Defaultnya adalah jendela 30 menit yang dipilih secara acak dari blok waktu 8 jam untuk masing-masing Wilayah AWS.

  • --backup-retention-period—Opsional. Jumlah hari cadangan otomatis dipertahankan. Nilai default adalah 1.

  • --storage-encrypted—Opsional. Mengkonfigurasi apakah cluster dienkripsi atau tidak dienkripsi.

    --no-storage-encryptedmenentukan bahwa cluster tidak dienkripsi.

  • --subnet-ids—Opsional. Konfigurasikan ID subnet jaringan.

Dalam contoh berikut, ganti masing-masing user input placeholder dengan informasi Anda sendiri.

catatan

Contoh berikut termasuk pembuatan kunci KMS tertentu. Untuk menggunakan kunci KMS default, jangan sertakan --kms-key-id parameter.

Untuk Linux, macOS, atau Unix:

aws docdb-elastic create-cluster \ --cluster-name sample-cluster-123 \ --shard-capacity 8 \ --shard-count 4 \ --shard-instance-count 3 \ --auth-type PLAIN_TEXT \ --admin-user-name testadmin \ --admin-user-password testPassword \ --vpc-security-group-ids ec-65f40350 \ --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9 \ --preferred-backup-window 18:00-18:30 \ --backup-retention-period 7

Untuk Windows:

aws docdb-elastic create-cluster ^ --cluster-name sample-cluster-123 ^ --shard-capacity 8 ^ --shard-count 4 ^ --shard-instance-count 3 ^ --auth-type PLAIN_TEXT ^ --admin-user-name testadmin ^ --admin-user-password testPassword ^ --vpc-security-group-ids ec-65f40350 ^ --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9 \ --preferred-backup-window 18:00-18:30 \ --backup-retention-period 7

Langkah 2: Hubungkan ke cluster elastis Anda

Hubungkan ke cluster elastis Amazon DocumentDB Anda menggunakan AWS CloudShell.

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

    Antarmuka manajemen cluster Amazon DocumentDB menunjukkan cluster elastis
  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 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.

    Layar perintah CloudShell Jalankan cluster elastis meminta nama lingkungan baru
  4. Saat diminta, masukkan kata sandi yang Anda buat di Langkah 1: Buat cluster elastis Amazon DocumentDB (sub-langkah 5).

    L CloudShell ayar cluster elastis meminta kata sandi pengguna

    Setelah Anda memasukkan kata sandi dan permintaan Anda menjadidirect: mongos] <env-name>>, Anda berhasil terhubung ke cluster Amazon DocumentDB

catatan

Untuk informasi pemecahan masalah, lihat Memecahkan Masalah Amazon DocumentDB.

Langkah 3: Pecahkan koleksi Anda, sisipkan, dan kueri data

Cluster elastis menambahkan dukungan untuk sharding di Amazon DocumentDB. Sekarang setelah Anda terhubung ke cluster Anda, Anda dapat memecah cluster, menyisipkan data, dan menjalankan beberapa kueri.

  1. Untuk memecah koleksi, masukkan yang berikut ini:

    sh.shardCollection("db.Employee1" , { "Employeeid" : "hashed" })
  2. Untuk memasukkan satu dokumen, masukkan hal berikut ini:

    db.Employee1.insertOne({"Employeeid":1, "Name":"Joe", "LastName": "Bruin", "level": 1 })

    Output berikut ditampilkan:

    WriteResult({ "nInserted" : 1 })
  3. Untuk membaca dokumen yang Anda tulis, masukkan findOne() perintah (mengembalikan satu dokumen):

    db.Employee1.findOne()

    Output berikut ditampilkan:

    { "_id" : ObjectId("61f344e0594fe1a1685a8151"), "EmployeeID" : 1, "Name" : "Joe", "LastName" : "Bruin", "level" : 1 }
  4. Untuk melakukan beberapa pertanyaan lagi, pertimbangkan kasus penggunaan profil game. Pertama, masukkan beberapa entri ke dalam koleksi berjudul “Karyawan”. 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 } ])

    Output berikut ditampilkan:

    { acknowledged: true, insertedIds: { '0': ObjectId('679d02cd6b5a0581be78bcbd'), '1': ObjectId('679d02cd6b5a0581be78bcbe'), '2': ObjectId('679d02cd6b5a0581be78bcbf'), '3': ObjectId('679d02cd6b5a0581be78bcc0') } }
  5. Untuk mengembalikan semua dokumen dalam koleksi profil, masukkan perintah find ():

    db.Employee.find()

    Data yang Anda masukkan pada langkah 4 ditampilkan.

  6. Untuk menanyakan satu dokumen, sertakan filter (misalnya: “Katie”). Masukkan yang berikut ini:

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

    Output berikut ditampilkan:

    [
 {
 _id: ObjectId('679d02cd6b5a0581be78bcc0'),
 Employeeid: 4,
 name: 'Katie',
 lastname: 'Schaper',
 level: 3
 }
 ]
  7. Untuk menemukan profil dan memodifikasinya, masukkan findAndModify perintah. Dalam contoh ini, karyawan “Matt” diberi level “14" yang lebih tinggi:

    db.Employee.findAndModify({ query: { "Employeeid" : 1, "name" : "Matt"}, update: { "Employeeid" : 1, "name" : "Matt", "lastname" : "Winkle", "level" : 14 } })

    Output berikut ditampilkan (perhatikan bahwa level belum berubah):

    {
 _id: ObjectId('679d02cd6b5a0581be78bcbd'),
 Employeeid: 1,
 name: 'Matt',
 lastname: 'Winkle',
 level: 12
 }
  8. Untuk memverifikasi kenaikan level, masukkan kueri berikut:

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

    Output berikut ditampilkan:

    [ {
 _id: ObjectId('679d02cd6b5a0581be78bcbd'),
 Employeeid: 1,
 name: 'Matt',
 lastname: 'Winkle',
 level: 14
 } ]

Langkah 4: Jelajahi

Selamat! Anda telah berhasil menyelesaikan prosedur Mulai untuk cluster elastis Amazon DocumentDB.

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

catatan

Cluster elastis yang Anda buat dari prosedur memulai ini akan terus menambah biaya kecuali Anda menghapusnya. Untuk petunjuk arah, lihatMenghapus cluster elastis.