

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Neptune エンジンバージョン 1.0.2.1 (2019-11-22)
<a name="engine-releases-1.0.2.1"></a>

## このリリースの後続のパッチリリース
<a name="engine-releases-1.0.2.1-patches"></a>
+ [リリース：1.0.2.1.R6 (2020-04-22)](engine-releases-1.0.2.1.R6.md) 
+ [リリース：1.0.2.1.R5（2020-04-22）](engine-releases-1.0.2.1.R5.md) *このパッチリリースはデプロイされませんでした。*
+ [リリース：1.0.2.1.R4（2019-12-20）](engine-releases-1.0.2.1.R4.md) 
+ [リリース：1.0.2.1.R3 (2019-12-12)](engine-releases-1.0.2.1.R3.md) 
+ [リリース：1.0.2.1.R2 (2019-11-25)](engine-releases-1.0.2.1.R2.md) 

## このエンジンリリースの新機能
<a name="engine-releases-1.0.2.1-features"></a>
+ Amazon OpenSearch Service との統合により、フルテキスト検索機能を追加しました。[Neptune フルテキスト検索](full-text-search.md) を参照してください。
+ 多数の述語に対して 4 番目のインデックス (OSGP インデックス) を作成するためにラボモードを使用するオプションを追加しました。「[OSGP インデックス](features-lab-mode.md#features-lab-mode-features-osgp-index)」を参照してください。
+ SPARQL Explain に*詳細*モードを追加しました。詳細については、「[SPARQL `explain` を使う](sparql-explain-using.md)」と「[詳細モード出力](sparql-explain-examples.md#sparql-explain-example-details)」を参照してください。
+ エンジンステータスレポートにラボモード情報を追加しました。詳細については、「[インスタンスのステータス](access-graph-status.md)」を参照してください。
+ DB クラスターのスナップショットを AWS リージョン間でコピーできるようになりました。「[スナップショットのコピー](backup-restore-copy-snapshot.md)」を参照してください。

## このエンジンリリースの改良点
<a name="engine-releases-1.0.2.1-improvements"></a>
+ 多数の述語を処理する際のパフォーマンスが向上しました。
+ クエリの最適化が強化されました。これはお客様には完全に透過的ですが、アプリケーションをアップグレードする前にテストし、正常に動作することを確認することをお勧めします。
+ エラー報告のマイナーな機能強化。
+ Gremlin の `.project()` ステップと `.identity()` ステップの最適化を追加しました。
+ 非ターミナル Gremlin の `.union()` ケースの最適化を追加しました。
+ Gremlin `.path().by()` トラバーサルのネイティブサポートを追加しました。
+ Gremlin `.coalesce()` のネイティブサポートを追加しました。
+ 一括書き込みのさらなる最適化。
+ HTTPS 接続では、期限切れの安全でない暗号が使用されないように、TLS バージョン 1.2 以上の使用が要求されるようになりました。

## このエンジンリリースで修正された不具合
<a name="engine-releases-1.0.2.1-defects"></a>
+ Gremlin `addE()` 内部トラバーサル処理のバグを修正しました。
+ AST 注釈が子トラバーサルから親にリークすることで引き起こされる Gremlin のバグを修正しました。
+ `.otherV()` が `select()` の後で呼び出されたときに Gremlin で発生するバグを修正しました。
+ `.hasLabel()` ステップの後に表示された場合、一部の `bothE()` ステップが失敗する原因となった Gremlin のバグを修正しました。
+ Gremlin の .sum() と .project() のマイナーな修正を行いました。
+ 閉じ括弧がない SPARQL クエリの処理に伴うバグを修正しました。
+ SPARQL Explain のいくつかのマイナーなバグを修正しました。
+ 複数のロードステータス取得リクエストの同時処理に伴うバグを修正しました。
+ 一部の Gremlin トラバーサルを `.project()` ステップで実行する際に消費されるメモリを削減しました。
+ SPARQL での特殊値の数値比較を修正しました。「[標準コンプライアンス](feature-overview-standards-compliance.md)」を参照してください。

## このリリースでサポートされるクエリ言語バージョン
<a name="engine-releases-1.0.2.1-query-versions"></a>

DB クラスターをバージョン 1.0.2.1 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.1`
+ *SPARQL バージョン:* `1.1`

## エンジンリリース 1.0.2.1 へのアップグレードパス
<a name="engine-releases-1.0.2.1-upgrade-paths"></a>

以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。

このリリースに自動的にアップグレードされることはありません。

## このリリースへのアップグレード
<a name="engine-releases-1.0.2.1-upgrading"></a>

Amazon Neptune 1.0.2.1 が公開されました。

DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。

Linux、OS X、Unix の場合:

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

Windows の場合:

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

更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。

### アップグレードの前に必ずテストする
<a name="engine-1.0.2.1-test-before-upgrading"></a>

新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。

まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。

本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。

### アップグレードの前に必ずスナップショットを手動で作成してください
<a name="engine-1.0.2.1-snapshot-before-upgrading"></a>

アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。

場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。

DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。

**注記**  
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。  

```
   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.
```
このエラーが発生した場合は、保留中のアクションが終了するのを待つか、すぐにメンテナンスウィンドウをトリガーして、前回のアップグレードを完了させます。

お使いのエンジンバージョンのアップグレードの詳細については、[Amazon Neptune DB クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。

# Amazon Neptune エンジンバージョン 1.0.2.1.R6 (2020-04-22)
<a name="engine-releases-1.0.2.1.R6"></a>

2020 年 4 月 22 日現在、エンジンバージョン1.0.2.1.R6 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。

## このエンジンリリースで修正された不具合
<a name="engine-releases-1.0.2.1.R6-defects"></a>
+ `ConcurrentModificationConflictException` と `TransactionException` が `NeptuneGremlinException` に変換されず、`InternalFailureException` がお客様に返送される不具合を修正しました。
+ サーバーの準備が完了する前に、Neptune によりステータスが正常と報告されるバグを修正しました。
+ 2 つの `value->id` マッピングを同時に挿入すると、ディクショナリとユーザートランザクションのコミットが機能しない不具合を修正しました。
+ ロードステータスのシリアル化の不具合を修正しました。
+ Gremlin セッションの不具合を修正しました。
+ サーバーの起動に失敗したときに、Neptune により例外がスローされない不具合を修正しました。
+ チャンネルを閉じる前に Neptune がウェブソケットクローズフレームを送信できない不具合を修正しました。

## このリリースでサポートされるクエリ言語バージョン
<a name="engine-releases-1.0.2.1.R6-query-versions"></a>

DB クラスターをバージョン 1.0.2.1.R6 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.1`
+ *SPARQL バージョン:* `1.1`

## エンジンリリース 1.0.2.1.R6 へのアップグレードパス
<a name="engine-releases-1.0.2.1.R6-upgrade-paths"></a>

エンジンバージョン `1.0.2.1` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。

以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。

## このリリースへのアップグレード
<a name="engine-releases-1.0.2.1.R6-upgrading"></a>

Amazon Neptune 1.0.2.1.R6 が一般に利用可能になりました。

DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。

Linux、OS X、Unix の場合:

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

Windows の場合:

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

更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。

### アップグレードの前に必ずテストする
<a name="engine-1.0.2.1.R6-test-before-upgrading"></a>

新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。

まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。

本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。

### アップグレードの前に必ずスナップショットを手動で作成してください
<a name="engine-1.0.2.1.R6-snapshot-before-upgrading"></a>

アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。

場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。

DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。

**注記**  
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。  

```
   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.
```
このエラーが発生した場合は、保留中のアクションが終了するのを待つか、すぐにメンテナンスウィンドウをトリガーして、前回のアップグレードを完了させます。

お使いのエンジンバージョンのアップグレードの詳細については、[Amazon Neptune DB クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。

# Amazon Neptune エンジンバージョン 1.0.2.1.R5 (2020-04-22)
<a name="engine-releases-1.0.2.1.R5"></a>

エンジンリリース 1.0.2.1.R5 はデプロイされませんでした。

# Amazon Neptune エンジンバージョン 1.0.2.1.R4 (2019-12-20)
<a name="engine-releases-1.0.2.1.R4"></a>

## このエンジンリリースの改良点
<a name="engine-releases-1.0.2.1.R4-improvements"></a>
+ Neptune は、すべてのフルテキスト検索呼び出しを実行パイプラインで常に最初に試行するようになりました。これにより、OpenSearch への呼び出し量が減り、パフォーマンスが大幅に向上します。「[フルテキスト検索クエリの実行](full-text-search-query-execution.md)」を参照してください。
+ Neptune は、存在しないプロパティ、頂点、エッジにアクセスしようとした場合に `IllegalArgumentException` を発生させるようになりました。以前は、Neptune ではその状況で `UnsupportedOperationException` が発生しました。

  たとえば、存在しない頂点を参照するエッジを追加しようとすると、`IllegalArgumentException` が発生します。

## このエンジンリリースで修正された不具合
<a name="engine-releases-1.0.2.1.R4-defects"></a>
+ `union` 内部の `project-by` トラバーサルが結果を返さないか、誤った結果が返される Gremlin のバグを修正しました。
+ ネストされた `.project().by()` ステップが誤った結果を返す原因となっていた Gremlin のバグを修正しました。

## このリリースでサポートされるクエリ言語バージョン
<a name="engine-releases-1.0.2.1.R4-query-versions"></a>

DB クラスターをバージョン 1.0.2.1.R4 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.1`
+ *SPARQL バージョン:* `1.1`

## エンジンリリース 1.0.2.1.R4 へのアップグレードパス
<a name="engine-releases-1.0.2.1.R4-upgrade-paths"></a>

以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。

ただし、**このリリースへの自動更新はサポートされていません**。

## このリリースへのアップグレード
<a name="engine-releases-1.0.2.1.R4-upgrading"></a>

Amazon Neptune 1.0.2.1.R4 が一般的に利用可能になりました。

DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。

Linux、OS X、Unix の場合:

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

Windows の場合:

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

更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。

### アップグレードの前に必ずテストする
<a name="engine-1.0.2.1.R4-test-before-upgrading"></a>

新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。

まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。

本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。

### アップグレードの前に必ずスナップショットを手動で作成してください
<a name="engine-1.0.2.1.R4-snapshot-before-upgrading"></a>

アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。

場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。

DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。

**注記**  
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。  

```
   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.
```
このエラーが発生した場合は、保留中のアクションが終了するのを待つか、すぐにメンテナンスウィンドウをトリガーして、前回のアップグレードを完了させます。

お使いのエンジンバージョンのアップグレードの詳細については、[Amazon Neptune DB クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。

# Amazon Neptune エンジンバージョン 1.0.2.1.R3 (2019-12-12)
<a name="engine-releases-1.0.2.1.R3"></a>

## このエンジンリリースで修正された不具合
<a name="engine-releases-1.0.2.1.R3-defects"></a>
+ `OSGP` パラメータの [ラボモード](features-lab-mode.md) 値を使用して、`ObjectIndex` で機能を正しく有効化していても、`neptune_lab_mode` インデックスが無効になっていたバグを修正しました。
+ `.fold()` ステップ内にある `.project().by()` を使用して Gremlin クエリに影響したバグを修正しました。たとえば、次のクエリは不完全な結果を返します。

  ```
  g.V().project("a").by(valueMap().fold())
  ```
+ RDF データのバルクロードにおけるパフォーマンスのボトルネックを修正しました。
+ ストリームが有効化され、レプリカがプライマリの前に再起動されたときに、レプリカでクラッシュするバグを修正しました。
+ インスタンスのローテーションされた SSL 証明書が、インスタンスの再起動なしに取得されなかったバグを修正しました。

## このリリースでサポートされるクエリ言語バージョン
<a name="engine-releases-1.0.2.1.R3-query-versions"></a>

DB クラスターをバージョン 1.0.2.1.R3 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.1`
+ *SPARQL バージョン:* `1.1`

## エンジンリリース 1.0.2.1.R3 へのアップグレードパス
<a name="engine-releases-1.0.2.1.R3-upgrade-paths"></a>

以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。

ただし、**このリリースへの自動更新はサポートされていません**。

## このリリースへのアップグレード
<a name="engine-releases-1.0.2.1.R3-upgrading"></a>

Amazon Neptune 1.0.2.1.R3 が一般に利用可能になりました。

DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。

Linux、OS X、Unix の場合:

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

Windows の場合:

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

更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。

### アップグレードの前に必ずテストする
<a name="engine-1.0.2.1.R3-test-before-upgrading"></a>

新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。

まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。

本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。

### アップグレードの前に必ずスナップショットを手動で作成してください
<a name="engine-1.0.2.1.R3-snapshot-before-upgrading"></a>

アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。

場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。

DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。

**注記**  
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。  

```
   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.
```
このエラーが発生した場合は、保留中のアクションが終了するのを待つか、すぐにメンテナンスウィンドウをトリガーして、前回のアップグレードを完了させます。

お使いのエンジンバージョンのアップグレードの詳細については、[Amazon Neptune DB クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。

# Amazon Neptune エンジンバージョン 1.0.2.1.R2 (2019-11-25)
<a name="engine-releases-1.0.2.1.R2"></a>

## このエンジンリリースで修正された不具合
<a name="engine-releases-1.0.2.1.R2-defects"></a>
+ ラウンドロビン以外の副次トラバーサルと `project().by()` 以外の副次トラバーサルを使用するすべての `path()` クエリに影響するバグを修正しました。

## このリリースでサポートされるクエリ言語バージョン
<a name="engine-releases-1.0.2.1.R2-query-versions"></a>

DB クラスターをバージョン 1.0.2.1.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.1`
+ *SPARQL バージョン:* `1.1`

## エンジンリリース 1.0.2.1.R2 へのアップグレードパス
<a name="engine-releases-1.0.2.1.R2-upgrade-paths"></a>

以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。

ただし、**このリリースへの自動更新はサポートされていません**。

## このリリースへのアップグレード
<a name="engine-releases-1.0.2.1.R2-upgrading"></a>

Amazon Neptune 1.0.2.1.R2 が一般に利用可能になりました。

DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。

Linux、OS X、Unix の場合:

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

Windows の場合:

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

更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。

### アップグレードの前に必ずテストする
<a name="engine-1.0.2.1.R2-test-before-upgrading"></a>

新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。

まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。

本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。

### アップグレードの前に必ずスナップショットを手動で作成してください
<a name="engine-1.0.2.1.R2-snapshot-before-upgrading"></a>

アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。

場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。

DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。

**注記**  
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。  

```
   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.
```
このエラーが発生した場合は、保留中のアクションが終了するのを待つか、すぐにメンテナンスウィンドウをトリガーして、前回のアップグレードを完了させます。

お使いのエンジンバージョンのアップグレードの詳細については、[Amazon Neptune DB クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。