View a markdown version of this page

Mesin Amazon Neptune Versi 1.2.1.0.R3 (2023-06-13) - Amazon Neptune
Fitur 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.R3 (2023-06-13)

Pada 2023-06-13, versi mesin 1.2.1.0.R3 umumnya digunakan. Harap dicatat bahwa perlu beberapa hari agar rilis baru tersedia di setiap wilayah.

penting

Perubahan yang diperkenalkan dalam rilis mesin ini dalam beberapa kasus dapat menyebabkan Anda mengamati penurunan kinerja beban massal. Akibatnya, peningkatan ke rilis ini telah ditangguhkan sementara sampai masalah telah diselesaikan.

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.

Fitur Baru dalam Rilis Mesin Ini

  • Menambahkan dukungan untuk pemuatan massal lintas akun menggunakan rantai peran IAM.

Perbaikan dalam Rilis Mesin Ini

  • Meningkatkan fail() langkah Gremlin untuk membedakan pengecualian yang dihasilkannya dari generik InternalFailureException dan untuk memastikan bahwa pesan yang diberikan pengguna yang diberikan kepadanya disebarkan kembali ke penelepon.

  • Peningkatan optimasi mesin kueri Gremlin untukstore,,, aggregatecap, limit dan. hasLabel

  • Menambahkan dukungan untuk fungsi trignometric OpenCypher:

    • acos()

    • asin()

    • atan()

    • atan2()

    • cos()

    • cot()

    • degrees()

    • pi()

    • radians()

    • sin()

    • tan()

  • Menambahkan dukungan untuk beberapa fungsi agregasi OpenCypher:

    • percentileDisc()

    • stDev()

  • Menambahkan dukungan untuk epochmillis() fungsi OpenCypher yang mengonversi a datetime ke. epochmillis Contoh:

    MATCH (n) RETURN epochMillis(n.someDateTime)
1698972364782

  • Menambahkan dukungan untuk operator OpenCypher modulo ()%.

  • Menambahkan dukungan untuk alat OpenCypher Static Debug Explain.

  • Menambahkan dukungan untuk fungsi OpenCypherrandomUUID().

  • Peningkatan kinerja OpenCypher:

    • Memperbaiki parser dan perencana kueri.

    • Peningkatan pemanfaatan CPU di mesin DFE.

    • Meningkatkan kinerja kueri yang berisi beberapa klausa pembaruan yang menggunakan kembali variabel yang sama. Contohnya adalah:

      MERGE (n {name: 'John'})
  or
MERGE (m {name: 'Jim'})
  or
MERGE (n)-[:knows {since: 2023}]→(m)

    • Rencana kueri yang dioptimalkan untuk pola kueri multi-hop seperti:

      MATCH (n)-->()-->()-->(m)
RETURN n m

    • Meningkatkan kinerja injeksi daftar dan peta melalui kueri parameter. Contoh:

      UNWIND $idList as id MATCH (n {`~id`: id})
RETURN n.name

    • Peningkatan eksekusi kueri berisi WITH dengan menjadikannya penghalang yang sesuai.

    • Dioptimalkan untuk menghindari materialisasi nilai yang berlebihan dalam Unfold dan fungsi agregasi.

  • Meningkatkan kinerja kueri SPARQL yang berisi sejumlah besar input statis dalam VALUES klausa, seperti:

    SELECT ?n WHERE { VALUES (?name) { ("John") ("Jim") ... many values ... } ?n a ?n_type . ?n ?name . }

  • Peningkatan kinerja kueri SPARQL CBD.

Perbaikan Cacat dalam Rilis Mesin Ini

  • Memperbaiki bug Gremlin di mana kueri panjang dengan sarang dalam menyebabkan penggunaan CPU yang tinggi dan batas waktu kueri selama fase perencanaan kueri.

  • Memperbaiki bug Gremlin di mana yang tidak valid NullPointerException dapat dilemparkan saat menggunakan mergeV atau. mergeE

Query-Language Versi yang Didukung dalam Rilis Ini

Sebelum memutakhirkan cluster DB ke versi 1.2.1.0.R3, 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.0

  • Versi SPARQL: 1.1

Tingkatkan Jalur ke Rilis Mesin 1.2.1.0.R3

Peningkatan ke Rilis Ini

Amazon Neptune 1.2.1.0.R3 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.