Memulai dengan Amazon DocumentDB

Ada banyak cara untuk terhubung dan memulai dengan Amazon DocumentDB. Kami membuat panduan ini karena kami menemukan cara ini sebagai cara tercepat, paling sederhana dan termudah bagi pengguna untuk mulai menggunakan basis data dokumen kami yang kuat. Panduan ini menggunakan AWS Cloud9, terminal berbasis web untuk menghubungkan dan mengajukan kueri untuk klaster Amazon DocumentDB Anda dengan menggunakan mongo shell secara langsung dari AWS Management Console. Pelanggan baru yang memenuhi syarat untuk Tingkat AWS Gratis dapat menggunakan Amazon DocumentDB AWS Cloud9 dan gratis. Jika AWS Cloud9 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 15 menit.

catatan

Petunjuk dalam panduan ini khusus untuk membuat dan menghubungkan ke cluster berbasis instans Amazon DocumentDB. Jika Anda ingin membuat dan terhubung ke cluster elastis Amazon DocumentDB, lihat. Memulai dengan cluster elastis Amazon DocumentDB

Jika Anda lebih memilih untuk terhubung ke Amazon DocumentDB dari mesin lokal dengan membuat koneksi SSH ke instans Amazon EC2, silakan lihat petunjuk Hubungkan dengan EC2

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). Akun AWS 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 Akun AWS

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

2. Ikuti petunjuk secara online.

   Anda akan diminta untuk menerima panggilan telepon dan memasukkan kode verifikasi pada keypad telepon sebagai bagian dari prosedur pendaftaran.

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

Mengatur izin AWS Identity and Access Management (IAM) yang dibutuhkan.

Akses untuk mengelola sumber daya Amazon DocumentDB seperti klaster, instans, dan grup parameter klaster memerlukan kredensial yang AWS dapat digunakan untuk 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 pilihan menurun yang muncul.

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

3. Pilih nama pengguna Anda.

4. Klik tombol Tambahkan izin.

5. Pilih Lampirkan kebijakan yang ada secara langsung.

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

7. Klik tombol biru di bagian bawah yang bertuliskan Berikutnya: Tinjau.

8. Klik tombol biru di bagian bawah yang bertuliskan Tambahkan izin.

Buat Amazon Virtual Private Cloud (Amazon VPC)

Langkah ini diperlukan hanya jika Anda belum memiliki Amazon VPC default. Jika tidak, selesaikan langkah 1 dari Memulai Amazon VPC di Panduan Pengguna Amazon VPC. Ini akan memakan waktu kurang dari lima menit.

Langkah 1: Buat lingkungan AWS Cloud9

AWS Cloud9 menyediakan terminal berbasis web yang dapat Anda gunakan untuk terhubung dan mengajukan kueri klaster Amazon DocumentDB Anda dengan menggunakan shell mongo.

1. Dari navigasi AWS Management Console ke konsol AWS Cloud9 dan pilih Buat lingkungan.

   

2. Di bagian Detail dari dialog Buat lingkungan, masukkan DocumentDBCloud9 di bidang Nama.

   

3. Untuk bagian Instans EC2 Baru, Pengaturan Jaringan, dan Tag, biarkan pengaturan default apa adanya dan klik Buat di bagian bawah layar.

   

AWS Cloud9Lingkungan baru Anda muncul di tabel Lingkungan:

catatan

Penyediaan lingkungan AWS Cloud9 dapat memakan waktu hingga tiga menit.

Langkah 2: Membuat grup keamanan

Grup keamanan ini akan memungkinkan Anda untuk terhubung ke klaster Amazon DocumentDB Anda dari lingkungan AWS Cloud9 Anda.

1. Di Konsol Manajemen Amazon EC2, di bawah Jaringan dan Keamanan, pilih Grup keamanan.

   

2. Pilih Buat grup keamanan.

   

3. Di bagian Detail dasar:

   1. Untuk Nama grup keamanan, masukkan demoDocDB.

   2. Untuk Deskripsi, masukkan deskripsi.

   3. Untuk VPC, terima penggunaan VPC default Anda.

   

4. Di bagian Aturan masuk, pilih Tambahkan aturan.

   1. Untuk Jenis, pilih Aturan TCP Kustom.

   2. Untuk Rentang port, masukkan 27017.

   3. Untuk Sumber, pilih grup keamanan untuk AWS Cloud9 lingkungan yang baru saja Anda buat. Untuk melihat daftar grup keamanan yang tersedia, masukkan cloud9 di bidang pencarian di sisi kanan bidang Sumber. Pilih grup keamanan dengan nama aws-cloud9-<environment name>.

   4. Untuk Tujuan, pilih Kustom. Di bidang di sebelahnya, cari grup keamanan yang baru saja Anda buat bernama demoEC2. Anda mungkin perlu untuk me-refresh peramban Anda bagi konsol Amazon EC2 untuk mengisi otomatis nama sumber demoEC2.

   

   catatan

   Port 27017 adalah port default untuk Amazon DocumentDB.

5. Terima semua default lainnya dan pilih Buat grup keamanan.

   

Langkah 3: Buat klaster Amazon DocumentDB

Pada langkah ini, Anda akan membuat klaster Amazon DocumentDB dengan menggunakan grup keamanan yang Anda buat di langkah sebelumnya.

catatan

Petunjuk dalam langkah ini khusus untuk membuat cluster berbasis instans Amazon DocumentDB. Jika Anda ingin membuat cluster elastis Amazon DocumentDB, lihat. Memulai dengan cluster elastis Amazon DocumentDB

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

   

2. Pada halaman cluster Create Amazon DocumentDB, di bagian tipe Cluster, pilih Instance Based Clusters (ini adalah opsi default).

   

3. Di bagian Konfigurasi, pilih 1 instance. Memilih satu instans membantu meminimalkan biaya. Jika ini adalah sistem produksi, kami sarankan Anda menyediakan tiga instans untuk ketersediaan tinggi. Anda dapat meninggalkan pengaturan lain di bagian Konfigurasi pada defaultnya.

   

4. Untuk Konektivitas, biarkan pengaturan default Jangan sambungkan ke sumber daya komputasi EC2.

   

5. Di bagian Otentikasi, masukkan kredensi masuk.

   

6. Hidupkan Tampilkan pengaturan lanjutan.

   

7. Di bagian Pengaturan jaringan, untuk grup keamanan VPC, pilih DemoDocDB (VPC) jika Anda membuat cluster pengujian atau demo. Jika Anda membuat klaster untuk sistem produksi, pilih default (VPC) atau jika Anda ingin membuat grup keamanan VPC tertentu, lihat Grup keamanan di Panduan Pengguna Amazon Virtual Private Cloud.

   

8. Pilih Buat klaster.

   

Amazon DocumentDB sekarang menyediakan klaster Anda, dan penyelesaian proses ini dapat memakan waktu hingga beberapa menit. Anda dapat membuat koneksi ke klaster ketika klaster dan instans sama-sama menunjukkan status available.

catatan

Untuk informasi tentang nilai status klaster, lihat Nilai Status Klaster di bagian Memantau Amazon DocumentDB.

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

Langkah 4: Instal shell mongo

Anda sekarang akan menginstal mongo shell di lingkungan AWS Cloud9 yang Anda buat pada langkah 1. Mongo shell adalah utilitas baris perintah yang Anda gunakan untuk menghubungkan dan mengajukan kueri pada klaster Amazon DocumentDB Anda.

1. Jika lingkungan AWS Cloud9 Anda masih terbuka dari Langkah 1, kembali ke lingkungan tersebut dan langsung lanjutkan ke instruksi 3. Jika Anda menavigasi jauh dari AWS Cloud9 lingkungan Anda, di konsol AWS Cloud9 manajemen, di bawah Lingkungan, temukan lingkungan berlabel DocumentDbCloud9. Pilih Buka di kolom Cloud9 IDE.

   

2. Pada prompt perintah, buat file repositori dengan perintah berikut:

   echo -e "[mongodb-org-4.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2013.03/mongodb-org/4.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://www.mongodb.org/static/pgp/server-4.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-4.0.repo

3. Setelah selesai, instal mongo shell dengan perintah berikut:

   sudo yum install -y mongodb-org-shell

Langkah 5: Buat koneksi ke klaster Amazon DocumentDB Anda

Anda sekarang akan terhubung ke klaster Amazon DocumentDB dengan menggunakan mongo shell yang Anda instal di Langkah 4.

1. Di konsol manajemen Amazon DocumentDB, di bawah Klaster, temukan klasster Anda. Pilih klaster yang Anda buat dengan mengeklik pengidentifikasi klaster.

   

2. E ncryption-in-transit diaktifkan secara default di Amazon DocumentDB. Anda dapat menonaktifkan TLS secara opsional. Untuk mengunduh sertifikat saat ini yang diperlukan untuk mengautentikasi ke klaster Anda, di tab Konektivitas & keamanan, di bagian Connect, di bawah Unduh sertifikat Amazon DocumentDB Certificate Authority (CA) yang diperlukan untuk mengautentikasi ke cluster Anda, salin string koneksi yang disediakan. Kembali ke lingkungan AWS Cloud9 Anda dan rekatkan string koneksi.

   

3. Kembali ke cluster Anda di konsol Amazon DocumentDB, buka tab Konektivitas & keamanan, di bagian Connect, di bawah Connect to this cluster dengan shell mongo, salin string koneksi yang disediakan. Abaikan penyalinan <insertYourPassword> sehingga Anda dimintai kata sandi oleh mongo shell saat Anda terhubung.

   

   Kembali ke lingkungan AWS Cloud9 Anda dan rekatkan string koneksi.

Saat Anda memasukkan kata sandi dan prompt Anda menjadi prompt rs0:PRIMARY>, Anda berhasil terhubung ke klaster Amazon DocumentDB Anda.

catatan

Untuk informasi pemecahan masalah, lihat Memecahkan Masalah Amazon DocumentDB.

Langkah 6: Masukkan dan ajukan 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.insert({"hello":"DocumentDB"})

2. Anda mendapatkan output berikut ini:

   WriteResult({ "nInserted" : 1 })

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

   db.collection.findOne()

4. Anda mendapatkan output berikut ini:

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

5. 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}
                       ])

6. Anda mendapatkan output berikut ini:

   { "acknowledged" : true, "insertedIds" : [ 1, 2, 3, 4 ] }

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

   db.profiles.find()

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

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

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

10. Anda harus mendapatkan kembali output ini:

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

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

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

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

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

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

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

14. Anda mendapatkan output berikut ini:

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

Langkah 7: Jelajahi

Selamat! Anda telah berhasil menyelesaikan Panduan Memulai untuk Amazon DocumentDB.

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

• Mengelola Amazon DocumentDB

• Penskalaan

• Mencadangkan dan memulihkan

catatan

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