Mesin Amazon Neptunus versi 1.3.4.0 (2024-10-01) - Amazon Neptune
PerbaikanCacat diperbaikiVersi Kueri Bahasa yang DidukungJalur peningkatanMeningkatkan

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

Mesin Amazon Neptunus versi 1.3.4.0 (2024-10-01)

Pada 2024-10-01, engine versi 1.3.4.0 sedang digunakan secara umum. Harap dicatat bahwa perlu beberapa hari agar rilis baru tersedia di setiap wilayah.

catatan

Engine release 1.3.0.0 memperkenalkan format baru untuk grup parameter kustom dan grup parameter cluster kustom. Akibatnya, jika Anda memutakhirkan dari versi engine lebih awal dari 1.3.0.0 ke engine versi 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, neptune1.2 atau. dan grup parameter tersebut tidak akan berfungsi dengan rilis 1.3.0.0 ke atas. Untuk informasi selengkapnya, lihat Grup parameter Amazon Neptunus.

Awas

Masalah terdeteksi dengan operasi pembaruan SPARQL 1.1 yang mungkin ada dalam kondisi tertentu ketika operator pembaruan digunakan dengan kebijakan otorisasi berbasis tindakan. Jika Anda menggunakan operasi pembaruan SPARQL 1.1 dengan kebijakan otorisasi berbasis tindakan, kami sarankan untuk meningkatkan ke versi mesin minor Neptunus terbaru (setidaknya 1.3.4.0) yang mencakup perbaikan untuk masalah ini.

Cache paket kueri dinonaktifkan sementara untuk kueri berparameter yang melibatkan nilai parameter numerik karena masalah dalam menangani penggunaan duplikat parameter tipe numerik seperti pada kueri berikut: 

MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n 
UNION 
MATCH (n:show) WHERE n.duration>=$minutes RETURN n

parameters={"minutes":130}

Perbaikan dalam rilis mesin ini

  • Menambahkan dukungan untuk eksekusi langkah Gremlin limit () di lintasan bersarang untuk engine. DFE

  • Menambahkan CloudWatch metrik yang terkait dengan cache hasil Gremlin seperti yang tercantum di bawah ini, yang dapat berguna dalam mendiagnosis dan menyetel latensi cache hasil. Lihat Metrik Neptunus untuk detailnya. 

    NumResultCacheHit
NumResultCacheMiss
ResultCacheSizeInBytes
ResultCacheItemCount
ResultCacheOldestItemTimestamp
ResultCacheNewestItemTimestamp

Cacat diperbaiki dalam rilis mesin ini

Perbaikan umum

  • Memperbaiki bug di mana dalam kasus yang jarang terjadi, mesin mogok alih-alih mengembalikan kesalahan kueri.

Perbaikan Gremlin

  • Kami telah meningkatkan penanganan permintaan dan pelaporan kesalahan ketika klien atau proxy mengirim permintaan peningkatan soket web melalui HTTP koneksi yang ditetapkan/digunakan (sebelumnya 400 tanggapan dengan kesalahan “tidak ada skrip gremlin yang disediakan, kode" dikembalikan). MissingParameterException

  • Mengoptimalkan penanganan langkah MergeV dengan pembaruan nilai properti kardinalitas tunggal. Misalnya, kueri di bawah ini sekarang didukung secara native di Neptunus. 

    g.mergeV([(T.id): 1234]). option(onMatch, ['age': single(20), 'name': single('alice'), 'city': set('miami')])

  • Memperbaiki bug evaluasi DFE kueri Gremlin yang menyebabkan kueri gagal dengan InternalFailureException ketika kueri berisi fungsi ToMap logis untuk menghasilkan peta saat runtime, dan keluaran peta digunakan sebagai kunci agregasi (in). DFEAggregationNode Contoh kueri yang terpengaruh: 

    g.V("1").as("a").as("b").select("a","b").dedup()
openCypher perbaikan

  • Memperbaiki bug saat berjalan collect(distinct()) dengan nilai nol yang ada menyebabkan kesalahan dikembalikan.

  • Memperbaiki bug saat menjalankan kueri berparameter yang berisi filter rentang (</<=/>/>= terhadap nilai parameter) menyebabkan hasil duplikat/hilang.

  • Memperbaiki bug di mana DFE mesin menghasilkan lebih banyak output daripada yang diminta dalam kueri batas, yang dapat menyebabkan kesalahan memori.

SPARQLperbaikan

  • Memperbaiki bug saat menjalankan kueri SPARQL pembaruan gabungan pada IAM kluster yang mendukung otentikasi menyebabkan kesalahan dikembalikan.

  • Memperbaiki izin berbasis tindakan untuk operasi pembaruan SPARQL 1.1.

Versi Kueri Bahasa yang Didukung dalam Rilis Ini

Sebelum memutakhirkan kluster DB ke versi 1.3.4.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

  • openCypher versi: Neptune-9.0.20190305-1.0

  • SPARQLversi: 1.1

Tingkatkan jalur ke rilis mesin 1.3.4.0

Anda dapat memutakhirkan 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 memutakhirkan kluster yang memenuhi syarat menggunakan operasi cluster DB di konsol atau dengan menggunakanSDK. CLIPerintah berikut akan segera memutakhirkan cluster yang memenuhi syarat:

Untuk Linux, OS X, atau Unix:

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

Untuk Windows:

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

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

Jika klaster Anda menggunakan grup parameter cluster kustom, pastikan untuk menyertakan paramater 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 meng-upgrade

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 meng-upgrade

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 menghapusnya secara eksplisit.

Dalam kasus tertentu Neptunus membuat snapshot manual untuk Anda sebagai bagian dari proses peningkatan, tetapi Anda tidak harus bergantung pada 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 yang 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 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 Support tersedia di forum komunitas dan melalui AWS Premium Support.