Amazon Neptune エンジンバージョン 1.0.4.2.R2 (2021-06-01)

2021 年 6 月 1 日現在、エンジンバージョン1.0.4.2.R2 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。

このリリースの後続のパッチリリース

• リリース： 1.0.4.2.R3 (2021-06-28)

このエンジンリリースの既知の問題

問題:

スペースがあると Accept ヘッダーのメディアタイプが受け入れられない SPARQL バグ。

たとえば、 -H "Accept: text/csv; q=1.0, */*; q=0.1" があるクエリは CSV 出力ではなく JSON 出力を返します。

回避方法:

ヘッダー内の Accept 句中のスペースを削除すると、エンジンは正しい要求された形式で出力を返します。つまり、 -H "Accept: text/csv; q=1.0, */*; q=0.1" の代わりに、次のものを使用します。

  -H "Accept: text/csv;q=1.0,*/*;q=0.1"

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

• 新しい R5d インスタンスタイプを追加しました。これには、大量のプロパティ値または RDF リテラルルックアップを含むユースケースでの読み込みを高速化するためのルックアップキャッシュが含まれています。「Neptune ルックアップキャッシュは読み取りクエリを高速化できます。」を参照してください。

• 実験的な DFE エンジンを useDFE クエリヒントに基づきクエリ単位でのみ呼び出すことができる新しい lab-mode パラメータが追加されました。

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

• TinkerPop 3.4.10 のサポートが追加されました。

• Gremlin スクリプト要求を送信するときの withStrategies( ) 設定ステップの使用のサポートが追加されました。具体的には、SubgraphStrategy、PartitionStrategy、ReadOnlyStrategy、EdgeLabelVerificationStrategy および ReservedKeysVerificationStrategy すべてがサポートされています。

• クエリの途中での V() トラバーサルの最適化が追加されました。以前は、このようなトラバーサルは Neptune では最適化されていませんでした。

• バルクロードの baseUri および namedGraphUri パラメータとして使用する RFC 2141 URN のサポートを追加しました。

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

• 不正なクエリが有効として扱われるパーサーの Gremlin のバグを修正しました。

• cap().unfold() により aggregate() 副作用が展開され valueMap() 例外が発生する Gremlin のバグを修正しました。

• addV() ステップ後の property() ステップが「文字列にキャストできません」エラーで失敗する Gremlin のバグを修正しました。

• 一部の条件付き挿入パターンが同時変更例外を発生させないように Gremlin のバグを修正しました。

• クエリリクエストのタイムアウトがセッションタイムアウトを超えなくなるように、Gremlin のバグを修正しました。

• リモートサーバーが使用できないときに、LOAD または UNLOAD を使用した更新が HTTP コード 400 ではなく HTTP コード 500 で失敗することがあった SPARQL バグを修正しました。

• 32 ビット符号付き整数の制限 (2,147,483,647) より大きい commitNum または opNum 値が使用されるとストリーム API 呼び出しが失敗するバグを修正しました。

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

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

• Gremlin バージョン: 3.4.10

• SPARQL バージョン: 1.1

エンジンリリース 1.0.4.2.R2 へのアップグレードパス

以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。

このリリースに自動的にアップグレードされることはありません。

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

Amazon Neptune 1.0.4.2.R2 が一般に利用可能になりました。

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

Linux、OS X、Unix の場合:

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

Windows の場合:

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