

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.1.0 (2023-03-08)
<a name="engine-releases-1.2.1.0"></a>

Pada 2023-03-08, engine versi 1.2.1.0 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.1.0-patches"></a>
+ [Rilis: 1.2.1.0.R2 (2023-05-02)](engine-releases-1.2.1.0.R2.md) 
+ [Rilis: 1.2.1.0.R3 (2023-06-13)](engine-releases-1.2.1.0.R3.md) 
+ [Rilis: 1.2.1.0.R4 (2023-08-10)](engine-releases-1.2.1.0.R4.md) 
+ [Rilis: 1.2.1.0.R5 (2023-09-02)](engine-releases-1.2.1.0.R5.md) 
+ [Rilis: 1.2.1.0.R6 (2023-09-12)](engine-releases-1.2.1.0.R6.md) 
+ [Rilis: 1.2.1.0.R7 (2023-10-06)](engine-releases-1.2.1.0.R7.md) 

## Fitur Baru dalam Rilis Mesin Ini
<a name="engine-releases-1.2.1.0-features"></a>
+ Menambahkan dukungan untuk [TinkerPop 3.6.2](https://tinkerpop.apache.org/docs/3.6.2-SNAPSHOT/dev/provider/), yang menambahkan banyak fitur Gremlin baru seperti yang baru`mergeV()`,,`mergeE()`, `element()` dan langkah-langkah. `fail()` `mergeE()`Langkah-langkah `mergeV()` dan adalah catatan khusus karena mereka menawarkan opsi deklaratif yang telah lama ditunggu-tunggu untuk melakukan operasi seperti upsert, 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 ke `property()` langkah yang mengambil`Map`, dan revisi besar perilaku `by()` modulasi yang jauh lebih konsisten di semua langkah yang menggunakannya.

  Lihat [log TinkerPop perubahan](https://github.com/apache/tinkerpop/blob/3.6.0/CHANGELOG.asciidoc#release-3-6-0) dan [halaman pemutakhiran](https://tinkerpop.apache.org/docs/current/upgrade/) untuk informasi tentang perubahan di versi 3.6 dan hal-hal yang perlu dipertimbangkan saat memutakhirkan.

  [https://tinkerpop.apache.org/docs/3.6.0/reference/#mergevertex-step](https://tinkerpop.apache.org/docs/3.6.0/reference/#mergevertex-step) Neptunus menggunakan pola penguncian yang lebih sempit `Merge` untuk daripada `Coalesce` for, yang dapat mengurangi pengecualian modifikasi bersamaan (). CMEs

  Untuk informasi lebih lanjut tentang fitur baru yang tersedia dalam TinkerPop rilis ini, lihat blog Stephen Mallette, [Menjelajahi fitur baru Apache TinkerPop 3.6.x di Amazon](https://aws.amazon.com/blogs/database/exploring-new-features-of-apache-tinkerpop-3-6-x-in-amazon-neptune/) Neptunus.
+ Menambahkan dukungan untuk [tipe instans R6i](https://aws.amazon.com/ec2/instance-types/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 per vCPU hingga 20% lebih tinggi daripada jenis instans R5 yang sebanding.
+ Menambahkan titik akhir [API ringkasan grafik](neptune-graph-summary.md) 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 read-only label node dan edge dan kunci properti, bersama dengan jumlah node, tepi, dan properti. Untuk grafik RDF, ini menyediakan daftar kelas dan kunci predikat, bersama dengan jumlah paha depan, subjek, dan predikat.

  Perubahan berikut sejalan dengan API ringkasan grafik baru:
  + Menambahkan aksi [GetGraphSummary](iam-dp-actions.md#getgraphsummary)dataplane baru.
  + Menambahkan `rdf/statistics` endpoint baru untuk menggantikan `sparql/statistics` endpoint, yang sekarang sudah usang.
  + Mengubah nama `summary` bidang dalam respons status statistik`signatureInfo`, agar tidak membingungkan dengan informasi ringkasan grafik. Versi mesin sebelumnya terus digunakan `summary` dalam respons JSON.
  + Mengubah ketepatan `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 diuraikan.
  + Menambahkan keajaiban [`%statistics`](notebooks-magics.md#notebooks-line-magics-statistics)baris baru di Workbench yang memungkinkan Anda mengambil statistik mesin DFE.
  + Menambahkan sihir [`%summary`](notebooks-magics.md#notebooks-line-magics-summary)baris baru di Workbench yang memungkinkan Anda mengambil informasi ringkasan grafik.
+ Menambahkan [pencatatan kueri lambat](slow-query-logs.md) ke kueri log yang membutuhkan waktu lebih lama untuk dieksekusi daripada ambang batas yang ditentukan. [Anda mengaktifkan dan mengontrol logging query lambat menggunakan dua parameter dinamis baru, yaitu [neptune\$1enable\$1slow\$1query\$1log, dan neptune\$1slow\$1query\$1log\$1threshold](parameters.md#parameters-db-cluster-parameters-neptune_enable_slow_query_log).](parameters.md#parameters-db-cluster-parameters-neptune_slow_query_log_threshold)
+ [Menambahkan dukungan untuk dua [parameter dinamis, yaitu parameter](parameter-groups.md) cluster baru, neptune\$1enable\$1slow\$1query\$1log, dan [neptune\$1slow\$1query\$1log\$1threshold](parameters.md#parameters-db-cluster-parameters-neptune_enable_slow_query_log).](parameters.md#parameters-db-cluster-parameters-neptune_slow_query_log_threshold) Ketika Anda membuat perubahan ke parameter dinamis, itu akan segera berlaku, tanpa memerlukan reboot instance apa pun.
+ Menambahkan fungsi OpenCypher [removeKeyFromMap ()](access-graph-opencypher-extensions.md#opencypher-compliance-removeKeyFromMap-function) khusus Neptunus yang menghapus kunci tertentu dari peta dan mengembalikan peta baru yang dihasilkan.

## Perbaikan dalam Rilis Mesin Ini
<a name="engine-releases-1.2.1.0-improvements"></a>
+ Memperluas dukungan Gremlin DFE untuk `limit` langkah-langkah dengan cakupan lokal.
+ Menambahkan dukungan `by()` modulasi untuk Gremlin `DedupGlobalStep` di mesin DFE.
+ Menambahkan dukungan DFE untuk Gremlin `SelectStep` dan. `SelectOneStep`
+ Peningkatan kinerja dan perbaikan kebenaran untuk berbagai operator Gremlin, termasuk`repeat`,,, dan. `coalesce` `store` `aggregate`
+ 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
  ```
+ Menambahkan kemampuan untuk menentukan IRI dasar untuk kueri SPARQL menggunakan pernyataan BASE (lihat). [Basis IRI default untuk kueri dan pembaruan](feature-sparql-compliance.md#opencypher-compliance-default-iri)
+ Mempersingkat waktu tunggu pemrosesan beban untuk beban curah khusus tepi Gremlin dan OpenCypher.
+ Pemuatan massal yang dibuat dilanjutkan secara asinkron saat Neptunus memulai ulang untuk menghindari waktu tunggu yang lama yang disebabkan oleh masalah konektivitas Amazon S3 sebelum gagal melanjutkan upaya.
+ Peningkatan penanganan kueri SPARQL DESCRIBE yang memiliki petunjuk kueri [DescribeMode](sparql-query-hints-for-describe.md#sparql-query-hints-describeMode) yang disetel ke `"CBD"` (deskripsi terbatas ringkas) dan yang melibatkan sejumlah besar node kosong.

## Perbaikan Cacat dalam Rilis Mesin Ini
<a name="engine-releases-1.2.1.0-defects"></a>
+ Memperbaiki bug OpenCypher di mana kueri mengembalikan string,`"null"`, bukan 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 `limit` sebagai traversal 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 klausa. `FROM NAMED`
+ 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 DESKRIPSI SPARQL sehubungan dengan grafik default](sparql-default-describe.md).
+ Memperbaiki bug SPARQL sehingga pesan pengecualian yang benar dikembalikan ketika karakter null ditolak.
+ Memperbaiki bug [penjelasan](sparql-explain.md) SPARQL yang memengaruhi paket yang berisi operator. [PipelinedHashIndexJoin](sparql-explain-operators.md#sparql-explain-operator-pipeline-hash-index-join)
+ Memperbaiki bug yang menyebabkan kesalahan internal dilemparkan saat kueri yang mengembalikan nilai konstan dikirimkan.
+ Memperbaiki masalah dengan logika detektor kebuntuan yang terkadang membuat mesin tidak responsif.

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

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
<a name="engine-releases-1.2.1.0-upgrade-paths"></a>

[Anda dapat memutakhirkan ke rilis ini secara manual dari rilis mesin Neptunus sebelumnya yang lebih besar dari atau sama dengan 1.1.0.0.](engine-releases-1.1.0.0.md)

**catatan**  
Dimulai dengan [rilis mesin 1.2.0.0](engine-releases-1.2.0.0.md), semua grup parameter khusus dan grup parameter cluster khusus yang Anda gunakan dengan versi mesin lebih awal dari sekarang `1.2.0.0` harus dibuat ulang menggunakan keluarga grup parameter. `neptune1.2` Rilis sebelumnya menggunakan keluarga grup parameter`neptune1`, dan grup parameter tersebut tidak akan berfungsi dengan rilis dari `1.2.0.0` seterusnya. Untuk informasi selengkapnya, lihat [Grup parameter Amazon Neptunus](parameter-groups.md).

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

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

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:

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

Untuk Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.1.0 ^
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.1.0-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.1.0-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.1.0.R7 (2023-10-06)
<a name="engine-releases-1.2.1.0.R7"></a>

Pada 2023-10-06, versi mesin 1.2.1.0.R7 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 Cacat dalam Rilis Mesin Ini
<a name="engine-releases-1.2.1.0.R7-defects"></a>
+ Memperbaiki bug di mana dalam beberapa kasus transaksi yang gagal tidak ditutup dengan benar.

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

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

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

Amazon Neptune 1.2.1.0.R7 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.1.0 \
4.     --apply-immediately
```

Untuk Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.1.0 ^
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.1.0.R7-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.1.0.R7-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).

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

Pada 2023-09-12, versi mesin 1.2.1.0.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.

## Fitur Baru dalam Rilis Mesin Ini
<a name="engine-releases-1.2.1.0.R6-features"></a>
+ Merilis API [data Neptunus](data-api.md).

  API data Amazon Neptune menyediakan dukungan SDK untuk memuat data, menjalankan kueri, mendapatkan informasi tentang data Anda, dan menjalankan operasi pembelajaran mesin. Ini mendukung bahasa query Gremlin dan OpenCypher di Neptunus dan tersedia dalam semua bahasa SDK. Ini secara otomatis menandatangani permintaan API dan sangat menyederhanakan integrasi Neptunus ke dalam aplikasi.

## Perbaikan Cacat dalam Rilis Mesin Ini
<a name="engine-releases-1.2.1.0.R6-defects"></a>
+ Memperbaiki bug yang dapat menyebabkan lonjakan CPU di bawah beban tinggi saat log Kueri Lambat diaktifkan.
+ Memperbaiki bug Gremlin di mana menambahkan tepi dan propertinya diikuti oleh `inV()` atau `outV()` memunculkan file. `InternalFailureException`
+ Memperbaiki beberapa masalah dengan rantai peran IAM yang menyebabkan penurunan kinerja bulk-loader dalam beberapa kasus.

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

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

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

Amazon Neptunus 1.2.1.0.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.1.0 \
4.     --apply-immediately
```

Untuk Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.1.0 ^
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.1.0.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.1.0.R6-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.1.0.R5 (2023-09-02)
<a name="engine-releases-1.2.1.0.R5"></a>

Pada 2023-09-02, versi mesin 1.2.1.0.R5 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.

## Fitur Baru dalam Rilis Mesin Ini
<a name="engine-releases-1.2.1.0.R5-features"></a>
+ Merilis API [data Neptunus](data-api.md).

  API data Amazon Neptune menyediakan dukungan SDK untuk memuat data, menjalankan kueri, mendapatkan informasi tentang data Anda, dan menjalankan operasi pembelajaran mesin. Ini mendukung bahasa query Gremlin dan OpenCypher di Neptunus dan tersedia dalam semua bahasa SDK. Ini secara otomatis menandatangani permintaan API dan sangat menyederhanakan integrasi Neptunus ke dalam aplikasi.

## Perbaikan Cacat dalam Rilis Mesin Ini
<a name="engine-releases-1.2.1.0.R5-defects"></a>
+ Memperbaiki bug Gremlin di mana menambahkan tepi dan propertinya diikuti oleh `inV()` atau `outV()` memunculkan file. `InternalFailureException`
+ Memperbaiki beberapa masalah dengan rantai peran IAM yang menyebabkan penurunan kinerja bulk-loader dalam beberapa kasus.

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

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

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

Amazon Neptune 1.2.1.0.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.1.0 \
4.     --apply-immediately
```

Untuk Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.1.0 ^
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.1.0.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 meningkatkan
<a name="engine-1.2.1.0.R5-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 [Dukungan AWS Premium](https://aws.amazon.com/support).

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

Pada 2023-08-10, versi mesin 1.2.1.0.R4 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 dalam Rilis Mesin Ini
<a name="engine-releases-1.2.1.0.R4-improvements"></a>
+ Tambahkan dukungan [Graphson-1.0](https://tinkerpop.apache.org/docs/3.4.1/dev/io/#graphson) untuk Gremlin. Untuk menggunakan Graphson-1.0, lulus `Accept header` dengan nilai:

  ```
  application/vnd.gremlin-v1.0+json;types=false
  ```

## Perbaikan Cacat dalam Rilis Mesin Ini
<a name="engine-releases-1.2.1.0.R4-defects"></a>
+ 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.
+ Memperbaiki bug di log kueri lambat untuk memastikan bahwa mereka tidak aktif saat dinonaktifkan.

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

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

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

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

Amazon Neptunus 1.2.1.0.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.1.0 \
4.     --apply-immediately
```

Untuk Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.1.0 ^
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.1.0.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.1.0.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 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.1.0.R3 (2023-06-13)
<a name="engine-releases-1.2.1.0.R3"></a>

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 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.

## Fitur Baru dalam Rilis Mesin Ini
<a name="engine-releases-1.2.1.0.R3-features"></a>
+ Menambahkan dukungan untuk pemuatan massal lintas akun menggunakan rantai [peran IAM](bulk-load-tutorial-chain-roles.md).

## Perbaikan dalam Rilis Mesin Ini
<a name="engine-releases-1.2.1.0.R3-improvements"></a>
+ Meningkatkan `fail()` langkah Gremlin untuk membedakan pengecualian yang dihasilkannya dari generik `InternalFailureException` dan untuk memastikan bahwa setiap pesan yang diberikan pengguna yang diberikan padanya disebarkan kembali ke penelepon.
+ Peningkatan optimasi mesin kueri Gremlin untuk`store`,,,`aggregate`, `cap` dan. `limit` `hasLabel`
+ Ditambahkan dukungan untuk fungsi trignometrik OpenCypher:
  + `acos()`
  + `asin()`
  + `atan()`
  + `atan2()`
  + `cos()`
  + `cot()`
  + `degrees()`
  + `pi()`
  + `radians()`
  + `sin()`
  + `tan()`
+ Ditambahkan dukungan untuk beberapa fungsi agregasi OpenCypher:
  + `percentileDisc()`
  + `stDev()`
+ Ditambahkan dukungan untuk `epochmillis()` fungsi OpenCypher yang mengkonversi ke. `datetime` `epochmillis` Misalnya:

  ```
  MATCH (n) RETURN epochMillis(n.someDateTime)
  1698972364782
  ```
+ Ditambahkan dukungan untuk OpenCypher modulo () operator. `%`
+ Menambahkan dukungan untuk alat OpenCypher Static Debug Explain.
+ Ditambahkan dukungan untuk fungsi OpenCypher`randomUUID()`.
+ Peningkatan kinerja OpenCypher:
  + Meningkatkan parser dan query planner.
  + 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)
    ```
  + Paket kueri yang dioptimalkan untuk pola kueri multi-hop seperti:

    ```
    MATCH (n)-->()-->()-->(m)
    RETURN n m
    ```
  + Meningkatkan kinerja daftar dan injeksi peta melalui kueri parameter. Misalnya:

    ```
    UNWIND $idList as id MATCH (n {`~id`: id})
    RETURN n.name
    ```
  + Peningkatan eksekusi query yang mengandung `WITH` dengan menjadikannya penghalang yang tepat.
  + Dioptimalkan untuk menghindari perwujudan nilai dalam `Unfold` dan fungsi agregasi yang berlebihan.
+ Meningkatkan kinerja query 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 CBD SPARQL.

## Perbaikan Cacat dalam Rilis Mesin Ini
<a name="engine-releases-1.2.1.0.R3-defects"></a>
+ Memperbaiki bug Gremlin di mana kueri panjang dengan deep nesting 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 atau. `mergeV` `mergeE`

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

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
<a name="engine-releases-1.2.1.0.R3-upgrade-paths"></a>

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

Amazon Neptunus 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:

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

Untuk Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.1.0 ^
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.1.0.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 meng-upgrade
<a name="engine-1.2.1.0.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.1.0.R2 (2023-05-02)
<a name="engine-releases-1.2.1.0.R2"></a>

Pada 2023-05-02, versi mesin 1.2.1.0.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, 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.1.0.R2-improvements"></a>
+ 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.
+ Menambahkan dukungan multi-label untuk Gremlin `mergeV()` dan. `mergeE()`

## Perbaikan Cacat dalam Rilis Mesin Ini
<a name="engine-releases-1.2.1.0.R2-defects"></a>
+ 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 OpenCypher di mana log kueri lambat tidak berisi waktu kueri yang benar.
+ Memperbaiki bug Gremlin di mana kebocoran transaksi dapat terjadi ketika kueri yang berisi `GroupCountStep` dikirimkan sebagai string.
+ Memperbaiki bug Gremlin di mana WebSocket kueri gagal saat log kueri lambat diaktifkan.
+ Memperbaiki bug Gremlin di mana log debug penghitung penyimpanan hilang di log kueri lambat untuk permintaan. WebSocket 
+ Memperbaiki beberapa bug Gremlin yang melibatkan `mergeV()` dan. `mergeE()`
+ Memperbaiki bug SPARQL di mana biaya kueri grafik bernama salah estimasi, yang mengarah ke rencana dan kesalahan kueri yang kurang optimal. out-of-memory
+ Memperbaiki bug yang memengaruhi otorisasi untuk kueri Gremlin dan OpenCypher pada cluster yang mendukung IAM.

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

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

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

Amazon Neptunus 1.2.1.0.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.1.0 \
4.     --apply-immediately
```

Untuk Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.1.0 ^
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.1.0.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.1.0.R2-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).