アップグレードアップグレード前のテストエンジンバージョン番号コンソールを使用した手動アップグレードコンソールを使用した自動アップグレード CLI を使用した手動更新 CLI を使用した自動更新

Amazon Neptune のエンジンリリース

Amazon Neptune は定期的にエンジンの更新をリリースします。

instance-status API を使用して、現在インストールされているエンジンリリースバージョンを確認できます。また、オリジナルリリース (.R1) を実行しているのか、それ以降のパッチ (.R2、.R3 など) を実行しているのかもわかります。リリースの番号付けの詳細については、「エンジンバージョン番号」を参照してください。

注記

からのマイナーエンジンリリースの場合1.0.1.0以降では、暗黙的な開始バージョンは.R1であり、それ以降のパッチは.R2,.R3などといった感じです。

Neptune DB エンジンの更新方法については、Neptune の更新。

以下に、エンジンリリースの一覧と、アップグレード方法に関する情報を示します。

トピック

Neptune エンジンのアップグレード

メジャーエンジンリリースは手動でのみインストールできます。

パッチリリース (.R2,.R3など）は、次回のメンテナンスウィンドウ中に常に自動的にインストールされます。これは、AutoMinorVersionUpgradeパラメータの設定。

必要に応じて、エンジンのマイナーな更新をクラスター全体に自動的にインストールすることもできます。これを行うには、プライマリライターインスタンスの AutoMinorVersionUpgrade パラメータを true に設定します。新しいエンジンバージョンが、リリースから 2～3 週間後に安定していることが証明されると、メンテナンスウィンドウ中にクラスター内のすべてのインスタンスにエンジンのマイナーな更新が自動的にインストールされます。

「コンソールを使用してエンジンを最新バージョンにアップグレードする」で説明されているように、AWS Management Console を使用してエンジンを手動で更新できます。
CLI を使用してエンジンを手動で更新することもできます。
コンソールを使用して、プライマリライターインスタンスで AutoMinorVersionUpgrade を true に設定できます。これにより、最新リリースから 2～3 週間の安定化期間の経過後に、クラスターがメンテナンスウィンドウ中に常に最新のマイナーバージョンに自動的にアップグレードされます。
他のインスタンスでCLIを使用してAutoMinorVersionUpgrade～trueプライマリライターインスタンスで。リーダーインスタンスで true に設定しても効果はありません。

AWS CLI を使用して手動でアップグレードする場合は、アップグレードするエンジンバージョンを必ず指定してください。そうしないと、エンジンが最新バージョンまたは期待するバージョンではないバージョンにアップグレードされる可能性があります。

インスタンスのステータス API を使用して、DB クラスターが実行しているエンジンバージョンをいつでも確認できます。CreateDBCluster を使用してクラスターを作成している場合、API はその応答でクラスターの作成に使用されたエンジンバージョンを返します。

自動更新のタイミングは、AWSDB クラスターのリージョンおよびメンテナンスウィンドウ設定について説明します。メンテナンスウィンドウの設定は、Neptune。詳細については、「Neptune メンテナンスウィンドウ」を参照してください。

クラスターの更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、これらすべてのインスタンスでデータベースを再起動する必要があるため、20～30 秒間のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。

アップグレードする前に、Neptune エンジンの新しいバージョンをテストする

新しいメジャー Neptune エンジンのバージョンがリリースされると、アップグレードする前に、必ず Neptune アプリケーションを最初にテストしてください。あなたが持っていない場合AutoMinorVersionUpgrade設定されている場合、コードに影響を与える可能性のある新しい機能や動作を導入するマイナーエンジンバージョンでもこれを行うことができます。

本番 DB クラスターをアップグレードせずに新しいバージョンをテストする最善の方法は、クラスターをクローンして、クローンが新しいエンジンバージョンを実行することです。その後、実稼働 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。

Neptune エンジンのバージョン番号

Neptune のバージョン番号には 3 つの部分があります。バージョン番号 1.0.2.0.R2 を例として取り上げます。

最初の部分（最初の 2 つの番号、つまり 1.0.2.0.R2 の 1.0）は、データベースのメジャーバージョン番号です。

この部分は、アップグレード時にデータの移行が必要なデータの保存方法の変更など、大きな互換性のない変更が発生した場合にのみ変更されます。多くの場合、新しいメジャーバージョンにアップグレードするには、アップグレードするクラスターのサイズに比例したダウンタイムが必要であり、他のアップグレードよりもはるかに時間がかかる場合があります。
2 番目の部分（3 番目と 4 番目の番号、つまり 1.0.2.0.R2 の 2.0）は、エンジンリリースのマイナーバージョン番号です。

以下に説明するように、エンジンを自動的に新しいマイナーバージョンにアップグレードするか、マイナーバージョンの変更ごとに決定するかを選択できます。
3 番目の部分（最後の番号、つまり 1.0.2.0.R2 の R2）は、マイナーバージョンのエンジンのパッチ番号です。

パッチには、マイナーエンジンリリースの間にデプロイされるバグ修正やセキュリティ変更などの緊急の変更が含まれます。エンジンバージョンの最初のリリースは暗黙で R0 となり、そのパッチには R1、R2 などの番号が付けられます。

パッチは、以下で説明するように、システムメンテナンスウィンドウ中に常に自動的に適用されます。

次のように、AWS CLI を使用して利用可能なエンジンリリースを一覧表示できます。

Linux、OS X、Unix の場合:


aws neptune describe-db-engine-versions \
    --region <your-region> \
    --engine neptune

Windows の場合:


aws neptune describe-db-engine-versions ^
    --region <your-region> ^
    --engine neptune

利用可能なエンジンリリースには、現在のバージョン番号よりも高いバージョン番号があり、アップグレードパスが定義されているリリースのみが含まれます。

コンソールを使用してエンジンを最新バージョンにアップグレードする

Neptune DB クラスターのマイナーバージョンアップグレードは、AWS Management Console以下のように設定します。

コンソールを使用して DB クラスターのエンジンバージョンをアップグレードするには

にサインインします。AWS管理コンソールを開き、Amazon Neptune コンソール (https://console.aws.amazon.com/neptune/home。
ナビゲーションペインで、[Clusters (クラスター)] を選択して、変更する DB クラスターを選択します。
[Actions]、[Modify cluster] の順に選択します。[DB クラスターの変更] ページが表示されます。
[DB engine version] で、新しいバージョンを選択します。
[Continue] を選択して、変更の概要を確認します。
変更をすぐに反映させるには、[Apply immediately] を選択します。
確認ページで、変更内容を確認します。正しい場合は、[クラスターの変更] を選択して変更を保存します。

または、[Back] を選択して変更を編集するか、[Cancel] を選択して変更をキャンセルします。

コンソールを使用して自動エンジン更新を有効にする

設定した場合AutoMinorVersionUpgradeフィールドをtrueDB クラスターのライターインスタンスで Neptune は 2～3 週間の安定化期間の経過後に、クラスター全体のエンジンを最新のマイナーバージョンに自動的に更新します。

AWS Management Console を使用して、このフィールドを設定できます。

DB クラスターの AutoMinorVersionUpgrade を設定するには

にサインインします。AWS管理コンソールを開き、Amazon Neptune コンソール (https://console.aws.amazon.com/neptune/home。
DB インスタンスのリストで、DB クラスターのプライマリインスタンス (ライターインスタンス) を選択します。
[Instance actions] を選択してから、[Modify] を選択します。[Modify DB Instance] ページが表示されます。
[Actions (アクション)]、[Modify Snapshot (スナップショットの変更)] の順に選択します。[Modify DB instance] ページが表示されます。
マイナーバージョンの自動更新フィールドを設定します。

詳細については、「インスタンスを変更する」を参照してください。

CLI を使用して Neptune DB エンジンを手動で更新する

AWS CLI と ModifyDBInstance API を使用して DB クラスターのエンジンバージョンをアップグレードできます。

Linux、OS X、Unix の場合:


aws neptune modify-db-cluster \
    --db-cluster-identifier <your-neptune-cluster> \
    --engine-version <new-engine-version> \
    --apply-immediately

Windows の場合:


aws neptune modify-db-cluster ^
    --db-cluster-identifier <your-neptune-cluster> ^
    --engine-version <new-engine-version> ^
    --apply-immediately

アップグレードするエンジンのバージョンを必ず含めてください。そうしないと、エンジンが最新ではないバージョンにアップグレードされる可能性があります。

CLI を使用して Neptune エンジンの自動更新を有効にする

AWS CLI を使用して DBcluster のエンジンの自動更新を有効または無効にするには、プライマリインスタンスの AutoMinorVersionUpgrade パラメータを設定します。

DB クラスターのエンジンの自動アップグレードを有効にするには

Linux、OS X、Unix の場合:


aws neptune modify-db-instance \
    --db-instance-identifier <your-cluster-write-instance> \
    --auto-minor-version-upgrade \
    --apply-immediately

Windows の場合:


aws neptune modify-db-instance ^
    --db-instance-identifier <your-cluster-write-instance> ^
    --auto-minor-version-upgrade ^
    --apply-immediately

同様に、エンジンの自動更新を無効にすることもできます。

Linux、OS X、Unix の場合:


aws neptune modify-db-instance \
    --db-instance-identifier <your-cluster-write-instance> \
    --no-auto-minor-version-upgrade \
    --apply-immediately

Windows の場合:


aws neptune modify-db-instance ^
    --db-instance-identifier <your-cluster-write-instance> ^
    --no-auto-minor-version-upgrade ^
    --apply-immediately

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

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

ドキュメントの表記規則

ローダーエラー

リリース: 1.0.5.1 (2021-10-01)