改良点修正された不具合サポートされているクエリ言語バージョンアップグレードパスアップグレード

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 プロトコルの使用」を参照してください。

このエンジンリリースの改良点

メモリを大量に消費するワークロード向けに最適化された Graviton2 x2g 搭載インスタンスタイプのサポートが追加されました。これらは当初、次の 4 つの AWS リージョンでのみ利用可能です。
- 米国東部 (バージニア北部) (us-east-1)
- 米国東部 (オハイオ) (us-east-2)
- 米国西部 (オレゴン) (us-west-2)
- 欧州 (アイルランド) (eu-west-1)
詳細については、Neptune 料金表ページを参照してください。
複数のエッジまたは頂点のトラバーサル、プロパティ検索、またはラベル検索が必要な 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 を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。

このリリースへのアップグレード

重要

エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、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 の場合:


aws neptune modify-db-cluster \
    --db-cluster-identifier (your-neptune-cluster) \
    --engine-version 1.1.1.0 \
    --apply-immediately

Windows の場合:


aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.1.1.0 ^
    --apply-immediately

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

アップグレードの前に必ずテストする

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

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

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

アップグレードの前に必ずスナップショットを手動で作成してください

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

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

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

注記

保留中のアクションの処理中にアップグレードを試みた場合、次のようなエラーが発生する可能性があります。


   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 クラスターのメンテナンスを参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや AWS プレミアムサポートから AWS サポートチームにお問い合わせください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

リリース: 1.1.1.0.R4 (2022-06-23)

メンテナンスリリース: 1.1.0.0.R2 (2022-05-16)