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](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) 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.
**Topics**
+ [Prasyarat](#elastic-clusters-prerequisites)
+ [Langkah 1: Buat cluster elastis](#elastic-get-started-clusters)
+ [Langkah 2: Hubungkan ke cluster elastis Anda](#ec-gs-connect)
+ [Langkah 3: Pecahkan koleksi Anda, sisipkan, dan kueri data](#elastic-get-started-shard)
+ [Langkah 4: Jelajahi](#ec-gs-congrats)
## 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](https://portal.aws.amazon.com/billing/signup).
1. 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
**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](security-iam.md).
1. Di bilah pencarian Konsol Manajemen AWS, masukkan **IAM** dan pilih ** IAM ** di menu tarik-turun.
1. Setelah Anda berada di konsol IAM, pilih **Pengguna** dari panel navigasi.
1. Pilih nama pengguna Anda.
1. Pilih **Tambahkan izin**.
1. Pilih Lamp ** irkan kebijakan secara langsung**.
1. Ketik `AmazonDocDBElasticFullAccess` di bilah pencarian dan pilih itu setelah muncul di hasil pencarian.
1. Pilih **Berikutnya**.
1. Pilih **Tambahkan izin**.
****
AWS Akun Anda menyertakan VPC default di setiap Wilayah. Jika Anda memilih untuk menggunakan Amazon VPC, selesaikan langkah-langkah dalam [ topik ](https://docs.aws.amazon.com/vpc/latest/userguide/create-vpc.html) 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](https://console.aws.amazon.com/docdb).
1. Di ** Amazon DocumentDB Management Console**, di bawah ** Cluster**, pilih ** Buat**.
1. Pada ** halaman ** Create Amazon DocumentDB cluster, di ** bagian ** Cluster type, pilih ** Elastic cluster**.
1. Di ** bagian ** Konfigurasi, konfigurasikan yang berikut ini:
1. Di ** bidang Nama ** cluster, masukkan pengidentifikasi cluster unik (mengikuti persyaratan penamaan di bawah bidang).
1. 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.
1. 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.
1. 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.
1. Di ** bidang ** Virtual Private Cloud (VPC), pilih VPC dari daftar dropdown.
1. Untuk ** Subnets ** dan ** grup keamanan VPC**, Anda dapat menggunakan default atau memilih tiga subnet pilihan Anda dan hingga tiga grup ** keamanan ** VPC (minimal satu).
1. 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.
1. 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](elastic-encryption.md).
**penting**
Enkripsi harus diaktifkan untuk cluster elastis.
1. Di ** bagian ** Cadangan, edit bidang sesuai dengan persyaratan cadangan Anda. Untuk tujuan pengujian, Anda dapat mempertahankan pengaturan default.
1. **Periode retensi cadangan**—Dalam daftar, pilih jumlah hari untuk menyimpan backup otomatis klaster ini sebelum menghapusnya.
1. **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.
1. Pilih ** Tidak ada preferensi ** jika Anda ingin Amazon DocumentDB memilih waktu dan durasi saat cadangan dibuat.
1. Di ** bagian ** Pemeliharaan, pilih hari, waktu, dan durasi saat modifikasi atau patch diterapkan ke cluster Anda. Untuk tujuan pengujian, Anda dapat mempertahankan pengaturan default.
1. 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` atau`SECRET_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-encrypted`menentukan 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.
1. 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.
1. 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.
1. Saat diminta, masukkan kata sandi yang Anda buat di Langkah 1: Buat cluster elastis Amazon DocumentDB (sub-langkah 5).
Setelah Anda memasukkan kata sandi dan permintaan Anda menjadi`direct: mongos] >`, Anda berhasil terhubung ke cluster Amazon DocumentDB
**catatan**
Untuk informasi pemecahan masalah, lihat [Memecahkan Masalah Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/devguide/troubleshooting.html).
## 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" })
```
1. 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 })
```
1. 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
}
```
1. 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')
}
}
```
1. Untuk mengembalikan semua dokumen dalam koleksi profil, masukkan perintah `find` ():
```
db.Employee.find()
```
Data yang Anda masukkan pada langkah 4 ditampilkan.
1. 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
}
]
```
1. 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
}
```
1. 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:
+ [Praktik terbaik cluster elastis Amazon DocumentDB](elastic-best-practices.md)
+ [Mengelola cluster elastis Amazon DocumentDB](elastic-managing.md)
**catatan**
Cluster elastis yang Anda buat dari prosedur memulai ini akan terus menambah biaya kecuali Anda menghapusnya. Untuk petunjuk arah, lihat[Menghapus cluster elastis](elastic-managing.md#elastic-delete).