View a markdown version of this page

Mesin Amazon Neptune Versi 1.2.1.0 (//) - Amazon Neptune
Rilis PatchFitur BaruPerbaikanPerbaikan CacatVersi yang Di Query-Language dukungJalur PeningkatanMeningkatkan

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.2.1.0 (//)

Pada//, versi mesin 1.2.1.0 umumnya sedang digunakan. Harap dicatat bahwa perlu beberapa hari agar rilis baru tersedia di setiap wilayah.

catatan

Jika memutakhirkan dari versi mesin lebih awal dari 1.2.0.0:

  • Rilis mesin 1.2.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.2.0.0 ke versi mesin 1.2.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.2 Rilis sebelumnya menggunakan keluarga grup parameterneptune1, dan grup parameter tersebut tidak akan berfungsi dengan rilis 1.2.0.0 ke atas. Untuk informasi selengkapnya, lihat Grup parameter Amazon Neptunus.

  • Rilis mesin 1.2.0.0 juga memperkenalkan format baru untuk undo log. Akibatnya, setiap log undo yang dibuat oleh versi engine sebelumnya harus dibersihkan dan UndoLogsListSize CloudWatch metrik harus turun ke nol sebelum peningkatan dari versi yang lebih awal dari 1.2.0.0 dapat dimulai. Jika ada terlalu banyak catatan log batalkan (200.000 atau lebih) saat Anda mencoba memulai pembaruan, upaya pemutakhiran dapat habis sementara menunggu pembersihan log undo selesai.

    Anda dapat mempercepat laju pembersihan dengan memutakhirkan instance penulis cluster, yang merupakan tempat pembersihan terjadi. Melakukan hal itu sebelum mencoba memutakhirkan dapat menurunkan jumlah log undo sebelum Anda mulai. Meningkatkan ukuran penulis ke jenis instans 24XL dapat meningkatkan tingkat pembersihan Anda menjadi lebih dari satu juta catatan per jam.

    Jika UndoLogsListSize CloudWatch metriknya sangat besar, membuka kasus dukungan dapat membantu Anda menjelajahi strategi tambahan untuk menurunkannya.

  • Akhirnya, ada perubahan besar dalam rilis 1.2.0.0 yang mempengaruhi kode sebelumnya yang menggunakan protokol Bolt dengan otentikasi IAM. Dimulai dengan rilis 1.2.0.0, Bolt memerlukan jalur sumber daya untuk penandatanganan IAM. Di Java, pengaturan jalur sumber daya mungkin terlihat seperti ini:request.setResourcePath("/openCypher"));. Dalam bahasa lain, /openCypher dapat ditambahkan ke URI titik akhir. Lihat Menggunakan protokol Bolt sebagai contoh.

Rilis Patch Berikutnya untuk Rilis Ini

Fitur Baru dalam Rilis Mesin Ini

  • Menambahkan dukungan untuk TinkerPop 3.6.2, yang menambahkan banyak fitur Gremlin baru seperti yang barumergeV(),, mergeE()element(), dan langkah-langkah. fail() Lang mergeE() kah-langkah mergeV() dan menjadi perhatian khusus karena mereka menawarkan opsi deklaratif yang telah lama ditunggu-tunggu untuk melakukan operasi seperti upser, yang seharusnya sangat menyederhanakan pola kode yang ada dan membuat Gremlin lebih mudah dibaca. Versi 3.6.x juga menambahkan predikat regex, kelebihan beban baru pada property() langkah yang membutuhkanMap, dan revisi besar perilaku by() modulasi yang jauh lebih konsisten di semua langkah yang menggunakannya.

    Lihat log TinkerPop perubahan dan halaman pemut akhiran untuk informasi tentang perubahan di versi 3.6 dan hal-hal yang perlu dipertimbangkan saat memutakhirkan.

    Jika Anda menggunakan fold().coalesce(unfold(), <mutate>) untuk sisipan bersyarat, kami sarankan Anda bermigrasi ke mergeV/E() sintaks baru, dijelaskan di sini dan di sini. Neptunus menggunakan pola penguncian yang lebih sempit untuk Merge than forCoalesce, yang dapat mengurangi pengecualian modifikasi bersamaan (CME).

    Untuk informasi lebih lanjut tentang fitur-fitur baru yang tersedia dalam TinkerPop rilis ini, lihat blog Stephen Mallette, Men jelajahi fitur baru Apache TinkerPop 3.6.x di Amazon Neptune.

  • Menambahkan dukungan untuk jenis instans R6i, didukung oleh prosesor Intel Xeon Scalable generasi ke-3. Ini sangat cocok untuk beban kerja intensif memori dan menawarkan compute/price kinerja hingga 15% lebih baik dan bandwidth memori hingga 20% lebih tinggi per vCPU daripada jenis instance R5 yang sebanding.

  • Menambahkan titik akhir API ringkasan grafik untuk grafik properti dan grafik RDF, yang memungkinkan Anda mendapatkan laporan ringkasan cepat tentang grafik Anda.

    Untuk grafik properti (PG), API ringkasan grafik menyediakan daftar label node dan tepi yang hanya dapat dibaca dan kunci properti, bersama dengan jumlah node, tepi, dan properti. Untuk grafik RDF, ini menyediakan daftar kelas dan kunci predikat, bersama dengan jumlah quad, subjek, dan predikat.

    Perubahan berikut sejalan dengan API ringkasan grafik baru:

    • Menambahkan tindakan GetGraphSummary dataplane baru.

    • Menambahkan rdf/statistics titik akhir baru untuk menggantikan titik sparql/statistics akhir, yang sekarang tidak digunakan lagi.

    • Mengubah nama summary bidang dalam respons status statistik kesignatureInfo, agar tidak membingungkannya dengan informasi ringkasan grafik. Versi mesin sebelumnya terus digunakan summary dalam respons JSON.

    • Mengubah presisi date bidang dalam respons status statistik dari menit ke milidetik. Format sebelumnya adalah 2020-05-07T23:13Z (presisi menit), sedangkan format baru adalah 2023-01-24T00:47:43.319Z (presisi milidetik). Keduanya sesuai dengan ISO 8601, tetapi perubahan ini dapat merusak kode yang ada, tergantung pada bagaimana tanggal diurai.

    • Menambahkan sihir %statistics baris baru di Workbench yang memungkinkan Anda mengambil statistik mesin DFE.

    • Menambahkan sihir %summary garis baru di Workbench yang memungkinkan Anda mengambil informasi ringkasan grafik.

  • Menambahkan logging kueri lambat ke kueri log yang membutuhkan waktu lebih lama untuk dieksekusi daripada ambang batas yang ditentukan. Anda mengaktifkan dan mengontrol pencatatan kueri lambat menggunakan dua parameter dinamis baru, yaitu neptune_enable_slow_query_log, dan neptune_ slow_query_log_. neptune_slow_query_log_threshold(parameter tingkat cluster)

  • Menambahkan dukungan untuk dua parameter dinamis, yaitu parameter cluster baru, neptune_enable_slow_query_log, dan neptune_slow_query_log_. neptune_slow_query_log_threshold(parameter tingkat cluster) Ketika Anda membuat perubahan pada parameter dinamis, itu akan segera berlaku, tanpa memerlukan reboot instance apa pun.

  • Menambahkan fungsi Neptune-specific openCypher remove KeyFromMap () yang menghapus kunci tertentu dari peta dan mengembalikan peta baru yang dihasilkan.

Perbaikan dalam Rilis Mesin Ini

  • Dukungan Gremlin DFE yang diperluas ke limit langkah-langkah dengan lingkup lokal.

  • Men by() ambahkan dukungan modulasi untuk Gremlin DedupGlobalStep di mesin DFE.

  • Menambahkan dukungan DFE untuk Gremlin danSelectStep. SelectOneStep

  • Peningkatan kinerja dan perbaikan kebenaran untuk berbagai operator Gremlin, termasuk,repeat, coalescestore, dan. aggregate

  • Peningkatan kinerja kueri OpenCypher yang melibatkan MERGE dan. OPTIONAL MATCH

  • Peningkatan kinerja kueri OpenCypher UNWIND yang melibatkan daftar peta nilai literal.

  • Peningkatan kinerja kueri OpenCypher yang memiliki IN filter untuk. id Contoh:

    MATCH (n) WHERE id(n) IN ['1', '2', '3'] RETURN n

  • Menambahkan kemampuan untuk menentukan IRI dasar untuk kueri SPARQL menggunakan pernyataan BASE (lihatIRI dasar default untuk kueri dan pembaruan).

  • Memperpendek waktu tunggu pemrosesan beban untuk beban massal khusus tepi Gremlin dan OpenCypher.

  • Pemuatan massal dibuat dilanjutkan secara asinkron saat Neptune restart untuk menghindari waktu tunggu yang lama yang disebabkan oleh masalah konektivitas Amazon S3 sebelum upaya melanjutkan gagal.

  • Peningkatan penanganan kueri SPARQL DESCRIBE yang memiliki petunjuk kueri Describe Mode disetel ke "CBD" (deskripsi terbatas ringkas) dan yang melibatkan sejumlah besar node kosong.

Perbaikan Cacat dalam Rilis Mesin Ini

  • Memperbaiki bug OpenCypher di mana kueri mengembalikan string,"null", alih-alih nilai null di Bolt dan. SPARQL-JSON

  • Memperbaiki bug OpenCypher dalam pemahaman daftar yang menghasilkan nilai nol daripada nilai yang disediakan untuk elemen daftar.

  • Memperbaiki bug OpenCypher di mana nilai byte tidak diserialkan dengan benar.

  • Memperbaiki bug Gremlin UnionStep yang terjadi ketika input adalah tepi yang melintasi ke simpul di dalam traversal anak.

  • Memperbaiki bug Gremlin yang menyebabkan label langkah yang terkait dengan UnionStep tidak menyebar dengan benar ke langkah terakhir dari setiap traversal anak.

  • Memperbaiki bug Gremlin untuk dedup langkah dengan label mengikuti repeat langkah, di mana label yang dilampirkan pada dedup langkah tidak tersedia untuk digunakan dalam kueri lebih lanjut.

  • Memperbaiki bug Gremlin di mana menerjemahkan repeat langkah di dalam union langkah gagal dengan kesalahan internal.

  • Memperbaiki masalah kebenaran Gremlin untuk kueri DFE dengan penel limit usuran anak dari langkah-langkah non-serikat dengan kembali ke Tinkerpop. Kueri dalam bentuk seperti ini terpengaruh: 

    g.withSideEffect('Neptune#useDFE', true).V().as("a").select("a").by(out().limit(1))

  • Memperbaiki bug SPARQL di mana SPARQL GRAPH pola tidak akan mempertimbangkan kumpulan data yang disediakan oleh FROM NAMED klausa.

  • Memperbaiki bug SPARQL di mana SPARQL DESCRIBE dengan beberapa FROM and/or FROM NAMED klausa tidak selalu menggunakan data dengan benar dari grafik default dan terkadang melemparkan pengecualian. Lihat Perilaku SPARQL DESCRIBE sehubungan dengan grafik default.

  • Memperbaiki bug SPARQL sehingga pesan pengecualian yang benar dikembalikan ketika karakter null ditolak.

  • Memperbaiki bug penjelasan SPARQL yang memengaruhi rencana yang berisi PipelinedHashIndexJoin operator.

  • Memperbaiki bug yang menyebabkan kesalahan internal dilemparkan ketika kueri yang mengembalikan nilai konstan dikirimkan.

  • Memperbaiki masalah dengan logika detektor kebuntuan yang terkadang membuat mesin tidak responsif.

Query-Language Versi yang Didukung dalam Rilis Ini

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

  • Versi paling awal Gremlin didukung: 3.6.2

  • Gremlin versi terbaru didukung: 3.6.2

  • Versi OpenCypher: Neptune-9.0.20190305-1.1

  • Versi SPARQL: 1.1

Tingkatkan Jalur ke Rilis Mesin 1.2.1.0

Anda dapat memutakhirkan secara manual ke rilis ini dari rilis mesin Neptune sebelumnya yang lebih besar dari atau sama dengan 1.1.0.0.

catatan

Dimulai dengan rilis mesin 1.2.0.0, semua grup parameter kustom dan grup parameter cluster kustom yang Anda gunakan dengan versi engine sebelumnya sekarang 1.2.0.0 harus dibuat ulang menggunakan keluarga grup parameter. neptune1.2 Rilis sebelumnya menggunakan keluarga grup parameterneptune1, dan grup parameter tersebut tidak akan berfungsi dengan rilis mulai dan 1.2.0.0 seterusnya. Untuk informasi selengkapnya, lihat Grup parameter Amazon Neptunus.

Anda tidak akan secara otomatis ditingkatkan ke rilis versi utama ini.

Peningkatan ke Rilis Ini

Amazon Neptune 1.2.1.0 sekarang tersedia secara umum.

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.2.1.0 \
    --apply-immediately

Untuk Windows:

aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.2.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 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.