Amazon Neptune エンジンバージョン 1.3.1.0 (2024-03-06)

2024-03-06 の時点で、エンジンバージョン 1.3.1.0 が一般的に導入されています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。

注記

エンジンリリース 1.3.0.0 では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.3.0.0 より前のエンジンバージョンからエンジンバージョン 1.3.0.0 以降にアップグレードする場合は、パラメータグループファミリー neptune1.3 を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー neptune1 または neptune1.2 を使用していましたが、これらのパラメータグループはリリース 1.3.0.0 以降では動作しません。詳細については、「Amazon Neptune パラメータグループ」を参照してください。

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

全般的な機能強化

• Neptune は、プロファイル/説明に表示される警告を改善しました。

• TLS ネゴシエーション中に使用されるデフォルトの名前付きグループから、古い NIST EC 曲線を削除しました。削除された曲線は sect409k1、sect409r1、および sect571k1 です。

グレムリンの改良

• DFE 統計計算を改善して、サーバーレスインスタンスの NCU が非常に高くなるのを防ぎました。

• WITHIN の Gremlin のパフォーマンスが向上しました。

このエンジンリリースで修正された不具合

Gremlin の修正

• Gremlin DFE クエリプランにさまざまな改良が加えられました。

• オプションでトラバーサルを使用する Gremlin クエリのバグが修正されました。たとえば、`g.V () .hasLabel ('person') .group () .by (__.in ('friend') .id () .fold ()) `という形式のクエリでは、フレンドエッジのないユーザーはグループ化されませんでした。

• DFEエンジンを使用して実行すると、byモジュレーター内の合体ステップを含むGremlinクエリがエラーを返すバグを修正しました。

• Gremlin セッションで実行されている読み取り専用クエリがリードレプリカに接続されているときに機能しないバグを修正しました。

• Gremlin の最初のウェブソケット接続リクエストが成功した際に IAM ARN が監査ログに存在しなかったバグを修正しました。

• ステップを合体させ、DFE でステップカバレッジを特定します。

• DFE プラン全体の特性セット最適化。

openCypher の修正

• OpenCypher SET 句のバグが修正され、非変数式 (例:match (n: Test) セット (n.prop = 2 の後に n が終了する場合) に設定できるようになりました。.prop = 3 は.prop を返すようになります。

• 集計と順序付けに関する OpenCypher クエリの失敗に関するバグが修正されました。

• 静的マップを含む大きなリストの UNWIND を改善しました。

• 重複する値を持つカスタム ID を使用する OpenCypher MERGE クエリのバグが修正されました。

SPARQL の修正

• オプションパターンの変数スコープに関する SPARQL のバグを修正しました。

このリリースでサポートされるクエリ言語バージョン

DB クラスターをバージョン 1.3.1.0 にアップグレードする前に、プロジェクトが以下のクエリ言語バージョンと互換性があることを確認してください。

• サポートされている最も古いバージョンの Gremlin: 3.6.2

• サポートされている最も新しいバージョンの Gremlin: 3.6.5

• openCypher バージョン: Neptune-9.0.20190305-1.0

• SPARQL バージョン: 1.1

エンジンリリース 1.3.1.0 へのアップグレードパス

このリリースへは、エンジンリリース 1.2.0.0 以降からアップグレードできます。

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

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

Linux、OS X、Unix の場合:

aws neptune modify-db-cluster \
    --db-cluster-identifier (your-neptune-cluster) \
    --engine-version 1.3.1.0 \
    --allow-major-version-upgrade \
    --apply-immediately

Windows の場合:

aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.3.1.0 ^
    --allow-major-version-upgrade ^
    --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。

注記

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

   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 コミュニティフォーラムやプレミアムSupport を通じてSupport チームにお問い合わせください。