Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memulai 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](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 CloudShell dan gratis. Jika AWS CloudShell lingkungan Anda atau klaster 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 lima menit.
**catatan**
Petunjuk dalam panduan ini khusus untuk membuat dan menghubungkan ke cluster berbasis instans Amazon DocumentDB tempat Amazon DocumentDB dan tersedia. AWS CloudShell
Jika Anda ingin membuat dan terhubung ke cluster elastis Amazon DocumentDB, lihat. [Memulai dengan cluster elastis Amazon DocumentDB](elastic-get-started.md)
Jika Anda berlokasi di Wilayah AWS Tiongkok, [Hubungkan Amazon EC2 secara otomatis](connect-ec2-auto.md) lihat.
**Topics**
+ [
## Prasyarat
](#quickstart-prerequisites)
+ [
## Langkah 1: Buat cluster
](#get-start-cluster)
+ [
## Langkah 2: Connect ke cluster Anda
](#get-start-connectcluster)
+ [
## Langkah 3: Masukkan dan kueri data
](#get-start-insert-query)
+ [
## Langkah 4: Jelajahi
](#get-start-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 memiliki Akun AWS, selesaikan langkah-langkah berikut untuk membuatnya.
**Untuk mendaftar untuk Akun AWS**
1. Buka [https://portal.aws.amazon.com/billing/pendaftaran.](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 untuk sebuah Akun AWS, sebuah *Pengguna root akun AWS*dibuat. 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
**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 kredensional yang dapat digunakan untuk AWS mengautentikasi permintaan Anda. Untuk informasi selengkapnya, lihat [Identity and Access Management untuk Amazon DocumentDB](security-iam.md).
1. Di bilah pencarian Konsol Manajemen AWS, ketik IAM dan pilih **IAM** di menu tarik-turun yang muncul.
1. Setelah Anda berada di konsol IAM, pilih **Pengguna** dari panel navigasi.
1. Pilih nama pengguna Anda.
1. Klik **Tambahkan izin**.
1. Pilih **Lampirkan kebijakan secara langsung**.
1. Ketik `AmazonDocDBFullAccess` di bilah pencarian dan pilih itu setelah muncul di hasil pencarian.
1. Klik **Berikutnya**.
1. Klik **Tambahkan izin**.
****
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*](https://docs.aws.amazon.com/vpc/latest/userguide/create-vpc.html).
## 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 /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di konsol manajemen Amazon DocumentDB, di bawah **Klaster**, pilih **Buat**.
![\[Dasbor Cluster kosong dengan opsi untuk membuat cluster baru dan mengelola sumber daya.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec-gs-start.png)
1. Pada halaman cluster Create Amazon DocumentDB, di bagian tipe **Cluster, pilih cluster** **berbasis Instance** (ini adalah opsi default).
![\[Pemilihan tipe cluster dengan opsi Instance Based Cluster disorot dan kedua tipe cluster dijelaskan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-cluster/cluster-type.png)
**catatan**
Pilihan lain dalam kategori ini adalah **cluster elastis**. Untuk mempelajari selengkapnya tentang cluster elastis Amazon DocumentDB, lihat [Menggunakan cluster elastis Amazon DocumentDB](docdb-using-elastic-clusters.md)
1. Di bagian **konfigurasi Cluster**:
1. Untuk **pengidentifikasi Cluster**, masukkan nama unik, seperti**mydocdbcluster**. Perhatikan bahwa konsol akan mengubah semua nama cluster menjadi huruf kecil terlepas dari bagaimana mereka dimasukkan.
1. Untuk **versi Engine**, pilih **5.0.0**.
![\[Formulir konfigurasi untuk cluster database dengan bidang untuk pengenal dan versi mesin.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-cluster/cluster-config.png)
1. 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.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-cluster/cluster-storage.png)
**catatan**
Opsi lain dalam kategori ini adalah **Amazon DocumentDB I/O-Optimized**. Untuk mempelajari lebih lanjut tentang salah satu opsi, lihat [Konfigurasi penyimpanan klaster Amazon DocumentDB](db-cluster-storage-configs.md)
1. Di bagian **konfigurasi Instans**:
1. Untuk **kelas instans DB**, pilih **kelas yang dioptimalkan memori (termasuk kelas r)** (ini adalah default).
Opsi instance lainnya adalah **kelas NVMe yang didukung**. Untuk mempelajari selengkapnya, lihat [NVMecontoh -didukung](db-instance-nvme.md).
1. Untuk **kelas Instance**, pilih **db.t3.medium**. Ini memenuhi syarat untuk uji coba AWS gratis.
1. 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 instans DB, kelas instance yang didukung, dan jumlah instance.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-cluster/instance-config.png)
1. Di bagian **Konektivitas**, biarkan pengaturan default **Jangan sambungkan ke sumber daya EC2 komputasi**.
![\[Pengaturan konektivitas untuk database dengan opsi untuk terhubung atau tidak terhubung ke sumber daya EC2 komputasi.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-cluster/cluster-connectivity-no-ec2.png)
1. Di bagian **Autentikasi**, masukkan nama pengguna untuk pengguna utama, lalu pilih **Self managed**. Masukkan kata sandi, lalu konfirmasikan.
Jika Anda memilih **Managed in AWS Secrets Manager**, lihat [Manajemen kata sandi dengan Amazon DocumentDB dan AWS Secrets Manager](docdb-secrets-manager.md) untuk informasi selengkapnya.
![\[Pemilihan jenis otentikasi dengan AWS Secrets Manager opsi Dikelola dalam disorot dan kedua jenis otentikasi dijelaskan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-cluster/cluster-auth-self.png)
1. 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 klaster, lihat [Nilai status cluster](monitoring_docdb-cluster_status.md#monitoring_docdb-status_values) di bagian Memantau Amazon DocumentDB.
## Langkah 2: Connect ke cluster Anda
Connect ke cluster Amazon DocumentDB Anda menggunakan. AWS CloudShell
1. Di konsol manajemen Amazon DocumentDB, **di bawah** Clusters, temukan klaster yang Anda buat. Pilih klaster Anda dengan mengklik kotak centang di sebelahnya.
![\[Antarmuka manajemen klaster Amazon DocumentDB menampilkan klaster regional dengan detail instans utama\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/cluster-connect-cloud-shell.png)
1. Klik **Connect to cluster** (yang berada di sebelah menu dropdown **Actions**). **Tombol ini diaktifkan hanya setelah Anda mengklik kotak centang di sebelah klaster Anda, dan status cluster regional dan instance utama ditampilkan sebagai Tersedia.** Layar **perintah CloudShell Jalankan** muncul.
1. 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.
![\[Cluster cluster CloudShell Jalankan layar perintah meminta nama lingkungan baru\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec-gs-run-command.png)
1. Saat diminta, masukkan kata sandi yang Anda buat di Langkah 1: Buat klaster Amazon DocumentDB (sub-langkah 7).
![\[CloudShell Layar cluster meminta kata sandi pengguna\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec-gs-cs-password.png)
Setelah Anda memasukkan kata sandi dan prompt Anda menjadi`rs0 [direct: primary] >`, Anda berhasil terhubung ke cluster Amazon DocumentDB Anda.
**catatan**
Untuk informasi pemecahan masalah, lihat [Memecahkan Masalah Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/troubleshooting.html).
## Langkah 3: Masukkan 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')
}
```
1. 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" }
```
1. 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 } }
```
1. 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.
1. 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}
```
1. 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}]
```
1. 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\$1 Anda telah berhasil menyelesaikan panduan Memulai untuk klaster berbasis instans Amazon DocumentDB.
Apa selanjutnya? Pelajari cara memanfaatkan basis data ini sepenuhnya dengan beberapa fitur populernya:
+ [Mengelola Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/managing-documentdb.html)
+ [Penskalaan](https://docs.aws.amazon.com/documentdb/latest/developerguide/operational_tasks.html)
+ [Mencadangkan dan memulihkan](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup_restore.html)
**catatan**
Cluster yang Anda buat dari latihan memulai ini akan terus bertambah biaya kecuali Anda menghapusnya. Untuk mengetahui petunjuknya, lihat [Menghapus Klaster Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-delete.html).