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

Amazon Neptune Engine バージョン 1.4.0.0 (2024-11-06)

2024-11-06 の時点で、エンジンバージョン 1.4.0.0 は一般的にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。

注記

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

警告

クエリ内の数値型パラメータの重複使用を処理するバグにより、数値パラメータ値を含むパラメータ化されたクエリを実行するユースケースでは、クエリプランキャッシュは一時的にサポートされていません。例:


MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n 
      UNION 
      MATCH (n:show) WHERE n.duration>=$minutes RETURN n
      
      parameters={"minutes":130}

ステートメントまたはディクショナリインデックスに対して多くのインデックス検索を実行するクエリでは、5% のパフォーマンス回帰が表示される可能性があります。例えば、すべての頂点の数を取得したり、すべての頂点idのを取得したりしても影響を受けません。すべての頂点のすべてのプロパティを取得すると、最大 5% の回帰が表示される可能性があります。

このエンジンリリースの新機能

明示的な ID なしでエッジがプロパティグラフに追加されると、サーバーはデフォルトで UUIDベースのエッジ ID を割り当てます。これはディクショナリに保存されます。これで、新しいクラスターパラメータ neptune_enable_server_generated_edge_id = 1 を設定することで、サーバーはディクショナリオーバーヘッドなしで内部管理の 8 バイト整数IDsを使用してを割り当てます。これにより、クエリを変更することなく、ストレージの節約とクエリパフォーマンスの向上につながります。この機能は現在、Gremlin クエリ言語を介した挿入でのみサポートされています。
DFE エンジンのネストされたトラバーサルでの Gremlin limit() ステップ実行のサポートを追加しました。
```
g.V().project("foo").by(out().order().by(T.id).limit(1))
```

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

全般的な改善点

Neptune は、トランザクションが完了し、復旧にログが不要になると、大規模なトランザクションによって保持されている元に戻すストレージを自動的に復元します。
グローバルデータベースサバイバルレプリカのサポート。この機能により、セカンダリクラスターは、プライマリクラスターでのライターインスタンスの再起動中に読み取りリクエストを引き続き処理できます。以前は、ライターインスタンスが再起動すると、セカンダリクラスター内のすべてのリーダーインスタンスも再起動していました。このリリースでは、セカンダリクラスターリーダーインスタンスはライターインスタンスの再起動中に読み取りリクエストを引き続き処理するため、クラスター内の読み取り可用性が向上します。
監査ログが同期的に書き込まれるようになりました。これにより、すべてのクエリがログに記録されます。これは、特に大きなクエリ (>100 kb) または高スループットワークロード (>1000 qps) のパフォーマンスに影響する可能性があります。

Gremlin の改善

デフォルトでは、クエリごとのタイムアウトはクラスターレベルのタイムアウトよりも小さくなります。以前のリリースでは、このチェックが導入されましたが、ラボモードパラメータ 'StrictTimeoutValidation' を介して明示的に有効にする必要があります。このリリースでは、'StrictTimeoutValidation' はデフォルトで有効になり、古い動作を維持するために明示的に無効にする必要があります。

openCypher 改善点

以前のリリースでは、拡張日時形式サポートを導入し、ラボモードパラメータを介して有効化しましたDatetimeMillisecond。この拡張日時形式サポートがデフォルトで有効になりました。

SPARQL 改善点

クエリアクセス許可の新しい明示的IAMなアクション。


Previously:
COPY: WriteDataViaQuery & ReadDataViaQuery
MOVE: WriteDataViaQuery & DeleteDataViaQuery
DELETEINSERT: ReadDataViaQuery & DeleteDataViaQuery

 Now, 
COPY: WriteDataViaQuery & ReadDataViaQuery & DeleteDataViaQuery 
MOVE: WriteDataViaQuery & ReadDataViaQuery & DeleteDataViaQuery 
DELETEINSERT: ReadDataViaQuery, WriteDataViaQuery if there is INSERT clause, DeleteDataViaQuery if there is DELETE clause.

このエンジンリリースで修正された欠陥

一般的な修正

スケールアップ中にデータベースが再起動する可能性のある Serverless インスタンスの問題を修正しました。
監査ログファイルの管理に関連する問題を修正しました。これにより、ログファイルのダウンロードやローテーションができなくなる可能性があり、場合によってはCPU使用量が増加する可能性があります。
DFE エンジンでのマップ出力生成の最適化遅延に関連するクエリの問題を修正しました。
監査ログとスロークエリログの間でタイムスタンプが一致しない問題を修正しました。

Gremlin の修正

クエリヒントがキャッシュキー生成に適切に組み込まれていない Gremlin 結果キャッシュ無効化の問題を解決しました。詳細については、https://issues.apache.org/jira/browse/TINKERPOP-3110 を参照してください。
Gremlin WebSocket 接続管理で、接続アイドルタイムアウトを超える時間実行されているクエリが早期に終了する問題を解決しました。これは、AIOHTTPトランスポートを使用する Python Gremlin クライアントに特に影響を与えました。
新しい Labmodeparameter で Gremlin クエリ結果キャッシュ機能の正確なオブジェクト推定のサポートが追加されましたAccurateQRCMemoryEstimation。

openCypher 修正

collect(distinct(n)) クエリコンストラクト中に null 値が存在する場合、内部障害例外を引き起こす collect ステップの問題を修正しました。
クエリプランキャッシュが有効になっているときにクエリでが発生するNullPointerException可能性がある問題を修正しました。
クエリに LIMIT句が含まれているときに必要以上に多くのデータを評価する問題を修正しました。
クエリプランキャッシュでパラメータ化されたクエリで範囲オペレーション (<、<=、＞、>=) を使用すると、結果が重複する問題を修正しました。
ボルト接続を使用して UNION および UNIONALLオペレーションを実行すると、結果列が変換される問題を修正しました。

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

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

サポートされている最も古いバージョンの Gremlin: 3.7.1
サポートされている最も新しいバージョンの Gremlin: 3.7.1
openCypher バージョン： Neptune-9.0.20190305-1.0
SPARQL バージョン： 1.1

エンジンリリース 1.4.0.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.4.0.0 \
    --allow-major-version-upgrade \
    --apply-immediately

Windows の場合:


aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.4.0.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 サポートチームを利用できます。

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

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

ドキュメントの表記規則

エンジンリリース

リリース: 1.3.4.0 (2024-10-01)