View a markdown version of this page

Mesin Amazon Neptune versi 1.4.0.0 (2024-11-06) - Amazon Neptune

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mesin Amazon Neptune versi 1.4.0.0 (2024-11-06)

Pada 2024-11-06, versi mesin 1.4.0.0 secara umum digunakan. Harap dicatat bahwa perlu beberapa hari agar rilis baru tersedia di setiap wilayah.

catatan

Rilis mesin 1.3.0.0 memperkenalkan format baru untuk grup parameter kustom dan grup parameter cluster kustom. Akibatnya, jika Anda memutakhirkan dari versi mesin yang lebih awal dari 1.3.0.0 ke versi mesin 1.3.0.0 atau lebih tinggi, Anda harus membuat ulang semua grup parameter kustom yang ada dan grup parameter cluster kustom menggunakan keluarga grup parameter. neptune1.3 Rilis sebelumnya menggunakan keluarga grup parameterneptune1, atauneptune1.2. dan grup parameter tersebut tidak akan berfungsi dengan rilis 1.3.0.0 ke atas. Demikian pula, Anda harus menggunakan grup parameter cluster 1.4.0.0 untuk versi mesin 1.4.0.0 dan lebih tinggi. Untuk informasi selengkapnya, lihat Grup parameter Amazon Neptunus.

Awas

Cache rencana kueri sementara tidak didukung untuk kasus penggunaan menjalankan kueri berparameter yang melibatkan nilai parameter numerik, karena bug dalam menangani penggunaan duplikat parameter tipe numerik dalam kueri. Contoh:

MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n UNION MATCH (n:show) WHERE n.duration>=$minutes RETURN n parameters={"minutes":130}

Kueri yang melakukan banyak pencarian indeks pada pernyataan atau indeks kamus dapat melihat regresi kinerja 5%. Misalnya - mendapatkan hitungan semua simpul, atau mendapatkan semua simp id ul tidak akan terpengaruh. Mendapatkan semua properti dari semua simpul dapat melihat regresi hingga 5%.

Fitur baru dalam rilis mesin ini

  • Ketika tepi ditambahkan ke grafik properti tanpa ID eksplisit, secara default server menetapkan ID UUID-based tepi, yang disimpan dalam kamus. Sekarang dengan mengatur parameter cluster baru,neptune_enable_server_generated_edge_id = 1, server akan menetapkan ID menggunakan bilangan bulat 8-byte yang dikelola secara internal, tanpa overhead kamus apa pun. Hal ini menghasilkan penghematan penyimpanan dan peningkatan kinerja kueri tanpa perubahan pada kueri. Fitur ini saat ini didukung untuk sisipan melalui bahasa query Gremlin saja.

  • Menambahkan dukungan untuk eksekusi langkah Gremlin limit () di traversal bersarang untuk mesin DFE.

    g.V().project("foo").by(out().order().by(T.id).limit(1))

Perbaikan dalam rilis mesin ini

Perbaikan Umum
  • Neptunus akan secara otomatis merebut kembali penyimpanan undo yang dipegang oleh transaksi besar setelah transaksi selesai dan log tidak lagi diperlukan untuk pemulihan.

  • Dukungan untuk replika database global yang dapat bertahan. Fitur ini memungkinkan cluster sekunder untuk tetap melayani permintaan baca selama restart instance penulis pada cluster utama. Sebelumnya, ketika instance penulis dimulai ulang, semua instance pembaca di cluster sekunder juga dimulai ulang. Dengan rilis ini, instans pembaca cluster sekunder terus melayani permintaan baca selama restart instance penulis, meningkatkan ketersediaan baca di cluster.

  • Log audit sekarang ditulis secara sinkron, yang menjamin bahwa setiap kueri dicatat. Hal ini dapat mempengaruhi kinerja untuk kueri yang sangat besar (>100kb) atau beban kerja throughput tinggi (>1000 qps).

Perbaikan Gremlin
  • Batas waktu per kueri secara default diberlakukan menjadi lebih kecil dari batas waktu tingkat cluster. Dalam rilis sebelumnya, pemeriksaan ini diperkenalkan tetapi perlu diaktifkan secara eksplisit melalui parameter mode lab ''. StrictTimeoutValidation Dengan rilis ini, 'StrictTimeoutValidation' akan diaktifkan secara default dan harus dinonaktifkan secara eksplisit untuk mempertahankan perilaku lama.

Peningkatan OpenCypher
  • Dalam rilis sebelumnya kami memperkenalkan dukungan format datetime yang diperluas, diaktifkan melalui parameter DatetimeMillisecond mode lab. Dukungan format datetime yang diperpanjang ini sekarang diaktifkan secara default.

Peningkatan SPARQL
  • Tindakan IAM eksplisit baru untuk izin kueri.

    Previously: COPY: WriteDataViaQuery & ReadDataViaQuery MOVE: WriteDataViaQuery & DeleteDataViaQuery DELETEINSERT: ReadDataViaQuery & DeleteDataViaQuery Now, COPY: WriteDataViaQuery & ReadDataViaQuery & DeleteDataViaQuery MOVE: WriteDataViaQuery & ReadDataViaQuery & DeleteDataViaQuery DELETEINSERT: ReadDataViaQuery, WriteDataViaQuery if there is INSERT clause, DeleteDataViaQuery if there is DELETE clause.

Cacat diperbaiki dalam rilis mesin ini

Perbaikan umum
  • Memperbaiki masalah dengan instans Tanpa Server yang dapat menyebabkan restart database saat meningkatkan skala.

  • Memperbaiki masalah terkait manajemen file log audit yang dapat menyebabkan file log tidak dapat diakses untuk diunduh atau rotasi, dan dalam beberapa kasus meningkatkan penggunaan CPU.

  • Memperbaiki masalah kueri terkait pengoptimalan yang menunda pembuatan output peta di mesin DFE.

  • Memperbaiki masalah yang menyebabkan cap waktu yang tidak cocok antara log audit dan log kueri yang lambat.

Perbaikan Gremlin
  • Menyelesaikan masalah dalam manajemen WebSocket koneksi Gremlin di mana kueri yang berjalan untuk waktu yang melebihi batas waktu idle koneksi dihentikan sebelum waktunya. Ini secara khusus mempengaruhi klien Python Gremlin menggunakan transportasi AIOHTTP.

Perbaikan OpenCypher
  • Memperbaiki masalah pada langkah pengumpulan yang menyebabkan pengecualian kegagalan internal ketika nilai nol hadir selama konstruksi kueri kumpulkan (distinct (n)).

  • Memperbaiki masalah yang NullPointerException mungkin terjadi dalam kueri saat cache rencana kueri diaktifkan.

  • Memperbaiki masalah yang mengevaluasi lebih banyak data daripada yang diperlukan ketika kueri berisi klausa LIMIT.

  • Memperbaiki masalah di mana menggunakan operasi rentang (<, <=, >, > =) dalam kueri berparameter dengan cache rencana kueri akan menghasilkan hasil duplikat.

  • Memperbaiki masalah yang mengubah kolom hasil saat operasi UNION dan UNION ALL dilakukan menggunakan koneksi baut.

Query-Language Versi yang Didukung dalam Rilis Ini

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

  • Versi paling awal Gremlin didukung: 3.7.1

  • Gremlin versi terbaru didukung: 3.7.1

  • Versi OpenCypher: Neptune-9.0.20190305-1.0

  • Versi SPARQL: 1.1

Tingkatkan jalur ke rilis mesin 1.4.0.0

Anda dapat meningkatkan ke rilis ini dari rilis mesin 1.2.0.0 atau lebih tinggi.

Peningkatan ke Rilis Ini

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.4.0.0 \ --allow-major-version-upgrade \ --apply-immediately

Untuk Windows:

aws neptune modify-db-cluster ^ --db-cluster-identifier (your-neptune-cluster) ^ --engine-version 1.4.0.0 ^ --allow-major-version-upgrade ^ --apply-immediately

Alih-alih--apply-immediately, Anda dapat menentukan--no-apply-immediately. Untuk melakukan peningkatan versi utama, parameter allow-major-version-upgrade diperlukan. Juga, pastikan untuk menyertakan versi mesin atau mesin Anda mungkin ditingkatkan ke versi yang berbeda.

Jika cluster Anda menggunakan grup parameter cluster kustom, pastikan untuk menyertakan parameter ini untuk menentukannya:

--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)

Demikian pula, jika ada instance di cluster yang menggunakan grup parameter DB kustom, pastikan untuk menyertakan parameter ini untuk menentukannya:

--db-instance-parameter-group-name (name of the custom instance parameter group)

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 besar 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 memutakhirkan

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

Dalam kasus tertentu Neptunus membuat snapshot manual untuk Anda sebagai bagian dari proses peningkatan, tetapi Anda tidak boleh 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-upgrade, Anda dapat secara eksplisit menghapus snapshot manual yang Anda buat sendiri, serta snapshot manual yang mungkin telah dibuat Neptunus. Jika Neptune membuat snapshot manual, itu akan memiliki nama yang dimulai denganpreupgrade, diikuti oleh 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 ini:

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 tindakan yang tertunda selesai, atau segera picu jendela pemeliharaan untuk membiarkan 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 AWS Dukungan tersedia di forum komunitas dan melalui AWS Dukungan Premium.