翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Neptune エンジンバージョン 1.1.1.0 (2022-04-19)
2022 年 4 月 19 日現在、エンジンバージョン 1.1.1.0 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードを正常に完了するには、すべてのアベイラビリティーゾーン (AZ) の各サブネットに、Neptune インスタンスごとに利用可能な IP アドレスが少なくとも 1 つ必要です。例えば、サブネット 1 に 1 つのライターインスタンスと 2 つのリーダーインスタンスがあり、サブネット 2 に 2 つのリーダーインスタンスがある場合、アップグレードを開始する前に、サブネット 1 には少なくとも 3 つの IP アドレスの空きがあり、サブネット 2 には少なくとも 2 つの IP アドレスが空いている必要があります。
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
## このリリースの後続のパッチリリース
+ [メンテナンスリリース: 1.1.0.0.R2 (2022-05-16)](engine-releases-1.1.1.0.R2.md)
+ [リリース: 1.1.1.0.R3 (2022-06-07)](engine-releases-1.1.1.0.R3.md)
+ [リリース: 1.1.1.0.R4 (2022-06-23)](engine-releases-1.1.1.0.R4.md)
+ [リリース: 1.1.1.0.R5 (2022-07-21)](engine-releases-1.1.1.0.R5.md)
+ [リリース: 1.1.1.0.R6 (2022-09-23)](engine-releases-1.1.1.0.R6.md)
+ [リリース: 1.1.1.0.R7 (2023-01-23)](engine-releases-1.1.1.0.R7.md)
## このエンジンリリースの新機能
+ [openCypher クエリ言語](access-graph-opencypher.md)は、本稼働環境用に一般公開されるようになりました。
**警告**
このリリースでは、IAM 認証で openCypher を使用するコードに重大な変更が加えられています。openCypher の Neptune プレビューでは、IAM シグネチャのホスト文字列に `bolt://` など、次のようなプロトコルが含まれていました。
```
"Host":"bolt://(host URL):(port)"
```
このエンジンリリース以降、このプロトコルは省略する必要があります。
```
"Host":"(host URL):(port)"
```
設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
+ TinkerPop `3.5.2` のサポートが追加されました。[このリリースの変更点](https://github.com/apache/tinkerpop/blob/3.5.2/CHANGELOG.asciidoc#release-3-5-2)には、リモートトランザクションのサポート、セッション (を使用 [https://tinkerpop.apache.org/docs/current/reference/#transactions](https://tinkerpop.apache.org/docs/current/reference/#transactions)) のバイトコードサポート、Gremlin 言語への `datetime()` 関数の追加などがあります。
**警告**
TinkerPop 3.5.0、3.5.1、3.5.2 では、Gremlin コードに影響を与える可能性のあるいくつかの重大な変更が導入されています。例えば、[GraphTraversalSource によって生成されたトラバーサルを `g.V().union(identity(), g.V())` のように子として使用しても](https://issues.apache.org/jira/browse/TINKERPOP-2361)機能しなくなります。
今度は、代わりに `g.V().union(identity(), __.V())` のような匿名トラバーサルを使用してください。
+ [IAM データアクセスポリシー](iam-admin-policies.md)で使用して、Neptune DB クラスターに保存されているデータへのアクセスを制御できる[AWS グローバル条件キー](iam-data-condition-keys.md#iam-data-global-condition-keys)のサポートが追加されました。
+ [Neptune DFE クエリエンジン](neptune-dfe-engine.md)は OpenCypher クエリ言語による本番環境での使用が可能になりましたが、Gremlin および SPARQL クエリではまだ使用できません。lab-mode パラメータではなく、独自の [neptune\$1dfe\$1query\$1engine](parameters.md#parameters-instance-parameters-neptune_dfe_query_engine) インスタンスパラメータを使用して有効化できるようになりました。
## このエンジンリリースの改良点
+ パラメータ化されたクエリサポート、パラメータ化されたクエリのための抽象構文ツリー (AST) キャッシュ、可変長パス (VLP) の改良、新しい演算子と句などの新機能が [openCypher](access-graph-opencypher.md) に追加されました。現在の言語サポートレベルについては、「[Amazon Neptune における openCypher の仕様準拠](feature-opencypher-compliance.md)」を参照してください。
+ 単純な読み取り/書き込みワークロードの openCypher のパフォーマンスを大幅に改善し、リリース 1.1.0.0 と比較してスループットが向上しました。
+ 可変長パスを処理する openCypher の双方向と深度の制限がなくなりました。
+ DFE エンジンでの Gremlin `within` および `without` 述部のサポートが完了しました。他の述語演算子と組み合わせる場合も含みます。例:
```
g.V().has('age', within(12, 15, 18).or(gt(30)))
```
+ スコープがグローバルであり (つまり `order(local)` ではない)、`by()` モジュレーターが使用されていない場合の DFE エンジンでの Gremlin `order` ステップのサポートが拡張されました。例えば、このクエリは DFE によってサポートされるようになりました。
```
g.V().values("age").order()
```
+ レコードがトランザクションの最後の操作であることを示すために、[Neptune ストリーム変更ログ](streams-using-api-reponse.md)レスポンス形式に `isLastOp` フィールドが追加されました。
+ 監査ログのパフォーマンスが大幅に向上し、監査ログが有効になっている場合の待ち時間が短縮されました。
+ Gremlin WebSocket バイトコードと HTTP クエリが、監査ログでユーザーが読み取り可能な形式に変換されました。クエリを監査ログから直接コピーして、Neptune ノートブックなどで実行できるようになりました。現在の監査ログ形式のこの変更は、重大な変更であることに注意してください。
## このエンジンリリースで修正された不具合
+ 次のクエリのように、ネストされた `filter()` および `count()` ステップを組み合わせて使用すると結果が返されないというまれな Gremlin のバグを修正しました。
```
g.V("1").filter(out("knows")
.filter(in("knows")
.hasId("notExists"))
.count())
```
+ 集約ステップによって保存された頂点を `to()` または `from()` トラバーサルで `addE` ステップと組み合わせて使用するとエラーが返される Gremlin のバグを修正しました。このようなクエリの例は以下のとおりです。
```
g.V("id").aggregate("v").out().addE().to(select("v").unfold()))
```
+ DFE エンジンを使用しているときに `not` ステップがエッジケースで失敗する Gremlin のバグを修正しました。例:
```
g.V().not(V())
```
+ `to()` および `from()` トラバーサル内で `sideEffect` 値が使用できないという Gremlin のバグを修正しました。
+ 高速リセットによってインスタンスフェイルオーバーがトリガーされることがあったバグを修正しました。
+ 失敗したトランザクションが次のロードジョブを開始する前にクローズされないバルクローダーのバグを修正しました。
+ メモリ不足によりシステムがクラッシュするバルクローダーのバグを修正しました。
+ フェイルオーバー後に IAM 認証情報が利用可能になるまでローダーが長時間待たなかったというバルクローダーのバグを修正するためのリトライを追加しました。
+ `status` エンドポイントなど、クエリ以外のエンドポイントの内部認証情報キャッシュが適切にクリアされないバグを修正しました。
+ ストリームのコミットのシーケンス番号が正しい順序になるようにストリームのバグを修正しました。
+ IAM 対応クラスターで長時間実行される接続が 10 日より早く終了するバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.1.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.1.0 へのアップグレードパス
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。メジャーバージョンエンジン (1.1.0.0) より前のバージョンでは、このリリースへのアップグレードに時間がかかることに注意してください。
このリリースに自動的にアップグレードされることはありません。
## このリリースへのアップグレード
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine neptune \
4. --engine-version 1.1.1.0 \
5. --allow-major-version-upgrade \
6. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine neptune ^
4. --engine-version 1.1.1.0 ^
5. --allow-major-version-upgrade ^
6. --apply-immediately
```
`--apply-immediately` の代わりに `--no-apply-immediately` と指定することができます。メジャーバージョンアップグレードを実行するためには、allow-major-version-upgrade パラメータが必要です。また、エンジンバージョンを含めるようにしてください。そうしないと、エンジンが別のバージョンにアップグレードされる可能性があります。
クラスターでカスタムクラスターパラメータグループを使用する場合は、必ずこのパラメータを含めて、それを指定してください。
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同様に、クラスター内のインスタンスがカスタム DB のパラメータグループを使用している場合は、必ずこのパラメータを指定して、次のようになります。
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず 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.1.1.0.R7 (2023-01-23)
2023 年 1 月 23 日現在、エンジンバージョン1.1.1.0.R7 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードを正常に完了するには、すべてのアベイラビリティーゾーン (AZ) の各サブネットに、Neptune インスタンスごとに利用可能な IP アドレスが少なくとも 1 つ必要です。例えば、サブネット 1 に 1 つのライターインスタンスと 2 つのリーダーインスタンスがあり、サブネット 2 に 2 つのリーダーインスタンスがある場合、アップグレードを開始する前に、サブネット 1 には少なくとも 3 つの IP アドレスの空きがあり、サブネット 2 には少なくとも 2 つの IP アドレスが空いている必要があります。
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
## このエンジンリリースの改良点
+ `MERGE` と `OPTIONAL MATCH` を含む openCypher クエリのパフォーマンスが向上しました。
+ リテラル値のマップのリストの `UNWIND` を含む openCypher クエリのパフォーマンスが向上しました。
+ `id` の `IN` フィルターの付いた openCypher クエリのパフォーマンスが向上しました。例:
```
MATCH (n) WHERE id(n) IN ['1', '2', '3'] RETURN n
```
+ `repeat`、`coalesce`、`store`、`aggregate` など、さまざまな Gremlin 演算子のパフォーマンスの向上と正確性の修正を行いました。
## このエンジンリリースで修正された不具合
+ HTTP キープアライブを使用するリクエストが、リクエストが失敗した後に送信された場合に誤ってクローズされる可能性がある openCypher のバグを修正しました。
+ リストまたはマップのリストでパラメータタイプが正しく解釈されないことがあるという openCypher のバグを修正しました。
+ Bolt と SPARQL-JSON でクエリが NULL 値の代わりに文字列 `"null"` を返す openCypher のバグを修正しました。
+ クエリタイムアウトエラーとメモリ不足エラーに関する openCypher エラーコードとエラーメッセージを修正しました。
+ DFE エンジンの `by()` トラバーサル時に `valueMap()` が最適化されない原因となっていた Gremlin のバグを修正しました。
+ デッドロック検出ロジックで、エンジンが応答しなくなることがあった問題を修正しました。
+ 不要な情報がログに記録されたり、特定のフィールドがログから欠落したりする監査ログのバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.1.0.R7 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.3`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.1.0.R7 へのアップグレードパス
エンジンバージョン `1.1.1.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
## このリリースへのアップグレード
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
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.1.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず 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.1.1.0.R6 (2022-09-23)
2022 年 9 月 23 日現在、エンジンバージョン1.1.1.0.R6 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードを正常に完了するには、すべてのアベイラビリティーゾーン (AZ) の各サブネットに、Neptune インスタンスごとに利用可能な IP アドレスが少なくとも 1 つ必要です。例えば、サブネット 1 に 1 つのライターインスタンスと 2 つのリーダーインスタンスがあり、サブネット 2 に 2 つのリーダーインスタンスがある場合、アップグレードを開始する前に、サブネット 1 には少なくとも 3 つの IP アドレスの空きがあり、サブネット 2 には少なくとも 2 つの IP アドレスが空いている必要があります。
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**注記**
このリリースでは、IAM 認証で openCypher を使用するコードに重大な変更が加えられています。これまでは、IAM シグネチャーのホスト文字列には、`bolt://` など、次のようなプロトコルが含まれていました。
```
"Host":"bolt://(host URL):(port)"
```
エンジンリリース `1.1.1.0` 以降、このプロトコルは省略する必要があります。
```
"Host":"(host URL):(port)"
```
設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ Gremlin `order-by` クエリのパフォーマンスが改善されました。`NeptuneGraphQueryStep` の末尾に `order-by` が付いている Gremlin クエリは、パフォーマンスを向上させるために、より大きなサイズのチャンクを使用するようになりました。これはクエリプランの内部 (ルート以外の) ノードの `order-by` には適用されません。
+ Gremlin 更新クエリのパフォーマンスが改善されました。エッジやプロパティを追加している間は、削除されないように頂点とエッジをロックする必要があります。この変更により、トランザクション内の重複ロックがなくなり、パフォーマンスが向上します。
## このエンジンリリースで修正された不具合
+ ノードとエッジが重複して作成されることがあった `MERGE` 句内の openCypher のバグが修正されました。
+ `OPTIONAL` 句内に `(NOT) EXISTS` を含む SPARQL クエリの処理において、クエリの結果が表示されない場合があるバグを修正しました。
+ 一括ロードの進行中にサーバーの再起動が遅れるバグを修正しました。
+ リレーションシッププロパティにフィルターを設定した openCypher 可変長パターンの双方向トラバーサルでエラーが発生するバグを修正しました。このような可変長パターンの例としては、`(n)-[r*1..2]->(m)` があります。
+ キャッシュされたデータをクライアントに送り返す方法に関するバグを修正しました。このバグが原因で、場合によっては予想外に長い待ち時間が発生することがありました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.1.0.R6 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.1.0.R6 へのアップグレードパス
エンジンバージョン `1.1.1.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
## このリリースへのアップグレード
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
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.1.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず 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.1.1.0.R5 (2022-07-21)
2022 年 7 月 21 日現在、エンジンバージョン1.1.1.0.R5 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードを正常に完了するには、すべてのアベイラビリティーゾーン (AZ) の各サブネットに、Neptune インスタンスごとに利用可能な IP アドレスが少なくとも 1 つ必要です。例えば、サブネット 1 に 1 つのライターインスタンスと 2 つのリーダーインスタンスがあり、サブネット 2 に 2 つのリーダーインスタンスがある場合、アップグレードを開始する前に、サブネット 1 には少なくとも 3 つの IP アドレスの空きがあり、サブネット 2 には少なくとも 2 つの IP アドレスが空いている必要があります。
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**注記**
このリリースでは、IAM 認証で openCypher を使用するコードに重大な変更が加えられています。これまでは、IAM シグネチャーのホスト文字列には、`bolt://` など、次のようなプロトコルが含まれていました。
```
"Host":"bolt://(host URL):(port)"
```
エンジンリリース `1.1.1.0` 以降、このプロトコルは省略する必要があります。
```
"Host":"(host URL):(port)"
```
設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ デッドロック検出をサポートするように改良を加えました。
## このエンジンリリースで修正された不具合
+ 特定の条件下で DB クラスターをクリーンシャットダウンできないバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.1.0.R5 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.1.0.R5 へのアップグレードパス
エンジンバージョン `1.1.1.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
## このリリースへのアップグレード
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
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.1.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず 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.1.1.0.R4 (2022-06-23)
2022 年 6 月 23 日現在、エンジンバージョン1.1.1.0.R4 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードを正常に完了するには、すべてのアベイラビリティーゾーン (AZ) の各サブネットに、Neptune インスタンスごとに利用可能な IP アドレスが少なくとも 1 つ必要です。例えば、サブネット 1 に 1 つのライターインスタンスと 2 つのリーダーインスタンスがあり、サブネット 2 に 2 つのリーダーインスタンスがある場合、アップグレードを開始する前に、サブネット 1 には少なくとも 3 つの IP アドレスの空きがあり、サブネット 2 には少なくとも 2 つの IP アドレスが空いている必要があります。
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**注記**
このリリースでは、IAM 認証で openCypher を使用するコードに重大な変更が加えられています。これまでは、IAM シグネチャーのホスト文字列には、`bolt://` など、次のようなプロトコルが含まれていました。
```
"Host":"bolt://(host URL):(port)"
```
エンジンリリース `1.1.1.0` 以降、このプロトコルは省略する必要があります。
```
"Host":"(host URL):(port)"
```
設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ インスタンスタイプのインスタンス設定が更新されました。`x2g`
+ 頂点ドロップのパフォーマンスが向上しました。
## このエンジンリリースで修正された不具合
+ 特定の種類の ASK 結合について、複数回呼び出されたり、複数のリーダーで呼び出されたクエリの順序が安定していなかったという Gremlin のバグを修正しました。
+ また、Gremlin の特定の種類の ASK 結合でパフォーマンスの低下を引き起こしていた以前のリリースの変更の範囲を絞り込みました。
+ 子トラバーサル内でエッジ入力と頂点へのトラバーサルがあった場合に発生していた `union()` ステップの Gremlin のバグを修正しました。
+ 一部のステップが実際に最適化されていても最適化されていないと報告される Gremlin プロファイルのバグを修正しました。
+ `UNION` 句にネストされた `FILTER` 式内で使用される変数に無効なスコープ情報が代入されるという SPARQL のバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.1.0.R4 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.1.0.R4 へのアップグレードパス
エンジンバージョン `1.1.1.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
## このリリースへのアップグレード
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
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.1.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず 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.1.1.0.R3 (2022-06-07)
2022 年 6 月 7 日現在、エンジンバージョン1.1.1.0.R3 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**注記**
このリリースでは、IAM 認証で openCypher を使用するコードに重大な変更が加えられています。これまでは、IAM シグネチャーのホスト文字列には、`bolt://` など、次のようなプロトコルが含まれていました。
```
"Host":"bolt://(host URL):(port)"
```
エンジンリリース `1.1.1.0` 以降、このプロトコルは省略する必要があります。
```
"Host":"(host URL):(port)"
```
設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ メモリを大量に消費するワークロード向けに最適化された Graviton2 `x2g` 搭載インスタンスタイプのサポートが追加されました。これらは当初、次の 4 つの AWS リージョン でのみ利用可能です。
+ 米国東部 (バージニア北部) (`us-east-1`)
+ 米国東部 (オハイオ) (`us-east-2`)
+ 米国西部 (オレゴン) (`us-west-2`)
+ 欧州 (アイルランド) (`eu-west-1`)
詳細については、[Neptune 料金表ページ](https://aws.amazon.com/neptune/pricing/)を参照してください。
+ 複数のエッジまたは頂点のトラバーサル、プロパティ検索、またはラベル検索が必要な Gremlin ステップのパフォーマンスが向上しました。
## このエンジンリリースで修正された不具合
+ 子トラバーサル内の `otherV()` ステップ処理での Gremlin のバグを修正しました。
+ 子としてフィルターステップしか存在しない `union` のクエリの Gremlin のバグを修正しました。例:
```
g.V().union(has("name"), out("knows")).out()
```
+ `UNION`句にネストされた `FILTER` 式内で使用される変数に無効なスコープ情報が代入されるという SPARQL のバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.1.0.R3 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.1.0.R3 へのアップグレードパス
エンジンバージョン `1.1.1.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
## このリリースへのアップグレード
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
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.1.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず 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.1.1.0.R2 (2022-05-16)
2022 年 5 月 16 日現在、エンジンバージョン 1.1.1.0.R2 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードを正常に完了するには、すべてのアベイラビリティーゾーン (AZ) の各サブネットに、Neptune インスタンスごとに利用可能な IP アドレスが少なくとも 1 つ必要です。例えば、サブネット 1 に 1 つのライターインスタンスと 2 つのリーダーインスタンスがあり、サブネット 2 に 2 つのリーダーインスタンスがある場合、アップグレードを開始する前に、サブネット 1 には少なくとも 3 つの IP アドレスの空きがあり、サブネット 2 には少なくとも 2 つの IP アドレスが空いている必要があります。
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**注記**
このリリースでは、IAM 認証で openCypher を使用するコードに重大な変更が加えられています。これまでは、IAM シグネチャーのホスト文字列には、`bolt://` など、次のようなプロトコルが含まれていました。
```
"Host":"bolt://(host URL):(port)"
```
エンジンリリース `1.1.1.0` 以降、このプロトコルは省略する必要があります。
```
"Host":"(host URL):(port)"
```
設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.1.0.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.1.0.R2 へのアップグレードパス
エンジンバージョン `1.1.1.0` を実行している場合、クラスターは次のメンテナンスウィンドウで自動的にこのメンテナンスパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
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.1.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず 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 サポートチームにお問い合わせください。