Perbaikan Perbaikan Cacat Versi Kueri Bahasa yang Didukung Jalur peningkatan Meningkatkan

Mesin Amazon Neptunus Versi 1.1.1.0.R6 (2022-09-23)

Pada 2022-09-23, versi mesin 1.1.1.0.R6 umumnya digunakan. Harap dicatat bahwa perlu beberapa hari agar rilis baru tersedia di setiap wilayah.

penting

Memutakhirkan ke rilis mesin ini dari versi sebelumnya 1.1.0.0 juga memicu peningkatan sistem operasi pada semua instance di cluster DB Anda. Karena permintaan penulisan aktif yang terjadi selama pemutakhiran sistem operasi tidak akan diproses, Anda harus menjeda semua beban kerja tulis ke klaster yang sedang ditingkatkan, termasuk pemuatan data massal, sebelum memulai pemutakhiran.

Agar berhasil menyelesaikan peningkatan, setiap subnet di setiap zona ketersediaan (AZ) harus memiliki setidaknya satu alamat IP yang tersedia per instance Neptunus. Misalnya, jika ada satu instance penulis dan dua instance pembaca di subnet 1, dan dua instance pembaca di subnet 2, subnet 1 harus memiliki setidaknya 3 alamat IP gratis dan subnet 2 harus memiliki setidaknya 2 alamat IP gratis sebelum memulai upgrade.

Pada awal pemutakhiran, Neptunus menghasilkan snapshot dengan nama yang terdiri dari diikuti oleh pengidentifikasi yang dibuat preupgrade secara otomatis berdasarkan informasi cluster DB Anda. Anda tidak akan dikenakan biaya untuk snapshot ini, dan Anda dapat menggunakannya untuk memulihkan cluster DB Anda jika terjadi kesalahan selama proses peningkatan.

Ketika upgrade mesin itu sendiri telah selesai, versi mesin baru akan tersedia sebentar pada sistem operasi lama, tetapi dalam waktu kurang dari 5 menit semua instance di cluster Anda secara bersamaan akan memulai upgrade sistem operasi. Cluster DB Anda tidak akan tersedia pada saat ini selama beberapa menit. Anda dapat melanjutkan beban kerja menulis setelah peningkatan selesai.

Proses ini menghasilkan peristiwa berikut:

Pesan acara per cluster:
- Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]
- Database cluster major version has been upgraded
Pesan acara per instance:
- Applying off-line patches to DB instance
- DB instance shutdown
- Finished applying off-line patches to DB instance
- DB instance restarted

catatan

Ada perubahan besar dalam rilis ini untuk kode yang menggunakan OpenCypher dengan otentikasi IAM. Hingga saat ini, string host dalam tanda tangan IAM menyertakan protokol, sepertibolt://, seperti ini:


"Host":"bolt://(host URL):(port)"

Dimulai dengan pelepasan mesin1.1.1.0, protokol harus dihilangkan:


"Host":"(host URL):(port)"

Lihat Menggunakan protokol Bolt sebagai contoh.

Perbaikan dalam Rilis Mesin Ini

Peningkatan kinerja kueri Gremlinorder-by. Kueri Gremlin dengan order-by di akhir NeptuneGraphQueryStep sekarang menggunakan ukuran potongan yang lebih besar untuk kinerja yang lebih baik. Ini tidak berlaku untuk order-by node internal (non-root) dari rencana kueri.
Peningkatan kinerja kueri pembaruan Gremlin. Simpul dan tepi sekarang harus dikunci terhadap penghapusan sambil menambahkan tepi atau properti. Perubahan ini menghilangkan kunci duplikat dalam transaksi, yang meningkatkan kinerja.

Perbaikan Cacat dalam Rilis Mesin Ini

Memperbaiki bug OpenCypher di MERGE klausa yang dalam beberapa kasus menyebabkan duplikat node dan pembuatan edge.
Memperbaiki bug dalam penanganan kueri SPARQL yang berisi (NOT) EXISTS dalam OPTIONAL klausa, di mana dalam beberapa kasus hasil kueri akan hilang.
Memperbaiki bug yang menunda restart server saat beban massal sedang berlangsung.
Memperbaiki bug di mana traversal bi-directional pola panjang variabel OpenCypher dengan filter pada properti relasi akan mengakibatkan kesalahan. Contoh pola panjang variabel tersebut adalah. (n)-[r*1..2]->(m)
Memperbaiki bug yang terkait dengan bagaimana data cache dikirim kembali ke klien, yang dalam beberapa kasus mengakibatkan latensi panjang yang tak terduga.

Versi Kueri Bahasa yang Didukung dalam Rilis Ini

Sebelum memutakhirkan cluster DB ke versi 1.1.1.0.R6, pastikan proyek Anda kompatibel dengan versi bahasa kueri ini:

Versi paling awal Gremlin didukung: 3.5.2
Gremlin versi terbaru didukung: 3.5.4
Versi OpenCypher: Neptune-9.0.20190305-1.0
Versi SPARQL: 1.1

Tingkatkan jalur ke rilis mesin 1.1.1.0.R6

Klaster Anda akan ditingkatkan ke rilis patch ini secara otomatis selama jendela pemeliharaan berikutnya jika Anda menjalankan versi mesin1.1.1.0.

Meningkatkan ke Rilis Ini

penting

Memutakhirkan ke rilis mesin ini dari versi apa pun sebelumnya 1.1.0.0 juga memicu peningkatan sistem operasi pada semua instance di cluster DB Anda. Karena permintaan penulisan aktif yang terjadi selama pemutakhiran sistem operasi tidak akan diproses, Anda harus menjeda semua beban kerja tulis ke klaster yang sedang ditingkatkan, termasuk pemuatan data massal, sebelum memulai pemutakhiran.

Ketika upgrade mesin itu sendiri telah selesai, versi mesin baru akan tersedia sebentar pada sistem operasi lama, tetapi dalam waktu kurang dari 5 menit semua instance di cluster Anda secara bersamaan akan memulai upgrade sistem operasi. Cluster DB Anda tidak akan tersedia pada saat ini selama sekitar 6 menit. Anda dapat melanjutkan beban kerja menulis setelah peningkatan selesai.

Proses ini menghasilkan peristiwa berikut:

Pesan acara per cluster:
- Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]
- Database cluster major version has been upgraded
Pesan acara per instance:
- Applying off-line patches to DB instance
- DB instance shutdown
- Finished applying off-line patches to DB instance
- DB instance restarted

Jika klaster DB menjalankan versi mesin yang ada peningkatan jalur untuk rilis ini, klaster tersebut sekarang memenuhi syarat untuk ditingkatkan. Anda dapat meningkatkan klaster yang memenuhi syarat menggunakan operasi klaster DB pada konsol atau dengan menggunakan SDK. Perintah CLI berikut akan meningkatkan klaster yang memenuhi syarat dengan segera:

Untuk Linux, macOS, atau Unix:


aws neptune modify-db-cluster \
    --db-cluster-identifier (your-neptune-cluster) \
    --engine-version 1.1.1.0 \
    --apply-immediately

Untuk Windows:


aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.1.1.0 ^
    --apply-immediately

Pembaruan diterapkan ke semua instans dalam klaster DB pada saat yang sama. Pembaruan memerlukan basis data dimulai ulang di instans tersebut, sehingga Anda mengalami waktu henti 20 hingga 30 detik, setelah itu Anda dapat melanjutkan penggunaan klaster DB Anda.

Selalu uji sebelum Anda meningkatkan

Saat versi mesin Neptunus mayor atau minor baru dirilis, selalu uji aplikasi Neptunus Anda terlebih dahulu sebelum memutakhirkannya. Bahkan peningkatan kecil dapat memperkenalkan fitur atau perilaku baru yang akan memengaruhi kode Anda.

Mulailah dengan membandingkan halaman catatan rilis dari versi Anda saat ini dengan versi yang ditargetkan untuk melihat apakah akan ada perubahan dalam versi bahasa kueri atau perubahan melanggar lainnya.

Cara terbaik untuk menguji versi baru sebelum memutakhirkan cluster DB produksi Anda adalah dengan mengkloning cluster produksi Anda sehingga klon menjalankan versi mesin baru. Anda kemudian dapat menjalankan kueri pada klon tanpa mempengaruhi cluster DB produksi.

Selalu buat snapshot manual sebelum Anda meningkatkan

Sebelum melakukan upgrade, kami sangat menyarankan agar Anda selalu membuat snapshot manual cluster DB Anda. Memiliki snapshot otomatis hanya menawarkan perlindungan jangka pendek, sedangkan snapshot manual tetap tersedia sampai Anda menghapusnya secara eksplisit.

Dalam kasus tertentu Neptunus membuat snapshot manual untuk Anda sebagai bagian dari proses peningkatan, tetapi Anda tidak harus mengandalkan ini, dan harus membuat snapshot manual Anda sendiri dalam hal apa pun.

Ketika Anda yakin bahwa Anda tidak perlu mengembalikan cluster DB Anda ke status pra-pemutakhiran, Anda dapat secara eksplisit menghapus snapshot manual yang Anda buat sendiri, serta snapshot manual yang mungkin dibuat Neptunus. Jika Neptunus membuat snapshot manual, itu akan memiliki nama yang dimulai preupgrade dengan, diikuti dengan nama cluster DB Anda, versi mesin sumber, versi mesin target, dan tanggal.

catatan

Jika Anda mencoba memutakhirkan saat tindakan tertunda sedang dalam proses, Anda mungkin mengalami kesalahan seperti berikut:


   We're sorry, your request to modify DB cluster (cluster identifier) has failed.
   Cannot modify engine version because instance (instance identifier) is
   running on an old configuration. Apply any pending maintenance actions on the instance before
   proceeding with the upgrade.

Jika Anda mengalami kesalahan ini, tunggu hingga tindakan yang tertunda selesai, atau segera picu jendela pemeliharaan agar pemutakhiran sebelumnya selesai.

Untuk informasi selengkapnya tentang peningkatan versi mesin Anda, lihat Mempertahankan Cluster DB Amazon Neptunus Anda. Jika Anda memiliki pertanyaan atau masalah, tim Support AWS tersedia di forum komunitas dan melalui Premium Support AWS.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Rilis: 1.1.1.0.R7 (2023-01-23)

Rilis: 1.1.1.0.R5 (2022-07-21)