Memulai 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 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 Amazon Elastic Compute Cloud (AmazonEC2) untuk menghubungkan dan menanyakan klaster Amazon DocumentDB Anda langsung dari. AWS Management Console Pelanggan baru yang memenuhi syarat untuk Tingkat AWS Gratis dapat menggunakan Amazon DocumentDB dan EC2 Amazon secara gratis. Jika EC2 lingkungan Amazon 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 suka terhubung ke Amazon DocumentDB dari komputer lokal Anda dengan membuat SSH koneksi ke instans AmazonEC2, lihat Connect menggunakan Amazon 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). 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 AWS Identity and Access Management (IAM) yang diperlukan.

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.

  1. Di bilah pencarian AWS Management Console, ketik IAM dan pilih IAMdi menu tarik-turun yang muncul.

  2. Setelah Anda berada di IAM konsol, 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 (AmazonVPC)

AWS Akun Anda menyertakan default VPC di setiap wilayah. Langkah ini hanya diperlukan jika Anda memilih untuk menggunakan Amazon defaultVPC. Dalam hal ini, selesaikan langkah-langkah dalam VPC topik Buat Amazon di Panduan VPC Pengguna Amazon.

Luncurkan EC2 instans Amazon

Selesaikan langkah 1 dan 2 dari EC2 topik Memulai Amazon di Panduan Pengguna Amazon Elastic Compute Cloud.

Langkah 1: Buat cluster Amazon DocumentDB

Pada langkah ini Anda akan membuat cluster Amazon DocumentDB.

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

    Empty Clusters dashboard with options to create a new klaster and manage resources.
  2. Pada halaman cluster Create Amazon DocumentDB, di bagian tipe Cluster, pilih Instance Based Clusters (ini adalah opsi default).

    Klaster type selection with Instance Based Klaster option highlighted and described.
  3. Di bagian Konfigurasi:

    1. Untuk pengidentifikasi Cluster, masukkan nama unik, sepertimydocdbcluster. Perhatikan bahwa konsol akan mengubah semua nama cluster menjadi huruf kecil terlepas dari bagaimana mereka dimasukkan.

    2. Untuk versi Engine, pilih 5.0.0.

    3. Untuk kelas Instance, pilih db.t3.medium. Ini memenuhi syarat untuk Tingkat AWS Gratis.

    4. Untuk Jumlah instance, pilih 1 instance. Memilih satu instans membantu meminimalkan biaya. Jika ini adalah sistem produksi, kami sarankan Anda menyediakan tiga instans untuk ketersediaan tinggi.

    Configuration form for a database klaster with fields for identifier, version, instance class, and number.
  4. Di bagian konfigurasi penyimpanan Cluster, pilih Amazon DocumentDB Standard (ini adalah opsi default).

  5. Di bagian Konektivitas:

    1. Pilih Connect ke sumber daya EC2 komputasi.

    2. EC2Misalnya, pilih EC2 instance yang Anda buatPrasyarat.

    Connectivity settings for database with options to connect or not connect to an EC2 compute resource.
  6. Di bagian Otentikasi, masukkan kredensi masuk.

    Authentication form with username and password fields, including input requirements.
  7. Biarkan semua opsi lain sebagai default dan pilih Buat cluster.

catatan

Saat Anda menyiapkan sambungan antara EC2 instans dan database Amazon DocumentDB, Amazon DocumentDB secara otomatis mengonfigurasi VPC grup keamanan untuk instans EC2 Anda dan untuk basis data Amazon DocumentDB Anda. Untuk informasi selengkapnya, lihat Ikhtisar konektivitas otomatis dengan sebuah EC2 instance.

Amazon DocumentDB sekarang menyediakan klaster Anda, dan penyelesaian proses ini dapat memakan waktu hingga beberapa menit. Anda dapat terhubung ke klaster saat status klaster dan instance ditampilkan sebagai tersedia.

catatan

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

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

Langkah 2: Instal cangkang mongo

Instal shell mongo di EC2 instans Amazon yang Anda buat. Prasyarat Mongo shell adalah utilitas baris perintah yang Anda gunakan untuk menghubungkan dan mengajukan kueri pada klaster Amazon DocumentDB Anda.

Connect ke EC2 instans Amazon Anda dan pada command prompt, buat file repositori dengan perintah berikut:

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

Setelah selesai, instal mongo shell dengan perintah berikut:

sudo yum install -y mongodb-org-shell

Langkah 3: Connect ke cluster Amazon DocumentDB Anda

Hubungkan ke cluster Amazon DocumentDB Anda menggunakan shell mongo yang Anda instal di Langkah 2.

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

    DocumentDB klaster management interface showing a regional klaster with primary instance details.
  2. Encryption-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 perintah yang disediakan. Kembali ke EC2 instance Amazon Anda dan tempel perintahnya.

    Command to download Amazon DocumentDB Certificate Authority (CA) certificate for klaster authentication.
  3. Kembali ke cluster Anda di konsol Amazon DocumentDB, di bawah 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.

    MongoDB connection string for connecting to a DocumentDB klaster using the mongo shell.

    Kembali ke EC2 instance Amazon Anda dan tempel string koneksi.

Saat Anda memasukkan kata sandi dan prompt Anda menjadirs0:PRIMARY>, Anda berhasil terhubung ke cluster Amazon DocumentDB Anda.

catatan

Untuk informasi pemecahan masalah, lihat Memecahkan Masalah Amazon DocumentDB.

Langkah 4: 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.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 5: Jelajahi

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

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

catatan

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