

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.2.0.2 (2022-11-20)
<a name="engine-releases-1.2.0.2"></a>

Pada 2022-11-20, engine versi 1.2.0.2 sedang digunakan secara umum. 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:**  
[Engine release 1.2.0.0](engine-releases-1.2.0.0.md) memperkenalkan format baru untuk grup parameter kustom dan grup parameter cluster kustom. Akibatnya, jika Anda memutakhirkan dari versi engine lebih awal dari 1.2.0.0 ke engine versi 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 parameter`neptune1`, dan grup parameter tersebut tidak akan berfungsi dengan rilis 1.2.0.0 ke atas. Untuk informasi selengkapnya, lihat [Grup parameter Amazon Neptunus](parameter-groups.md).
Engine release 1.2.0.0 juga memperkenalkan format baru untuk membatalkan log. Akibatnya, setiap log pembatalan yang dibuat oleh versi mesin sebelumnya harus dibersihkan dan [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch metrik harus jatuh ke nol sebelum peningkatan apa pun dari versi yang lebih awal dari 1.2.0.0 dapat dimulai. Jika ada terlalu banyak catatan log undo (200.000 atau lebih) saat Anda mencoba memulai pembaruan, upaya pemutakhiran dapat habis sementara menunggu pembersihan log pembatalan selesai.  
Anda dapat mempercepat tingkat pembersihan dengan memutakhirkan instance penulis cluster, di mana pembersihan terjadi. Melakukan itu sebelum mencoba memutakhirkan dapat menurunkan jumlah log batal 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 mengeksplorasi 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 membutuhkan jalur sumber daya untuk penandatanganan IAM. Di Java, menyetel jalur sumber daya mungkin terlihat seperti ini:`request.setResourcePath("/openCypher"));`. Dalam bahasa lain, `/openCypher` dapat ditambahkan ke URI endpoint. Lihat [Menggunakan protokol Bolt](access-graph-opencypher-bolt.md) sebagai contoh.

## Rilis Patch Berikutnya untuk Rilis Ini
<a name="engine-releases-1.2.0.2-patches"></a>
+ [Rilis: 1.2.0.2.R2 (2022-12-15)](engine-releases-1.2.0.2.R2.md) 
+ [Rilis: 1.2.0.2.R3 (2023-03-27)](engine-releases-1.2.0.2.R3.md) 
+ [Rilis: 1.2.0.2.R4 (2023-05-08)](engine-releases-1.2.0.2.R4.md) 
+ [Rilis: 1.2.0.2.R5 (2023-08-16)](engine-releases-1.2.0.2.R5.md) 
+ [Rilis: 1.2.0.2.R6 (2023-09-12)](engine-releases-1.2.0.2.R6.md) 

## Fitur Baru dalam Rilis Mesin Ini
<a name="engine-releases-1.2.0.2-features"></a>
+ Memperkenalkan [inferensi induktif real-time](machine-learning-overview-evolving-data.md#inductive-vs-transductive-inference) untuk Gremlin di Neptunus ML.
+ Memperkenalkan ekstensi OpenCypher yang mendukung penentuan [nilai ID khusus untuk entitas](access-graph-opencypher-extensions.md#opencypher-compliance-custom-ids) alih-alih yang dihasilkan UUIDs Neptunus. Kemampuan untuk menetapkan kustom IDs membuatnya lebih mudah untuk bermigrasi ke Neptunus dari Neo4j.
**Awas**  
Ekstensi ke spesifikasi OpenCypher ini tidak kompatibel ke belakang, karena sekarang `~id` dianggap sebagai nama properti yang dicadangkan. Jika Anda sudah menggunakan `~id` sebagai properti dalam data dan kueri, Anda harus [memigrasikan `~id` properti ke kunci properti baru](access-graph-opencypher-extensions.md#opencypher-compliance-custom-ids-migrating) sebelum memutakhirkan ke rilis ini.
+ Menambahkan [beberapa `DESCRIBE` mode SPARQL baru](sparql-query-hints-for-describe.md) bersama dengan petunjuk kueri untuk mengonfigurasinya.

## Perbaikan dalam Rilis Mesin Ini
<a name="engine-releases-1.2.0.2-improvements"></a>
+ Peningkatan kinerja OpenCypher, terutama untuk kueri VLP.
+ Peningkatan kinerja DFE untuk kueri Gremlin dengan batas non-terminal, seperti:

  ```
  g.withSideEffect('Neptune#useDFE',true).V().hasLabel('Student').limit(5).out('takesCourse')
  ```

## Versi Kueri Bahasa yang Didukung dalam Rilis Ini
<a name="engine-releases-1.2.0.2-query-versions"></a>

Sebelum memutakhirkan cluster DB ke versi 1.2.0.2, 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.2.0.2
<a name="engine-releases-1.2.0.2-upgrade-paths"></a>

## Peningkatan ke Rilis Ini
<a name="engine-releases-1.2.0.2-upgrading"></a>

Amazon Neptune 1.2.0.2 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:

```
1. aws neptune modify-db-cluster \
2.     --db-cluster-identifier (your-neptune-cluster) \
3.     --engine-version 1.2.0.2 \
4.     --apply-immediately
```

Untuk Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.0.2 ^
4.     --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
<a name="engine-1.2.0.2-test-before-upgrading"></a>

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
<a name="engine-1.2.0.2-snapshot-before-upgrading"></a>

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 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 yang tertunda sedang dalam proses](manage-console-maintaining), 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](cluster-maintenance.md). Jika Anda memiliki pertanyaan atau masalah, tim AWS Support tersedia di forum komunitas dan melalui [AWS Premium Support](https://aws.amazon.com/support).

# Mesin Amazon Neptunus Versi 1.2.0.2.R6 (2023-09-12)
<a name="engine-releases-1.2.0.2.R6"></a>

Pada 2023-09-12, versi mesin 1.2.0.2.R6 umumnya 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:**  
[Engine release 1.2.0.0](engine-releases-1.2.0.0.md) memperkenalkan format baru untuk grup parameter kustom dan grup parameter cluster kustom. Akibatnya, jika Anda memutakhirkan dari versi engine lebih awal dari 1.2.0.0 ke engine versi 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 parameter`neptune1`, dan grup parameter tersebut tidak akan berfungsi dengan rilis 1.2.0.0 ke atas. Untuk informasi selengkapnya, lihat [Grup parameter Amazon Neptunus](parameter-groups.md).
Engine release 1.2.0.0 juga memperkenalkan format baru untuk membatalkan log. Akibatnya, setiap log pembatalan yang dibuat oleh versi mesin sebelumnya harus dibersihkan dan [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch metrik harus jatuh ke nol sebelum peningkatan apa pun dari versi yang lebih awal dari 1.2.0.0 dapat dimulai. Jika ada terlalu banyak catatan log undo (200.000 atau lebih) saat Anda mencoba memulai pembaruan, upaya pemutakhiran dapat habis sementara menunggu pembersihan log pembatalan selesai.  
Anda dapat mempercepat tingkat pembersihan dengan memutakhirkan instance penulis cluster, di mana pembersihan terjadi. Melakukan itu sebelum mencoba memutakhirkan dapat menurunkan jumlah log batal 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 mengeksplorasi 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 membutuhkan jalur sumber daya untuk penandatanganan IAM. Di Java, menyetel jalur sumber daya mungkin terlihat seperti ini:`request.setResourcePath("/openCypher"));`. Dalam bahasa lain, `/openCypher` dapat ditambahkan ke URI endpoint. Lihat [Menggunakan protokol Bolt](access-graph-opencypher-bolt.md) sebagai contoh.

## Perbaikan Cacat dalam Rilis Mesin Ini
<a name="engine-releases-1.2.0.2.R6-defects"></a>
+ Memperbaiki bug SPARQL di mana `REGEX` operator tidak akan pernah berhasil saat dipanggil pada literal yang diberi tag bahasa.
+ Memperbaiki masalah yang menyebabkan kinerja beban massal menurun.

## Versi Kueri Bahasa yang Didukung dalam Rilis Ini
<a name="engine-releases-1.2.0.2.R6-query-versions"></a>

Sebelum memutakhirkan cluster DB ke versi 1.2.0.2.R6, pastikan proyek Anda kompatibel dengan versi bahasa kueri ini:
+ *Versi paling awal Gremlin didukung:* `3.5.2`
+ *Gremlin versi terbaru didukung:* `3.5.5`
+ *Versi OpenCypher:* `Neptune-9.0.20190305-1.0`
+ *Versi SPARQL:* `1.1`

## Tingkatkan Jalur ke Rilis Mesin 1.2.0.2.R6
<a name="engine-releases-1.2.0.2.R6-upgrade-paths"></a>

Cluster DB Neptunus Anda akan ditingkatkan ke rilis patch pemeliharaan ini secara otomatis selama jendela pemeliharaan berikutnya jika Anda menjalankan versi engine. `1.2.0.2`

## Peningkatan ke Rilis Ini
<a name="engine-releases-1.2.0.2.R6-upgrading"></a>

Amazon Neptune 1.2.0.2.R6 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:

```
1. aws neptune modify-db-cluster \
2.     --db-cluster-identifier (your-neptune-cluster) \
3.     --engine-version 1.2.0.2 \
4.     --apply-immediately
```

Untuk Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.0.2 ^
4.     --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
<a name="engine-1.2.0.2.R6-test-before-upgrading"></a>

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
<a name="engine-1.2.0.2.R6-snapshot-before-upgrading"></a>

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 yang tertunda sedang dalam proses](manage-console-maintaining), 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](cluster-maintenance.md). Jika Anda memiliki pertanyaan atau masalah, tim AWS Support tersedia di forum komunitas dan melalui [AWS Premium Support](https://aws.amazon.com/support).

# Mesin Amazon Neptunus Versi 1.2.0.2.R5 (2023-08-16)
<a name="engine-releases-1.2.0.2.R5"></a>

Pada 2023-08-16, versi mesin 1.2.0.2.R5 umumnya digunakan. Harap dicatat bahwa perlu beberapa hari agar rilis baru tersedia di setiap wilayah.

**penting**  
Perubahan yang terjadi pada pelepasan mesin ini dalam beberapa kasus dapat menyebabkan Anda mengamati kinerja beban curah yang menurun. Akibatnya, upgrade ke rilis ini telah ditangguhkan sementara sampai masalah telah diselesaikan.

**catatan**  
**Jika memutakhirkan dari versi mesin lebih awal dari 1.2.0.0:**  
[Engine release 1.2.0.0](engine-releases-1.2.0.0.md) memperkenalkan format baru untuk grup parameter kustom dan grup parameter cluster kustom. Akibatnya, jika Anda memutakhirkan dari versi engine lebih awal dari 1.2.0.0 ke engine versi 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 parameter`neptune1`, dan grup parameter tersebut tidak akan berfungsi dengan rilis 1.2.0.0 ke atas. Untuk informasi selengkapnya, lihat [Grup parameter Amazon Neptunus](parameter-groups.md).
Engine release 1.2.0.0 juga memperkenalkan format baru untuk membatalkan log. Akibatnya, setiap log pembatalan yang dibuat oleh versi mesin sebelumnya harus dibersihkan dan [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch metrik harus jatuh ke nol sebelum peningkatan apa pun dari versi yang lebih awal dari 1.2.0.0 dapat dimulai. Jika ada terlalu banyak catatan log undo (200.000 atau lebih) saat Anda mencoba memulai pembaruan, upaya pemutakhiran dapat habis sementara menunggu pembersihan log pembatalan selesai.  
Anda dapat mempercepat tingkat pembersihan dengan memutakhirkan instance penulis cluster, di mana pembersihan terjadi. Melakukan itu sebelum mencoba memutakhirkan dapat menurunkan jumlah log batal 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 mengeksplorasi 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 membutuhkan jalur sumber daya untuk penandatanganan IAM. Di Java, menyetel jalur sumber daya mungkin terlihat seperti ini:`request.setResourcePath("/openCypher"));`. Dalam bahasa lain, `/openCypher` dapat ditambahkan ke URI endpoint. Lihat [Menggunakan protokol Bolt](access-graph-opencypher-bolt.md) sebagai contoh.

## Perbaikan Cacat dalam Rilis Mesin Ini
<a name="engine-releases-1.2.0.2.R5-defects"></a>
+ Memperbaiki bug Gremlin di mana tidak `order()` akan mengurutkan output string dengan benar ketika beberapa di antaranya berisi karakter spasi.
+ Memperbaiki bug Gremlin di mana kebocoran transaksi akan terjadi saat memeriksa titik akhir status kueri Gremlin untuk kueri dengan predikat di lintasan anak untuk langkah-langkah yang tidak diproses secara asli.
+ Memperbaiki bug OpenCypher dalam penanganan transaksi Bolt.
+ Memperbaiki masalah konkurensi pada lapisan penyimpanan yang dapat menyebabkan crash.

## Versi Kueri Bahasa yang Didukung dalam Rilis Ini
<a name="engine-releases-1.2.0.2.R5-query-versions"></a>

Sebelum memutakhirkan cluster DB ke versi 1.2.0.2.R5, pastikan proyek Anda kompatibel dengan versi bahasa kueri ini:
+ *Versi paling awal Gremlin didukung:* `3.5.2`
+ *Gremlin versi terbaru didukung:* `3.5.5`
+ *Versi OpenCypher:* `Neptune-9.0.20190305-1.0`
+ *Versi SPARQL:* `1.1`

## Tingkatkan Jalur ke Rilis Mesin 1.2.0.2.R5
<a name="engine-releases-1.2.0.2.R5-upgrade-paths"></a>

Cluster DB Neptunus Anda akan ditingkatkan ke rilis patch pemeliharaan ini secara otomatis selama jendela pemeliharaan berikutnya jika Anda menjalankan versi engine. `1.2.0.2`

## Peningkatan ke Rilis Ini
<a name="engine-releases-1.2.0.2.R5-upgrading"></a>

Amazon Neptune 1.2.0.2.R5 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:

```
1. aws neptune modify-db-cluster \
2.     --db-cluster-identifier (your-neptune-cluster) \
3.     --engine-version 1.2.0.2 \
4.     --apply-immediately
```

Untuk Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.0.2 ^
4.     --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
<a name="engine-1.2.0.2.R5-test-before-upgrading"></a>

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
<a name="engine-1.2.0.2.R5-snapshot-before-upgrading"></a>

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](manage-console-maintaining), 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](cluster-maintenance.md). Jika Anda memiliki pertanyaan atau masalah, tim AWS Support tersedia di forum komunitas dan melalui [AWS Premium Support](https://aws.amazon.com/support).

# Mesin Amazon Neptunus Versi 1.2.0.2.R4 (2023-05-08)
<a name="engine-releases-1.2.0.2.R4"></a>

Pada 2023-05-08, versi mesin 1.2.0.2.R4 umumnya 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:**  
[Engine release 1.2.0.0](engine-releases-1.2.0.0.md) memperkenalkan format baru untuk grup parameter kustom dan grup parameter cluster kustom. Akibatnya, jika Anda memutakhirkan dari versi engine lebih awal dari 1.2.0.0 ke engine versi 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 parameter`neptune1`, dan grup parameter tersebut tidak akan berfungsi dengan rilis 1.2.0.0 ke atas. Untuk informasi selengkapnya, lihat [Grup parameter Amazon Neptunus](parameter-groups.md).
Engine release 1.2.0.0 juga memperkenalkan format baru untuk membatalkan log. Akibatnya, setiap log pembatalan yang dibuat oleh versi mesin sebelumnya harus dibersihkan dan [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch metrik harus jatuh ke nol sebelum peningkatan apa pun dari versi yang lebih awal dari 1.2.0.0 dapat dimulai. Jika ada terlalu banyak catatan log undo (200.000 atau lebih) saat Anda mencoba memulai pembaruan, upaya pemutakhiran dapat habis sementara menunggu pembersihan log pembatalan selesai.  
Anda dapat mempercepat tingkat pembersihan dengan memutakhirkan instance penulis cluster, di mana pembersihan terjadi. Melakukan itu sebelum mencoba memutakhirkan dapat menurunkan jumlah log batal 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 mengeksplorasi 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 membutuhkan jalur sumber daya untuk penandatanganan IAM. Di Java, menyetel jalur sumber daya mungkin terlihat seperti ini:`request.setResourcePath("/openCypher"));`. Dalam bahasa lain, `/openCypher` dapat ditambahkan ke URI endpoint. Lihat [Menggunakan protokol Bolt](access-graph-opencypher-bolt.md) sebagai contoh.

## Perbaikan Cacat dalam Rilis Mesin Ini
<a name="engine-releases-1.2.0.2.R4-defects"></a>
+ Memperbaiki bug SPARQL di mana sejumlah besar nilai yang disuntikkan melalui `VALUES` klausa dapat menyebabkan penurunan kinerja.

## Versi Kueri Bahasa yang Didukung dalam Rilis Ini
<a name="engine-releases-1.2.0.2.R4-query-versions"></a>

Sebelum memutakhirkan cluster DB ke versi 1.2.0.2.R4, pastikan proyek Anda kompatibel dengan versi bahasa kueri ini:
+ *Versi paling awal Gremlin didukung:* `3.5.2`
+ *Gremlin versi terbaru didukung:* `3.5.6`
+ *Versi OpenCypher:* `Neptune-9.0.20190305-1.0`
+ *Versi SPARQL:* `1.1`

## Tingkatkan Jalur ke Rilis Mesin 1.2.0.2.R4
<a name="engine-releases-1.2.0.2.R4-upgrade-paths"></a>

Cluster DB Neptunus Anda akan ditingkatkan ke rilis patch pemeliharaan ini secara otomatis selama jendela pemeliharaan berikutnya jika Anda menjalankan versi engine. `1.2.0.2`

## Peningkatan ke Rilis Ini
<a name="engine-releases-1.2.0.2.R4-upgrading"></a>

Amazon Neptune 1.2.0.2.R4 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:

```
1. aws neptune modify-db-cluster \
2.     --db-cluster-identifier (your-neptune-cluster) \
3.     --engine-version 1.2.0.2 \
4.     --apply-immediately
```

Untuk Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.0.2 ^
4.     --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 meng-upgrade
<a name="engine-1.2.0.2.R4-test-before-upgrading"></a>

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
<a name="engine-1.2.0.2.R4-snapshot-before-upgrading"></a>

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](manage-console-maintaining), 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](cluster-maintenance.md). Jika Anda memiliki pertanyaan atau masalah, tim AWS Support tersedia di forum komunitas dan melalui [AWS Premium Support](https://aws.amazon.com/support).

# Mesin Amazon Neptunus Versi 1.2.0.2.R3 (2023-03-27)
<a name="engine-releases-1.2.0.2.R3"></a>

Pada 2023-03-27, versi mesin 1.2.0.2.R3 umumnya 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:**  
[Engine release 1.2.0.0](engine-releases-1.2.0.0.md) memperkenalkan format baru untuk grup parameter kustom dan grup parameter cluster kustom. Akibatnya, jika Anda memutakhirkan dari versi engine lebih awal dari 1.2.0.0 ke engine versi 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 parameter`neptune1`, dan grup parameter tersebut tidak akan berfungsi dengan rilis 1.2.0.0 ke atas. Untuk informasi selengkapnya, lihat [Grup parameter Amazon Neptunus](parameter-groups.md).
Engine release 1.2.0.0 juga memperkenalkan format baru untuk membatalkan log. Akibatnya, setiap log pembatalan yang dibuat oleh versi mesin sebelumnya harus dibersihkan dan [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch metrik harus jatuh ke nol sebelum peningkatan apa pun dari versi yang lebih awal dari 1.2.0.0 dapat dimulai. Jika ada terlalu banyak catatan log undo (200.000 atau lebih) saat Anda mencoba memulai pembaruan, upaya pemutakhiran dapat habis sementara menunggu pembersihan log pembatalan selesai.  
Anda dapat mempercepat tingkat pembersihan dengan memutakhirkan instance penulis cluster, di mana pembersihan terjadi. Melakukan itu sebelum mencoba memutakhirkan dapat menurunkan jumlah log batal 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 mengeksplorasi 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 membutuhkan jalur sumber daya untuk penandatanganan IAM. Di Java, menyetel jalur sumber daya mungkin terlihat seperti ini:`request.setResourcePath("/openCypher"));`. Dalam bahasa lain, `/openCypher` dapat ditambahkan ke URI endpoint. Lihat [Menggunakan protokol Bolt](access-graph-opencypher-bolt.md) sebagai contoh.

## Perbaikan dalam Rilis Mesin Ini
<a name="engine-releases-1.2.0.2.R3-improvements"></a>
+ Untuk cluster DB tanpa server, ubah pengaturan kapasitas minimum menjadi 1.0 NCU, dan pengaturan maksimum valid terendah menjadi 2,5. NCUs Lihat [Penskalaan kapasitas dalam cluster DB Neptunus Tanpa Server](neptune-serverless-capacity-scaling.md)
+ Menambahkan `enableInterContainerTrafficEncryption` parameter ke semua [Neptunus APIs Neptunus](machine-learning-api-reference.md), yang dapat Anda gunakan untuk mengaktifkan dan menonaktifkan enkripsi lalu lintas antar-kontainer dalam pelatihan atau pekerjaan penyetelan hiper-parameter.

## Perbaikan Cacat dalam Rilis Mesin Ini
<a name="engine-releases-1.2.0.2.R3-defects"></a>
+ Memperbaiki bug Gremlin yang tidak dikenali sebagai `option(Predicate)` sintaks Gremlin yang valid.
+ Memperbaiki bug Gremlin yang menyebabkan kueri tidak dibersihkan dengan benar jika gagal karena mengandung terlalu banyak langkah.
+ Memperbaiki masalah kebenaran Gremlin yang memengaruhi kueri DFE `limit` sebagai traversal anak dari langkah non-serikat dengan kembali ke Tinkerpop. Berikut adalah contoh kueri seperti itu:

  ```
  g.withSideEffect('Neptune#useDFE', true).V().as("a").select("a").by(out().limit(1))
  ```
+ Memperbaiki potensi kebocoran transaksi Gremlin saat kueri dikirimkan sebagai String berisi. `GroupCountStep`
+ Memperbaiki bug OpenCypher di mana jenis nilai parameter tidak disimpulkan dengan benar dalam daftar atau daftar peta.
+ Memperbaiki bug OpenCypher di mana kueri pembaruan dan pengembalian tidak ditangani`orderBy`,, `limit` atau dengan benar. `skip`
+ Memperbaiki bug OpenCypher yang memungkinkan parameter yang terkandung dalam satu permintaan diganti oleh parameter yang terkandung dalam permintaan simultan lainnya.
+ Memperbaiki bug SPARQL di mana sejumlah besar nilai yang disuntikkan dalam `VALUES` klausa dapat menyebabkan penurunan kinerja.

## Versi Kueri Bahasa yang Didukung dalam Rilis Ini
<a name="engine-releases-1.2.0.2.R3-query-versions"></a>

Sebelum memutakhirkan cluster DB ke versi 1.2.0.2.R3, pastikan proyek Anda kompatibel dengan versi bahasa kueri ini:
+ *Versi paling awal Gremlin didukung:* `3.5.2`
+ *Gremlin versi terbaru didukung:* `3.5.6`
+ *Versi OpenCypher:* `Neptune-9.0.20190305-1.0`
+ *Versi SPARQL:* `1.1`

## Tingkatkan Jalur ke Rilis Mesin 1.2.0.2.R3
<a name="engine-releases-1.2.0.2.R3-upgrade-paths"></a>

Cluster DB Neptunus Anda akan ditingkatkan ke rilis patch pemeliharaan ini secara otomatis selama jendela pemeliharaan berikutnya jika Anda menjalankan versi engine. `1.2.0.2`

## Peningkatan ke Rilis Ini
<a name="engine-releases-1.2.0.2.R3-upgrading"></a>

Amazon Neptune 1.2.0.2.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:

```
1. aws neptune modify-db-cluster \
2.     --db-cluster-identifier (your-neptune-cluster) \
3.     --engine-version 1.2.0.2 \
4.     --apply-immediately
```

Untuk Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.0.2 ^
4.     --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
<a name="engine-1.2.0.2.R3-test-before-upgrading"></a>

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
<a name="engine-1.2.0.2.R3-snapshot-before-upgrading"></a>

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 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 yang tertunda sedang dalam proses](manage-console-maintaining), 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](cluster-maintenance.md). Jika Anda memiliki pertanyaan atau masalah, tim AWS Support tersedia di forum komunitas dan melalui [AWS Premium Support](https://aws.amazon.com/support).

# Mesin Amazon Neptunus Versi 1.2.0.2.R2 (2022-12-15)
<a name="engine-releases-1.2.0.2.R2"></a>

Pada 2022-12-15, versi mesin 1.2.0.2.R2 umumnya 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:**  
[Engine release 1.2.0.0](engine-releases-1.2.0.0.md) memperkenalkan format baru untuk grup parameter kustom dan grup parameter cluster kustom. Akibatnya, jika Anda memutakhirkan dari versi engine lebih awal dari 1.2.0.0 ke engine versi 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 parameter`neptune1`, dan grup parameter tersebut tidak akan berfungsi dengan rilis 1.2.0.0 ke atas. Untuk informasi selengkapnya, lihat [Grup parameter Amazon Neptunus](parameter-groups.md).
Engine release 1.2.0.0 juga memperkenalkan format baru untuk membatalkan log. Akibatnya, setiap log pembatalan yang dibuat oleh versi mesin sebelumnya harus dibersihkan dan [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch metrik harus jatuh ke nol sebelum peningkatan apa pun dari versi yang lebih awal dari 1.2.0.0 dapat dimulai. Jika ada terlalu banyak catatan log undo (200.000 atau lebih) saat Anda mencoba memulai pembaruan, upaya pemutakhiran dapat habis sementara menunggu pembersihan log pembatalan selesai.  
Anda dapat mempercepat tingkat pembersihan dengan memutakhirkan instance penulis cluster, di mana pembersihan terjadi. Melakukan itu sebelum mencoba memutakhirkan dapat menurunkan jumlah log batal 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 mengeksplorasi 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 membutuhkan 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 endpoint. Lihat [Menggunakan protokol Bolt](access-graph-opencypher-bolt.md) sebagai contoh.

## Perbaikan dalam Rilis Mesin Ini
<a name="engine-releases-1.2.0.2.R2-improvements"></a>
+ Peningkatan kinerja kueri OpenCypher yang melibatkan dan. `MERGE` `OPTIONAL MATCH`
+ Peningkatan kinerja query OpenCypher yang melibatkan `UNWIND` daftar peta nilai literal.
+ Peningkatan kinerja kueri OpenCypher yang memiliki filter untuk. `IN` `id` Misalnya:

  ```
  MATCH (n) WHERE id(n) IN ['1', '2', '3'] RETURN n
  ```
+ Peningkatan kinerja dan perbaikan kebenaran untuk berbagai operator Gremlin, termasuk`repeat`,,, dan. `coalesce` `store` `aggregate`

## Perbaikan Cacat dalam Rilis Mesin Ini
<a name="engine-releases-1.2.0.2.R2-defects"></a>
+ Memperbaiki bug OpenCypher di mana kueri mengembalikan string,`"null"`, bukan nilai null di Bolt dan SPARQL-JSON.
+ Memperbaiki bug Gremlin yang menyebabkan label langkah yang dilampirkan `UnionStep` tidak disebarkan ke elemen jalur terakhir dari lintasan turunannya.
+ Memperbaiki bug Gremlin yang menyebabkan `valueMap()` tidak dioptimalkan di bawah `by()` traversal di mesin DFE.
+ Memperbaiki bug Gremlin di mana kueri baca yang dieksekusi sebagai bagian dari transaksi Gremlin yang lebih lama tidak akan mengunci baris.
+ Memperbaiki bug log audit yang menyebabkan informasi yang tidak perlu dicatat dan bidang tertentu hilang dari log.
+ Memperbaiki bug log audit di mana IAM ARN permintaan HTTP ke kluster DB berkemampuan IAM tidak direkam.
+ Memperbaiki bug lookup-cache sehingga dapat membatasi memori tambahan yang digunakan untuk menulis ke cache.
+ Memperbaiki bug lookup-cache yang melibatkan pengaturan mode hanya-baca untuk cache pencarian saat penulisan gagal.

## Versi Kueri Bahasa yang Didukung dalam Rilis Ini
<a name="engine-releases-1.2.0.2.R2-query-versions"></a>

Sebelum memutakhirkan cluster DB ke versi 1.2.0.2.R2, 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.2.0.2.R2
<a name="engine-releases-1.2.0.2.R2-upgrade-paths"></a>

Cluster DB Neptunus Anda akan ditingkatkan ke rilis patch pemeliharaan ini secara otomatis selama jendela pemeliharaan berikutnya jika Anda menjalankan versi engine. `1.2.0.2`

## Peningkatan ke Rilis Ini
<a name="engine-releases-1.2.0.2.R2-upgrading"></a>

Amazon Neptune 1.2.0.2.R2 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:

```
1. aws neptune modify-db-cluster \
2.     --db-cluster-identifier (your-neptune-cluster) \
3.     --engine-version 1.2.0.2 \
4.     --apply-immediately
```

Untuk Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.0.2 ^
4.     --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
<a name="engine-1.2.0.2.R2-test-before-upgrading"></a>

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
<a name="engine-1.2.0.2.R2-snapshot-before-upgrading"></a>

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](manage-console-maintaining), 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](cluster-maintenance.md). Jika Anda memiliki pertanyaan atau masalah, tim AWS Support tersedia di forum komunitas dan melalui [AWS Premium Support](https://aws.amazon.com/support).