Amazon Neptune Engine バージョン 1.3.4.0 (2024-10-01) - Amazon Neptune
改良点不具合の修正サポートされているクエリ言語バージョンアップグレードパスアップグレード

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

Amazon Neptune Engine バージョン 1.3.4.0 (2024-10-01)

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

注記

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

警告

更新演算子をアクションベースの承認ポリシーで使用すると、特定の条件下で存在する可能性のある SPARQL 1.1 更新オペレーションで問題が検出されました。アクションベースの承認ポリシーで SPARQL1.1 更新オペレーションを使用している場合は、この問題の修正を含む最新の Neptune マイナーエンジンバージョン (少なくとも 1.3.4.0) にアップグレードすることをお勧めします。

次のクエリのように、数値型パラメータの重複使用を処理するバグが原因で、数値パラメータ値を含むパラメータ化されたクエリでは、クエリプランキャッシュが一時的に無効になりました。

MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n 
UNION 
MATCH (n:show) WHERE n.duration>=$minutes RETURN n

parameters={"minutes":130}

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

  • DFE エンジンのネストされたトラバーサルでの Gremlin limit() ステップ実行のサポートを追加しました。

  • Gremlin 結果キャッシュに関連する CloudWatch メトリクスを以下に示すように追加しました。これは、結果キャッシュのレイテンシーの診断と調整に役立ちます。詳細については、「Neptune メトリクス」を参照してください。

    NumResultCacheHit
NumResultCacheMiss
ResultCacheSizeInBytes
ResultCacheItemCount
ResultCacheOldestItemTimestamp
ResultCacheNewestItemTimestamp

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

全般的な機能強化

  • まれに、クエリエラーを返す代わりにエンジンがクラッシュするバグを修正しました。

Gremlin の修正

  • クライアントまたはプロキシが確立/使用済みHTTP接続経由でウェブソケットアップグレードリクエストを送信した場合のリクエスト処理とエラーレポートが改善されました (以前は、エラーのある 400 件のレスポンス「gremlin スクリプトが指定されておらず、コード MissingParameterException」が返されました）。

  • 単一のカーディナリティプロパティ値の更新で mergeV ステップの処理を最適化しました。例えば、以下のクエリは Neptune でネイティブにサポートされるようになりました。

    g.mergeV([(T.id): 1234]). option(onMatch, ['age': single(20), 'name': single('alice'), 'city': set('miami')])

  • クエリに実行時にマップを生成するToMap論理関数が含まれ、マップ出力が集計キー ( 内) として使用されるInternalFailureException場合に、クエリが で失敗する原因となる Gremlin クエリDFE評価のバグを修正しましたDFEAggregationNode。影響を受けるクエリの例：

    g.V("1").as("a").as("b").select("a","b").dedup()
openCypher 修正

  • NULL 値を含む を実行するcollect(distinct())とエラーが返されるバグを修正しました。

  • 範囲フィルター (</<=/>= とパラメータ値) を含むパラメータ化されたクエリを実行すると、結果が重複/欠落するバグを修正しました。

  • DFE エンジンが制限クエリで要求されたよりも多くの出力を生成し、メモリ不足エラーが発生する可能性があるバグを修正しました。

SPARQL 修正

  • IAM 認証対応クラスターでフェデレーティッドSPARQL更新クエリを実行するとエラーが返されるバグを修正しました。

  • 1.1 更新オペレーションSPARQLのアクションベースのアクセス許可を修正しました。

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

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

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

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

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

  • SPARQL バージョン： 1.1

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

Windows の場合:

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