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 CloudShelluntuk menghubungkan dan menanyakan cluster Amazon DocumentDB Anda langsung dari. AWS Management Console Pelanggan baru yang memenuhi syarat untuk Tingkat AWS Gratis dapat menggunakan Amazon DocumentDB CloudShell dan gratis. Jika AWS CloudShell lingkungan Anda atau cluster elastis Amazon DocumentDB menggunakan sumber daya di luar tingkat gratis, Anda akan dikenakan tarif AWS normal untuk sumber daya tersebut. Panduan ini akan membantu Anda memulai 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 memiliki Akun AWS, selesaikan langkah-langkah berikut untuk membuatnya.

Untuk mendaftar untuk Akun AWS
  1. Buka https://portal.aws.amazon.com/billing/pendaftaran.

  2. Ikuti petunjuk online.

    Bagian dari prosedur pendaftaran melibatkan tindakan menerima panggilan telepon dan memasukkan kode verifikasi di keypad telepon.

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

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

Akses untuk mengelola sumber daya Amazon DocumentDB seperti cluster, instance, dan grup parameter cluster memerlukan kredensil yang dapat digunakan untuk AWS mengautentikasi permintaan Anda. Untuk informasi selengkapnya, lihat Identity and Access Management untuk Amazon DocumentDB.

  1. Di bilah pencarian AWS Management Console, ketik 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. Klik Tambahkan izin.

  5. Pilih Lampirkan kebijakan secara langsung.

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

  7. Klik Berikutnya.

  8. Klik Tambahkan izin.

catatan

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

Langkah 1: Buat cluster elastis

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

Using the AWS Management Console

Untuk membuat konfigurasi cluster elastis menggunakan AWS Management Console:

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

  2. Di Amazon DocumentDB Management Console, di bawah Clusters, pilih Create.

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

    Dialog tipe cluster elastis yang menampilkan pilihan cluster berbasis Instance 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 hitungan instance Shard, pilih jumlah instance replika yang ingin Anda kaitkan dengan setiap pecahan. Jumlah maksimum instance shard adalah 16, dengan penambahan 1. Semua contoh replika memiliki kapasitas pecahan yang sama seperti yang didefinisikan dalam bidang berikut. Untuk tujuan pengujian, nilai default 2 sudah cukup.

      catatan

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

    4. Di bidang kapasitas Shard, pilih jumlah virtual CPUs (vCPUs) yang ingin Anda kaitkan dengan setiap instance shard. Jumlah maksimum v CPUs per instance shard adalah 64. Nilai yang diizinkan adalah 2, 4, 8, 16, 32, 64. Untuk tujuan pengujian, nilai default 2 sudah cukup.

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

    6. Untuk grup keamanan Subnet dan 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 saat istirahat untuk cluster elastis Amazon DocumentDB.

    penting

    Enkripsi harus diaktifkan untuk cluster elastis.

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

    Screenshot dari dialog Backup yang 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 cadangan 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 backup dibuat.

  8. Di bagian Maintenance, 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 sedang disediakan. Ini bisa memakan waktu hingga beberapa menit untuk menyelesaikannya. Anda dapat terhubung ke klaster Anda ketika status cluster elastis ditampilkan sebagai Tersedia dalam daftar Clusters.

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 v yang CPUs ditetapkan untuk setiap pecahan. Maksimal 64. Nilai yang diizinkan adalah 2, 4, 8, 16, 32, 64.

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

  • --shard-instance-count—Opsional. Jumlah contoh replika yang diterapkan ke semua pecahan di cluster ini. Maksimal adalah 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 untuk mengambil password 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 selama pemeliharaan sistem dapat terjadi, di Universal Coordinated Time (UTC).

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

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

    Jendela minimal 30 menit.

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

    Pengidentifikasi kunci KMS adalah Amazon Resource Name (ARN) untuk kunci enkripsi. AWS KMS 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 KmsKeyId dan jika StorageEncrypted parameternya benar, Amazon DocumentDB menggunakan kunci enkripsi default Anda.

  • --preferred-backup-window—Opsional. Rentang waktu harian yang disukai selama pencadangan 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 penyimpanan cadangan otomatis. Nilai default adalah 1.

  • --storage-encrypted—Opsional. Mengkonfigurasikan 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: Connect ke cluster elastis Anda

Connect ke cluster elastis Amazon DocumentDB Anda menggunakan. AWS CloudShell

  1. Di konsol manajemen Amazon DocumentDB, di bawah Clusters, temukan cluster elastis yang Anda buat. Pilih klaster Anda dengan mengklik kotak centang di sebelahnya.

    Antarmuka manajemen cluster Amazon DocumentDB menunjukkan cluster elastis
  2. Klik Connect to cluster (yang berada di sebelah menu dropdown Actions. Tombol ini diaktifkan hanya setelah Anda mengklik kotak centang di sebelah cluster Anda, dan status klaster ditampilkan sebagai Tersedia. Layar perintah CloudShell Jalankan muncul.

  3. Di bidang Nama lingkungan baru, masukkan nama unik, seperti “uji” dan klik 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).

    CloudShell Layar cluster elastis meminta kata sandi pengguna

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

catatan

Untuk informasi pemecahan masalah, lihat Memecahkan Masalah Amazon DocumentDB.

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

Cluster elastis menambahkan dukungan untuk sharding di Amazon DocumentDB. Sekarang Anda terhubung ke cluster Anda, Anda dapat menghancurkan 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 levelnya belum berubah):

    {
 _id: ObjectId('679d02cd6b5a0581be78bcbd'),
 Employeeid: 1,
 name: 'Matt',
 lastname: 'Winkle',
 level: 12
 }
  8. Untuk memverifikasi peningkatan 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 Memulai 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 bertambah biaya kecuali Anda menghapusnya. Untuk petunjuk arah, lihatMenghapus cluster elastis.