Menyiapkan database global di Amazon Neptune

Anda dapat membuat basis data global Neptune dengan salah satu cara berikut:

• Buat database global dengan semua klaster dan instans DB baru.

• Buat database global menggunakan klaster DB Neptune yang ada sebagai klaster utama.

Persyaratan konfigurasi untuk database global di Amazon Neptune

basis data global Neptune membentang beberapaWilayah AWS. primerWilayah AWS berisi klaster DB Neptune yang memiliki salah satu instans penulis. Satu sampai lima sekunderWilayah AWS masing-masing berisi klaster DB Neptune read-only yang seluruhnya terdiri dari instans read-replica. Setidaknya satu sekunderWilayah AWS diperlukan.

Klaster DB Neptune yang membentuk basis data global memiliki persyaratan khusus berikut:

• Persyaratan kelas instans DB — Sebuah basis data global membutuhkanr5 atau kelas instansr6g DB yang dioptimalkan untuk beban kerja yang memakan memori, seperti jenisdb.r5.large instans.

• Wilayah AWSpersyaratan — Sebuah basis data membutuhkan klaster DB Neptune primer dalam satuWilayah AWS, dan setidaknya satu klaster DB Neptune sekunder di wilayah yang berbeda. Anda dapat membuat hingga lima klaster DB Neptune read-only sekunder, dan masing-masing harus di wilayah yang berbeda. Dengan kata lain, tidak ada dua klaster DB Neptune dalam basis data global Neptune bisa samaWilayah AWS.

• Persyaratan versi mesin - Versi mesin Neptune yang digunakan oleh semua cluster DB dalam database global harus sama, dan harus lebih besar dari atau sama dengan1.2.0.0. Jika Anda tidak menentukan versi mesin saat membuat database global baru atau cluster atau instance, versi mesin terbaru akan digunakan.

penting

Meskipun grup parameter klaster DB dapat dikonfigurasi secara independen untuk setiap klaster DB dalam database global, yang terbaik adalah menjaga pengaturan konsisten di seluruh klaster untuk menghindari perubahan perilaku yang tidak terduga jika klaster sekunder harus dipromosikan ke primer. Misalnya, menggunakan pengaturan yang sama untuk indeks objek, aliran, dan sebagainya di semua klaster DB.

MenggunakanAWS CLI untuk membuat database global di Amazon Neptune

catatan

Contoh di bagian ini mengikuti konvensi UNIX menggunakan garis miring terbalik (\) sebagai karakter line-extender. Untuk Windows, ganti backslach dengan tanda sisipan (^).

Untuk membuat global basis data menggunakanAWS CLI

1. Mulailah dengan membuat database global kosong menggunakancreate-global-clusterAWS CLI perintah (yang membungkusCreateGlobalCluster API). Tentukan namaWilayah AWS yang Anda inginkan untuk menjadi primer, atur Neptune sebagai mesin database, dan secara opsional, tentukan versi mesin yang ingin Anda gunakan (ini harus versi 1.2.0.0 atau lebih tinggi):

   aws neptune create-global-cluster
     --region (primary region, such as us-east-1) \
     --global-cluster-identifier (ID for the global database) \
     --engine neptune \
     --engine-version (engine version; this is optional)

2. Diperlukan beberapa menit agar database global tersedia, jadi sebelum pergi ke langkah berikutnya, gunakan perintahdescribe-global-clusters CLI (yang membungkusDescribeGlobalClusters API) untuk memeriksa apakah database global tersedia:

   aws neptune describe-global-clusters \
     --region (primary region) \
     --global-cluster-identifier (global database ID)

3. Setelah database global Neptune tersedia, Anda dapat membuat klaster DB Neptune baru untuk menjadi klaster utamanya:

   aws neptune create-db-cluster \
     --region (primary region) \
     --db-cluster-identifier (ID for the primary DB cluster) \
     --engine neptune \
     --engine-version (engine version; must be >= 1.2.0.0) \
     --global-cluster-identifier (global database ID)

4. Gunakandescribe-db-clustersAWS CLI perintah untuk mengonfirmasi bahwa klaster DB baru siap untuk Anda tambahkan instans DB utamanya:

   aws neptune describe-db-clusters \
     --region (primary region) \
     --db-cluster-identifier (primary DB cluster ID)

   Ketika respon menunjukkan"Status": "available", lanjutkan ke langkah berikutnya.

5. Buat DB instance primer untuk cluster primer menggunakancreate-db-instanceAWS CLI perintah. Anda harus menggunakan salah satu jenis yang dioptimalkan memorir5 ataur6g instans, sepertidb.r5.large.

   aws neptune create-db-instance \
     --region (primary region) \
     --db-cluster-identifier (primary cluster ID) \
     --db-instance-class (instance class) \
     --db-instance-identifier (ID for the DB instance) \
     --engine neptune \
     --engine-version (optional: engine version)

catatan

Jika Anda berencana untuk menambahkan data ke klaster DB primer baru menggunakan pemuat massal Neptune, lakukan sebelum menambahkan wilayah sekunder. Ini lebih cepat dan lebih hemat biaya daripada melakukan beban massal setelah database global diatur sepenuhnya.

Sekarang tambahkan satu atau lebih daerah sekunder ke database global baru, seperti yang dijelaskan dalamMenambahkan wilayah sekunder menggunakanAWS CLI.

Mengubah klaster DB yang ada menjadi database global

Untuk mengubah klaster DB yang ada menjadi database global, gunakancreate-global-clusterAWS CLI perintah untuk membuat database global baru yangWilayah AWS sama dengan klaster DB yang ada, dan atur--source-db-cluster-identifier parameternya ke Amazon Resource Name (ARN) dari klaster yang ada di sana:

aws neptune create-global-cluster \
  --region (region where the existing cluster is located) \
  --global-cluster-identifier (provide an ID for the new global database) \
  --source-db-cluster-identifier (the ARN of the existing DB cluster) \
  --engine neptune \
  --engine-version (engine version; this is optional)

Sekarang tambahkan satu atau lebih daerah sekunder ke database global baru, seperti yang dijelaskan dalamMenambahkan wilayah sekunder menggunakanAWS CLI.

Gunakan klaster DB yang dipulihkan dari snapshot sebagai klaster utama

Anda dapat mengubah klaster DB yang dipulihkan dari snapshot menjadi database global Neptune. Setelah pemulihan selesai, putar klaster DB yang dibuat ke dalam klaster utama database global baru seperti dijelaskan di atas.

Menambahkan wilayah database global sekunder ke wilayah utama di Amazon Neptune

basis data global Neptune membutuhkan setidaknya satu klaster DB Neptune sekunder dalam klaster DB primer.Wilayah AWS Anda dapat melampirkan hingga lima klaster DB sekunder ke klaster DB primer.

Setiap klaster DB sekunder yang Anda tambahkan mengurangi satu jumlah maksimum instance read-replica yang dapat Anda miliki di klaster utama. Misalnya, jika ada 4 klaster sekunder, maka jumlah maksimum contoh baca-replika yang dapat Anda miliki pada klaster utama adalah15 - 4 = 11. Ini berarti bahwa jika Anda sudah memiliki 14 instance pembaca di klaster DB primer dan satu klaster sekunder, Anda tidak akan dapat menambahkan klaster sekunder lainnya.

MenggunakanAWS CLI untuk menambahkan wilayah sekunder ke database global di Neptune

Untuk menambahkan sekunderWilayah AWS ke database global Neptune menggunakanAWS CLI

1. Gunakancreate-db-clusterAWS CLI perintah untuk membuat klaster DB baru di wilayah yang berbeda dari klaster utama Anda, dan atur--global-cluster-identifier parameternya untuk menentukan ID database global:

   aws neptune create-db-cluster \
     --region (the secondary region) \
     --db-cluster-identifier (ID for the new secondary DB cluster) \
     --global-cluster-identifier (global database ID)
     --engine neptune \
     --engine-version (optional: engine version)

2. Gunakandescribe-db-clustersAWS CLI perintah untuk mengonfirmasi bahwa klaster DB baru siap untuk Anda tambahkan instans DB utamanya:

   aws neptune describe-db-clusters \
     --region (primary region) \
     --db-cluster-identifier (primary DB cluster ID)

   Ketika respon menunjukkan"Status": "available", lanjutkan ke langkah berikutnya.

3. Buat instance DB utama untuk klaster utama menggunakancreate-db-instanceAWS CLI perintah, menggunakan jenis instance di kelasr5 ataur6g instance:

   aws neptune create-db-instance \
     --region (secondary region) \
     --db-cluster-identifier (secondary cluster ID) \
     --db-instance-class (instance class) \
     --db-instance-identifier (ID for the DB instance) \
     --engine neptune \
     --engine-version (optional: engine version)

catatan

Jika Anda tidak bermaksud untuk melayani sejumlah besar permintaan baca di wilayah sekunder, dan terutama berkaitan dengan menjaga data Anda dicadangkan dengan andal di sana, Anda dapat membuat klaster DB sekunder tanpa instans DB. Ini menghemat uang, karena Anda kemudian hanya membayar untuk penyimpanan klaster sekunder, yang Neptune akan tetap sinkron dengan penyimpanan di klaster DB utama.

Menghubungkan ke database global Neptune

Cara Anda terhubung ke basis data global Neptune bergantung pada apakah Anda perlu menulis atau membaca darinya:

• Untuk permintaan atau kueri read-only, sambungkan ke endpoint pembaca untuk cluster Neptune diWilayah AWS.

• Untuk menjalankan kueri mutasi, sambungkan ke endpoint klaster untuk klaster DB primer, yang mungkin berbedaWilayah AWS dari aplikasi Anda.