Amazon Neptune エンジンバージョン 1.4.3.0 (2025-01-21) - Amazon Neptune
新機能改善点修正された不具合サポートされているクエリ言語バージョンアップグレードパスアップグレード

Amazon Neptune エンジンバージョン 1.4.3.0 (2025-01-21)

2025 年 1 月 21 日現在、エンジンバージョン 1.4.3.0 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。

警告

クエリで重複使用される数値型パラメータの処理に関するバグのため、数値パラメータ値が関与するパラメータ化クエリを実行するユースケースで、クエリプランキャッシュのサポートを一時的に中止します。例: 

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% の低下が見られる可能性があります。

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

  • Gremlin クエリ結果を Amazon S3 にエクスポートする。Gremlin クエリ結果を Amazon S3 に直接エクスポートします。この機能を使用すると、大規模なクエリ結果をクエリレスポンスとして返す代わりに Amazon S3 バケットにエクスポートすることで効率的に処理できます。

    g.V().
    hasLabel('Comment').
    valueMap().
    call('neptune.query.exportToS3', [
    'destination': 's3://your-bucket/path/result.json',
    'format': 'GraphSONv3',
    'keyArn': 'optional-kms-key-arn'
  ])

  • R7i インスタンス。最大 48xlarge の R7i インスタンスファミリーが、次のリージョンで利用可能になりました。

    • ap-northeast-1 – アジアパシフィック (東京)

    • ap-northeast-2 – アジアパシフィック (ソウル)

    • ap-south-1 – アジアパシフィック (ムンバイ)

    • ap-southeast-1 – アジアパシフィック (シンガポール)

    • ap-southeast-2 – アジアパシフィック (シドニー)

    • ap-southeast-3 – アジアパシフィック (ジャカルタ)

    • ca-central-1 – カナダ (中部)

    • eu-central-1 – 欧州 (フランクフルト)

    • eu-north-1 – 欧州 (ストックホルム)

    • eu-south-2 – 欧州 (スペイン)

    • eu-west-1 – 欧州 (アイルランド)

    • eu-west-2 – 欧州 (ロンドン)

    • eu-west-3 – 欧州 (パリ)

    • us-east-1 – 米国東部 (バージニア北部)

    • us-east-2 – 米国東部 (オハイオ)

    • us-west-1 – 米国西部 (北カリフォルニア)

    • us-west-2 – 米国西部 (オレゴン)

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

全般的な機能強化

  • ラボモードでディクショナリガベージコレクション (GC) がサポートされます。

    有効にすると、未使用のディクショナリエントリがバックグラウンドジョブでクリーンアップされます。VolumeBytesUsed を減らすのではなく、インデックス内のスペースを新しい挿入用に解放します。ディクショナリ GC が有効な場合、VolumeBytesUsed の増加率は、有効でない場合よりも低くなる可能性があります。これは、neptune_streams パラメータが有効になっていない場合に、(Gremlin または openCypher を介して挿入される) プロパティグラフデータに対して効果的です。詳細については、Neptune ディクショナリガベージコレクションを参照してください。

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

一般的な修正

  • DFE エンジンの使用時に FreeableMemory に影響する 2 つのメモリリークの問題を修正しました。

openCypher の修正

  • 重複する行の MERGE ON MATCH/ON CREATE の問題を解決します。

    UNWIND [1, 1] AS id
MERGE (n:Person {id: id})
  ON CREATE SET n.p = 5
  ON MATCH SET n.p = 6

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

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

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

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

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

  • SPARQL バージョン: 1.1

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

Windows の場合:

aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.4.3.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 サポートチームにお問い合わせください。