翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Neptune のエンジンリリース
Amazon Neptune は定期的にエンジンの更新をリリースします。
[instance-status API](access-graph-status.md) または Neptune コンソールを使用して、現在インストールされているエンジンリリースバージョンを確認できます。バージョン番号は、元のメジャーリリース、マイナーリリース、またはパッチリリースのいずれを実行しているかを示します。リリースの番号付けの詳細については、「[エンジンバージョン番号](cluster-maintenance.md#engine-version-numbers)」を参照してください。
全般的な更新の詳細については、「[クラスターのメンテナンス](cluster-maintenance.md)」を参照してください。
エンジンリリース 1.3.0.0 以降のエンジンバージョンは、次の表に示す構造になります。マイナーバージョン番号は、[`AutoMinorVersionUpgrade`](engine-maintenance-management.md#using-amvu) 処理で評価される番号です。
| バージョン | 製品バージョン | メジャーバージョン | マイナーバージョン | パッチバージョン | ステータス | 解放済み | サポート終了 | アップグレード後 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [1.4.7.0](engine-releases-1.4.7.0.md) | 1 | 4 | 7 | 0 | *ACTIVE* | 2026-03-03 | 2027-06-03 | 該当なし |
| [1.4.6.3](engine-releases-1.4.6.3.md) | 1 | 4 | 6 | 3 | *ACTIVE* | 2025-12-18 | 2027-06-03 | 1.4.7.0 |
| [1.4.6.2](engine-releases-1.4.6.2.md) | 1 | 4 | 6 | 2 | *ACTIVE* | 2025-11-18 | 2027-06-03 | 1.4.7.0 |
| [1.4.6.1](engine-releases-1.4.6.1.md) | 1 | 4 | 6 | 1 | *ACTIVE* | 2025-09-18 | 2027-03-06 | 1.4.6.2 |
| [1.4.6.0](engine-releases-1.4.6.0.md) | 1 | 4 | 6 | 0 | *ACTIVE* | 2025-09-02 | 2027-03-06 | 1.4.6.1 |
| [1.4.5.1](engine-releases-1.4.5.1.md) | 1 | 4 | 5 | 1 | *ACTIVE* | 2025-06-30 | 2027-03-06 | 1.4.6.0 |
| [1.4.5.0](engine-releases-1.4.5.0.md) | 1 | 4 | 5 | 0 | *ACTIVE* | 2025-04-09 | 2027-03-06 | 1.4.5.1 |
| [1.4.4.0](engine-releases-1.4.4.0.md) | 1 | 4 | 4 | 0 | *ACTIVE* | 2025-02-24 | 2027-03-06 | 1.4.5.0 |
| [1.4.3.0](engine-releases-1.4.3.0.md) | 1 | 4 | 3 | 0 | *ACTIVE* | 2025-01-21 | 2027-03-06 | 1.4.4.0 |
| [1.4.2.0](engine-releases-1.4.2.0.md) | 1 | 4 | 2 | 0 | *ACTIVE* | 2024-12-19 | 2027-03-06 | 1.4.3.0 |
| [1.4.1.0](engine-releases-1.4.1.0.md) | 1 | 4 | 1 | 0 | *ACTIVE* | 2024-11-21 | 2027-03-06 | 1.4.2.0 |
| [1.4.0.0](engine-releases-1.4.0.0.md) | 1 | 4 | 0 | 0 | *ACTIVE* | 2024-11-06 | 2027-03-06 | 1.4.1.0 |
| [1.3.4.0](engine-releases-1.3.4.0.md) | 1 | 3 | 4 | 0 | *ACTIVE* | 2024-10-01 | 2027-03-06 | 1.4.0.0 |
| [1.3.3.0](engine-releases-1.3.3.0.md) | 1 | 3 | 3 | 0 | *ACTIVE* | 2024-08-05 | 2027-03-06 | 1.3.4.0 |
| [1.3.2.1](engine-releases-1.3.2.1.md) | 1 | 3 | 2 | 1 | *ACTIVE* | 2024-06-20 | 2027-03-06 | 1.3.3.0 |
| [1.3.2.0](engine-releases-1.3.2.0.md) | 1 | 3 | 2 | 0 | *ACTIVE* | 2024-06-10 | 2027-03-06 | 1.3.2.1 |
| [1.3.1.0](engine-releases-1.3.1.0.md) | 1 | 3 | 1 | 0 | *ACTIVE* | 2024-03-06 | 2027-03-06 | 1.3.2.1 |
| [1.3.0.0](engine-releases-1.3.0.0.md) | 1 | 3 | 0 | 0 | *ACTIVE* | 2023-11-15 | 2027-03-06 | 1.3.2.1 |
以下の表は、1.0.1.0 以降のすべてのエンジンリリースと、バージョンのサポート終了に関する情報を示しています。表の日付を参考にして、テストとアップグレードのサイクルを計画することができます。
| バージョン | メジャーバージョン | マイナーバージョン | ステータス | 解放済み | サポート終了 | アップグレード後 |
| --- | --- | --- | --- | --- | --- | --- |
| [1.2.1.2](engine-releases-1.2.1.2.md) | 1.2 | 1.2 | *ACTIVE* | 2024-08-05 | 2026-06-30 | 1.3.0.0 |
| [1.2.1.1](engine-releases-1.2.1.1.md) | 1.2 | 1.1 | *ACTIVE* | 2024-03-11 | 2026-06-30 | 1.3.0.0 |
| [1.2.1.0](engine-releases-1.2.1.0.md) | 1.2 | 1.0 | *ACTIVE* | 2023-03-08 | 2026-06-30 | 1.3.0.0 |
| [1.2.0.2](engine-releases-1.2.0.2.md) | 1.2 | 0.2 | *ACTIVE* | 2022-11-16 | 2026-06-30 | 1.3.0.0 |
| [1.2.0.1](engine-releases-1.2.0.1.md) | 1.2 | 0.1 | *ACTIVE* | 2022-10-26 | 2026-06-30 | 1.3.0.0 |
| [1.2.0.0](engine-releases-1.2.0.0.md) | 1.2 | 0.0 | *ACTIVE* | 2022-07-21 | 2026-06-30 | 1.3.0.0 |
| [1.1.1.0](engine-releases-1.1.1.0.md) | 1.1 | 1.0 | *ACTIVE* | 2022-04-19 | 2026-06-30 | 1.2.1.0 |
| [1.1.0.0](engine-releases-1.1.0.0.md) | 1.1 | 0.0 | *廃止済み* | 2021-11-19 | 2025-03-15 | 1.1.1.0 |
| [1.0.5.1](engine-releases-1.0.5.1.md) | 1.0 | 5.1 | *廃止済み* | 2021-10-01 | 2023-01-30 | 1.1.0.0 |
| [1.0.5.0](engine-releases-1.0.5.0.md) | 1.0 | 5.0 | *廃止済み* | 2021-07-27 | 2023-01-30 | 1.1.0.0 |
| [1.0.4.2](engine-releases-1.0.4.2.md) | 1.0 | 4.2 | *廃止済み* | 2021-06-01 | 2023-01-30 | 1.1.0.0 |
| [1.0.4.1](engine-releases-1.0.4.1.md) | 1.0 | 4.1 | *廃止済み* | 2020-12-08 | 2023-01-30 | 1.1.0.0 |
| [1.0.4.0](engine-releases-1.0.4.0.md) | 1.0 | 4.0 | *廃止済み* | 2020-10-12 | 2023-01-30 | 1.1.0.0 |
| [1.0.3.0](engine-releases-1.0.3.0.md) | 1.0 | 3.0 | *廃止済み* | 2020-08-03 | 2023-01-30 | 1.1.0.0 |
| [1.0.2.2](engine-releases-1.0.2.2.md) | 1.0 | 2.2 | *廃止済み* | 2020-03-09 | 2022-07-29 | 1.0.3.0 |
| [1.0.2.1](engine-releases-1.0.2.1.md) | 1.0 | 2.1 | *廃止済み* | 2019-11-22 | 2022-07-29 | 1.0.3.0 |
| [1.0.2.0](engine-releases-1.0.2.0.md) | 1.0 | 2.0 | *廃止済み* | 2019-11-08 | 2020-05-19 | 1.0.3.0 |
| [1.0.1.2](engine-releases-1.0.1.2.md) | 1.0 | 1.2 | *廃止済み* | 2019-10-15 | — | — |
| [1.0.1.1](engine-releases-1.0.1.1.md) | 1.0 | 1.1 | *廃止済み* | 2019-08-13 | — | — |
| [1.0.1.0.\$1](engine-releases-1.0.1.0.md) | 1.0 | 1.0.\$1 | *廃止済み* | 2019-07-02 およびそれ以前 | — | — |
## メジャーエンジンバージョンのサポート終了計画
Neptune のエンジンバージョンは、ほとんどの場合、暦四半期の終わりに有効期限を迎えます。例外が発生するのは、セキュリティや可用性に関する重要な問題が発生した場合のみです。
エンジンバージョンの有効期間が終了すると、Neptune データベースを新しいバージョンにアップグレードする必要があります。
一般的に、Neptune エンジンバージョンは以下のように引き続きご利用いただけます。
+ **マイナーエンジンバージョン:** マイナーエンジンバージョンは、リリース後少なくとも 6 か月間はご利用いただけます。
+ **メジャーエンジンバージョン:** メジャーエンジンバージョンは、リリース後少なくとも 12 か月間はご利用いただけます。
エンジンバージョンの有効期限の少なくとも 3 か月前に、 AWS はアカウント AWS に関連付けられた E メールアドレスに自動 E メール通知を送信し、同じメッセージを [AWS Health Dashboard](https://docs.aws.amazon.com/health/latest/ug/aws-health-dashboard-status.html) に投稿します。これにより、アップグレードを計画し、準備する時間を確保できます。
エンジンバージョンの有効期間が終了すると、そのバージョンを使用して新しいクラスターやインスタンスを作成できなくなり、オートスケーリングでもそのバージョンを使用してインスタンスを作成できなくなります。
実際に有効期間が終了したエンジンバージョンは、メンテナンス期間中に自動的にアップグレードされます。エンジンバージョンの有効期限の 3 か月前に送信されるメッセージには、自動的にアップグレードされるバージョン、DB クラスターへの影響、推奨アクションなど、この自動更新の内容に関する詳細が記載されています。
**重要**
データベースエンジンのバージョンを最新の状態に保つ責任はお客様にあります。 AWS は、セキュリティ、プライバシー、および可用性に関する最新の保護措置の恩恵を受けるために、すべてのお客様にデータベースを最新のエンジンバージョンにアップグレードするよう促します。廃止日を過ぎたサポートされていないエンジンまたはソフトウェア (「レガシーエンジン」) でデータベースを運用すると、セキュリティ、プライバシー、およびダウンタイムイベントを含む運用上のリスクにさらされる可能性が高くなります。
任意のエンジンでのデータベースの運用には、サービスの使用に適用される契約が適用されます AWS 。レガシーエンジンは一般公開されていません。 はレガシーエンジンのサポートを提供し AWS なくなり、 AWS レガシーエンジンがサービス、 AWSその関連会社、または第三者にセキュリティまたは責任のリスク、または損害のリスクをもたらす AWS と判断した場合、いつでもレガシーエンジンへのアクセスまたは使用を制限することができます。レガシーエンジンでコンテンツを引き続き実行すると、コンテンツが利用できなくなったり、破損したり、回復できなくなったりする可能性があります。レガシーエンジンで実行されているデータベースは、サービスレベルアグリーメント (SLA) の例外の対象となります。
レガシーエンジンで実行されているデータベースおよび関連ソフトウェアには、バグ、エラー、欠陥、または有害なコンポーネントが含まれています。それに応じて、契約またはサービス条件にこれと異なる規定があっても、 AWS はレガシーエンジンを「現状のまま」にしています。
# Amazon Neptune エンジンバージョン 1.4.7.0 (2026-03-03)
2026-03-03 の時点で、エンジンバージョン 1.4.7.0 は一般的にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**一時的にアップグレードできません**
グローバルデータベース (GDB) クラスターのアップグレードに関連する既知の問題のため、現時点では Neptune エンジンバージョン 1.4.7.0 へのアップグレードは使用できません。数週間でアップグレードを有効にする予定です。
## このエンジンリリースの新機能
+ openCypher は、OC を介した Parquet ファイルと CSV ファイルに対する S3 サポートから読み取られます。[neptune.read()](access-graph-opencypher-21-extensions-s3-read.md) ドキュメントを参照してください。
+ openCypher 地理空間クエリ関数。このリリースには、ISO/IEC 13249-3:2016 標準に基づく 12 の空間型関数、迅速な検索のために新しい地理インデックスに保存されている POINT の新しいジオメトリプロパティタイプ、および Well-Known Text (WKT) 形式のサポートが含まれています。[空間データ](access-graph-opencypher-22-spatial-data.md) および [空間関数](access-graph-opencypher-22-spatial-functions.md)ドキュメントを参照してください。
## このエンジンリリースの改善点
+ LIMIT 値が小さい結果セットを含む、小さな結果セットを返す SPARQL サブクエリのクエリパフォーマンスを改善
+ 変数が多数の定数値 (SPARQL VALUES 句や OpenCypher UNWIND 句など) によって制約されている場合のクエリパフォーマンスの向上
+ ディクショナリ挿入の最適化による低レイテンシー挿入クエリの改善
+ 新しい Gremlin 言語ステップを DFE エンジンに追加しました ([「DFE の Gremlin ステップカバレッジ](gremlin-step-coverage-in-DFE.md)」を参照）。
+ パスとトラバーサルステップ: `order(local)`
+ 集約と収集のステップ: `dedup(local)`
+ を含む OpenCypher クエリのパフォーマンスが向上しました`COLLECT(DISTINCT ...)`。エンジンバージョン 1.4.7.0 [以降を使用する場合、「COLLECT(DISTINCT ...) クエリの書き換え](best-practices-content-11.md)」で説明されている書き換えは不要になりました。
## このエンジンリリースで修正された不具合
一般的な修正:
+ 多数のエッジファイルをロードするときに一括ロードが応答しなくなる修正
+ リリース 1.4.0.0、1.4.1.0、および 1.4.2.0 からのセカンダリクラスターの更新に影響するグローバルデータベースクラスターのパッチ適用の問題を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.4.7.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.7.1`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.7.1`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.4.7.0 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.4.7.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.7.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムおよび[AWS プレミアムサポート](https://aws.amazon.com/support)を通じて AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.4.6.3 (2025-12-18)
2025-12-18 の時点で、エンジンバージョン 1.4.6.3 は一般的にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリース (1.4.6.3) で修正された不具合
**一般的な修正**
+ 誤って内部サーバーエラーとして分類された一部の例外は、データフローエンジン (DFE) の実行中にメモリ不足例外として正しく報告されるようになりました。
+ インラインエッジ ID 検証で予期しないディクショナリエントリタイプが発生したときに、起動中に Neptune データベースインスタンスが失敗する問題を修正しました。インラインエッジ ID 検証は Gremlin クエリエンジン設定でのみ実行され、非 URI ディクショナリエントリを適切に処理するようになりました。
+ エンドポイントの解決が正しくないため、Neptune バルクローダーが特定のリージョンで S3 に接続できない問題を修正しました。
**openCypher の修正**
+ を使用したクエリで発生することがあるエンジンのクラッシュを修正しました`CALL`。
+ ミューテーションクエリのタイムアウトとキャンセルの処理を修正しました。
+ に渡されたプロパティ値の 1 つに null 値がある場合に、 `MERGE``MERGE`句が誤った結果を与えるバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.4.6.3 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.7.1`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.7.1`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.4.6.3 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.4.6.3 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.6.3 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムおよび[AWS プレミアムサポート](https://aws.amazon.com/support)を通じて AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.4.6.2 (2025-11-18)
2025-11-18 の時点で、エンジンバージョン 1.4.6.2 は一般的にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースで修正された不具合
**一般的な修正**
+ 誤って内部障害例外 (IFEs) として分類された一部の例外は、データフローエンジン (DFE) の実行中に同時変更例外 (CMEs) として正しく報告されるようになりました。
**Gremlin の修正**
+ DFE よりも Gremlin のエンジン安定性を改善
**openCypher の修正**
+ Neptune エンジンリリース 1.4.6.0 で、openCypher MERGE クエリが受信リレーションシップ方向 (←) を誤って処理する問題を修正しました。MERGE (n)←[:type]-(m) などのパターンを使用するクエリは、正しい方向との関係を作成するようになりました。
+ 正しくロールバックされなかったライタートランザクションで失敗したコミットオペレーションを修正しました。
+ 最適化クエリプランは、パラメータ化された値を参照する MERGE クエリでサポートされるようになりました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.4.6.2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.7.1`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.7.1`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.4.6.2 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.4.6.2 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.6.2 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムおよび[AWSプレミアムサポート](https://aws.amazon.com/support)を通じてAWSサポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.4.6.1 (2025-09-18)
2025 年 9 月 18 日現在、エンジンバージョン 1.4.6.1 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースで修正された不具合
**一般的な修正**
+ リリース [Amazon Neptune エンジンバージョン 1.4.6.0 (2025-09-02)](engine-releases-1.4.6.0.md) で導入された非 RFC 1918 準拠のプライベート IP 範囲を使用しているクラスターに対するネットワークチェックを削除しました。
**Gremlin の修正**
+ トランザクションに関する WebSocket 接続管理の問題を修正しました。
+ gremlin DFE モードを使用しているときにまれに発生するインスタンスの再起動の問題を修正しました
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.4.6.1 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.7.1`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.7.1`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.4.6.1 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.4.6.1 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.6.1 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムおよび[AWS プレミアムサポート](https://aws.amazon.com/support)を通じて AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.4.6.0 (2025-09-02)
2025 年 9 月 2 日現在、エンジンバージョン 1.4.6.0 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**警告**
1.4.6.0 エンジンバージョンには、IAM 認証なしでデータベース VPC に非 RFC 1918 準拠のプライベート IP 範囲を使用しているクラスターに対する新しいネットワークチェックが含まれています。このような VPC および IAM 構成を使用している場合は、データベース VPC を更新して RFC 1918 プライベート IP 範囲を使用するか、IAM 認証を有効にして、1.4.6.0 へのアップグレード後にクエリでエラーが発生しないようにする必要があります。
## このエンジンリリースの新機能
+ パブリックエンドポイントを使用して Neptune に接続します。詳細については、「[Neptune パブリックエンドポイント](neptune-public-endpoints.md)」を参照してください。
## このエンジンリリースの改良点
**全般的な機能強化**
+ 更新オペレーションの SPARQL パフォーマンスが向上しました。
+ `CREATE`、`MERGE`、および `SET` (ミューテーション) オペレーションの OpenCypher パフォーマンスが向上しました。
+ CALL サブクエリオペレーションの OpenCypher パフォーマンスが向上しました。
**openCypher の改善**
+ クエリ[レベルのタイムアウトをサポートする新しいクエリ](opencypher-query-hints-timeout-hint.md)ヒントを追加しました。
## このエンジンリリースで修正された不具合
**Gremlin の修正**
+ Gremlin セッションへの接続は、セッションを作成したのと同じチャネルで実行する必要があります。つまり、複数のクライアントインスタンスを同じセッションに接続することはできません。
+ Gremlin セッションは、クライアントによって終了したときには必ず終了しますが、サーバーによって接続が終了された場合にも終了するようになりました。これにより、意図しない、または予期しない再接続を防ぐことができます。
+ 大きな BLOB タイプのデータを読み取る Gremlin クエリのメモリリークを修正しました。
**openCypher の修正**
+ `CALL` サブクエリ後の変数処理を修正しました。
+ 算術オーバーフローシナリオを正しく処理する`reduce`関数の問題を修正しました。
+ クエリプランキャッシュが有効になっている場合に、パラメータ化されたクエリに影響するメモリリークを修正しました。
+ 複雑な`WHERE``NOT EXISTS`句で使用される の問題を修正しました。
+ BadRequestException として誤って報告される Cuncurrent Memory Exception (CMEs) を修正しました。
**SPARQL の修正**
+ リモートソースが使用できない場合の SPARQL `LOAD/UNLOAD` のエラーメッセージを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.4.6.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.7.1`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.7.1`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.4.6.0 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.4.6.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.6.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムおよび[AWSプレミアム](https://aws.amazon.com/support)AWSサポートを通じてサポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.4.5.1 (2025-06-30)
2025 年 6 月 30 日現在、エンジンバージョン 1.4.5.1 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースで修正された不具合
**一般的な修正**
+ すべてのクエリ言語に影響を与えていたサーバーレススケーリングの問題を修正しました。
+ `collect(distinct())` をリストに対して実行するときに一部の OpenCypher クエリで内部エラーが返される問題を修正しました。
+ OpenSearch サーバーレスの使用時に、同時 FTS クエリによって他の同時 FTS クエリが終了する問題を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.4.5.1 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.7.1`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.7.1`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.4.5.1 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.4.5.1 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.5.1 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.4.5.0 (2025-04-09)
2025 年 4 月 9 日現在、エンジンバージョン 1.4.5.0 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**警告**
特定のサーバーレス構成で問題が発生する可能性があるため、1.4.5.0 へのアップグレードを一時的に停止しました。1.4.5.1 エンジンバージョンにアップグレードすることをお勧めします。1.4.5.0 へのアップグレードは一時的に無効になっています。
## このエンジンリリースの新機能
+ 新しい Gremlin 言語ステップを DFE エンジンに追加しました。
+ **パスとトラバーサルステップ: **asDate()、dateAdd()、dateDiff()、fail()、Inject()、label()、path()、project()、repeat()、sack()、select()、unfold()、disjunct()、drop()、identity()、intersect()、length()、loops()、barrier()、order()、range()、reverse()、sample()、cap()、split()、filter()、flatMap()、map()、sideEffect()、union()、index()
+ **集計および収集ステップ: **aggregate(global)、combine()、count()、dedup(global)、fold()、group()、groupCount()
+ **数学ステップ: **max()、mean()、min()、sum()
+ **要素ステップ: **otherV()、elementMap()、element()、V()、out()、in()、both()、outE()、inE()、bothE()、outV()、inV()、bothV()、otherV()
+ **プロパティステップ: **properties()、key()、valueMap()、value()
+ **フィルターステップ: **and()、coalesce()、coin()、is()、local()、none()、not()、or()、where()
+ **文字列操作ステップ: **concat()、lTrim()、rTrim()、substring()、toLower()、toUpper()、trim()
+
**述語:**
+ 比較: eq、neq、lt、lte、gt、gte
+ 包含: within、without
+ TextP: endingWith、containing、notStartingWith、notEndingWith、notContaining
+ P: and、or、between、outside、inside
DFE で使用可能なすべての Gremlin ステップの詳細については、「[DFE での Gremlin ステップカバレッジ](gremlin-step-coverage-in-DFE.md)」を参照してください。
## このエンジンリリースの改良点
**全般的な機能強化**
+ スロークエリログのロック待機時間が改善されました。スロークエリログに、共有ロックと排他的ロックの待機時間メトリクスが含まれるようになりました。遅延読み取り/書き込みの昇格である場合、これらのメトリクスが各トランザクションの一部として保存されます。これらは、スロークエリログの storageCounters セクションに表示されます。
+ 次の暗号スイートのサポートが終了しました。
+ TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256
+ TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384
+ TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256
+ TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384
**Gremlin の改善点**
+ Gremlin 言語に多くの新しいステップを追加しました。詳細については、「[DFE での Gremlin ステップカバレッジ](gremlin-step-coverage-in-DFE.md)」を参照してください。
**openCypher の改善**
+ CREATE、MERGE、SET (ミューテーション) のパフォーマンスが向上しました。
+ CALL サブクエリのパフォーマンスが向上しました。
+ マルチパート openCypher レスポンスの HTTP 末尾ヘッダーのサポートを開始しました。詳細については、「[マルチパート OpenCypher レスポンス用のオプションの HTTP 末尾ヘッダー](https://docs.aws.amazon.com//neptune/latest/userguide/access-graph-opencypher-queries.html#optional-http-trailing-headers)」を参照してください。
+ openCypher に日、月、年の時間関数を追加しました。詳細については、「[時間関数](https://docs.aws.amazon.com//neptune/latest/userguide/access-graph-opencypher-extensions.html#temporal-functions)」を参照してください。
```
RETURN day(datetime('2021-06-03T01:48:14Z'))
{
"results": [{
"day(datetime('2021-06-03T01:48:14Z'))": 3
}]
}
```
## このエンジンリリースで修正された不具合
**一般的な修正**
+ Audit/SlowQueryLog ログファイルが削除される問題を修正しました。
**Gremlin の修正**
+ 結果キャッシュ機能を無効にした状態で Gremlin クエリが実行される問題を修正しました。iterate() で終わるクエリが、空のレスポンスを返す代わりに結果を返していました。
+ 同じキーを持つ同時クエリによって発生する Gremlin 結果キャッシュの問題を修正しました。同時実行クエリの 1 つが、空の結果を返すのではなく、誤って結果を返していました。
+ クリーンアップ時間を増やすことで、タイムアウトまたはキャンセルが原因で Amazon S3 へのマルチパートアップロードに失敗するという Amazon S3 エクスポートクエリの問題を修正しました。
+ Gremlin Amazon S3 エクスポートに関連するアクセス許可の問題を修正しました。
**SPARQL の修正**
+ 複数のベース IRI を宣言する SPARQL クエリで最初の宣言のみが使用される問題を修正しました。
+ エラーが返される原因となる無効なパターン文字列を使用した SPARQL `REPLACE` 関数の処理の問題を修正しました。
+ ユニコードデータで大文字と小文字を区別しない (`"i"`) フラグを使用した SPARQL `REPLACE` 関数の処理に関する問題を修正しました。
+ 無効なエスケープシーケンス `\u` と `\U` コードポイントエスケープシーケンスを使用した SPARQL クエリの解析で、レスポンスが返されない問題を修正しました。
+ SPARQL `IRI` 関数で、現在のベース IRI に対する相対 IRI が常に正しく解決されない問題を修正しました。
+ プレフィックス名を使用した `SPARQL INSERT DATA` および `DELETE DATA` の更新で、現在のベース IRI に対する相対 IRI が正しく解決されない問題を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.4.5.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.7.1`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.7.1`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.4.5.0 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.4.5.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.5.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムおよび[AWSプレミアムサポート](https://aws.amazon.com/support)を通じてAWSサポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.4.4.0 (2025-02-24)
2025 年 2 月 24 日現在、エンジンバージョン 1.4.4.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% の低下が見られる可能性があります。
## このエンジンリリースで修正された不具合
**一般的な修正**
+ アスタリスク (`*`) とエイリアシング式を含む `WITH` 句が openCypher で誤ったクエリ解析を引き起こす問題を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.4.4.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.7.1`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.7.1`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.4.4.0 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.4.4.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.4.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# 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 にエクスポートする](exporting-gremlin.md)。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 ディクショナリガベージコレクション](storage-gc.md)を参照してください。
## このエンジンリリースで修正された不具合
**一般的な修正**
+ 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](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.4.3.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.3.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.4.2.0 (2024-12-19)
2024 年 12 月 19 日現在、エンジンバージョン 1.4.2.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% の低下が見られる可能性があります。
## このエンジンリリースで修正された不具合
**一般的な修正**
+ OPTIONAL MATCH 内やとリスト内表記の中で同じ変数に対して複数のプロパティアクセスを使用するクエリの実行プランとパフォーマンスを修正しました。例:
```
MATCH (n)
WHERE n.name = 'A'
OPTIONAL MATCH (n)-[:knows]->(m)
WHERE m.name = 'C' or m.city = 'B'
RETURN m
```
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.4.2.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.7.1`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.7.1`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.4.2.0 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.4.2.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.2.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.4.1.0 (2024-11-21)
2024 年 11 月 21 日現在、エンジンバージョン 1.4.1.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% の低下が見られる可能性があります。
## このエンジンリリースの新機能
+ 読み取り専用サブクエリを使用した `CALL` サブクエリのサポートが追加され、定義されたスコープ内でのオペレーションの実行が可能になりました。`CALL` サブクエリが受信行ごとに 1 回実行され、返される変数を、それを囲むクエリの外側のスコープで使用できます。外側のスコープからの変数は、インポートを行う `WITH` 句を使用して `CALL` サブクエリにインポートできます。詳細については、「[Neptune での CALL サブクエリのサポート](https://docs.aws.amazon.com//neptune/latest/userguide/access-graph-opencypher-extensions.html#call-subquery-support)」を参照してください。
```
MATCH (origin:airport {code:"AUS"})-[:route]->(stopover)
CALL {
WITH stopover
MATCH (stopover)-[r:route]->(destination)
RETURN destination
ORDER BY r.dist DESC LIMIT 2
}
RETURN stopover, destination
```
+ openCypher 関数を追加しました。文字列、コレクションの操作、コレクションのソートに役立つ 8 つの新しい関数を導入しました。例として、`textIndexOf`、`collToSet`、`collSubtract`、`collIntersection`、`collSort`、`collSortMaps`、`collSortMulti`、および `collSortNodes` があります。説明、入力パラメータ、出力、および例については、「[Neptune openCypher 関数](https://docs.aws.amazon.com//neptune/latest/userguide/access-graph-opencypher-extensions.html#opencypher-compliance-new-functions)」を参照してください。
## このエンジンリリースの改良点
**Gremlin の改善点**
+ 新しいラボモードパラメータ `AccurateQRCMemoryEstimation`。[Gremlin クエリ結果キャッシュ](https://docs.aws.amazon.com//neptune/latest/userguide/gremlin-results-cache.html)を有効にすると、データベースでのクエリ結果のキャッシュが許可されます。デフォルトでは、キャッシュされた結果のサイズは概算推定を使用して決定されます。このラボモードパラメータ `AccurateQRCMemoryEstimation` を有効にすると、キャッシュされた結果のサイズ推定で、概算ではなく正確なサイズの推定が使用されます。
+ デフォルトの実行エンジンで実行される Gremlin クエリの「not」フィルター最適化の問題を修正しました。この問題は、エッジのフィルタリングで not() ステップと outV()/inV()/otherV() ステップの組み合わせを使用する場合にクエリに影響を及ぼしていました。サンプルクエリは以下のとおりです。
+ `g.E().hasLabel("knows").not(outV().hasId("5"))`
+ `g.V().has('airport','code','SDF').outE().where(not(otherV().has(id, within('1','5','7')))).count()`
**openCypher の改善**
+ 大規模な静的リストまたはマップを使用するクエリのパフォーマンスが向上しました。プロパティを持つノードを挿入/アップサートするために使用されるネストされたマップの大きなリストに対して UNWIND を行う特定のクエリで、パフォーマンスが大幅に向上します。
+ このクエリで使用される値に対して一貫したデータ型を継承するようエンジンに指示する新しい openCypher クエリヒントを導入します。新しい openCypher クエリヒントの詳細については、「[AssumeConsistentDataTypes](https://docs.aws.amazon.com//neptune/latest/userguide/opencypher-query-hints-AssumeConsistentDataTypes.html)」を参照してください。
+ テキスト値とコレクション値を処理するための[新しい openCypher 関数](https://docs.aws.amazon.com//neptune/latest/userguide/access-graph-opencypher-extensions.html#opencypher-compliance-new-functions)のセットを導入します。
## このエンジンリリースで修正された不具合
**Gremlin の修正**
+ `GraphTraversalSource` 「g」オブジェクトでいずれかの `withStrategies()/withoutStrategies()/with()` ステップが使用されている場合、TinkerPop OSS コードパスでトラバーサルクエリのバイトコード表現が構築される問題を修正しました。この問題で、同じ戦略の既存の指示を置き換える代わりに、誤って新しい指示がバイトコードに追加され、結果キャッシュの無効化中にキャッシュキーの不一致が発生し、保存された結果がクリアされていました。
**openCypher の修正**
+ CREATE/MERGE/MATCH 句の ``~id`match` の動作を修正しました。null 型や文字列以外の型などの無効な ``~id`` 値を使用した場合、CREATE/MERGE 句には正しい例外がスローされ、`MATCH` 句にはゼロの結果が返されるようになりました。
+ ユーザーが集計関数 (sum(<文字列>)) でサポートされていない型の値を使用する場合の IFE を修正しました。
+ 大量のクエリのワークロードからの低レイテンシーミューテーションクエリが OutOfMemory エラーで失敗する問題を修正しました。
**SPARQL の修正**
+ `'%'` 文字を含む SPARQL クエリを処理する際の監査ログの問題を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.4.1.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.7.1`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.7.1`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.4.1.0 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.4.1.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.1.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムおよび[AWSプレミアムサポート](https://aws.amazon.com/support)を通じてAWSサポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.4.0.0 (2024-11-06)
2024 年 11 月 6 日現在、エンジンバージョン 1.4.0.0 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
[エンジンリリース 1.3.0.0](engine-releases-1.3.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.3.0.0 より前のエンジンバージョンからエンジンバージョン 1.3.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.3` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` または `neptune1.2` を使用していましたが、これらのパラメータグループはリリース 1.3.0.0 以降では動作しません。同様に、エンジンバージョン 1.4.0.0 以降では 1.4.0.0 クラスターパラメータグループを使用する必要があります。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
**警告**
クエリの数値型パラメータの重複使用を処理するバグにより、数値パラメータ値を含むパラメータ化されたクエリを実行するユースケースでは、クエリプランキャッシュは一時的にサポートされていません。例えば、次のようになります。
```
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 バイト整数を使用して ID を割り当てます。ディクショナリのオーバーヘッドはありません。これにより、クエリを変更することなく、ストレージの節約とクエリパフォーマンスの向上につながります。この機能は現在、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 の改善**
+ 以前のリリースでは、[日時形式のサポートの拡張](https://docs.aws.amazon.com//neptune/latest/userguide/feature-opencypher-compliance.html#opencypher-compliance-time-na)が導入され、ラボモードパラメータ `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.
```
## このエンジンリリースで修正された不具合
**一般的な修正**
+ スケールアップ中にデータベースが再起動する可能性があるサーバーレスインスタンスの問題を修正しました。
+ 監査ログファイルの管理について、ログファイルにアクセスしてダウンロードやローテーションを行うのを妨げ、場合によっては CPU 使用率を上昇させる問題を修正しました。
+ DFE エンジンでのマップ出力生成の最適化遅延に関連するクエリの問題を修正しました。
+ 監査ログとスロークエリログの間でタイムスタンプが一致しない問題を修正しました。
**Gremlin の修正**
+ Gremlin WebSocket 接続管理で、接続アイドルタイムアウトを超える時間実行されているクエリが途中で終了する問題を解決しました。これは、特に AIOHTTP トランスポートを使用する Python Gremlin クライアントに影響を与えました。
**openCypher の修正**
+ collect(distinct(n)) クエリコンストラクト中に null 値が存在する場合に内部障害例外が発生する collect ステップの問題を修正しました。
+ クエリプランキャッシュが有効になっている場合に、クエリで `NullPointerException` が発生する可能性がある問題を修正しました。
+ クエリに LIMIT 句が含まれている場合に、必要以上のデータを評価する問題を修正しました。
+ クエリプランキャッシュでパラメータ化されたクエリで範囲操作 (<、<=、>、>=) を使用すると重複した結果が生成される問題を修正しました。
+ ボルト接続を使用して UNION および UNION ALL 操作を実行すると、結果列が入れ替えられる問題を修正しました。
## このリリースでサポートされるクエリ言語バージョン
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](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.4.0.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.0.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムおよび[AWSプレミアム](https://aws.amazon.com/support)AWSサポートを通じてサポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.3.4.0 (2024-10-01)
2024 年 10 月 1 日現在、エンジンバージョン 1.3.4.0. は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
[エンジンリリース 1.3.0.0](engine-releases-1.3.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.3.0.0 より前のエンジンバージョンからエンジンバージョン 1.3.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.3` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` または `neptune1.2` を使用していましたが、これらのパラメータグループはリリース 1.3.0.0 以降では動作しません。同様に、エンジンバージョン 1.4.0.0 以降では 1.4.0.0 クラスターパラメータグループを使用する必要があります。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
**警告**
SPARQL 1.1 の更新操作で問題が検出されました。これは、更新演算子をアクションベースの認可ポリシーで使用するときに、特定の条件下で発生する可能性があります。アクションベースの認可ポリシーで SPARQL 1.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 メトリクス](https://docs.aws.amazon.com//neptune/latest/userguide/cw-metrics.html#cw-metrics-available)」を参照してください。
```
NumResultCacheHit
NumResultCacheMiss
ResultCacheSizeInBytes
ResultCacheItemCount
ResultCacheOldestItemTimestamp
ResultCacheNewestItemTimestamp
```
## このエンジンリリースで修正された不具合
**全般的な改善点:**
+ まれに、クエリエラーを返す代わりにエンジンがクラッシュする問題を修正しました。
**Gremlin の修正**
+ クライアントまたはプロキシが、確立/使用されている HTTP 接続経由で Websocket アップグレードリクエストを送信したときのリクエスト処理とエラーレポートを改善しました (以前は、「Gremlin スクリプトが指定されていません。コード MissingParameterException」というエラーを含む 400 の応答が返されていました)。
+ 単一基数プロパティ値の更新による`mergeV`ステップの処理を最適化しました。例えば、以下のクエリは Neptune でネイティブにサポートされるようになりました。
```
g.mergeV([(T.id): 1234]). option(onMatch, ['age': single(20), 'name': single('alice'), 'city': set('miami')])
```
+ クエリが で失敗する原因となる Gremlin DFE クエリ評価の問題を修正しました`InternalFailureException`。このエラーは、次の例`select`に示すように、 の特定のパターンで発生しました。
```
g.V("1").as("a").as("b").select("a","b").dedup()
```
**openCypher の修正**
+ null 値が存在する を実行する`collect(distinct())`とエラーが返される問題を修正しました。
+ 範囲フィルター (パラメータ値に対する=) を含むパラメータ化されたクエリを実行すると、結果が重複/欠落する問題を修正しました。
+ 制限クエリで DFE エンジンが要求したよりも多くの出力を生成し、メモリ不足エラーが発生する可能性があるバグを修正しました。
**SPARQL の修正**
+ IAM 認証が有効なクラスターでフェデレーション SPARQL 更新クエリを実行すると、エラーが返される問題を修正しました。
+ SPARQL 1.1 更新操作のアクションベースの権限を修正しました。
## このリリースでサポートされるクエリ言語バージョン
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](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.3.4.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.3.4.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムおよび[AWS プレミアム](https://aws.amazon.com/support) AWS サポートを通じてサポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.3.3.0 (2024-08-05)
2024 年 8 月 5 日現在、エンジンバージョン 1.3.3.0. は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
[エンジンリリース 1.3.0.0](engine-releases-1.3.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.3.0.0 より前のエンジンバージョンからエンジンバージョン 1.3.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.3` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` または `neptune1.2` を使用していましたが、これらのパラメータグループはリリース 1.3.0.0 以降では動作しません。同様に、エンジンバージョン 1.4.0.0 以降では 1.4.0.0 クラスターパラメータグループを使用する必要があります。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
**警告**
エンジンリリース 1.3.3.0 では、注意すべき潜在的な問題がいくつか発生しました。詳細については、次の「[リリース 1.3.3.0 の問題の軽減](#1.3.3.0-mitigation)」セクションを参照してください。
## このエンジンリリースで修正された不具合
**全般的な機能強化**
+ 述語キャッシュに多数の述語がある場合にエンジンが不安定になる問題を修正しました。
**openCypher の修正**
+ 内部例外がスローされた後、クエリ実行が停止したままになる問題を修正しました。
+ クエリプランキャッシュの使用時に内部例外でクエリが失敗する問題を修正しました。
**SPARQL の修正**
+ アクションベースの認可ポリシーで GSP を使用する場合、特定の条件下で発生する可能性がある SPARQL 1.1 Graph Store HTTP Protocol (GSP) の問題を修正しました。
## リリース 1.3.3.0 の問題の軽減
+ 数値フィルター値を使用するクエリは、クエリプランキャッシュを使用する際に誤った結果が返される可能性があります。問題を回避するには、クエリヒント `QUERY:PLANCACHE "disabled"` を使用してクエリプランキャッシュをスキップします。例えば
```
USING QUERY:PLANCACHE "disabled"
MATCH (n:person)
WHERE n.yearOfBirth > $year
RETURN n
parameters={"year":1950}
```
+ 同じパラメータ名を複数回使用するクエリは、エラー `Parameter name should not be a number and/or contain _internal_ or _modified_user_ string within it. These are reserved for planCache. Otherwise, rerun with HTTP parameter planCache=disabled` で失敗する可能性があります。このような場合は、上記のようなクエリプランキャッシュをスキップするか、次の例のようにパラメータを複製します。
```
MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$minutes RETURN n
parameters={"minutes":130}
```
ヒント `QUERY:PLANCACHE "disabled"` を使用するか、パラメータを変更します。
```
MATCH (n:movie) WHERE n.runtime>=$rt_min RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$dur_min RETURN n
parameters={"rt_min":130, "dur_min":130}
```
+ Bolt プロトコルで実行されるクエリは、クエリが UNION または UNION ALL クエリの場合、誤った結果を生成する可能性があります。この問題を回避するには、HTTP エンドポイントで特定のクエリを実行することを検討してください。または、Bolt プロトコルを使用する場合は、UNION の各部分を個別に実行します。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.3.3.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.7.1`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.7.1`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.3.3.0 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.3.3.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.3.3.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.3.2.1 (2024-06-20)
2024 年 6 月 20 日現在、エンジンバージョン 1.3.2.1 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
[エンジンリリース 1.3.0.0](engine-releases-1.3.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.3.0.0 より前のエンジンバージョンからエンジンバージョン 1.3.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.3` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` または `neptune1.2` を使用していましたが、これらのパラメータグループはリリース 1.3.0.0 以降では動作しません。同様に、エンジンバージョン 1.4.0.0 以降では 1.4.0.0 クラスターパラメータグループを使用する必要があります。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
**警告**
エンジンリリース 1.3.2.1 では、注意すべき潜在的な問題がいくつか発生しました。詳細については、次の「[リリース 1.3.2.1 の問題の軽減](#1.3.2.1-mitigation)」セクションを参照してください。
## このエンジンリリースで修正された不具合
**openCypher の修正**
+ パラメータとして `SKIP` および `LIMIT` を持つ内部 `WITH` 句を含むパラメータ化されたクエリのクエリプランキャッシュ機能でバグが検出されました。SKIP/LIMIT 値が適切にパラメータ化されなかったため、パラメータ値が異なる同じキャッシュされたクエリプランの後続の実行でも、最初の実行と同じ結果が返されます。この問題は修正されました。
```
# insert some nodes
UNWIND range(1, 10) as i CREATE (s {name: i}) RETURN s
# sample query
MATCH (p)
WITH p ORDER BY p.name SKIP $s LIMIT $l
RETURN p.name as res
# first time executing with {"s": 2, "l": 1}
{
"results" : [ {
"res" : 3
} ]
}
# second time executing with {"s": 2, "l": 10}
# due to bug, produces
{
"results" : [ {
"res" : 3
} ]
}
# with fix, produces correct results:
{
"results" : [ {
"res" : 3
}, {
"res" : 4
}, {
"res" : 5
}, {
"res" : 6
}, {
"res" : 7
}, {
"res" : 8
}, {
"res" : 9
}, {
"res" : 10
} ]
}%
```
+ 渡されたパラメータがデータベースにまだ存在しない場合に、パラメータ化されたミューテーションクエリが `InternalFailureException` をスローするバグを修正しました。
+ クエリリソースのクリーンアップ中に競合状態になった後、パラメータ化された Bolt クエリが停止するバグを修正しました。
## 1.3.2.0 から引き継がれた 1.3.2.1 の変更点
### エンジンリリース 1.3.2.0 から引き継がれた改善点
**全般的な機能強化**
+ 暗号スイート TLS\$1AES\$1128\$1GCM\$1SHA256 と TLS\$1AES\$1256\$1GCM\$1SHA384 を含む TLS バージョン 1.3 のサポート。TLS 1.3 はオプションです。TLS 1.2 はまだ最小です。
+ openCypher の datetime 形式の拡張サポートは、このバージョンの lab\$1mode にあります。テストすることをお勧めします。
**Gremlin の改善**
+ TinkerPop 3.7.x のアップグレード
+ Gremlin 言語の大規模な拡張を提供します。
+ 文字列、リスト、日付を処理するための新しいステップ。
+ `mergeV()` ステップ内で基数を指定するための新しい構文。
+ `union()` を開始ステップとして使用できるようになりました。
+ 3.7.x の変更の詳細については、[TinkerPop アップグレードドキュメント](https://tinkerpop.apache.org/docs/3.7.1/upgrade/#_tinkerpop_3_7_1)を参照してください。
+ Java 用のクライアント Gremlin 言語ドライバーをアップグレードする場合、シリアライザークラスの[名前変更](https://tinkerpop.apache.org/docs/3.7.1/upgrade/#_serializer_renaming)が一部無効になっていることに注意してください。指定されている場合は、構成ファイルとコードでパッケージとクラスの命名を更新する必要があります。
+ `StrictTimeoutValidation` (`StrictTimeoutValidation=enabled` を含めることでラボモード `StrictTimeoutValidation` で有効になっている場合のみ): `StrictTimeoutValidation` パラメータの値が `enabled` である場合、リクエストオプションまたはクエリヒントとして指定されたクエリごとのタイムアウト値は、パラメータグループでグローバルに設定された値を超えることはできません。このような場合、Neptune は `InvalidParameterException` をスローします。この設定は、値が `disabled` である場合に `/status` エンドポイントのレスポンスで確認できます。Neptune バージョン 1.3.2.0 および 1.3.2.1 では、このパラメータのデフォルト値は `Disabled` です。
**openCypher の改善**
+ Amazon Neptune エンジンバージョン 1.3.2.0 は、以前のエンジンリリースと比較して openCypher クエリのパフォーマンスに対して最大 9 倍高速で 10 倍高いスループットを提供します。
+ 低レイテンシのクエリとスループットパフォーマンスの向上: 低レイテンシの openCypher クエリの全体的なパフォーマンスの向上。新しいバージョンでは、このようなクエリのスループットも向上します。パラメータ化されたクエリを使用すると、改善効果がより顕著になります。
+ クエリプランキャッシュのサポート: クエリが Neptune に送信されると、クエリ文字列が解析、最適化され、クエリプランに変換されて、エンジンによって実行されます。アプリケーションは、多くの場合に、異なる値でインスタンス化された一般的なクエリパターンによってバックアップされます。クエリプランキャッシュは、クエリプランをキャッシュすることで全体的なレイテンシーを低減し、このような繰り返しパターンの解析と最適化を回避できます。詳細については、「[Amazon Neptune のクエリプランキャッシュ](access-graph-qpc.md)」を参照してください。
+ DISTINCT 集約クエリのパフォーマンス向上。
+ null 可能な変数を含む結合のパフォーマンス向上。
+ id (ノードおよび関係) 述語と等しくないクエリのパフォーマンス向上。
+ 日時機能のサポートの拡張 (`DatetimeMillisecond=enabled` を含めることでラボモード `DatetimeMillisecond` でのみ有効になります)。詳細については、「[Neptune openCypher 実装 (Neptune Analytics および Neptune データベース 1.3.2.0 以降) での一時的なサポート](feature-opencypher-compliance.md#opencypher-compliance-time-na)」を参照してください。
### エンジンリリース 1.3.2.0 から引き継がれた不具合の修正
**全般的な機能強化**
+ Graphlytics バケットへのアクセスを検証する際の NeptuneML エラーメッセージを更新しました。
**Gremlin の修正**
+ パス以外の寄与ステップにラベルが含まれているシナリオの DFE クエリ変換で欠落しているラベル情報を修正しました。例:
```
g.withSideEffect('Neptune#useDFE', true).
V().
has('name', 'marko').
has("name", TextP.regex("mark.*")).as("p1").
not(out().has("name", P.within("peter"))).
out().as('p2').
dedup('p1', 'p2')
```
+ 2 つの DFE フラグメントでクエリが実行され、最初のフラグメントが満たされないノードに最適化された場合に発生する DFE クエリ変換の `NullPointerException` バグを修正しました。例:
```
g.withSideEffect('Neptune#useDFE', true).
V().
has('name', 'doesNotExists').
has("name", TextP.regex("mark.*")).
inject(1).
V().
out().
has('name', 'vadas')
```
+ クエリの by() モジュレータ内に ValueTraversal が含まれ、その入力が Map である場合に、Neptune が `InternalFailureException` をスローすることがあるバグを修正しました。例:
```
g.V().
hasLabel("person").
project("age", "name").by("age").by("name").
order().by("age")
```
**openCypher の修正**
+ UNWIND 操作 (値のリストを個々の値に拡張するなど) を改善し、メモリ不足 (OOM) 状態を防止しました。例:
```
MATCH (n)-->(m)
WITH collect(m) AS list
UNWIND list AS m
RETURN m, list
```
+ ID が UNWIND を介して挿入される複数の MERGE 操作の場合のカスタム ID 最適化を修正しました。例:
```
UNWIND [{nid: 'nid1', mid: 'mid1'}, {nid: 'nid2', mid: 'mid2'}] as ids
MERGE (n:N {`~id`: ids.nid})
MERGE (m:M {`~id`: ids.mid})
```
+ プロパティアクセスと双方向の関係を持つ複数のホップを含む複雑なクエリを計画する際のメモリ爆発を修正しました。例:
```
MATCH (person1:person)-[:likes]->(res)-[:partOf]->(group)-[:knows]-(:entity {name: 'foo'}),
(person1)-[:knows]->(person2)-[:likes]-(res2), (comment)-[:presentIn]->(:Group {name: 'barGroup'}),
(person1)-[:commented]->(comment2:comment)-[:partOf]->(post:Post), (comment2)-[:presentIn]->(:Group {name: 'fooGroup'}),
(comment)-[:contains]->(info:Details)-[:CommentType]->(:CommentType {name: 'Positive'}),
(comment2)-[:contains]->(info2:Details)-[:CommentType]->(:CommentType {name: 'Positive'})
WHERE datetime('2020-01-01T00:00') <= person1.addedAfter <= datetime('2023-01-01T23:59') AND comment.approvedBy = comment2.approvedBy
MATCH (comment)-[:contains]->(info3:Details)-[:CommentType]->(:CommentType {name: 'Neutral'})
RETURN person1, group.name, info1.value, post.ranking, info3.value
```
+ グループ化変数として null を持つ集計クエリを修正しました。例:
```
MATCH (n)
RETURN null AS group, sum(n.num) AS result
```
**SPARQL の修正**
+ 多数のトリプルと大きなトークンを含む INSERT DATA などの大規模なクエリの解析時間を短縮するため、SPARQL パーサーを修正しました。
### リリース 1.3.2.1 の問題の軽減
+ 数値フィルター値を使用するクエリは、クエリプランキャッシュを使用する際に誤った結果が返される可能性があります。問題を回避するには、クエリヒント `QUERY:PLANCACHE "disabled"` を使用してクエリプランキャッシュをスキップします。例えば
```
USING QUERY:PLANCACHE "disabled"
MATCH (n:person)
WHERE n.yearOfBirth > $year
RETURN n
parameters={"year":1950}
```
+ 同じパラメータ名を複数回使用するクエリは、エラー `Parameter name should not be a number and/or contain _internal_ or _modified_user_ string within it. These are reserved for planCache. Otherwise, rerun with HTTP parameter planCache=disabled` で失敗する可能性があります。このような場合は、上記のようなクエリプランキャッシュをスキップするか、次の例のようにパラメータを複製します。
```
MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$minutes RETURN n
parameters={"minutes":130}
```
ヒント `QUERY:PLANCACHE "disabled"` を使用するか、パラメータを変更します。
```
MATCH (n:movie) WHERE n.runtime>=$rt_min RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$dur_min RETURN n
parameters={"rt_min":130, "dur_min":130}
```
+ Bolt プロトコルで実行されるクエリは、クエリが UNION または UNION ALL クエリの場合、誤った結果を生成する可能性があります。この問題を回避するには、HTTP エンドポイントで特定のクエリを実行することを検討してください。または、Bolt プロトコルを使用する場合は、UNION の各部分を個別に実行します。
### このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.3.2.1 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.7.1`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.7.1`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.3.2.1 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.3.2.1 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.3.2.1 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.3.2.0 (2024-06-10)
2024 年 6 月 10 日現在、エンジンバージョン 1.3.2.0 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
[エンジンリリース 1.3.0.0](engine-releases-1.3.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.3.0.0 より前のエンジンバージョンからエンジンバージョン 1.3.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.3` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` または `neptune1.2` を使用していましたが、これらのパラメータグループはリリース 1.3.0.0 以降では動作しません。同様に、エンジンバージョン 1.4.0.0 以降では 1.4.0.0 クラスターパラメータグループを使用する必要があります。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
**警告**
エンジンリリース 1.3.2.0 では、注意すべき潜在的な問題がいくつか発生しました。詳細については、次の「[リリース 1.3.2.0 の問題の軽減](#1.3.2.0-mitigation)」セクションを参照してください。
## このエンジンリリースの改良点
**全般的な機能強化**
+ 暗号スイート TLS\$1AES\$1128\$1GCM\$1SHA256 と TLS\$1AES\$1256\$1GCM\$1SHA384 を含む TLS バージョン 1.3 のサポート。TLS 1.3 はオプションです。TLS 1.2 はまだ最小です。
**Gremlin の改善**
+ TinkerPop 3.7.x のアップグレード
+ Gremlin 言語の大規模な拡張を提供します。
+ 文字列、リスト、日付を処理するための新しいステップ。
+ `mergeV()` ステップで基数を指定するための新しい構文。
+ `union()` を開始ステップとして使用できるようになりました。
+ 3.7.x の変更の詳細については、[TinkerPop アップグレードドキュメント](https://tinkerpop.apache.org/docs/3.7.1/upgrade/#_tinkerpop_3_7_1)を参照してください。
+ Java 用のクライアント Gremlin 言語ドライバーをアップグレードする場合、シリアライザークラスの[名前変更](https://tinkerpop.apache.org/docs/3.7.1/upgrade/#_serializer_renaming)が一部無効になっていることに注意してください。指定されている場合は、構成ファイルとコードでパッケージとクラスの命名を更新する必要があります。
+ `StrictTimeoutValidation` (`StrictTimeoutValidation=enabled` を含めることでラボモード `StrictTimeoutValidation` で有効になっている場合のみ): `StrictTimeoutValidation` パラメータの値が `enabled` である場合、リクエストオプションまたはクエリヒントとして指定されたクエリごとのタイムアウト値は、パラメータグループでグローバルに設定された値を超えることはできません。このような場合、Neptune は `InvalidParameterException` をスローします。この設定は、値が `disabled` である場合に `/status` エンドポイントのレスポンスで確認できます。Neptune バージョン 1.3.2.0 では、このパラメータのデフォルト値は `Disabled` です。
**openCypher の改善**
+ Amazon Neptune エンジンバージョン 1.3.2.0 は、以前のエンジンリリースと比較して openCypher クエリのパフォーマンスに対して最大 9 倍高速で 10 倍高いスループットを提供します。
+ 低レイテンシのクエリとスループットパフォーマンスの向上: 低レイテンシの openCypher クエリの全体的なパフォーマンスの向上。新しいバージョンでは、このようなクエリのスループットも向上します。パラメータ化されたクエリを使用すると、改善効果がより顕著になります。
+ クエリプランキャッシュのサポート: クエリが Neptune に送信されると、クエリ文字列が解析、最適化され、クエリプランに変換されて、エンジンによって実行されます。アプリケーションは、多くの場合に、異なる値でインスタンス化された一般的なクエリパターンによってバックアップされます。クエリプランキャッシュは、クエリプランをキャッシュすることで全体的なレイテンシーを低減し、このような繰り返しパターンの解析と最適化を回避できます。
+ DISTINCT 集約クエリのパフォーマンス向上。
+ null 可能な変数を含む結合のパフォーマンス向上。
+ id (ノードおよび関係) 述語と等しくないクエリのパフォーマンス向上。
+ 日時機能のサポートの拡張 (`DatetimeMillisecond=enabled` を含めることでラボモード `DatetimeMillisecond` でのみ有効になります)。詳細については、「[Neptune openCypher 実装 (Neptune Analytics および Neptune データベース 1.3.2.0 以降) での一時的なサポート](feature-opencypher-compliance.md#opencypher-compliance-time-na)」を参照してください。
## このエンジンリリースで修正された不具合
**全般的な機能強化**
+ Graphlytics バケットへのアクセスを検証する際の NeptuneML エラーメッセージを更新しました。
**Gremlin の修正**
+ パス以外の寄与ステップにラベルが含まれているシナリオの DFE クエリ変換で欠落しているラベル情報を修正しました。例:
```
g.withSideEffect('Neptune#useDFE', true).
V().
has('name', 'marko').
has("name", TextP.regex("mark.*")).as("p1").
not(out().has("name", P.within("peter"))).
out().as('p2').
dedup('p1', 'p2')
```
+ 2 つの DFE フラグメントでクエリが実行され、最初のフラグメントが満たされないノードに最適化された場合に発生する DFE クエリ変換の `NullPointerException` バグを修正しました。例:
```
g.withSideEffect('Neptune#useDFE', true).
V().
has('name', 'doesNotExists').
has("name", TextP.regex("mark.*")).
inject(1).
V().
out().
has('name', 'vadas')
```
+ クエリの by() モジュレータ内に ValueTraversal が含まれ、その入力が Map である場合に、Neptune が `InternalFailureException` をスローすることがあるバグを修正しました。例:
```
g.V().
hasLabel("person").
project("age", "name").by("age").by("name").
order().by("age")
```
**openCypher の修正**
+ UNWIND 操作 (値のリストを個々の値に拡張するなど) を改善し、メモリ不足 (OOM) 状態を防止しました。例:
```
MATCH (n)-->(m)
WITH collect(m) AS list
UNWIND list AS m
RETURN m, list
```
+ ID が UNWIND を介して挿入される複数の MERGE 操作の場合のカスタム ID 最適化を修正しました。例:
```
UNWIND [{nid: 'nid1', mid: 'mid1'}, {nid: 'nid2', mid: 'mid2'}] as ids
MERGE (n:N {`~id`: ids.nid})
MERGE (m:M {`~id`: ids.mid})
```
+ プロパティアクセスと双方向の関係を持つ複数のホップを含む複雑なクエリを計画する際のメモリ爆発を修正しました。例:
```
MATCH (person1:person)-[:likes]->(res)-[:partOf]->(group)-[:knows]-(:entity {name: 'foo'}),
(person1)-[:knows]->(person2)-[:likes]-(res2), (comment)-[:presentIn]->(:Group {name: 'barGroup'}),
(person1)-[:commented]->(comment2:comment)-[:partOf]->(post:Post), (comment2)-[:presentIn]->(:Group {name: 'fooGroup'}),
(comment)-[:contains]->(info:Details)-[:CommentType]->(:CommentType {name: 'Positive'}),
(comment2)-[:contains]->(info2:Details)-[:CommentType]->(:CommentType {name: 'Positive'})
WHERE datetime('2020-01-01T00:00') <= person1.addedAfter <= datetime('2023-01-01T23:59') AND comment.approvedBy = comment2.approvedBy
MATCH (comment)-[:contains]->(info3:Details)-[:CommentType]->(:CommentType {name: 'Neutral'})
RETURN person1, group.name, info1.value, post.ranking, info3.value
```
+ グループ化変数として null を持つ集計クエリを修正しました。例:
```
MATCH (n)
RETURN null AS group, sum(n.num) AS result
```
**SPARQL の修正**
+ 多数のトリプルと大きなトークンを含む INSERT DATA などの大規模なクエリの解析時間を短縮するため、SPARQL パーサーを修正しました。
## リリース 1.3.2.0 の問題の軽減
+ バージョン 1.3.2.0 では、`skip`または `limit` が内部 `WITH` 句で使用され、パラメータ化されている場合に、クエリプランキャッシュで問題が検出されました。例:
```
MATCH (n:Person)
WHERE n.age > $age
WITH n skip $skip LIMIT $limit
RETURN n.name, n.age
parameters={"age": 21, "skip": 2, "limit": 3}
```
この場合、最初のプランからのスキップと制限のパラメータ値が後続のクエリにも適用され、予期しない結果になります。
**緩和策**
この問題を回避するには、パラメータ化されたスキップや制限のサブ句を含むクエリを送信する際に、クエリヒント `QUERY:PLANCACHE "disabled"` を追加します。または、値をクエリにハードコードすることもできます。
**オプション 1:** クエリヒントを使用してプランキャッシュを無効にする。
```
Using QUERY:PLANCACHE "disabled"
MATCH (n:Person) WHERE n.age > $age
WITH n skip $skip LIMIT $limit
RETURN n.name, n.age
parameters={"age": 21, "skip": 2, "limit": 3}
```
**オプション 2:** スキップと制限にハードコードされた値を使用する。
```
MATCH (n:Person)
WHERE n.age > $age
WITH n skip 2 LIMIT 3
RETURN n.name, n.age
parameters={"age": 21}
```
+ 数値フィルター値を使用するクエリは、クエリプランキャッシュを使用する際に誤った結果が返される可能性があります。問題を回避するには、クエリヒント `QUERY:PLANCACHE "disabled"` を使用してクエリプランキャッシュをスキップします。例えば
```
USING QUERY:PLANCACHE "disabled"
MATCH (n:person)
WHERE n.yearOfBirth > $year
RETURN n
parameters={"year":1950}
```
+ 同じパラメータ名を複数回使用するクエリは、エラー `Parameter name should not be a number and/or contain _internal_ or _modified_user_ string within it. These are reserved for planCache. Otherwise, rerun with HTTP parameter planCache=disabled` で失敗する可能性があります。このような場合は、上記のようなクエリプランキャッシュをスキップするか、次の例のようにパラメータを複製します。
```
MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$minutes RETURN n
parameters={"minutes":130}
```
ヒント `QUERY:PLANCACHE "disabled"` を使用するか、パラメータを変更します。
```
MATCH (n:movie) WHERE n.runtime>=$rt_min RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$dur_min RETURN n
parameters={"rt_min":130, "dur_min":130}
```
+ Bolt プロトコルで実行されるクエリは、クエリが UNION または UNION ALL クエリの場合、誤った結果を生成する可能性があります。この問題を回避するには、HTTP エンドポイントで特定のクエリを実行することを検討してください。または、Bolt プロトコルを使用する場合は、UNION の各部分を個別に実行します。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.3.2.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.7.1`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.7.1`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.3.2.0 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.3.2.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.3.2.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.3.1.0 (2024-03-06)
2024 年 3 月 6 日現在、エンジンバージョン 1.3.1.0 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
[エンジンリリース 1.3.0.0](engine-releases-1.3.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.3.0.0 より前のエンジンバージョンからエンジンバージョン 1.3.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.3` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` または `neptune1.2` を使用していましたが、これらのパラメータグループはリリース 1.3.0.0 以降では動作しません。同様に、エンジンバージョン 1.4.0.0 以降では 1.4.0.0 クラスターパラメータグループを使用する必要があります。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
## このエンジンリリースの改良点
**全般的な機能強化**
+ Neptune は、プロファイルと説明に表示される警告を改善しました。
+ TLS ネゴシエーション中に使用されるデフォルトの名前付きグループから古い NIST EC 曲線を削除しました。削除された曲線は sect409k1、sect409r1、および sect571k1 です。
**Gremlin の改善**
+ サーバーレスインスタンスの NCU が非常に高くなるのを回避するために、DFE 統計の計算が改善されました。
+ WITHIN の Gremlin パフォーマンスの改善。
## このエンジンリリースで修正された不具合
**Gremlin の修正**
+ Gremlin DFE クエリプランのその他の改善。
+ オプションのトラバーサルを持つ Gremlin クエリのバグ修正。例えば、「g.V().hasLabel('person').group().by(id()).by(\$1\$1.in('friend').id().fold())」という形式のクエリでは、友人エッジのない人物はグループ化されません。
+ `by` モジュレータ内の結合ステップを含む Gremlin クエリが DFE エンジンを使用して実行された場合にエラーを返すバグを修正しました。
+ 読み取りレプリカに接続したときに Gremlin セッションで実行されている読み取り専用クエリが機能しないバグを修正しました。
+ Gremlin の初期 WebSocket 接続リクエストが成功した場合に IAM ARN が監査ログに存在しなかったバグの修正。
+ ステップを結合し、DFE でステップカバレッジを特定します。
+ DFE プラン全体の特性セットの最適化。
**openCypher の修正**
+ openCypher SET 句のバグ修正により、変数以外の式での設定が可能になりました (例: match(n:TEST) set(case when n.prop = 2 then n end).prop = 3 return n.prop)。
+ aggregation と order by を含む openCypher クエリの失敗に関するバグの修正。
+ 静的マップを含む大きなリストの UNWIND が改善。
+ 重複した値を持つカスタム ID を使用した openCypher MERGE クエリのバグの修正。
**SPARQL の修正**
+ オプションのパターンにおける変数スコープに関する SPARQL のバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.3.1.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.6.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.6.5`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.3.1.0 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.3.1.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.3.1.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.3.0.0 (2023-11-15)
2023 年 11 月 15 日現在、エンジンバージョン 1.3.0.0 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
[エンジンリリース 1.3.0.0](#engine-releases-1.3.0.0) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.3.0.0 より前のエンジンバージョンからエンジンバージョン 1.3.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.3` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` または `neptune1.2` を使用していましたが、これらのパラメータグループはリリース 1.3.0.0 以降では動作しません。同様に、エンジンバージョン 1.4.0.0 以降では 1.4.0.0 クラスターパラメータグループを使用する必要があります。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
## このエンジンリリースの新機能
+ [Neptune データ API](data-api.md) をリリースしました。
Amazon Neptune データ API は、データの読み込み、クエリの実行、データ照会、機械学習など、Neptune の 40 を超えるデータオペレーションを SDK でサポートしています。Neptune の 3 つすべてのクエリ言語 (Gremlin、openCypher､SPARQL) をサポートしており、すべての SDK 言語で使用できます。API リクエストに自動的に署名し、Neptune のアプリケーションへの統合を大幅に簡素化します。
+ [OpenSearch サーバーレス](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html)を Neptune と統合するためのサポートを追加しました。
## このエンジンリリースの改良点
**Neptune エンジンアップデートの改善点**
Neptune のエンジンアップデートのリリース方法が変わり、アップデートプロセスをより細かく制御できるようになりました。Neptune では、互換性を破る変更がない場合にパッチの代わりにマイナーバージョンをリリースし、これを [`AutoMinorVersionUpgrade` インスタンスフィールド](engine-maintenance-management.md#using-amvu)を使用して制御できるようになりました。[`RDS-EVENT-0156`](event-lists.md#RDS-EVENT-0156) イベントに[サブスクライブ](events-subscribing.md)することで、マイナーバージョンに関する通知を受け取ることができます。
これらの変更の詳細については、「[Amazon Neptune DB クラスターのメンテナンス](cluster-maintenance.md)」を参照してください。
**転送中の暗号化の改善**
Neptune では、以下の暗号スイートがサポートされなくなりました。
+ `TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA`
+ `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA`
Neptune では、TLS 1.2 を使用した、以下の強力な暗号スイートのみがサポートされます。
+ `TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384`
+ `TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256`
+ `TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384`
+ `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256`
**Gremlin の改善**
+ 以下の Gremlin ステップに対するサポートを DFE エンジンに追加しました。
+ `FoldStep`
+ `GroupStep`
+ `GroupCountStep`
+ `TraversalMapStep `
+ `UnfoldStep`
+ `LabelStep`
+ `PropertyKeyStep`
+ `PropertyValueStep`
+ `AndStep`
+ `OrStep`
+ `ConstantStep`
+ `CountGlobalStep`
+ Gremlin DFE クエリプランを最適化し、`by()` 変調の使用時に頂点全体がスキャンされないようにしました。
+ 低カーディナリティおよび低レイテンシーのクエリのパフォーマンスが大幅に向上しました。
+ TinkerPop `Or` フィルター述語に対する DFE サポートを追加しました。
+ 次のようなクエリに対して、同じキーでのフィルターのトラバーサルの DFE サポートを改善しました。
```
g.withSideEffect("Neptune#useDFE", true)
.V()
.has('name', 'marko')
.and(
or(
has('name', eq("marko")),
has('name', eq("vardas"))
)
)
```
+ `fail()` ステップのエラー処理を改善しました。
**openCypher の改善**
+ 低カーディナリティおよび低レイテンシーのクエリのパフォーマンスが大幅に向上しました。
+ クエリに多数のノードタイプが含まれる場合のクエリプランニングのパフォーマンスが向上しました。
+ すべての VLP クエリのレイテンシーが短縮されました。
+ 単一ノードパターンクエリの冗長なパイプライン結合を削除することでパフォーマンスが向上しました。
+ 次のようなサイクルを伴うマルチホップパターンを含むクエリのパフォーマンスが向上しました。
```
MATCH (n)-->()-->()-->(m)
RETURN n m
```
**SPARQL の改善**
+ 新しい SPARQL 演算子として `PipelineHashIndexJoin` を導入しました。
+ SPARQL クエリの URI 検証のパフォーマンスが向上しました。
+ 辞書用語のバッチ解決により、SPARQL 全文検索クエリのパフォーマンスが向上しました。
## このエンジンリリースで修正された不具合
**Gremlin の修正**
+ DFE エンジンでネイティブに処理されないステップの子トラバーサルに述語を含むクエリについて、Gremlin クエリステータスエンドポイントをチェックするときに、トランザクションリークが発生する Gremlin のバグを修正しました。
+ `by()` トラバーサル時の DFE エンジンで `valueMap()` が最適化されないという Gremlin のバグを修正しました。
+ `UnionStep` に付加したステップラベルが子トラバーサルの最後のパス要素にそれぞれ伝播されないという Gremlin のバグを修正しました。
+ TinkerPop のステップが多すぎるためにクエリが失敗し、クリーンアップされないという Gremlin のバグを修正しました。
+ `NullPointerException` が `mergeV` ステップや `mergeE` ステップにスローされるという Gremlin のバグを修正しました。
+ 文字列出力の一部にスペース文字が含まれていると `order()` によって正しくソートされない Gremlin のバグを修正しました。
+ DFE エンジンで `valueMap` ステップの処理時に発生する Gremlin の正確性の問題を修正しました。
+ `GroupStep` または `GroupCountStep` をキートラバーサルにネストする際に発生する Gremlin の正確性の問題を修正しました。
**openCypher の修正**
+ NULL 文字に関するエラー処理に伴う OpenCypher のバグを修正しました。
+ openCypher ボルトトランザクション処理に伴うバグを修正しました。
**SPARQL の修正**
+ 再帰関数内の値が適切に解決されないという SPARQL のバグを修正しました。
+ `VALUES` 句を使用して大量の値を挿入すると、パフォーマンスが低下するという SPARQL のバグを修正しました。
+ 言語タグ付きリテラルでの `REGEX` 演算子の呼び出しが成功しないという SPARQL のバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.3.0.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.6.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.6.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.3.0.0 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.3.0.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.3.0.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.1.2 (2024-08-05)
2024 年 8 月 5 日現在、エンジンバージョン 1.2.1.2 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
**警告**
アクションベースの認可ポリシーで GSP を使用する場合、特定の条件下で発生する可能性がある SPARQL 1.1 Graph Store HTTP Protocol (GSP) で問題が検出されました。アクションベースの認可ポリシーで SPARQL 1.1 Graph Store HTTP Protocol を使用している場合は、この問題の修正を含む最新のマイナー Neptune エンジンバージョン (1.2.1.2 以上) にアップグレードすることをお勧めします。
## このエンジンリリースで修正された不具合
**SPARQL の修正**
+ アクションベースの認可ポリシーで GSP を使用する場合、特定の条件下で発生する可能性がある SPARQL 1.1 Graph Store HTTP Protocol (GSP) の問題を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.1.2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.6.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.6.2`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.1.2 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.1.2 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.2 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.1.1 (2024-03-11)
2024 年 3 月 11 日現在、エンジンバージョン 1.2.1.1 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改善点
**全般的な改善点**:
Neptune は、プロファイル/説明に表示される警告を改善しました。
**Gremlin の改善点**
+ Serverless インスタンスの NCU が非常に高くなるのを避けるために、DFE 統計の計算が改善されました。
+ WITHIN の Gremlin パフォーマンスの改善。
## このエンジンリリースで修正された不具合
**Gremlin の修正**
+ Gremlin DFE エンジンクエリプランの順序付けによるバグ修正。
+ InternalFailureException として最初に報告されたときの Gremlin out-of-memory エラーによるバグ修正。
+ 最初の WebSocket 接続リクエストが成功した場合に IAM ARN が監査ログに存在しなかったバグ修正。
+ TinkerPop セッションが有効になっている Gremlin クエリのバグ修正は、セッション内のクエリがすべて読み取り専用でリーダーインスタンスに接続されていても失敗した場合に行われます。
**openCypher の修正**
+ openCypher SET 句のバグ修正により、変数以外の式での設定が可能になりました (例: match(n:TEST) set(case when n.prop = 2 then n end).prop = 3 return n.prop)。
+ 集計と順序を含む openCypher クエリの失敗に関するバグ修正。
+ 静的マップを含む大きなリストの UNWIND が改善。
+ 重複した値を持つカスタム ID を使用した openCypher MERGE クエリのバグ修正。
**SPARQL の修正**
+ SPARQL DFE クエリプランナーのバグ修正。
+ BIND キーワードと OPTIONAL キーワードで使用する場合の SPARQL のバグ修正。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.1.1 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.6.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.6.2`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.1.1 へのアップグレードパス
このリリースへは、[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降からアップグレードできます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.1.1 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.1 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.1.0 (2023-03-08)
2023 年 3 月 8 日現在、エンジンバージョン 1.2.1.0 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このリリースの後続のパッチリリース
+ [リリース: 1.2.1.0.R2 (2023-05-02)](engine-releases-1.2.1.0.R2.md)
+ [リリース: 1.2.1.0.R3 (2023-06-13)](engine-releases-1.2.1.0.R3.md)
+ [リリース: 1.2.1.0.R4 (2023-06-10)](engine-releases-1.2.1.0.R4.md)
+ [リリース: 1.2.1.0.R5 (2023-09-02)](engine-releases-1.2.1.0.R5.md)
+ [リリース: 1.2.1.0.R6 (2023-09-12)](engine-releases-1.2.1.0.R6.md)
+ [リリース: 1.2.1.0.R7 (2023-10-06)](engine-releases-1.2.1.0.R7.md)
## このエンジンリリースの新機能
+ [TinkerPop 3.6.2](https://tinkerpop.apache.org/docs/3.6.2-SNAPSHOT/dev/provider/) のサポートが追加されました。これにより、新しい `mergeV()`、`mergeE()`、`element()`、および `fail()` ステップなど、多くの新しい Gremlin 機能が追加されました。`mergeV()` および `mergeE()` ステップは、アップサートのような操作を実行するための待望の宣言型オプションを提供するため、特に注目すべき点です。これにより、既存のコードパターンが大幅に簡略化され、Gremlin が読みやすくなるはずです。3.6.x バージョンでは、正規表現述語、`Map` を取る `property()` ステップへの新しいオーバーロード、`by()` 変調動作の大幅な改訂も追加されました。変調動作の大幅な改訂により、これを使用するすべてのステップではるかに一貫性が保たれています。
バージョン 3.6 の変更点とアップグレード時に考慮すべき点については、[TinkerPop の変更ログ](https://github.com/apache/tinkerpop/blob/3.6.0/CHANGELOG.asciidoc#release-3-6-0)と[アップグレードのページ](https://tinkerpop.apache.org/docs/current/upgrade/)を参照してください。
`fold().coalesce(unfold(), )` を条件付き挿入に使用している場合は、[ここ](https://tinkerpop.apache.org/docs/3.6.0/reference/#mergevertex-step)と[ここ](https://tinkerpop.apache.org/docs/3.6.0/reference/#mergeedge-step)で説明されている新しい `mergeV/E()` 構文に移行することをお勧めします。Neptune では、`Merge` については `Coalesce` よりも狭いロックパターンを使用するため、同時変更例外 (CME) を減らすことができます。
今回の TinkerPop リリースで利用できる新機能の詳細については、Stephen Mallette のブログ「[Amazon Neptune での Apache TinkerPop 3.6.x の新機能の探求](https://aws.amazon.com/blogs/database/exploring-new-features-of-apache-tinkerpop-3-6-x-in-amazon-neptune/)」を参照してください。
+ 第 3 世代の Intel Xeon スケーラブルプロセッサを搭載した [R6i インスタンスタイプ](https://aws.amazon.com/ec2/instance-types/r6i/)のサポートを追加しました。これらはメモリ集約的なワークロードに最適であり、同等の R5 インスタンスタイプよりも計算性能/価格パフォーマンスが最大 15% 向上し、vCPU あたりのメモリ帯域幅が最大 20% 高くなります。
+ プロパティグラフと RDF グラフの両方に[グラフサマリー API](neptune-graph-summary.md) エンドポイントが追加され、グラフに関する概要レポートをすばやく取得できるようになりました。
プロパティ (PG) グラフについて、グラフサマリー API は、ノードおよびエッジラベルとプロパティキーの読み取り専用リストを、ノード、エッジ、プロパティの数とともに返します。RDF グラフでは、クラスと述語キーのリストに加え、クワッド、主語、述語の数も表示されます。
新しいグラフサマリー API に伴い、以下の変更が行われました。
+ 新しい [GetGraphSummary](iam-dp-actions.md#getgraphsummary) データプレーンアクションが追加されました。
+ 廃止された `sparql/statistics` エンドポイントに代わる新しい `rdf/statistics` エンドポイントが追加されました。
+ グラフのサマリー情報と混同しないように、統計ステータスレスポンスの `summary` フィールドの名前が`signatureInfo` に変更されました。JSON レスポンスでは、以前のエンジンバージョンも引き続き `summary` を使用します。
+ 統計ステータスレスポンスの `date` フィールドの精度が分単位からミリ秒単位に変更されました。以前の形式は `2020-05-07T23:13Z` (分精度) でしたが、新しい形式は `2023-01-24T00:47:43.319Z` (ミリ秒精度) です。どちらも ISO 8601 に準拠していますが、日付の解析方法によっては、この変更により既存のコードが壊れる可能性があります。
+ DFE エンジンの統計情報を取得できる新しい [`%statistics`](notebooks-magics.md#notebooks-line-magics-statistics) ラインマジックがワークベンチに追加されました。
+ グラフの概要情報を取得できる新しい [`%summary`](notebooks-magics.md#notebooks-line-magics-summary) ラインマジックがワークベンチに追加されました。
+ 指定したしきい値よりも実行に時間がかかったクエリをログに記録する[スロークエリロギング](slow-query-logs.md)が追加されました。スロークエリロギングを有効化および制御するには、[neptune\$1enable\$1slow\$1query\$1log](parameters.md#parameters-db-cluster-parameters-neptune_enable_slow_query_log) と [neptune\$1slow\$1query\$1log\$1threshold](parameters.md#parameters-db-cluster-parameters-neptune_slow_query_log_threshold) という 2 つの新しい動的パラメーターを使用します。
+ 2 つの[動的パラメータ](parameter-groups.md)、すなわち、新しいクラスターパラメータ [neptune\$1enable\$1slow\$1query\$1log](parameters.md#parameters-db-cluster-parameters-neptune_enable_slow_query_log) と [neptune\$1slow\$1query\$1log\$1threshold](parameters.md#parameters-db-cluster-parameters-neptune_slow_query_log_threshold) のサポートが追加されました。動的パラメータを変更すると、インスタンスを再起動しなくてもすぐに有効になります。
+ 指定されたキーをマップから削除し、生成された新しいマップを返す Neptune 固有の openCypher [removeKeyFromMap()](access-graph-opencypher-extensions.md#opencypher-compliance-removeKeyFromMap-function) 関数が追加されました。
## このエンジンリリースの改良点
+ Gremlin DFE のサポートがローカルスコープの `limit` ステップに拡張されました。
+ DFE エンジンでの Gremlin `DedupGlobalStep` の `by()` モジュレーションサポートが追加されました。
+ Gremlin `SelectStep` および `SelectOneStep` の DFE サポートが追加されました。
+ `repeat`、`coalesce`、`store`、`aggregate` など、さまざまな Gremlin 演算子のパフォーマンスの向上と正確性の修正を行いました。
+ `MERGE` と `OPTIONAL MATCH` を含む openCypher クエリのパフォーマンスが向上しました。
+ リテラル値のマップのリストの `UNWIND` を含む openCypher クエリのパフォーマンスが向上しました。
+ `id` の `IN` フィルターの付いた openCypher クエリのパフォーマンスが向上しました。例:
```
MATCH (n) WHERE id(n) IN ['1', '2', '3'] RETURN n
```
+ BASE ステートメントを使用して SPARQL クエリのベース IRI を指定する機能が追加されました (「[クエリと更新のためのデフォルトベース IRI](feature-sparql-compliance.md#opencypher-compliance-default-iri)」を参照)。
+ Gremlin と openCypher のエッジのみの一括ロードのロード処理待ち時間を短縮しました。
+ 再開の試みが失敗するまでの Amazon S3 接続の問題による長時間の待ち時間を回避するため、Neptune の再起動時に一括読み込みが非同期で再開されるようになりました。
+ [describeMode](sparql-query-hints-for-describe.md#sparql-query-hints-describeMode) クエリのヒントが `"CBD"` (簡潔で限定された説明) に設定されていて、多数の空白ノードを含む SPARQL DESCRIBE クエリの処理が改善されました。
## このエンジンリリースで修正された不具合
+ Bolt と SPARQL-JSON でクエリが NULL 値ではなく文字列 `"null"` を返す openCypher のバグを修正しました。
+ リスト要素に指定された値ではなく NULL 値が生成される、リスト内包表記の openCypher のバグを修正しました。
+ バイト値が正しくシリアル化されない openCypher のバグを修正しました。
+ 子トラバーサル内で入力が頂点へのエッジトラバーサルであった場合に発生していた `UnionStep` の Gremlin のバグを修正しました。
+ `UnionStep` に関連付けられたステップラベルが各子トラバーサルの最後のステップに正しく伝播されない Gremlin のバグを修正しました。
+ `repeat` ステップの後にラベルがある `dedup` ステップで、`dedup` ステップに添付されたラベルがクエリで今後使用できなくなる Gremlin のバグを修正しました。
+ `union` ステップ内の `repeat` ステップを変換すると内部エラーで失敗する Gremlin のバグを修正しました。
+ Tinkerpop にフォールバックして `limit` を非結合ステップの子トラバーサルとして持つ DFE クエリの Gremlin の正確性の問題を修正しました。次のような形式のクエリが影響を受けます。
```
g.withSideEffect('Neptune#useDFE', true).V().as("a").select("a").by(out().limit(1))
```
+ `SPARQL GRAPH` パターンが `FROM NAMED` 句によって指定されるデータセットを考慮しないという SPARQL のバグを修正しました。
+ SPARQL `DESCRIBE` に一部の `FROM` や `FROM NAMED` 句があると、デフォルトグラフのデータが常に正しく使用されず、例外が発生することがあった SPARQL のバグを修正しました。「[SPARQL DESCRIBE のデフォルトグラフに対する動作](sparql-default-describe.md)」を参照してください。
+ SPARQL のバグを修正し、NULL 文字が拒否された場合に正しい例外メッセージが返されるようになりました。
+ [PipelinedHashIndexJoin](sparql-explain-operators.md#sparql-explain-operator-pipeline-hash-index-join) 演算子を含むプランに影響を及ぼしていた SPARQL の[説明](sparql-explain.md)バグを修正しました。
+ 定数値を返すクエリが送信されると内部エラーがスローされる openCypher のバグを修正しました。
+ デッドロック検出ロジックで、エンジンが応答しなくなることがあった問題を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.1.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.6.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.6.2`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.1`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.1.0 へのアップグレードパス
[1.1.0.0](engine-releases-1.1.0.0.md) 以上の以前の Neptune エンジンリリースから、このリリースに手動でアップグレードできます。
**注記**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) 以降、`1.2.0.0` より前のエンジンバージョンで使用していたすべてのカスタムパラメータグループとカスタムクラスターパラメータグループは、パラメータグループファミリー `neptune1.2` を使用して再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、これらのパラメータグループは `1.2.0.0` 以降のリリースでは動作しなくなります。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
このメジャーバージョンリリースに自動的にアップグレードされることはありません。
## このリリースへのアップグレード
Amazon Neptune 1.2.1.0 が公開されました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.1.0.R7 (2023-10-06)
2023 年 10 月 6 日現在、エンジンバージョン 1.2.1.0.R7 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースで修正された不具合
+ 失敗したトランザクションが正しくクローズされないことがあるバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.1.0.R7 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.6.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.6.2`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## このリリースへのアップグレード
Amazon Neptune 1.2.1.0.R7 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.1.0.R6 (2023-09-12)
2023 年 9 月 12 日現在、エンジンバージョン 1.2.1.0.R6 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの新機能
+ [Neptune データ API](data-api.md) をリリースしました。
Amazon Neptune データ API は、データの読み込み、クエリの実行、データに関する情報の取得、機械学習操作の実行のための SDK サポートを提供します。Neptune における Gremlin および openCypher クエリ言語をサポートし、すべての SDK 言語で使用できます。API リクエストに自動的に署名し、Neptune のアプリケーションへの統合を大幅に簡素化します。
## このエンジンリリースで修正された不具合
+ スロークエリログが有効になっていると、高負荷時に CPU が急上昇するバグを修正しました。
+ `inV()` または `outV()` が続くエッジとそのプロパティを追加すると `InternalFailureException` が発生する Gremlin のバグを修正しました。
+ バルクローダーのパフォーマンスが低下する場合があった IAM ロールチェイニングのいくつかの問題を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.1.0.R6 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.6.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.6.2`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## このリリースへのアップグレード
Amazon Neptune 1.2.1.0.R6 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.1.0.R5 (2023-09-02)
2023 年 9 月 2 日現在、エンジンバージョン 1.2.1.0.R5 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの新機能
+ [Neptune データ API](data-api.md) をリリースしました。
Amazon Neptune データ API は、データの読み込み、クエリの実行、データに関する情報の取得、機械学習操作の実行のための SDK サポートを提供します。Neptune における Gremlin および openCypher クエリ言語をサポートし、すべての SDK 言語で使用できます。API リクエストに自動的に署名し、Neptune のアプリケーションへの統合を大幅に簡素化します。
## このエンジンリリースで修正された不具合
+ `inV()` または `outV()` が続くエッジとそのプロパティを追加すると `InternalFailureException` が発生する Gremlin のバグを修正しました。
+ バルクローダーのパフォーマンスが低下する場合があった IAM ロールチェイニングのいくつかの問題を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.1.0.R5 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.6.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.6.2`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## このリリースへのアップグレード
Amazon Neptune 1.2.1.0.R5 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.1.0.R4 (2023-08-10)
2023 年 8 月 10 日現在、エンジンバージョン 1.2.1.0.R4 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
このエンジンリリースで導入された変更により、一括ロードのパフォーマンスが低下する場合があります。そのため、このリリースへのアップグレードは、問題が解決されるまで一時的に中断されました。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ Gremlin の [GraphSON-1.0](https://tinkerpop.apache.org/docs/3.4.1/dev/io/#graphson) サポートを追加しました。GraphSON-1.0 を使用するには、次の値を指定して `Accept header` を渡します。
```
application/vnd.gremlin-v1.0+json;types=false
```
## このエンジンリリースで修正された不具合
+ ネイティブに処理されないステップの子トラバーサルに述語を含むクエリについて、Gremlin クエリステータスエンドポイントを確認すると、トランザクションリークが発生する Gremlin のバグを修正しました。
+ Bolt のトランザクション処理における openCypher のバグを修正しました。
+ クラッシュを引き起こす可能性のある、ストレージレイヤーの同時実行の問題を修正しました。
+ スロークエリログのバグを修正し、無効なときにはアクティブにならないようにしました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.1.0.R4 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.6.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.6.5`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.1.0.R4 へのアップグレードパス
## このリリースへのアップグレード
Amazon Neptune 1.2.1.0.R4 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.1.0.R3 (2023-06-13)
2023 年 6 月 13 日現在、エンジンバージョン 1.2.1.0.R3 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
このエンジンリリースで導入された変更により、一括ロードのパフォーマンスが低下する場合があります。そのため、このリリースへのアップグレードは、問題が解決されるまで一時的に中断されました。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの新機能
+ [IAM ロールチェイニング](bulk-load-tutorial-chain-roles.md)を使用したクロスアカウント一括読み込みのサポートが追加されました。
## このエンジンリリースの改良点
+ Gremlin の `fail()` ステップを改善して、生成された例外を汎用 `InternalFailureException` と区別し、ユーザーによって指定されたメッセージが呼び出し元に確実に伝わるようにしました。
+ `store`、`aggregate`、`cap`、`limit`、および `hasLabel` について、Gremlin クエリエンジンの最適化が改善されました。
+ openCypher 三角関数のサポートが追加されました。
+ `acos()`
+ `asin()`
+ `atan()`
+ `atan2()`
+ `cos()`
+ `cot()`
+ `degrees()`
+ `pi()`
+ `radians()`
+ `sin()`
+ `tan()`
+ いくつかの openCypher 集約関数のサポートが追加されました。
+ `percentileDisc()`
+ `stDev()`
+ `datetime` を `epochmillis` に変換する openCypher `epochmillis()` 関数のサポートが追加されました。例:
```
MATCH (n) RETURN epochMillis(n.someDateTime)
1698972364782
```
+ openCypher モジュロ (`%`) 演算子のサポートが追加されました。
+ openCypher Static Debug Explain ツールのサポートが追加されました。
+ openCypher `randomUUID()` 関数のサポートが追加されました。
+ openCypher のパフォーマンスが向上しました。
+ パーサーとクエリプランナーを改善しました。
+ DFE エンジンの CPU 使用率が向上しました。
+ 同じ変数を再利用する複数の更新句を含むクエリのパフォーマンスが向上しました。例:
```
MERGE (n {name: 'John'})
or
MERGE (m {name: 'Jim'})
or
MERGE (n)-[:knows {since: 2023}]→(m)
```
+ 次のようなマルチホップクエリパターンのクエリプランが最適化されました。
```
MATCH (n)-->()-->()-->(m)
RETURN n m
```
+ パラメータ化されたクエリにより、リストとマップの挿入のパフォーマンスが向上しました。例:
```
UNWIND $idList as id MATCH (n {`~id`: id})
RETURN n.name
```
+ `WITH` を含んでいるクエリ実行が、適切なバリアにすることで改善されました。
+ `Unfold` および集約関数内の値の重複した実体化を回避するように最適化されました。
+ 次のような `VALUES` 句に多数の静的入力を含む SPARQL クエリのパフォーマンスが向上しました。
```
SELECT ?n WHERE { VALUES (?name) { ("John") ("Jim") ... many values ... } ?n a ?n_type . ?n ?name . }
```
+ SPARQL CBD クエリのパフォーマンスが向上しました。
## このエンジンリリースで修正された不具合
+ 深いネストを伴う長いクエリが、クエリのプランニング段階で CPU 使用率が高くなり、クエリがタイムアウトする Gremlin のバグを修正しました。
+ `mergeV` または `mergeE` を使用すると、無効な `NullPointerException` がスローされる Gremlin のバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.1.0.R3 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.6.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.6.2`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.5.0.R3 へのアップグレードパス
## このリリースへのアップグレード
Amazon Neptune 1.2.1.0.R3 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.1.0.R2 (2023-05-02)
2023 年 5 月 2 日現在、エンジンバージョン 1.2.1.0.R2 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ すべての [Neptune ML API](machine-learning-api-reference.md) に `enableInterContainerTrafficEncryption` パラメータを追加しました。これを使用して、トレーニングジョブやハイパーパラメータチューニングジョブでコンテナ間トラフィック暗号化を有効または無効にできます。
+ Gremlin `mergeV()` および `mergeE()` のマルチラベルサポートが追加されました。
## このエンジンリリースで修正された不具合
+ 更新とリターンのクエリが `orderBy`、`limit`、または `skip` を正しく処理しない openCypher のバグを修正しました。
+ あるリクエストに含まれるパラメータが、別の同時リクエストに含まれるパラメータによってオーバーライドされる可能性がある openCypher のバグを修正しました。
+ スロークエリログに正しいクエリ時間が含まれていなかった openCypher のバグを修正しました。
+ `GroupCountStep` を含んでいるクエリが文字列として送信されたときに、トランザクションリークが発生する可能性がある Gremlin のバグを修正しました。
+ スロークエリログが有効になっていると WebSocket クエリが失敗する Gremlin のバグを修正しました。
+ WebSocket リクエストのスロークエリログにストレージカウンターのデバッグログが欠落していた Gremlin のバグを修正しました。
+ `mergeV()` と `mergeE()` に関係するいくつかの Gremlin のバグを修正しました。
+ 名前付きグラフのクエリコストが誤って見積もられ、クエリプランが最適でなかったり、メモリ不足エラーが発生したりする SPARQL のバグを修正しました。
+ IAM 対応クラスターでの Gremlin および openCypher クエリの承認に影響するバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.1.0.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.6.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.6.2`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.1.0.R2 へのアップグレードパス
## このリリースへのアップグレード
Amazon Neptune 1.2.1.0.R2 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.0.2 (2022-11-20)
2022 年 11 月 20 日現在、エンジンバージョン 1.2.0.2 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このリリースの後続のパッチリリース
+ [リリース: 1.2.0.2.R2 (2022-12-15)](engine-releases-1.2.0.2.R2.md)
+ [リリース: 1.2.0.2.R3 (2023-03-27)](engine-releases-1.2.0.2.R3.md)
+ [リリース: 1.2.0.2.R4 (2023-05-08)](engine-releases-1.2.0.2.R4.md)
+ [リリース: 1.2.0.2.R5 (2023-08-16)](engine-releases-1.2.0.2.R5.md)
+ [リリース: 1.2.0.2.R6 (2023-09-12)](engine-releases-1.2.0.2.R6.md)
## このエンジンリリースの新機能
+ Neptune ML に Gremlin の[リアルタイム帰納的推論](machine-learning-overview-evolving-data.md#inductive-vs-transductive-inference)を導入しました。
+ Neptune が生成する UUID の代わりに、[エンティティのカスタム ID 値](access-graph-opencypher-extensions.md#opencypher-compliance-custom-ids)の指定をサポートする openCypher 拡張機能を導入しました。カスタム ID を割り当てることができるため、Neo4j から Neptune への移行が容易になります。
**警告**
`~id` は、現在、予約済みのプロパティ名と見なされているため、openCypher 仕様に対するこの拡張は下位互換性がありません。`~id` をデータやクエリで既にプロパティとして使用している場合、このリリースにアップグレードする前に、[`~id` プロパティを新しいプロパティキーに移行する](access-graph-opencypher-extensions.md#opencypher-compliance-custom-ids-migrating)必要があります。
+ [いくつかの新しい SPARQL `DESCRIBE` モードと](sparql-query-hints-for-describe.md)、それらを設定するためのクエリーヒントが追加されました。
## このエンジンリリースの改良点
+ openCypher のパフォーマンス、特に VLP クエリのパフォーマンスが向上しました。
+ 次のような端末以外の制限がある Gremlin クエリの DFE パフォーマンスが向上しました。
```
g.withSideEffect('Neptune#useDFE',true).V().hasLabel('Student').limit(5).out('takesCourse')
```
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.0.2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.0.2 へのアップグレードパス
## このリリースへのアップグレード
Amazon Neptune 1.2.0.2 が公開されました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.0.2 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.2 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.0.2.R6 (2023-09-12)
2023 年 9 月 12 日現在、エンジンバージョン 1.2.0.2.R6 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースで修正された不具合
+ 言語タグ付きリテラルで呼び出されると、`REGEX` 演算子が成功しないという SPARQL のバグを修正しました。
+ 一括読み込みのパフォーマンスが低下する問題を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.0.2.R6 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.5`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.0.2.R6 へのアップグレードパス
エンジンバージョン `1.2.0.2` を実行している場合、Neptune DB クラスターは次のメンテナンスウィンドウで自動的にこのメンテナンスパッチリリースにアップグレードされます。
## このリリースへのアップグレード
Amazon Neptune 1.2.0.2.R6 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.0.2 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.2 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.0.2.R5 (2023-08-16)
2023 年 8 月 16 日現在、エンジンバージョン 1.2.0.2.R5 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
このエンジンリリースで導入された変更により、一括ロードのパフォーマンスが低下する場合があります。そのため、このリリースへのアップグレードは、問題が解決されるまで一時的に中断されました。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースで修正された不具合
+ 文字列出力の一部にスペース文字が含まれていると `order()` によって正しくソートされない Gremlin のバグを修正しました。
+ ネイティブに処理されないステップの子トラバーサルに述語を含むクエリについて、Gremlin クエリステータスエンドポイントを確認すると、トランザクションリークが発生する Gremlin のバグを修正しました。
+ Bolt のトランザクション処理における openCypher のバグを修正しました。
+ クラッシュを引き起こす可能性のある、ストレージレイヤーの同時実行の問題を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.0.2.R5 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.5`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.0.2.R5 へのアップグレードパス
エンジンバージョン `1.2.0.2` を実行している場合、Neptune DB クラスターは次のメンテナンスウィンドウで自動的にこのメンテナンスパッチリリースにアップグレードされます。
## このリリースへのアップグレード
Amazon Neptune 1.2.0.2.R5 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.0.2 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.2 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.0.2.R4 (2023-05-08)
2023 年 5 月 8 日現在、エンジンバージョン 1.2.0.2.R4 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースで修正された不具合
+ `VALUES` 句に大量の値が挿入されるとパフォーマンスが低下する可能性がある SPARQL のバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.0.2.R4 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.6`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.0.2.R4 へのアップグレードパス
エンジンバージョン `1.2.0.2` を実行している場合、Neptune DB クラスターは次のメンテナンスウィンドウで自動的にこのメンテナンスパッチリリースにアップグレードされます。
## このリリースへのアップグレード
Amazon Neptune 1.2.0.2.R4 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.0.2 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.2 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.0.2.R3 (2023-03-27)
2023 年 3 月 27 日現在、エンジンバージョン 1.2.0.2.R3 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ サーバーレス DB クラスターでは、最小容量設定を 1.0 NCU に、最小有効最大設定を 2.5 NCU に変更しました。「[Neptune サーバーレス DB クラスターの容量スケーリング](neptune-serverless-capacity-scaling.md)」を参照してください。
+ すべての [Neptune ML API](machine-learning-api-reference.md) に `enableInterContainerTrafficEncryption` パラメータを追加しました。これを使用して、トレーニングジョブやハイパーパラメータチューニングジョブでコンテナ間トラフィック暗号化を有効または無効にできます。
## このエンジンリリースで修正された不具合
+ `option(Predicate)` が有効な Gremlin 構文として認識されない Gremlin のバグを修正しました。
+ クエリに含まれるステップが多すぎるためにクエリが失敗した場合に正しくクリーンアップされない Gremlin のバグを修正しました。
+ Tinkerpop にフォールバックすることにより、`limit` を非結合ステップの子トラバーサルとして持つ DFE クエリに影響していた Gremlin の正確性の問題を修正しました。このようなクエリの例は以下のとおりです。
```
g.withSideEffect('Neptune#useDFE', true).V().as("a").select("a").by(out().limit(1))
```
+ 文字列として送信されたクエリに `GroupCountStep` が含まれるときの Gremlin トランザクションリークを修正しました。
+ リストまたはマップのリストでパラメータ値のタイプが正しく解釈されない openCypher のバグを修正しました。
+ 更新とリターンのクエリが `orderBy`、`limit`、または `skip` を正しく処理しない openCypher のバグを修正しました。
+ あるリクエストに含まれるパラメータが、別の同時リクエストに含まれるパラメータによってオーバーライドされる可能性がある openCypher のバグを修正しました。
+ `VALUES` 句に大量の値が挿入されるとパフォーマンスが低下する可能性がある SPARQL のバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.0.2.R3 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.6`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.0.2.R3 へのアップグレードパス
エンジンバージョン `1.2.0.2` を実行している場合、Neptune DB クラスターは次のメンテナンスウィンドウで自動的にこのメンテナンスパッチリリースにアップグレードされます。
## このリリースへのアップグレード
Amazon Neptune 1.2.0.2.R2 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.0.2 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.2 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.0.2.R2 (2022-12-15)
2022 年 12 月 15 日現在、エンジンバージョン 1.2.0.2.R2 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ `MERGE` と `OPTIONAL MATCH` を含む openCypher クエリのパフォーマンスが向上しました。
+ リテラル値のマップのリストの `UNWIND` を含む openCypher クエリのパフォーマンスが向上しました。
+ `id` の `IN` フィルターの付いた openCypher クエリのパフォーマンスが向上しました。例:
```
MATCH (n) WHERE id(n) IN ['1', '2', '3'] RETURN n
```
+ `repeat`、`coalesce`、`store`、`aggregate` など、さまざまな Gremlin 演算子のパフォーマンスの向上と正確性の修正を行いました。
## このエンジンリリースで修正された不具合
+ Bolt と SPARQL-JSON でクエリが NULL 値ではなく文字列 `"null"` を返す openCypher のバグを修正しました。
+ `UnionStep` に付加されたステップラベルが子トラバーサルの最後のパス要素に反映されない原因となっていた Gremlin のバグを修正しました。
+ DFE エンジンの `by()` トラバーサル時に `valueMap()` が最適化されない原因となっていた Gremlin のバグを修正しました。
+ 長い Gremlin トランザクションの一部として実行された読み取りクエリが行をロックしないという Gremlin のバグを修正しました。
+ 不要な情報がログに記録されたり、特定のフィールドがログから欠落したりする監査ログのバグを修正しました。
+ IAM 対応 DB クラスターへの HTTP リクエストの IAM ARN が記録されない監査ログのバグを修正しました。
+ ルックアップキャッシュのバグを修正して、キャッシュへの書き込みに使用される増分メモリを制限しました。
+ 書き込みが失敗したときにルックアップキャッシュに読み取り専用モードを設定するというルックアップキャッシュのバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.0.2.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.0.2.R2 へのアップグレードパス
エンジンバージョン `1.2.0.2` を実行している場合、Neptune DB クラスターは次のメンテナンスウィンドウで自動的にこのメンテナンスパッチリリースにアップグレードされます。
## このリリースへのアップグレード
Amazon Neptune 1.2.0.2.R2 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.0.2 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.2 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.0.1 (2022-10-26)
2022 年 10 月 26 日現在、エンジンバージョン1.2.0.1. は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このリリースの後続のパッチリリース
+ [メンテナンスリリース: 1.2.0.1.R2 (2022-12-13)](engine-releases-1.2.0.1.R2.md)
+ [メンテナンスリリース:1.2.0.1.R3 (2023-09-27)](engine-releases-1.2.0.1.R3.md)
## このエンジンリリースの新機能
+ [Amazon Neptune サーバーレス](neptune-serverless.md)を導入しました。これは、処理需要の増加に合わせて DB クラスターをスケールアップし、需要が減少すると再びスケールダウンするオンデマンド自動スケーリング設定です。
## このエンジンリリースの改良点
+ Gremlin `order-by` クエリのパフォーマンスが改善されました。`NeptuneGraphQueryStep` の末尾に `order-by` が付いている Gremlin クエリは、パフォーマンスを向上させるために、より大きなサイズのチャンクを使用するようになりました。これはクエリプランの内部 (ルート以外の) ノードの `order-by` には適用されません。
+ Gremlin 更新クエリのパフォーマンスが改善されました。エッジやプロパティを追加している間は、削除されないように頂点とエッジをロックする必要があります。この変更により、トランザクション内の重複ロックがなくなり、パフォーマンスが向上します。
+ `dedup` をネイティブ実行レイヤーにプッシュすることで、`repeat()` サブクエリの内部の `dedup()` を使用する Gremlin クエリのパフォーマンスが向上しました。
+ IAM 認証エラーに関するユーザーフレンドリーなエラーメッセージを追加しました。これらのメッセージには、IAM ユーザーまたはロール ARN、リソース ARN、およびリクエストに対する不正アクションのリストが表示されるようになりました。不正アクションのリストは、使用している IAM ポリシーに何が欠けているか、または明示的に拒否されているかを確認するのに役立ちます。
## このエンジンリリースで修正された不具合
+ TinkerPop 3.5 にアップグレードした後に `PartitionStrategy` を使用すると、「PartitionStrategy は匿名トラバーサルでは機能しません」というメッセージを含むエラーが誤って発生し、トラバーサルが実行されなくなるという Gremlin のバグを修正しました。
+ `WherePredicateStep` 変換に関する Gremlin の正確性に関するバグを修正しました。このバグでは、Neptune のクエリエンジンが、`where(P.neq('x'))` とそのバリエーションを使用するクエリについて誤った結果を生成していました。
+ ノードとエッジが重複して作成されることがあった `MERGE` 句内の openCypher のバグが修正されました。
+ `OPTIONAL` 句内に `(NOT) EXISTS` を含むクエリの処理において、クエリの結果が表示されない場合がある SPARQL のバグを修正しました。
+ 挿入負荷が高い場合にパフォーマンスが低下するバルクローダーのバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.0.1 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.0.1 へのアップグレードパス
## このリリースへのアップグレード
Amazon Neptune 1.2.0.1 が公開されました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.0.1 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.1 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.0.1.R3 (2023-09-27)
2023 年 9 月 27 日現在、エンジンバージョン 1.2.0.1.R3 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ すべての [Neptune ML API](machine-learning-api-reference.md) に `enableInterContainerTrafficEncryption` パラメータを追加しました。これを使用して、トレーニングジョブやハイパーパラメータチューニングジョブでコンテナ間トラフィック暗号化を有効または無効にできます。
+ サーバーレス DB クラスターでは、最小容量設定を 1.0 NCU に、最小有効最大設定を 2.5 NCU に変更しました。「[Neptune サーバーレス DB クラスターの容量スケーリング](neptune-serverless-capacity-scaling.md) (((リリース前に、この変更をサーバーレスページにも反映する必要があります)))」を参照してください。
## このエンジンリリースで修正された不具合
+ 更新とリターンのクエリが `orderBy`、`limit`、または `skip` を正しく処理しない openCypher のバグを修正しました。
+ あるリクエストに含まれるパラメータが、別の同時リクエストに含まれるパラメータによってオーバーライドされる可能性がある openCypher のバグを修正しました。
+ Bolt のトランザクション処理における openCypher のバグを修正しました。
+ Tinkerpop にフォールバックして `limit` を非結合ステップの子トラバーサルとして持つ DFE クエリの Gremlin の正確性の問題を修正しました。例えば、次のようなクエリの場合:
```
g.withSideEffect('Neptune#useDFE', true)
.V()
.as("a")
.select("a")
.by(out()
.limit(1))
```
+ TinkerPop のステップが多すぎるためにクエリが失敗し、クリーンアップされないという Gremlin のバグを修正しました。
+ 文字列出力の一部にスペース文字が含まれていると `order()` によって正しくソートされない Gremlin のバグを修正しました。
+ クエリが文字列として送信され、`GroupCountStep` を含んでいたときに、トランザクションリークが発生する可能性がある Gremlin のバグを修正しました。
+ ネイティブに処理されないステップの子トラバーサルに述語を含むクエリについて、Gremlin クエリステータスエンドポイントを確認すると、トランザクションリークが発生する Gremlin のバグを修正しました。
+ `inV()` または `outV()` が続くエッジとそのプロパティを追加すると `InternalFailureException` が発生する Gremlin のバグを修正しました。
+ ストレージレイヤーの同時実行の問題を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.2.1.R3 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.6`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.0.1.R3 へのアップグレードパス
[エンジンバージョン 1.2.0.1](engine-releases-1.2.0.1.md) を実行している場合、Neptune DB クラスターは次のメンテナンスウィンドウで自動的にこのパッチリリースにアップグレードされます。
## このリリースへのアップグレード
Amazon Neptune 1.0.2.1.R3 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.0.1 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.1 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.0.1.R2 (2022-12-13)
2022 年 12 月 13 日現在、エンジンバージョン 1.2.0.1.R2 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ リテラル値のマップのリストの `UNWIND` に関係する openCypher クエリのパフォーマンスが向上しました。
+ `repeat`、`coalesce`、`store`、`aggregate` など、さまざまな Gremlin 演算子のパフォーマンスの向上と正確性の修正を行いました。
## このエンジンリリースで修正された不具合
+ Bolt と SPARQL-JSON でクエリが NULL 値ではなく文字列 `"null"` を返す openCypher のバグを修正しました。
+ 不要な情報がログに記録されたり、特定のフィールドがログから欠落したりする監査ログのバグを修正しました。
+ ルックアップキャッシュのバグを修正して、キャッシュへの書き込みに使用される増分メモリを制限しました。
+ 書き込みが失敗したときにルックアップキャッシュに読み取り専用モードを設定するというルックアップキャッシュのバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.0.1.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.0.1.R2 へのアップグレードパス
[エンジンバージョン 1.2.0.1](engine-releases-1.2.0.1.md) を実行している場合、Neptune DB クラスターは次のメンテナンスウィンドウで自動的にこのパッチリリースにアップグレードされます。
## このリリースへのアップグレード
Amazon Neptune 1.2.0.1.R2 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.0.1 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.1 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.0.0 (2022-07-21)
2022 年 7 月 21 日現在、エンジンバージョン 1.2.0.0 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](#engine-releases-1.2.0.0) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このリリースの後続のパッチリリース
+ [リリース： 1.2.0.0.R2 (2022-10-14)](engine-releases-1.2.0.0.R2.md)
+ [リリース: 1.2.0.0.R3 (2022-12-15)](engine-releases-1.2.0.0.R3.md)
+ [リリース: 1.2.0.0.R4 (2023-09-29)](engine-releases-1.2.0.0.R4.md)
## このエンジンリリースの新機能
+ [グローバルデータベース](neptune-global-database.md)のサポートが追加されました。Neptune グローバルデータベースは複数の AWS リージョン にまたがり、1 つのリージョンにあるプライマリ DB クラスターと、他のリージョンにある最大 5 つのセカンダリ DB クラスターで構成されます。
+ Neptune IAM ポリシーに、データプレーンアクションに基づく、以前よりもきめ細かいアクセスコントロールのサポートが追加されました。廃止された `connect` アクションに基づく既存の IAM ポリシーを、より詳細なデータプレーンアクションを使用するように調整する必要があるという点で、これは重大な変更です。「[IAM ポリシーのタイプ](security-iam-access-manage.md#iam-auth-policy)」を参照してください。
+ リーダーインスタンスの可用性が向上しました。これまでは、ライターインスタンスが再起動すると、Neptune クラスター内のすべてのリーダーインスタンスも再起動していました。エンジンリリース 1.2.0.0 以降、ライターの再起動後もリーダーインスタンスはアクティブなままになり、リーダーの可用性が向上しました。リーダーインスタンスはパラメータグループの変更を反映するために個別に再起動できます。「[Amazon Neptune における DB インスタンスの再起動](manage-console-instances-reboot.md)」を参照してください。
+ 新しい [neptune\$1streams\$1expiry\$1days](parameters.md#parameters-db-cluster-parameters-neptune_streams_expiry_days) DB クラスターパラメータが追加されました。これにより、ストリームレコードが削除されるまでにサーバー上に保持される日数を設定できます。範囲は 1～90 で、デフォルトは 7 です。
## このエンジンリリースの改良点
+ ByteCode クエリの Gremlin シリアル化のパフォーマンスが向上しました。
+ Neptune は DFE エンジンを使用してテキスト述語を処理するようになり、パフォーマンスが向上しました。
+ Neptune は、非終端制限や子トラバーサル制限を含め、DFE エンジンを使用して Gremlin `limit()` ステップを処理するようになりました。
+ Gremlin `union()` ステップの DFE 処理を他の新機能と連携するように変更しました。つまり、リファレンスノードがクエリプロファイルに期待どおりに表示されるようになりました。
+ DFE 内の一部の高価な結合操作を並列化することで、パフォーマンスが最大 5 倍向上しました。
+ Gremlin DFE エンジンの `OrderGlobalStep order(global)` について `by()` モジュレーションサポートが追加されました。
+ DFE の詳細説明に、注入された静的な値の表示を追加しました。
+ 重複するパターンを削除するときのパフォーマンスが向上しました。
+ Gremlin DFE エンジンに順序保持サポートが追加されました。
+ 次のような空のフィルターを含む Gremlin クエリのパフォーマンスが向上しました。
```
g.V().hasId(P.within([]))
```
```
g.V().hasId([])
```
+ SPARQL クエリが Neptune が内部的に表現するには大きすぎる数値を使用する場合のエラーメッセージを改善しました。
+ ストリームが無効になっているときにインデックス検索を減らすことで、エッジが関連付けられた頂点を削除するときのパフォーマンスが向上しました。
+ DFE サポートを `has()` ステップのより多くのバリアント、特に `hasKey()`、`hasLabel()` と、`has()` 内の文字列/URI の範囲述語に拡張しました。これは次のようなクエリに影響します。
```
// hasKey() on properties
g.V().properties().hasKey("name")
g.V().properties().has(T.key, TextP.startingWith("a"))
g.E().properties().hasKey("weight")
g.E().properties().hasKey(TextP.containing("t"))
// hasLabel() on vertex properties
g.V().properties().hasLabel("name")
// range predicates on ID and Label fields
g.V().has(T.label, gt("person"))
g.E().has(T.id, lte("(an ID value)"))
```
+ リスト内の文字列を単一の文字列に連結する NepTune 固有の openCypher [`join()`](access-graph-opencypher-extensions.md#opencypher-compliance-join-function) 関数を追加しました。
+ データアクセス許可と新しいグローバルデータベース API のアクセス許可を含むように [Neptune 管理ポリシー](security-iam-access-managed-policies.md)を更新しました。
## このエンジンリリースで修正された不具合
+ コンテンツタイプが指定されていない HTTP リクエストが自動的に失敗するバグを修正しました。
+ クエリー内でサービスコールが使用できないというクエリーオプティマイザーの SPARQL バグを修正しました。
+ Unicode データの特定の組み合わせが原因で障害が発生するという Turtle RDF パーサーの SPARQL バグを修正しました。
+ `GRAPH` および `SELECT` 句の特定の組み合わせが誤ったクエリ結果を生成する SPARQL のバグを修正しました。
+ 次のような結合ステップ内のフィルターステップを使用するクエリで正確性の問題が発生する Gremlin のバグを修正しました。
```
g.V("1").union(hasLabel("person"), out())
```
+ `both().simplePath()` の `count()` によって、`count()` なしで返される結果の数が実際の 2 倍になるという Gremlin のバグを修正しました。
+ IAM 認証が有効になっているクラスターへの Bolt リクエストに対して、サーバーで署名不一致の例外が生成される openCypher のバグを修正しました。
+ HTTP キープアライブを使用するクエリが、リクエストが失敗した後に送信された場合に誤ってクローズされる可能性がある openCypher のバグを修正しました。
+ 定数値を返すクエリが送信されると内部エラーがスローされる openCypher のバグを修正しました。
+ 説明の詳細のバグが修正され、DFE サブクエリ `Time(ms)` が DFE サブクエリ内のオペレータの CPU 時間を正しく合計するようになりました。例として、次の説明出力の抜粋を考えてみましょう。
```
subQuery1
╔════╤════════╤════════╤═══════════════════════╤═══════════════════════════════════╤══════╤══════════╤═══════════╤═══════╤═══════════╗
║ ID │ Out #1 │ Out #2 │ Name │ Arguments │ Mode │ Units In │ Units Out │ Ratio │ Time (ms) ║
╠════╪════════╪════════╪═══════════════════════╪═══════════════════════════════════╪══════╪══════════╪═══════════╪═══════╪═══════════╣
...
╟────┼────────┼────────┼───────────────────────┼───────────────────────────────────┼──────┼──────────┼───────────┼───────┼───────────╢
║ 1 │ 2 │ - │ DFEChunkLocalSubQuery │ subQuery=...graph#336e.../graph_1 │ - │ 1 │ 1 │ 1.00 │ 0.38 ║
║ │ │ │ │ coordinationTime(ms)=0.026 │ │ │ │ │ ║
╟────┼────────┼────────┼───────────────────────┼───────────────────────────────────┼──────┼──────────┼───────────┼───────┼───────────╢
...
subQuery=...graph#336e.../graph_1
╔════╤════════╤════════╤═══════════════════════╤═══════════════════════════════════╤══════╤══════════╤═══════════╤═══════╤═══════════╗
║ ID │ Out #1 │ Out #2 │ Name │ Arguments │ Mode │ Units In │ Units Out │ Ratio │ Time (ms) ║
╠════╪════════╪════════╪═══════════════════════╪═══════════════════════════════════╪══════╪══════════╪═══════════╪═══════╪═══════════╣
║ 0 │ 1 │ - │ DFESolutionInjection │ solutions=[?100 -> [-10^^]] │ - │ 0 │ 1 │ 0.00 │ 0.04 ║
║ │ │ │ │ outSchema=[?100] │ │ │ │ │ ║
╟────┼────────┼────────┼───────────────────────┼───────────────────────────────────┼──────┼──────────┼───────────┼───────┼───────────╢
║ 1 │ 3 │ - │ DFERelationalJoin │ joinVars=[] │ - │ 2 │ 1 │ 0.50 │ 0.29 ║
╟────┼────────┼────────┼───────────────────────┼───────────────────────────────────┼──────┼──────────┼───────────┼───────┼───────────╢
║ 2 │ 1 │ - │ DFESolutionInjection │ outSchema=[] │ - │ 0 │ 1 │ 0.00 │ 0.01 ║
╟────┼────────┼────────┼───────────────────────┼───────────────────────────────────┼──────┼──────────┼───────────┼───────┼───────────╢
║ 3 │ - │ - │ DFEDrain │ - │ - │ 1 │ 0 │ 0.00 │ 0.02 ║
╚════╧════════╧════════╧═══════════════════════╧═══════════════════════════════════╧══════╧══════════╧═══════════╧═══════╧═══════════╝
```
下の表の最後の列のサブクエリ時間は、合計で 0.36 ms (`.04 + .29 + .01 + .02 = .36`) になります。そのサブクエリの調整時間を追加すると (`.36 + .026 = .386`) 、上のテーブルの最後の列に記録されているサブクエリの時間、つまり `0.38` ms に近い結果が得られます。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.0.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.0.0 へのアップグレードパス
これはエンジンのメジャーリリースなので、自動アップグレードはありません。
[エンジンリリース 1.1.1.0](engine-releases-1.1.1.0.md) の最新のパッチリリースからリリース `1.2.0.0` へのアップグレードは手動でのみ可能です。`1.2.0.0` にアップグレードするには、その前に、以前のエンジンリリースを `1.1.1.0` の最新リリースにアップグレードする必要があります。
そのため、このリリースにアップグレードする前に、リリース `1.1.1.0` の最新パッチリリースを現在実行していることを確認してください。そうでない場合は、`1.1.1.0` の最新パッチリリースにアップグレードすることから始めてください。
アップグレードする前に、パラメータグループファミリー `neptune1.2` を使用して、以前のバージョンで使用していたカスタム DB クラスターパラメータグループを再作成する必要もあります。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
最初にリリース `1.1.1.0` にアップグレードし、その後すぐに `1.2.0.0` にアップグレードする場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md)」を参照)。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.0.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.0.0.R4 (2023-09-29)
2023 年 9 月 29 日現在、エンジンバージョン1.2.0.0.R4 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ すべての [Neptune ML API](machine-learning-api-reference.md) に `enableInterContainerTrafficEncryption` パラメータを追加しました。これを使用して、トレーニングジョブやハイパーパラメータチューニングジョブでコンテナ間トラフィック暗号化を有効または無効にできます。
+ サーバーレス DB クラスターでは、最小容量設定を 1.0 NCU に、最小有効最大設定を 2.5 NCU に変更しました。「[Neptune サーバーレス DB クラスターの容量スケーリング](neptune-serverless-capacity-scaling.md) (((リリース前に、この変更をサーバーレスページにも反映する必要があります)))」を参照してください。
## このエンジンリリースで修正された不具合
+ 更新とリターンのクエリが `orderBy`、`limit`、または `skip` を正しく処理しない openCypher のバグを修正しました。
+ あるリクエストに含まれるパラメータが、別の同時リクエストに含まれるパラメータによってオーバーライドされる可能性がある openCypher のバグを修正しました。
+ Bolt のトランザクション処理における openCypher のバグを修正しました。
+ Tinkerpop にフォールバックして `limit` を非結合ステップの子トラバーサルとして持つ DFE クエリの Gremlin の正確性の問題を修正しました。例えば、次のようなクエリの場合:
```
g.withSideEffect('Neptune#useDFE', true)
.V()
.as("a")
.select("a")
.by(out()
.limit(1))
```
+ TinkerPop のステップが多すぎるためにクエリが失敗し、クリーンアップされないという Gremlin のバグを修正しました。
+ 文字列出力の一部にスペース文字が含まれていると `order()` によって正しくソートされない Gremlin のバグを修正しました。
+ クエリが文字列として送信され、`GroupCountStep` を含んでいたときに、トランザクションリークが発生する可能性がある Gremlin のバグを修正しました。
+ ネイティブに処理されないステップの子トラバーサルに述語を含むクエリについて、Gremlin クエリステータスエンドポイントを確認すると、トランザクションリークが発生する Gremlin のバグを修正しました。
+ `inV()` または `outV()` が続くエッジとそのプロパティを追加すると `InternalFailureException` が発生する Gremlin のバグを修正しました。
+ ストレージレイヤーの同時実行の問題を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.0.0.R4 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.6`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.0.0.R4 へのアップグレードパス
エンジンバージョン `1.2.0.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
[エンジンリリース 1.1.1.0](engine-releases-1.1.1.0.md) の最新のパッチリリースからリリース `1.2.0.0` へのアップグレードは手動でのみ可能です。`1.2.0.0` にアップグレードするには、その前に、以前のエンジンリリースを `1.1.1.0` の最新リリースにアップグレードする必要があります。
最初にリリース `1.1.1.0` にアップグレードし、その後すぐに `1.2.0.0` にアップグレードする場合、次のようなエラーが発生する可能性があります。
```
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.
```
このエラーが発生した場合は、保留中のアクションが終了するのを待つか、すぐにメンテナンスウィンドウをトリガーして、前回のアップグレードを完了させます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.0.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.0.0.R3 (2022-12-15)
2022 年 12 月 15 日現在、エンジンバージョン 1.2.0.0.R3 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ `MERGE` と `OPTIONAL MATCH` を含む openCypher クエリのパフォーマンスが向上しました。
+ リテラル値のマップのリストの `UNWIND` に関係する openCypher クエリのパフォーマンスが向上しました。
+ `id` の `IN` フィルターの付いた openCypher クエリのパフォーマンスが向上しました。例:
```
MATCH (n) WHERE id(n) IN ['1', '2', '3'] RETURN n
```
+ `repeat`、`coalesce`、`store`、`aggregate` など、さまざまな Gremlin 演算子のパフォーマンスの向上と正確性の修正を行いました。
## このエンジンリリースで修正された不具合
+ Bolt と SPARQL-JSON でクエリが NULL 値ではなく文字列 `"null"` を返す openCypher のバグを修正しました。
+ openCypher のバグを修正し、値がリストまたはマップのリストの場合にパラメータタイプを正しく解釈できるようにしました。
+ 不要な情報がログに記録されたり、特定のフィールドがログから欠落したりする監査ログのバグを修正しました。
+ IAM 対応 DB クラスターへの HTTP リクエストの IAM ARN が記録されない監査ログのバグを修正しました。
+ ルックアップキャッシュのバグを修正して、キャッシュへの書き込みに使用される増分メモリを制限しました。
+ 書き込みが失敗したときにルックアップキャッシュに読み取り専用モードを設定するというルックアップキャッシュのバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.0.0.R3 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.0.0.R3 へのアップグレードパス
エンジンバージョン `1.2.0.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
[エンジンリリース 1.1.1.0](engine-releases-1.1.1.0.md) の最新のパッチリリースからリリース `1.2.0.0` へのアップグレードは手動でのみ可能です。`1.2.0.0` にアップグレードするには、その前に、以前のエンジンリリースを `1.1.1.0` の最新リリースにアップグレードする必要があります。
最初にリリース `1.1.1.0` にアップグレードし、その後すぐに `1.2.0.0` にアップグレードする場合、次のようなエラーが発生する可能性があります。
```
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.
```
このエラーが発生した場合は、保留中のアクションが終了するのを待つか、すぐにメンテナンスウィンドウをトリガーして、前回のアップグレードを完了させます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.0.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.2.0.0.R2 (2022-10-14)
2022 年 10 月 14 日現在、エンジンバージョン 1.2.0.0.R2 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**注記**
**1.2.0.0 より前のエンジンバージョンからアップグレードを行う場合:**
[エンジンリリース 1.2.0.0](engine-releases-1.2.0.0.md) では、カスタムパラメータグループとカスタムクラスターパラメータグループに新しい形式が導入されました。そのため、1.2.0.0 より前のエンジンバージョンからエンジンバージョン 1.2.0.0 以降にアップグレードする場合は、パラメータグループファミリー `neptune1.2` を使用している既存のカスタムパラメータグループとカスタムクラスターパラメータグループをすべて再作成する必要があります。以前のリリースではパラメータグループファミリー `neptune1` が使用されていましたが、それらのパラメータグループはリリース 1.2.0.0 以降では動作しません。詳細については「[Amazon Neptune パラメータグループ](parameter-groups.md)」を参照してください。
エンジンリリース 1.2.0.0 では、元に戻すログの新しい形式も導入されました。そのため、1.2.0.0 より前のバージョンからのアップグレードを開始する前に、以前のエンジンバージョンで作成された UNDO ログをすべてパージし、[`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch メトリクスをゼロにする必要があります。更新を開始しようとしたときに UNDO ログレコードが多すぎる (200,000 以上) 場合、UNDO ログのパージが完了するのを待っている間にアップグレードがタイムアウトすることがあります。
パージが行われるクラスターのライターインスタンスをアップグレードすることで、パージの速度を上げることができます。アップグレードを試みる前にこれを行うと、開始前に UNDO ログの数を減らすことができます。ライターのサイズを 24XL インスタンスタイプに増やすと、パージ率が 1 時間あたり 100 万レコードを超えることがあります。
`UndoLogsListSize` CloudWatch メトリクスが非常に大きい場合、サポートケースを開くと、それを停止するための追加の戦略を検討するのに役立つ場合があります。
最後に、リリース 1.2.0.0 には、IAM 認証で Bolt プロトコルを使用していた以前のコードに影響する重大な変更がありました。リリース 1.2.0.0 以降、Bolt には IAM 署名用のリソースパスが必要です。Java では、リソースパスの設定は以下のようになります: `request.setResourcePath("/openCypher"));`。その他の言語では、`/openCypher` をエンドポイント URI に追加できます。設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ Gremlin `order-by` クエリのパフォーマンスが改善されました。`NeptuneGraphQueryStep` の末尾に `order-by` が付いている Gremlin クエリは、パフォーマンスを向上させるために、より大きなサイズのチャンクを使用するようになりました。これはクエリプランの内部 (ルート以外の) ノードの `order-by` には適用されません。
+ Gremlin 更新クエリのパフォーマンスが改善されました。エッジやプロパティを追加している間は、削除されないように頂点とエッジをロックする必要があります。この変更により、トランザクション内の重複ロックがなくなり、パフォーマンスが向上します。
+ `dedup` をネイティブ実行レイヤーにプッシュすることで、`repeat()` サブクエリの内部の `dedup()` を使用する Gremlin クエリのパフォーマンスが向上しました。
+ Gremlin `Neptune#cardinalityEstimates` クエリヒントを追加しました。`false` に設定すると、カーディナリティ推定が無効になります。
+ IAM 認証エラーに関するユーザーフレンドリーなエラーメッセージを追加しました。これらのメッセージには、IAM ユーザーまたはロール ARN、リソース ARN、およびリクエストに対する不正アクションのリストが表示されるようになりました。不正アクションのリストは、使用している IAM ポリシーに何が欠けているか、または明示的に拒否されているかを確認するのに役立ちます。
## このエンジンリリースで修正された不具合
+ `WherePredicateStep` 変換に関する Gremlin の正確性に関するバグを修正しました。このバグでは、Neptune のクエリエンジンが、`where(P.neq('x'))` とそのバリエーションを使用するクエリについて誤った結果を生成していました。
+ TinkerPop 3.5 にアップグレードした後に `PartitionStrategy` を使用すると、「PartitionStrategy は匿名トラバーサルでは機能しません」というメッセージを含むエラーが誤って発生し、トラバーサルが実行されなくなるという Gremlin のバグを修正しました。
+ 最終結合の `joinTime` と `Project.ASK` サブグループ内の統計に関するさまざまな Gremlin のバグが修正されました。
+ ノードとエッジが重複して作成されることがあった `MERGE` 句内の openCypher のバグが修正されました。
+ 対応する同時辞書挿入がロールバックされた場合でも、セッションがグラフデータを挿入してコミットする可能性があるというトランザクションのバグを修正しました。
+ 挿入負荷が高い場合にパフォーマンスが低下するバルクローダーのバグを修正しました。
+ `OPTIONAL` 句内に `(NOT) EXISTS` を含むクエリの処理において、クエリの結果が表示されない場合がある SPARQL のバグを修正しました。
+ 評価開始前のタイムアウトによりリクエストがキャンセルされた場合に、ドライバーがハングアップしたように見えるバグを修正しました。リクエストキュー内のアイテムでタイムアウトが発生している間に、サーバー上のすべてのクエリ処理スレッドが消費されると、この状態になる可能性がありました。リクエストキューからのタイムアウトによってメッセージがすぐに送信されるわけではなかったため、クライアントには応答が保留中のままのように見えました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.2.0.0.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.2.0.0.R2 へのアップグレードパス
エンジンバージョン `1.2.0.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
[エンジンリリース 1.1.1.0](engine-releases-1.1.1.0.md) の最新のパッチリリースからリリース `1.2.0.0` へのアップグレードは手動でのみ可能です。`1.2.0.0` にアップグレードするには、その前に、以前のエンジンリリースを `1.1.1.0` の最新リリースにアップグレードする必要があります。
最初にリリース `1.1.1.0` にアップグレードし、その後すぐに `1.2.0.0` にアップグレードする場合、次のようなエラーが発生する可能性があります。
```
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.
```
このエラーが発生した場合は、保留中のアクションが終了するのを待つか、すぐにメンテナンスウィンドウをトリガーして、前回のアップグレードを完了させます。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.2.0.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.1.1.0 (2022-04-19)
2022 年 4 月 19 日現在、エンジンバージョン 1.1.1.0 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードを正常に完了するには、すべてのアベイラビリティーゾーン (AZ) の各サブネットに、Neptune インスタンスごとに利用可能な IP アドレスが少なくとも 1 つ必要です。例えば、サブネット 1 に 1 つのライターインスタンスと 2 つのリーダーインスタンスがあり、サブネット 2 に 2 つのリーダーインスタンスがある場合、アップグレードを開始する前に、サブネット 1 には少なくとも 3 つの IP アドレスの空きがあり、サブネット 2 には少なくとも 2 つの IP アドレスが空いている必要があります。
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
## このリリースの後続のパッチリリース
+ [メンテナンスリリース: 1.1.0.0.R2 (2022-05-16)](engine-releases-1.1.1.0.R2.md)
+ [リリース: 1.1.1.0.R3 (2022-06-07)](engine-releases-1.1.1.0.R3.md)
+ [リリース: 1.1.1.0.R4 (2022-06-23)](engine-releases-1.1.1.0.R4.md)
+ [リリース: 1.1.1.0.R5 (2022-07-21)](engine-releases-1.1.1.0.R5.md)
+ [リリース: 1.1.1.0.R6 (2022-09-23)](engine-releases-1.1.1.0.R6.md)
+ [リリース: 1.1.1.0.R7 (2023-01-23)](engine-releases-1.1.1.0.R7.md)
## このエンジンリリースの新機能
+ [openCypher クエリ言語](access-graph-opencypher.md)は、本稼働環境用に一般公開されるようになりました。
**警告**
このリリースでは、IAM 認証で openCypher を使用するコードに重大な変更が加えられています。openCypher の Neptune プレビューでは、IAM シグネチャのホスト文字列に `bolt://` など、次のようなプロトコルが含まれていました。
```
"Host":"bolt://(host URL):(port)"
```
このエンジンリリース以降、このプロトコルは省略する必要があります。
```
"Host":"(host URL):(port)"
```
設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
+ TinkerPop `3.5.2` のサポートが追加されました。[このリリースの変更点](https://github.com/apache/tinkerpop/blob/3.5.2/CHANGELOG.asciidoc#release-3-5-2)には、リモートトランザクションのサポート、セッション (を使用 [https://tinkerpop.apache.org/docs/current/reference/#transactions](https://tinkerpop.apache.org/docs/current/reference/#transactions)) のバイトコードサポート、Gremlin 言語への `datetime()` 関数の追加などがあります。
**警告**
TinkerPop 3.5.0、3.5.1、3.5.2 では、Gremlin コードに影響を与える可能性のあるいくつかの重大な変更が導入されています。例えば、[GraphTraversalSource によって生成されたトラバーサルを `g.V().union(identity(), g.V())` のように子として使用しても](https://issues.apache.org/jira/browse/TINKERPOP-2361)機能しなくなります。
今度は、代わりに `g.V().union(identity(), __.V())` のような匿名トラバーサルを使用してください。
+ [IAM データアクセスポリシー](iam-admin-policies.md)で使用して、Neptune DB クラスターに保存されているデータへのアクセスを制御できる[AWS グローバル条件キー](iam-data-condition-keys.md#iam-data-global-condition-keys)のサポートが追加されました。
+ [Neptune DFE クエリエンジン](neptune-dfe-engine.md)は OpenCypher クエリ言語による本番環境での使用が可能になりましたが、Gremlin および SPARQL クエリではまだ使用できません。lab-mode パラメータではなく、独自の [neptune\$1dfe\$1query\$1engine](parameters.md#parameters-instance-parameters-neptune_dfe_query_engine) インスタンスパラメータを使用して有効化できるようになりました。
## このエンジンリリースの改良点
+ パラメータ化されたクエリサポート、パラメータ化されたクエリのための抽象構文ツリー (AST) キャッシュ、可変長パス (VLP) の改良、新しい演算子と句などの新機能が [openCypher](access-graph-opencypher.md) に追加されました。現在の言語サポートレベルについては、「[Amazon Neptune における openCypher の仕様準拠](feature-opencypher-compliance.md)」を参照してください。
+ 単純な読み取り/書き込みワークロードの openCypher のパフォーマンスを大幅に改善し、リリース 1.1.0.0 と比較してスループットが向上しました。
+ 可変長パスを処理する openCypher の双方向と深度の制限がなくなりました。
+ DFE エンジンでの Gremlin `within` および `without` 述部のサポートが完了しました。他の述語演算子と組み合わせる場合も含みます。例:
```
g.V().has('age', within(12, 15, 18).or(gt(30)))
```
+ スコープがグローバルであり (つまり `order(local)` ではない)、`by()` モジュレーターが使用されていない場合の DFE エンジンでの Gremlin `order` ステップのサポートが拡張されました。例えば、このクエリは DFE によってサポートされるようになりました。
```
g.V().values("age").order()
```
+ レコードがトランザクションの最後の操作であることを示すために、[Neptune ストリーム変更ログ](streams-using-api-reponse.md)レスポンス形式に `isLastOp` フィールドが追加されました。
+ 監査ログのパフォーマンスが大幅に向上し、監査ログが有効になっている場合の待ち時間が短縮されました。
+ Gremlin WebSocket バイトコードと HTTP クエリが、監査ログでユーザーが読み取り可能な形式に変換されました。クエリを監査ログから直接コピーして、Neptune ノートブックなどで実行できるようになりました。現在の監査ログ形式のこの変更は、重大な変更であることに注意してください。
## このエンジンリリースで修正された不具合
+ 次のクエリのように、ネストされた `filter()` および `count()` ステップを組み合わせて使用すると結果が返されないというまれな Gremlin のバグを修正しました。
```
g.V("1").filter(out("knows")
.filter(in("knows")
.hasId("notExists"))
.count())
```
+ 集約ステップによって保存された頂点を `to()` または `from()` トラバーサルで `addE` ステップと組み合わせて使用するとエラーが返される Gremlin のバグを修正しました。このようなクエリの例は以下のとおりです。
```
g.V("id").aggregate("v").out().addE().to(select("v").unfold()))
```
+ DFE エンジンを使用しているときに `not` ステップがエッジケースで失敗する Gremlin のバグを修正しました。例:
```
g.V().not(V())
```
+ `to()` および `from()` トラバーサル内で `sideEffect` 値が使用できないという Gremlin のバグを修正しました。
+ 高速リセットによってインスタンスフェイルオーバーがトリガーされることがあったバグを修正しました。
+ 失敗したトランザクションが次のロードジョブを開始する前にクローズされないバルクローダーのバグを修正しました。
+ メモリ不足によりシステムがクラッシュするバルクローダーのバグを修正しました。
+ フェイルオーバー後に IAM 認証情報が利用可能になるまでローダーが長時間待たなかったというバルクローダーのバグを修正するためのリトライを追加しました。
+ `status` エンドポイントなど、クエリ以外のエンドポイントの内部認証情報キャッシュが適切にクリアされないバグを修正しました。
+ ストリームのコミットのシーケンス番号が正しい順序になるようにストリームのバグを修正しました。
+ IAM 対応クラスターで長時間実行される接続が 10 日より早く終了するバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.1.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.1.0 へのアップグレードパス
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。メジャーバージョンエンジン (1.1.0.0) より前のバージョンでは、このリリースへのアップグレードに時間がかかることに注意してください。
このリリースに自動的にアップグレードされることはありません。
## このリリースへのアップグレード
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine neptune \
4. --engine-version 1.1.1.0 \
5. --allow-major-version-upgrade \
6. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine neptune ^
4. --engine-version 1.1.1.0 ^
5. --allow-major-version-upgrade ^
6. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.1.1.0.R7 (2023-01-23)
2023 年 1 月 23 日現在、エンジンバージョン1.1.1.0.R7 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードを正常に完了するには、すべてのアベイラビリティーゾーン (AZ) の各サブネットに、Neptune インスタンスごとに利用可能な IP アドレスが少なくとも 1 つ必要です。例えば、サブネット 1 に 1 つのライターインスタンスと 2 つのリーダーインスタンスがあり、サブネット 2 に 2 つのリーダーインスタンスがある場合、アップグレードを開始する前に、サブネット 1 には少なくとも 3 つの IP アドレスの空きがあり、サブネット 2 には少なくとも 2 つの IP アドレスが空いている必要があります。
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
## このエンジンリリースの改良点
+ `MERGE` と `OPTIONAL MATCH` を含む openCypher クエリのパフォーマンスが向上しました。
+ リテラル値のマップのリストの `UNWIND` を含む openCypher クエリのパフォーマンスが向上しました。
+ `id` の `IN` フィルターの付いた openCypher クエリのパフォーマンスが向上しました。例:
```
MATCH (n) WHERE id(n) IN ['1', '2', '3'] RETURN n
```
+ `repeat`、`coalesce`、`store`、`aggregate` など、さまざまな Gremlin 演算子のパフォーマンスの向上と正確性の修正を行いました。
## このエンジンリリースで修正された不具合
+ HTTP キープアライブを使用するリクエストが、リクエストが失敗した後に送信された場合に誤ってクローズされる可能性がある openCypher のバグを修正しました。
+ リストまたはマップのリストでパラメータタイプが正しく解釈されないことがあるという openCypher のバグを修正しました。
+ Bolt と SPARQL-JSON でクエリが NULL 値の代わりに文字列 `"null"` を返す openCypher のバグを修正しました。
+ クエリタイムアウトエラーとメモリ不足エラーに関する openCypher エラーコードとエラーメッセージを修正しました。
+ DFE エンジンの `by()` トラバーサル時に `valueMap()` が最適化されない原因となっていた Gremlin のバグを修正しました。
+ デッドロック検出ロジックで、エンジンが応答しなくなることがあった問題を修正しました。
+ 不要な情報がログに記録されたり、特定のフィールドがログから欠落したりする監査ログのバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.1.0.R7 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.3`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.1.0.R7 へのアップグレードパス
エンジンバージョン `1.1.1.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
## このリリースへのアップグレード
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.1.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.1.1.0.R6 (2022-09-23)
2022 年 9 月 23 日現在、エンジンバージョン1.1.1.0.R6 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードを正常に完了するには、すべてのアベイラビリティーゾーン (AZ) の各サブネットに、Neptune インスタンスごとに利用可能な IP アドレスが少なくとも 1 つ必要です。例えば、サブネット 1 に 1 つのライターインスタンスと 2 つのリーダーインスタンスがあり、サブネット 2 に 2 つのリーダーインスタンスがある場合、アップグレードを開始する前に、サブネット 1 には少なくとも 3 つの IP アドレスの空きがあり、サブネット 2 には少なくとも 2 つの IP アドレスが空いている必要があります。
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**注記**
このリリースでは、IAM 認証で openCypher を使用するコードに重大な変更が加えられています。これまでは、IAM シグネチャーのホスト文字列には、`bolt://` など、次のようなプロトコルが含まれていました。
```
"Host":"bolt://(host URL):(port)"
```
エンジンリリース `1.1.1.0` 以降、このプロトコルは省略する必要があります。
```
"Host":"(host URL):(port)"
```
設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ Gremlin `order-by` クエリのパフォーマンスが改善されました。`NeptuneGraphQueryStep` の末尾に `order-by` が付いている Gremlin クエリは、パフォーマンスを向上させるために、より大きなサイズのチャンクを使用するようになりました。これはクエリプランの内部 (ルート以外の) ノードの `order-by` には適用されません。
+ Gremlin 更新クエリのパフォーマンスが改善されました。エッジやプロパティを追加している間は、削除されないように頂点とエッジをロックする必要があります。この変更により、トランザクション内の重複ロックがなくなり、パフォーマンスが向上します。
## このエンジンリリースで修正された不具合
+ ノードとエッジが重複して作成されることがあった `MERGE` 句内の openCypher のバグが修正されました。
+ `OPTIONAL` 句内に `(NOT) EXISTS` を含む SPARQL クエリの処理において、クエリの結果が表示されない場合があるバグを修正しました。
+ 一括ロードの進行中にサーバーの再起動が遅れるバグを修正しました。
+ リレーションシッププロパティにフィルターを設定した openCypher 可変長パターンの双方向トラバーサルでエラーが発生するバグを修正しました。このような可変長パターンの例としては、`(n)-[r*1..2]->(m)` があります。
+ キャッシュされたデータをクライアントに送り返す方法に関するバグを修正しました。このバグが原因で、場合によっては予想外に長い待ち時間が発生することがありました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.1.0.R6 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.1.0.R6 へのアップグレードパス
エンジンバージョン `1.1.1.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
## このリリースへのアップグレード
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.1.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.1.1.0.R5 (2022-07-21)
2022 年 7 月 21 日現在、エンジンバージョン1.1.1.0.R5 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードを正常に完了するには、すべてのアベイラビリティーゾーン (AZ) の各サブネットに、Neptune インスタンスごとに利用可能な IP アドレスが少なくとも 1 つ必要です。例えば、サブネット 1 に 1 つのライターインスタンスと 2 つのリーダーインスタンスがあり、サブネット 2 に 2 つのリーダーインスタンスがある場合、アップグレードを開始する前に、サブネット 1 には少なくとも 3 つの IP アドレスの空きがあり、サブネット 2 には少なくとも 2 つの IP アドレスが空いている必要があります。
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**注記**
このリリースでは、IAM 認証で openCypher を使用するコードに重大な変更が加えられています。これまでは、IAM シグネチャーのホスト文字列には、`bolt://` など、次のようなプロトコルが含まれていました。
```
"Host":"bolt://(host URL):(port)"
```
エンジンリリース `1.1.1.0` 以降、このプロトコルは省略する必要があります。
```
"Host":"(host URL):(port)"
```
設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ デッドロック検出をサポートするように改良を加えました。
## このエンジンリリースで修正された不具合
+ 特定の条件下で DB クラスターをクリーンシャットダウンできないバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.1.0.R5 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.1.0.R5 へのアップグレードパス
エンジンバージョン `1.1.1.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
## このリリースへのアップグレード
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.1.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.1.1.0.R4 (2022-06-23)
2022 年 6 月 23 日現在、エンジンバージョン1.1.1.0.R4 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードを正常に完了するには、すべてのアベイラビリティーゾーン (AZ) の各サブネットに、Neptune インスタンスごとに利用可能な IP アドレスが少なくとも 1 つ必要です。例えば、サブネット 1 に 1 つのライターインスタンスと 2 つのリーダーインスタンスがあり、サブネット 2 に 2 つのリーダーインスタンスがある場合、アップグレードを開始する前に、サブネット 1 には少なくとも 3 つの IP アドレスの空きがあり、サブネット 2 には少なくとも 2 つの IP アドレスが空いている必要があります。
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**注記**
このリリースでは、IAM 認証で openCypher を使用するコードに重大な変更が加えられています。これまでは、IAM シグネチャーのホスト文字列には、`bolt://` など、次のようなプロトコルが含まれていました。
```
"Host":"bolt://(host URL):(port)"
```
エンジンリリース `1.1.1.0` 以降、このプロトコルは省略する必要があります。
```
"Host":"(host URL):(port)"
```
設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ インスタンスタイプのインスタンス設定が更新されました。`x2g`
+ 頂点ドロップのパフォーマンスが向上しました。
## このエンジンリリースで修正された不具合
+ 特定の種類の ASK 結合について、複数回呼び出されたり、複数のリーダーで呼び出されたクエリの順序が安定していなかったという Gremlin のバグを修正しました。
+ また、Gremlin の特定の種類の ASK 結合でパフォーマンスの低下を引き起こしていた以前のリリースの変更の範囲を絞り込みました。
+ 子トラバーサル内でエッジ入力と頂点へのトラバーサルがあった場合に発生していた `union()` ステップの Gremlin のバグを修正しました。
+ 一部のステップが実際に最適化されていても最適化されていないと報告される Gremlin プロファイルのバグを修正しました。
+ `UNION` 句にネストされた `FILTER` 式内で使用される変数に無効なスコープ情報が代入されるという SPARQL のバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.1.0.R4 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.1.0.R4 へのアップグレードパス
エンジンバージョン `1.1.1.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
## このリリースへのアップグレード
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.1.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.1.1.0.R3 (2022-06-07)
2022 年 6 月 7 日現在、エンジンバージョン1.1.1.0.R3 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**注記**
このリリースでは、IAM 認証で openCypher を使用するコードに重大な変更が加えられています。これまでは、IAM シグネチャーのホスト文字列には、`bolt://` など、次のようなプロトコルが含まれていました。
```
"Host":"bolt://(host URL):(port)"
```
エンジンリリース `1.1.1.0` 以降、このプロトコルは省略する必要があります。
```
"Host":"(host URL):(port)"
```
設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このエンジンリリースの改良点
+ メモリを大量に消費するワークロード向けに最適化された Graviton2 `x2g` 搭載インスタンスタイプのサポートが追加されました。これらは当初、次の 4 つの AWS リージョン でのみ利用可能です。
+ 米国東部 (バージニア北部) (`us-east-1`)
+ 米国東部 (オハイオ) (`us-east-2`)
+ 米国西部 (オレゴン) (`us-west-2`)
+ 欧州 (アイルランド) (`eu-west-1`)
詳細については、[Neptune 料金表ページ](https://aws.amazon.com/neptune/pricing/)を参照してください。
+ 複数のエッジまたは頂点のトラバーサル、プロパティ検索、またはラベル検索が必要な Gremlin ステップのパフォーマンスが向上しました。
## このエンジンリリースで修正された不具合
+ 子トラバーサル内の `otherV()` ステップ処理での Gremlin のバグを修正しました。
+ 子としてフィルターステップしか存在しない `union` のクエリの Gremlin のバグを修正しました。例:
```
g.V().union(has("name"), out("knows")).out()
```
+ `UNION`句にネストされた `FILTER` 式内で使用される変数に無効なスコープ情報が代入されるという SPARQL のバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.1.0.R3 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.1.0.R3 へのアップグレードパス
エンジンバージョン `1.1.1.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
## このリリースへのアップグレード
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.1.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune メンテナンスリリース、バージョン 1.1.1.0.R2 (2022-05-16)
2022 年 5 月 16 日現在、エンジンバージョン 1.1.1.0.R2 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードを正常に完了するには、すべてのアベイラビリティーゾーン (AZ) の各サブネットに、Neptune インスタンスごとに利用可能な IP アドレスが少なくとも 1 つ必要です。例えば、サブネット 1 に 1 つのライターインスタンスと 2 つのリーダーインスタンスがあり、サブネット 2 に 2 つのリーダーインスタンスがある場合、アップグレードを開始する前に、サブネット 1 には少なくとも 3 つの IP アドレスの空きがあり、サブネット 2 には少なくとも 2 つの IP アドレスが空いている必要があります。
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**注記**
このリリースでは、IAM 認証で openCypher を使用するコードに重大な変更が加えられています。これまでは、IAM シグネチャーのホスト文字列には、`bolt://` など、次のようなプロトコルが含まれていました。
```
"Host":"bolt://(host URL):(port)"
```
エンジンリリース `1.1.1.0` 以降、このプロトコルは省略する必要があります。
```
"Host":"(host URL):(port)"
```
設定ドキュメントの例については、「[Bolt プロトコルの使用](access-graph-opencypher-bolt.md)」を参照してください。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.1.0.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *サポートされている最も古いバージョンの Gremlin:* `3.5.2`
+ *サポートされている最も新しいバージョンの Gremlin:* `3.5.4`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.1.0.R2 へのアップグレードパス
エンジンバージョン `1.1.1.0` を実行している場合、クラスターは次のメンテナンスウィンドウで自動的にこのメンテナンスパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.1.1.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.1.0.0 (2021-11-19)
2021 年 11 月 19 日現在、エンジンバージョン 1.1.0.0 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードを正常に完了するには、すべてのアベイラビリティーゾーン (AZ) の各サブネットに、Neptune インスタンスごとに利用可能な IP アドレスが少なくとも 1 つ必要です。例えば、サブネット 1 に 1 つのライターインスタンスと 2 つのリーダーインスタンスがあり、サブネット 2 に 2 つのリーダーインスタンスがある場合、アップグレードを開始する前に、サブネット 1 には少なくとも 3 つの IP アドレスの空きがあり、サブネット 2 には少なくとも 2 つの IP アドレスが空いている必要があります。
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**注記**
このエンジンリリース以降、Neptune は[`R4` インスタンスタイプをサポートしなくなりました](instance-types.md#instance-type-r4)。DB クラスター内の `R4` インスタンスを使用している場合は、このリリースにアップグレードする前に、手動で別のインスタンスタイプに置き換える必要があります。ライターインスタンスが `R4` の場合は、[次の手順に従って](best-practices-general-basic.md#best-practices-resize-instance)移動してください。
## このリリースの後続のパッチリリース
+ [メンテナンスリリース: 1.1.0.0.R2 (2022-05-16)](engine-releases-1.1.0.0.R2.md)
+ [メンテナンスリリース: 1.1.0.0.R3 (2022-12-23)](engine-releases-1.1.0.0.R3.md)
## このエンジンリリースの新機能
+ [AWS Graviton2 プロセッサ](https://aws.amazon.com/ec2/graviton/)により稼働する汎用 `T4g` およびメモリ最適化 `R6g` データベースインスタンスを導入しました。Graviton2 ベースのインスタンスは、さまざまなワークロードに対して、同等の現行世代の x86 ベースのインスタンスよりも大幅に優れた価格/パフォーマンスを提供します。アプリケーションは、これらの新しいインスタンスタイプでは通常どおりに動作し、アップグレードするときにポートアプリケーションコードを移植する必要はありません。
料金および使用可能なリージョンに関する詳細については、[Amazon Neptune 料金表ページ](https://aws.amazon.com/neptune/pricing/)を参照してください。
+ Neptune ML に[カスタムモデル](machine-learning-custom-models.md)が導入されました。
+ Neptune ML に [SPARQL 推論クエリ](machine-learning-sparql-inference-queries.md)のサポートが追加されました。
+ プロパティグラフデータ用に[新しいストリームエンドポイント](streams-using-api-call.md)を追加しました。次のようになります。
```
https://Neptune-DNS:8182/propertygraph/stream
```
このエンドポイントの出力形式、つまり、`PG_JSON` は、古い `gremlin/stream` によって出力される `GREMLIN_JSON` フォーマットとまったく同じ動作をします。
新しい `propertygraph/stream` エンドポイントは、Neptune ストリームのサポートを openCypher に拡張し、`gremlin/stream` を、関連付けられたエンドポイント `GREMLIN_JSON` 出力形式に取り替えます。
## このエンジンリリースの改良点
+ Neptune ストリームを改善しました。
+ 変更ログストリーム内の各レコードのタイムスタンプを提供するために、`commitTimestamp` フィールドを `records` オブジェクト [Neptune ストリーム変更ログ応答形式](streams-using-api-reponse.md)に追加しました。
+ ストリームから最後に有効な eventId を取得できるように、`LATEST` 値を `iteratorType` パラメータに追加しました。「[Streams API の呼び出し](streams-using-api-call.md)」を参照してください。
+ Gremlin ノード分類および回帰クエリでの[推論信頼スコア](machine-learning-gremlin-inference-query-predicates.md#machine-learning-gremlin-inference-neptune-ml-score-predicate)取得のサポートが追加されました。
+ openCypher の `OPTIONAL MATCH` 句用のサポートを追加しました。
+ openCypher の `MERGE` 句用のサポートを追加しました。
+ openCypher の `WITH` 句の `ORDER BY` 使用のサポートを追加しました。
+ openCypher でのパターン理解のサポートが追加され、存在チェックを超えるパターン表現のサポートが拡張されました。
+ openCypher で `DELETE` および `DELETE DETACH` のサポートを拡張しました。これにより他の更新句と併用できるようになりました。
+ openCypherで `RETURN` とともに使用される `CREATE` および `UPDATE` のサポートを拡張しました。
+ Gremlin `limit`、`range` および `skip` ステップの DFE エンジンでのサポートを追加しました。
+ `explain` と `profile` のいずれもリクエストされていない場合の DFE エンジンでのクエリ実行が改善されました。
+ `value` 表現に対するDFE エンジンでのクエリ実行を改善しました。
+ 同時変更例外を回避し、次のようなクエリパターンの連鎖を可能にするために、多数の連鎖 Gremlin 条件付き挿入パターンを改善しました。
+ ID による条件付き頂点の挿入 (例)
```
g.V(ID).fold().coalesce(unfold(), g.addV("L1").property(id,ID))
```
+ 次のような複数のラベルを使用した条件付き頂点の挿入
```
g.V(ID).fold().coalesce(unfold(), g.addV("L1::L2").property(id,ID))
```
+ ID による条件付きエッジの挿入 (例)
```
g.E(ID).fold().coalesce(unfold(), V(from).addE(label).to(V(to)).property(id, ID))
```
+ 次のような複数のラベルを使用した条件付きエッジの挿入
```
g.E(ID).fold().coalesce(unfold(), g.addE(label).from(V(from)).to(V(to)).property(id, ID))
```
+ クエリが続く条件付き挿入 (例)
```
g.V(ID).fold().coalesce(unfold(), g.addV("L1").property(id,ID)).project("myvalues").by(valueMap())
```
+ プロパティを追加した条件付き挿入 (例)
```
g.V(ID).fold().coalesce(unfold(), g.addV("L1").property(id,ID).property("name","pumba"))
```
## このエンジンリリースで修正された不具合
+ サポートできなかった `T3.medium` インスタンスタイプの[統計](neptune-dfe-statistics.md)機能を無効にしました。
+ 非定数値を取った `IN` 関数を持つ `explain` にある SPARQL のバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.0.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.11`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.0.0 へのアップグレードパス
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
このリリースに自動的にアップグレードされることはありません。
## このリリースへのアップグレード
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.1.0.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.0.0 ^
4. --allow-major-version-upgrade ^
5. --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 クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune メンテナンスリリース、バージョン 1.1.0.0.R3 (2022-12-23)
2022 年 12 月 23 日現在、エンジンバージョン 1.1.0.0.R3 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードを正常に完了するには、すべてのアベイラビリティーゾーン (AZ) の各サブネットに、Neptune インスタンスごとに利用可能な IP アドレスが少なくとも 1 つ必要です。例えば、サブネット 1 に 1 つのライターインスタンスと 2 つのリーダーインスタンスがあり、サブネット 2 に 2 つのリーダーインスタンスがある場合、アップグレードを開始する前に、サブネット 1 には少なくとも 3 つの IP アドレスの空きがあり、サブネット 2 には少なくとも 2 つの IP アドレスが空いている必要があります。
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
## このエンジンリリースの改良点
+ `repeat`、`coalesce`、`store`、`aggregate` など、さまざまな Gremlin 演算子のパフォーマンスの向上と正確性の修正を行いました。
## このエンジンリリースで修正された不具合
+ CPU スパイクの問題を修正しました。
+ Bolt と SPARQL-JSON でクエリが NULL 値ではなく文字列 `"null"` を返す openCypher のバグを修正しました。
+ 不要な情報がログに記録されたり、特定のフィールドがログから欠落したりする監査ログのバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.0.0.R3 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.11`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.0.0.R3 へのアップグレードパス
エンジンバージョン `1.1.0.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのメンテナンスパッチリリースにアップグレードされます。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**注記**
このエンジンリリース以降、Neptune は[`R4` インスタンスタイプをサポートしなくなりました](instance-types.md#instance-type-r4)。DB クラスター内の `R4` インスタンスを使用している場合は、このリリースにアップグレードする前に、手動で別のインスタンスタイプに置き換える必要があります。ライターインスタンスが `R4` の場合は、[次の手順に従って](best-practices-general-basic.md#best-practices-resize-instance)移動してください。
## このリリースへのアップグレード
Amazon Neptune 1.1.0.0.R3 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.1.0.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.0.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune メンテナンスリリース、バージョン 1.1.1.0.0.R2 (2022-05-16)
2022 年 5 月 16 日現在、エンジンバージョン 1.1.0.0.R2 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターは、この時点で数分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
## このエンジンリリースで修正された不具合
+ ステータスエンドポイントなど、クエリ以外のエンドポイントの内部認証情報キャッシュが適切にクリアされないバグを修正しました。
+ エンジンのアップグレード後にレプリケーションの遅延が長くなるバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.1.0.0.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.11`
+ *openCypher バージョン:* `Neptune-9.0.20190305-1.0`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.1.0.0.R2 へのアップグレードパス
エンジンバージョン `1.1.0.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのメンテナンスパッチリリースにアップグレードされます。
**重要**
**`1.1.0.0` より前のバージョンからこのエンジンリリースにアップグレードすると、DB クラスター内のすべてのインスタンスでオペレーティングシステムのアップグレードもトリガーされます。オペレーティングシステムのアップグレード中に発生するアクティブな書き込み要求は処理されないため、アップグレードを開始する前に、一括データロードを含め、アップグレード中のクラスターへのすべての書き込みワークロードを一時停止する必要があります。**
アップグレードの開始時に、Neptune は `preupgrade` に DB クラスターの情報に基づいて自動生成された識別子が続く名前のスナップショットを生成します。このスナップショットには課金はされません。アップグレードプロセス中に問題が発生した場合は、DB クラスターを復元するために使用できます。
エンジンのアップグレード自体が完了すると、古いオペレーティングシステムで新しいエンジンバージョンが一時的に利用可能になりますが、5 分以内にクラスター内のすべてのインスタンスが同時にオペレーティングシステムのアップグレードを開始します。DB クラスターはこの時点で約 6 分間使用できなくなります。アップグレードの完了後に、書き込みワークロードを再開できます。
このプロセスでは、次のイベントが生成されます。
クラスターごとのイベントメッセージ。
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
インスタンスごとのイベントメッセージ。
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**注記**
このエンジンリリース以降、Neptune は[`R4` インスタンスタイプをサポートしなくなりました](instance-types.md#instance-type-r4)。DB クラスター内の `R4` インスタンスを使用している場合は、このリリースにアップグレードする前に、手動で別のインスタンスタイプに置き換える必要があります。ライターインスタンスが `R4` の場合は、[次の手順に従って](best-practices-general-basic.md#best-practices-resize-instance)移動してください。
## このリリースへのアップグレード
Amazon Neptune 1.1.0.0.R2 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.1.0.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.0.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.5.1 (2021-10-01)
2021 年 10 月 1 日現在、エンジンバージョン1.0.5.1. は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このリリースの後続のパッチリリース
+ [リリース： 1.0.5.1.R2 (2021-10-26)](engine-releases-1.0.5.1.R2.md)
+ [リリース: 1.0.5.1.R3 (2022-01-13)](engine-releases-1.0.5.1.R3.md)
+ [メンテナンスリリース: 1.0.5.1.R4 (2022-05-16)](engine-releases-1.0.5.1.R4.md)
## このエンジンリリースの新機能
+ 指定したクエリの結果をキャッシュするための[結果キャッシュ](gremlin-results-cache.md)が追加されました。
+ Neptune openCypher で日付/時刻のサポートが追加されました。
+ Neptune openCypher の要素への `List` および `Map` アクセスのサポートを追加しました。
## このエンジンリリースの改良点
+ Neptune openCypher エンドポイント名では大文字と小文字は区別されません。
+ openCypher の説明が改善されました。
+ Gremlin シングルアップサートクエリパターンが `iterate()` および `profile()` ステップで終了する問題が改善されました。
+ Gremlin `keys()` および `property()` 関数のパフォーマンスが向上しました。
+ Gremlin `dedup()` ステップは DFE でグローバルスコープとともに使用されるときに実行されます。
+ 次の Gremlin `HAS` 述語は、DFE エンジンが有効な場合、DFE エンジンで実行されます。
+ `EQ`
+ `NEQ`
+ `LT`
+ `LTE`
+ `GT`
+ `GTE`
+ `BETWEEN`
+ `INSIDE`
+ `OUTSIDE`
+ `WITHIN`
+ `AND (connectives)`
+ `OR (connectives)`
+ LIMIT クエリのパフォーマンスが向上しました。
+ openCypher の一般的な集計クエリのパフォーマンスが向上しました。
## このエンジンリリースで修正された不具合
+ エッジを別のエッジに接続できる Gremlin のバグを修正しました。
+ 最適でない結合戦略が選択される Gremlin のバグを修正しました。
+ 100 を超えるプロパティが存在するとノードとリレーションシップのシリアル化が停止する Gremlin のバグを修正しました。
+ グラフパターンが大きいクエリのクエリ実行計画が遅くなるバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.5.1 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.11`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.5.1 へのアップグレードパス
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
このリリースに自動的にアップグレードされることはありません。
## このリリースへのアップグレード
Amazon Neptune 1.0.5.1 が利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.5.1 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.1 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune メンテナンスリリース、バージョン 1.0.5.1.R4 (2022-05-16)
2022 年 5 月 16 日現在、エンジンバージョン 1.0.5.1.R4 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.5.1.R4 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.11`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.5.1.R4 へのアップグレードパス
エンジンバージョン `1.0.5.1` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのメンテナンスパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.5.1.R4 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.5.1 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.1 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.5.1.R3 (2022-01-13)
2022 年 1 月 13 日現在、エンジンバージョン 1.0.5.1.R3 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースで修正された不具合
+ クエリが必要なリソースをすべて取得できなかった場合にリソースリークを引き起こすバグを修正しました。
+ 要求されていないメモリ割り当てが原因で、クエリ実行中に発生していた小さなメモリリークを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.5.1.R3 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.11`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.5.1.R3 へのアップグレードパス
エンジンバージョン `1.0.5.1` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.5.1.R3 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.5.1 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.1 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.5.1.R2 (2021-10-26)
2021 年 10 月 26 日現在、エンジンバージョン 1.0.5.1.R2 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースで修正された不具合
+ 古いバージョンのグラフ要素の作成中に、繰り返し可能な読み取り分離において一時的なエラーが発生したときにサーバーを再起動するバグを修正しました。Neptune は代わりにエラーを返すので、クライアントは再試行できます。
+ 単一のカーディナリティ更新中に一時的なエラーが発生したときにサーバーを再起動するバグを修正しました。Neptune は代わりにエラーを返すので、クライアントは再試行できます。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.5.1.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.11`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.5.1.R2 へのアップグレードパス
エンジンバージョン `1.0.5.1` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.5.1.R2 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.5.1 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.1 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.5.0 (2021-07-27)
2021 年 7 月 27 日現在、エンジンバージョン1.0.5.0. は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このリリースの後続のパッチリリース
+ [リリース： 1.0.5.0.R2 (2021-08-16)](engine-releases-1.0.5.0.R2.md)
+ [リリース： 1.0.5.0.R3 (2021-09-15)](engine-releases-1.0.5.0.R3.md)
+ [メンテナンスリリースバージョン 1.0.5.0.R5 (2022-05-16)](engine-releases-1.0.5.0.R5.md)
## このエンジンリリースの新機能
+ [Neptune ML](machine-learning.md) は、多くの新機能を備えた実稼働用にリリースされ、ラボモードではなくなっています。
+ [openCypher](access-graph-opencypher.md) クエリ言語 (ラボモード)の初期サポートを追加しました。**openCypher** は、Cypher クエリ言語のオープンソース標準です。構文は、[Cypher クエリ言語リファレンス (バージョン 9)](https://s3.amazonaws.com/artifacts.opencypher.org/openCypher9.pdf) に記載されており、[openCypher](http://www.opencypher.org/) プロジェクトによって維持されています。
言語の Neptune の実装については、[openCypher でNeptune グラフにアクセスする](access-graph-opencypher.md) を参照してください。
Neptune クライアントが openCypher クエリに使用する [Bolt プロトコル](https://neo4j.com/docs/bolt/current/bolt/)もサポートされています。「[Bolt プロトコルを使用して openCypher クエリを Neptune に作成する](access-graph-opencypher-bolt.md)」を参照してください。
opencyPher サポートは自動的に有効化されるようになりましたが、 [Neptune DFEエンジン](neptune-dfe-engine.md) に依存し、現在[ラボモード](features-lab-mode.md)でののみ利用可能です。。`DFEQueryEngine` DB クラスターのパラメータのデフォルトである `neptune_lab_mode` 設定が `DFEQueryEngine=viaQueryHint` となりました。つまり、エンジンは有効ですが、`useDFE` クエリヒントが存在し、`true` に設定するためだけのクエリに使われます。`DFEQueryEngine=disabled` を設定して DFE エンジンを無効にすると、openCypher を使用できなくなります。
+ [SPARQL 1.1 Graph Store HTTP プロトコル](https://www.w3.org/TR/sparql11-http-rdf-update/)のサポートを追加しました。「[Amazon Neptune での SPARQL 1.1 グラフストア HTTP プロトコル (GSP) の使用](sparql-graph-store-protocol.md)」を参照してください。
+ [Neptune DFEエンジン](neptune-dfe-engine.md) に対するデフォルトのラボモード設定を `viaQueryHint` へ変更しました。すなわち、DFE エンジンがデフォルトで有効となりますが、`useDFE` クエリヒントが存在し、`true` に設定されているクエリのみに使用されます。
+ Neptune DFE エンジンの統計量の計算を監視するために、新しい Amazon CloudWatch メトリクス、`StatsNumStatementsScanned`、を追加しました。「[`StatsNumStatementsScanned` CloudWatch メトリクス統計を使って計算を監視する](neptune-dfe-statistics.md#neptune-dfe-statistics-monitoring)」を参照してください。
## このエンジンリリースの改良点
+ Apache TinkerPop 3.4.11 のサポートを追加しました。
**重要**
TinkerPop バージョン 3.4.11 に変更が加えられ、クエリの処理方法の正確性が向上しましたが、現時点ではクエリのパフォーマンスに重大な影響を与える場合があります。
たとえば、この種類のクエリの実行速度が大幅に遅くなる可能性があります。
```
g.V().hasLabel('airport').
order().
by(out().count(),desc).
limit(10).
out()
```
TinkerPop 3.4.11 の変更により、制限ステップの後の頂点は、最適ではない方法でフェッチされるようになりました。これを回避するには、barrier() ステップを `order().by()` の次の任意のポイントに追加して、クエリを変更できます。例:
```
g.V().hasLabel('airport').
order().
by(out().count(),desc).
limit(10).
barrier().
out()
```
+ [SPARQL`joinOrder` クエリヒント](sparql-query-hints-joinOrder.md)が、Neptune DFE 代替クエリエンジンでサポートされるようになりました。
+ DB クラスターの設定と機能についてより明確にするために、[Neptune ステータス API](access-graph-status.md) の出力が拡張および再編成されました。
新しい出力には、DB クラスターの機能に関するステータス情報を含む `features` 最上位オブジェクトと、設定情報を含む最上位 `settings` オブジェクトがあります。新しいフォーマットを確認するには、[インスタンスステータスコマンドからの出力例](access-graph-status.md#access-graph-status-sample-output) を参照してください。。
+ `AFTER_SEQUENCE_NUMBER` ストリームがサーバー上の最後のイベント ID で要求され、そのイベント ID がすでに期限切れになっている場合のストリーミング変更ログの処理が改善されました。要求されたイベント ID がサーバー上で最後にパージされたイベント ID である場合、サーバーが期限切れのイベント ID エラーをスローしなくなりました。
## このエンジンリリースで修正された不具合
+ 数値の順序に関する Gremlin のバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.5.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.11`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.5.0 へのアップグレードパス
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
このリリースに自動的にアップグレードされることはありません。
## このリリースへのアップグレード
Amazon Neptune 1.0.5.0 が利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.5.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune メンテナンスリリース、バージョン 1.0.5.0.R5 (2022-05-16)
2022 年 5 月 16 日現在、エンジンバージョン 1.0.5.0.R5 は一般にデプロイされています。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.5.0.R5 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.11`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.5.0.R5 へのアップグレードパス
エンジンバージョン 1.0.5.0 を実行している場合、クラスターは次のメンテナンスウィンドウに自動的にこのメンテナンスパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.5.0.R5 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.5.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.5.0.R3 (2021-09-15)
2021 年 9 月 15 日現在、エンジンバージョン 1.0.5.0.R3 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースで修正された不具合
+ 次のいずれかの状況でエンジンが応答しなくなるバグを修正しました。
+ バルクロードは、自動統計計算の実行と同時に発生します。
+ 統計情報の計算は、すでに発生していると同時に、手動で要求されました。
+ デッドロック検出とロック取得でエンジンがクラッシュするバグを修正しました。
+ Gremlin 推論クエリでリモート ML エンドポイントから不明なデータが検出されたときにエンジンがエラーをスローした Gremlin バグを修正しました。
+ モデル変換ジョブとインスタンスの推奨事項に関連する ML モデル管理 API のいくつかのバグを修正しました。
+ ノード ID とエッジ ID の生成時にエンジンがクラッシュする可能性があることの原因となるバグを修正しました。
+ 大きなグラフパターンを持つクエリのクエリプランの生成が遅くなるバグを修正しました。
+ 100 を超えるプロパティを持つノードを取得するときにクエリが停止する可能性がある openCypher のバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.5.0.R3 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.11`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.5.0.R3 へのアップグレードパス
エンジンバージョン 1.0.5.0 を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.5.0.R3 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.5.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.5.0.R2 (2021-08-16)
2021 年 8 月 16 日現在、エンジンバージョン 1.0.5.0.R2 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースで修正された不具合
+ レプリカでエンジンの再起動が残る [Neptune ルックアップキャッシュ](feature-overview-lookup-cache.md)を作成した[エンジンリリース `1.0.5.0`](engine-releases-1.0.5.0.md)で行われた最適化を無効にしました。レプリカが再起動すると、ルックアップキャッシュがクリアされるようになりました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.5.0.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.11`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.5.0.R2 へのアップグレードパス
エンジンバージョン `1.0.5.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.5.0.R2 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.5.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.4.2 (2021-06-01)
**注記**
エンジンリリースバージョン1.0.4.2.R2 は、1.0.4.2 の実際にリリースされる最初のバージョンでした。
**Topics**
+ [Amazon Neptune エンジンバージョン 1.0.4.2.R5 (2021-08-16)](engine-releases-1.0.4.2.R5.md)
+ [Amazon Neptune エンジンバージョン 1.0.4.2.R4 (2021-07-23)](engine-releases-1.0.4.2.R4.md)
+ [Amazon Neptune エンジンバージョン 1.0.4.2.R3 (2021-06-28)](engine-releases-1.0.4.2.R3.md)
+ [Amazon Neptune エンジンバージョン 1.0.4.2.R2 (2021-06-01)](engine-releases-1.0.4.2.R2.md)
+ [Amazon Neptune エンジンバージョン 1.0.4.2.R1 (2021-05-27)](engine-releases-1.0.4.2.R1.md)
# Amazon Neptune エンジンバージョン 1.0.4.2.R5 (2021-08-16)
2021 年 8 月 16 日現在、エンジンバージョン 1.0.4.2.R5 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースで修正された不具合
+ レプリカでエンジンの再起動が残る [Neptune ルックアップキャッシュ](feature-overview-lookup-cache.md)を作成した[エンジンリリース `1.0.4.2.R4`](engine-releases-1.0.4.2.R4.md)で行われた最適化を無効にしました。レプリカが再起動すると、ルックアップキャッシュがクリアされるようになりました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.4.2.R5 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.10`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.4.2.R5 へのアップグレードパス
エンジンバージョン `1.0.4.2` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
# Amazon Neptune エンジンバージョン 1.0.4.2.R4 (2021-07-23)
2021 年 7 月 23 日現在、エンジンバージョン1.0.4.2.R4 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースの改良点
+ レプリカで高速リセットを実行した後の冗長キャッシュクリアを回避するために、ルックアップキャッシュの動作が改善されました。
+ `AFTER_SEQUENCE_NUMBER` ストリームがサーバー上の最後のイベント ID で要求され、そのイベント ID がすでに期限切れになっている場合のストリーミング変更ログの処理が改善されました。要求されたイベント ID がサーバー上で最後にパージされたイベント ID である場合、サーバーが期限切れのイベント ID エラーをスローしなくなりました。
## このエンジンリリースで修正された不具合
+ クエリが 760 文字を超える文字列値の全体を返さない 1.0.4.0.R1 導入時のバグを修正しました。このバグの影響を受けた項は、RDF リテラルと URI、または Gremlin ID、キー、および文字列値でした。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.4.2.R4 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.10`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.4.2.R4 へのアップグレードパス
エンジンバージョン `1.0.4.2` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
# Amazon Neptune エンジンバージョン 1.0.4.2.R3 (2021-06-28)
2021 年 6 月 28 日現在、エンジンバージョン1.0.4.2.R3 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースの既知の問題
**問題:**
スペースがあると `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"
```
## このエンジンリリースで修正された不具合
+ 高速リセット後にレプリカのルックアップキャッシュをクリアする際のバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.4.2.R3 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.10`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.4.2.R3 へのアップグレードパス
DB クラスターが 1 つ以上の `R5d` インスタンスを使用していない限り、このパッチリリースはオプションです。クラスターに `R5d` インスタンスがある場合、次のメンテナンスウィンドウで自動的にアップグレードされます。そうしないと、このパッチリリースに自動的にアップグレードされません。
リリース`1.0.4.2.R2`を、AWS CLI [apply-pending-maintenance-action](https://docs.aws.amazon.com/cli/latest/reference/neptune/apply-pending-maintenance-action.html) (適用保留中のメンテナンスアクション) コマンド ([ApplyPendingMaintenanceAction](api-other-apis.md#ApplyPendingMaintenanceAction)API) を使用して手動でこの `1.0.4.2.R3` リリースにアップグレードできます。
# 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)](engine-releases-1.0.4.2.R3.md)
## このエンジンリリースの既知の問題
**問題:**
スペースがあると `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 ルックアップキャッシュは読み取りクエリを高速化できます。](feature-overview-lookup-cache.md)」を参照してください。
+ 実験的な DFE エンジンを `useDFE` クエリヒントに基づきクエリ単位でのみ呼び出すことができる新しい lab-mode パラメータが追加されました。
## このエンジンリリースの改良点
+ TinkerPop 3.4.10 のサポートが追加されました。
+ Gremlin スクリプト要求を送信するときの `withStrategies( )` 設定ステップの使用のサポートが追加されました。具体的には、`SubgraphStrategy`、`PartitionStrategy`、`ReadOnlyStrategy`、`EdgeLabelVerificationStrategy` および `ReservedKeysVerificationStrategy` すべてがサポートされています。
+ クエリの途中での `V()` トラバーサルの最適化が追加されました。以前は、このようなトラバーサルは Neptune では最適化されていませんでした。
+ バルクロードの `baseUri` および `namedGraphUri` パラメータとして使用する [RFC 2141 URN](https://tools.ietf.org/html/rfc2141) のサポートを追加しました。
## このエンジンリリースで修正された不具合
+ 不正なクエリが有効として扱われるパーサーの 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 の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.4.2 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.2 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.4.2.R1 (2021-05-27)
エンジンリリース 1.0.4.2.R1 はデプロイされませんでした。
# Amazon Neptune エンジンバージョン 1.0.4.1 (2020-12-08)
2020 年 12 月 8 日現在、エンジンバージョン1.0.4.1. は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このリリースの後続のパッチリリース
+ [リリース： 1.0.4.1.R1.1 (2021-03-22)](engine-releases-1.0.4.1.R1.1.md)
+ [リリース： 1.0.4.1.R2 (2021-02-24)](engine-releases-1.0.4.1.R2.md)
**重要**
[リリース： 1.0.4.0 (2020-10-12)](engine-releases-1.0.4.0.md) は、Amazon Neptune へのすべての接続で TLS 1.2 と HTTPS を必須にしました。しかし、このリリースのバグにより、HTTPS 接続の強制を防ぐために以前に DB クラスターパラメーターを設定したお客様に対して、HTTP 接続や古くなった TLS 接続が機能し続けていました。
このバグはパッチリリース [1.0.4.0.R2](engine-releases-1.0.4.0.R2.md) および [1.0.4.1.R2](engine-releases-1.0.4.1.R2.md) で修正されましたが、この修正によりパッチが自動的にインストールされるときに、予期しない接続エラーが生じるようになりました。このため、両方のパッチは元に戻され、TLS 1.2 のセットアップを更新できるよう、手動でのみインストールできます。
Neptune へのすべての接続に SSL/TLS を使用することで、Gremlin コンソール、Gremlin ドライバー、Gremlin Python、.NET、nodeJs、REST API、およびロードバランサー接続との接続に影響します。これまで HTTP または古い TLS バージョンをこれらの一部またはすべてに使用していた場合は、最新のパッチにシステムアップデートする前に関連するクライアントとドライバを更新し、HTTPS のみを使用するようにコードを変更する必要があります。
## このエンジンリリースの新機能
+ Amazon Neptune に強力な機械学習機能を提供する Neptune ML 機能を導入しました。「[グラフ上の機械学習のための Amazon Neptune ML](machine-learning.md)」を参照してください。
+ リモートソースから取得したデータを削除するためのカスタム SPARQL `UNLOAD` オペレーションを追加しました。「[SPARQL UPDATE UNLOAD](sparql-api-reference-unload.md)」を参照してください。
## このエンジンリリースの改良点
+ 同時変更例外を回避するために、Gremlin 条件付き挿入パターンをいくつか最適化しました。
## このエンジンリリースで修正された不具合
+ `as()` ステップを使用する特定のパターンのクエリに対して結果が欠損する場合がある Gremlin のバグを修正しました。
+ `project()` のような別のステップ内にネストされている `union()` ステップを使用するとエラーとなる場合があったGremlin のバグを修正しました。
+ `project()` ステップで Gremlin のバグを修正しました。
+ `none()` ステップがうまくいかなかった文字列ベースのトラバーサルの Gremlin のバグを修正しました。
+ `inject()` ステップに対して空のマップが引数としてサポートされていない文字列ベースのトラバーサルのグレムリンのバグを修正しました。。
+ `toList()` が正常に動作しないなどのDFE エンジンでの文字列ベースのトラバーサル実行における Gremlin のバグを修正しました。
+ 文字列クエリの `iterate()` ステップ使用時にトランザクションを閉じない Gremlin のバグを修正しました。
+ `is(P.gte(0))` パターン使用時にクエリが特定の状況において例外をスローする場合があった Gremlin のバグを修正しました。
+ `order().by(T.id)` パターン使用時にクエリが特定の状況において例外をスローする場合があった Gremlin のバグを修正しました。
+ `addV().aggregate()` パターン使用時にクエリが特定の状況において間違った結果となる場合があった Gremlin のバグを修正しました。
+ `path()` ステップの後に `project()` パターンを使用する際にクエリが特定の状況において例外をスローする場合があった Gremlin のバグを修正しました。
+ `SUBSTR` 関数が、空の文字列を返す代わりにエラーを通知する SPARQL のバグを修正しました。
+ 非ブロッキングクエリプランでの結合操作が、バインドされていない変数の存在下で誤った結果を生成する可能性があった DFE エンジンのバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.4.1 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.8`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.4.1 へのアップグレードパス
エンジンバージョン `1.0.4.1` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.4.1 が公開されました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.4.1 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.1 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.4.1.R1.1 (2021-03-22)
2021 年 3 月 22 日現在、エンジンバージョン 1.0.4.1.R1.1 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースで修正された不具合
+ 既存のラベルとプロパティに追加または添付できる Gremlin 条件付き挿入パターンの最適化を無効にしました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.4.1.R1.1 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.8`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.4.1.R1.1 へのアップグレードパス
エンジンバージョン `1.0.4.1` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
## このリリースへのアップグレード
Amazon Neptune 1.0.4.1.R1.1 が公開されました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.4.1 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.1 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.4.1.R2 (2021-02-24)
2021 年 2 月 24 日現在、エンジンバージョン 1.0.4.1.R2 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このリリースの後続のパッチリリース
+ [リリース：1.0.4.1.R2.1 (2021-03-11)](engine-releases-1.0.4.1.R2.1.md)
## このエンジンリリースの新機能
+ Neptune は、`bzip2` 形式の単一ファイルの圧縮をサポートしています。「[ロードデータ形式](bulk-load-tutorial-format.md)」を参照してください。
## このエンジンリリースで修正された不具合
+ [リリース： 1.0.4.0 (2020-10-12)](engine-releases-1.0.4.0.md) と TLS 1.2 ではなく `HTTP` または、TLSの以前のバージョンを使用して Neptune への接続ができた `HTTPS` のバグを修正しました。
**重要**
**Neptune へのすべての接続に SSL/TLS を使用しなければならないことは、大きな変更になる可能性があります。**これは、Gremlin コンソール、Gremlin ドライバー、Gremlin Python、.NET、nodeJs、REST API、およびロードバランサー接続との接続に影響します。これまで HTTP または古い TLS バージョンをこれらの一部またはすべてに使用していた場合は、このパッチをインストールする前に関連するクライアントとドライバを更新し、HTTPS のみを使用するようにコードを変更する必要があります。
+ `InternalFailureException` が発生した際に特定の状況において、レスポンスコードとして `ConcurrentModificationException` が設定されるという Gremlin のバグを修正しました。
+ 特定の条件下でエッジや頂点を更新すると過渡 `InternalFailureException` が発生する可能性がある Gremlin バグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.4.1.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.8`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.4.1.R2 へのアップグレードパス
エンジンバージョン `1.0.4.1` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
## このリリースへのアップグレード
Amazon Neptune 1.0.4.1.R2 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.4.1 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.1 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.4.1.R2.1 (2021-03-11)
2021 年 3 月 11 日現在、エンジンバージョン 1.0.4.1.R2.1 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースで修正された不具合
+ 既存のラベルとプロパティに追加または添付できる Gremlin 条件付き挿入パターンの最適化を無効にしました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.4.1.R2.1 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.8`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.4.1.R2.1 へのアップグレードパス
エンジンバージョン `1.0.4.1.R2` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.4.1.R2.1 が公開されました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.4.1.R2 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.1.R2 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.4.0 (2020-10-12)
2020 年 10 月 12 日現在、エンジンバージョン1.0.4.0. は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このリリースの後続のパッチリリース
+ [リリース： 1.0.4.0.R2 (2021-02-24)](engine-releases-1.0.4.0.R2.md)
## このエンジンリリースの新機能
+ Gremlin のフレームレベルの圧縮を追加しました。
## このエンジンリリースの改良点
+ Amazon Neptune では、次の強力な暗号スイートを使用して、すべてのリージョンで Neptune へのすべての接続に TLSv1.2 プロトコルで Secure Sockets Layer (SSL) を使用する必要があります。
+ `TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384`
+ `TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256`
+ `TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384`
+ `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256`
+ `TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA`
+ `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA`
これは、Neptune への REST 接続と WebSocket 接続の両方に当てはまります。すべてのリージョンで Neptune に接続する場合は、HTTP ではなく HTTPS を使用する必要があることを意味します。
HTTP または TLS 1.1 を使用するクライアント接続はどこでもサポートされなくなるため、このエンジンリリースにアップグレードする前に、クライアントとコードが TLS 1.2 および HTTPS を使用するように更新されていることを確認してください。
**重要**
**Neptune へのすべての接続に SSL/TLS を使用しなければならないことは、大きな変更になる可能性があります。**これは、Gremlin コンソール、Gremlin ドライバー、Gremlin Python、.NET、nodeJs、REST API、およびロードバランサー接続との接続に影響します。これらのいずれかまたはすべてに HTTP を使用している場合は、関連するクライアントとドライバを更新し、HTTPS を使用するようにコードを変更する必要があります。そうしないと、接続が失敗します。
このリリースのバグにより、HTTPS 接続の強制を防ぐために以前に DB クラスターパラメーターを設定したお客様に対して、HTTP 接続や古くなった TLS 接続が機能し続けることができました。このバグはパッチリリース [1.0.4.0.R2](engine-releases-1.0.4.0.R2.md) および [1.0.4.1.R2](engine-releases-1.0.4.1.R2.md) で修正されましたが、この修正によりパッチが自動的にインストールされるときに、予期しない接続エラーが生じるようになりました。
このため、両方のパッチは元に戻され、TLS 1.2 のセットアップを更新できるよう、手動でのみインストールできます。
+ TinkerPop 3.4.8 にアップグレードされました。これは下位互換のアップグレードです。詳細については、[TinkerPop の変更ログ](https://github.com/apache/tinkerpop/blob/master/CHANGELOG.asciidoc#tinkerpop-348-release-date-august-3-2020)を参照してください。
+ `properties()` ステップの Gremlin のパフォーマンスが改善されました。
+ `BindOp` および `MultiplexerOp` 説明レポートとプロファイルレポートに関する詳細の追加。
+ キャッシュミスがある場合のパフォーマンスを向上させるために、データのプリフェッチを追加しました。
+ 新しい追加されました。CSV ロードで空の文字列を有効なプロパティ値として処理できるようにするバルクローダーの `parserConfiguration` パラメータで `allowEmptyStrings` 設定を追加しました ([Neptune ローダーのリクエストパラメータ](load-api-reference-load.md#load-api-reference-load-parameters) を参照)。
+ ローダーでは、複数値の CSV 列でエスケープされたセミコロンを使用できるようになりました。
## このエンジンリリースで修正された不具合
+ `both()` ステップに関連する Gremlin メモリリークの可能性を修正しました。
+ 「/」で終わるエンドポイントが正しく処理されないため、リクエストメトリクスが欠落していたバグを修正しました。
+ DFE エンジンがラボモードで有効になっているときに、レプリカが重い負荷で停止して再起動するバグを修正しました。
+ メモリ不足が原因でバルクロードが失敗したときに、正しいエラーメッセージが報告されないバグを修正しました。
+ SPARQL クエリレスポンスの Content-Encoding ヘッダーに文字エンコーディングが配置された SPARQL バグを修正しました。`charset` が代わりに Content-Type ヘッダーに配置され、HTTP クライアントが使用されている文字セットを自動的に認識できるようになります。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.4.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.8`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.4.0 へのアップグレードパス
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
このリリースに自動的にアップグレードされることはありません。
## このリリースへのアップグレード
Amazon Neptune 1.0.4.0 が利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.4.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.4.0.R2 (2021-02-24)
2021 年 2 月 24 日現在、エンジンバージョン 1.0.4.0.R2 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースで修正された不具合
+ [リリース： 1.0.4.0 (2020-10-12)](engine-releases-1.0.4.0.md) と TLS 1.2 ではなく `HTTP` または、TLSの以前のバージョンを使用して Neptune への接続ができた `HTTPS` のバグを修正しました。
**重要**
**Neptune へのすべての接続に SSL/TLS を使用しなければならないことは、大きな変更になる可能性があります。**これは、Gremlin コンソール、Gremlin ドライバー、Gremlin Python、.NET、nodeJs、REST API、およびロードバランサー接続との接続に影響します。これまで HTTP または古い TLS バージョンをこれらの一部またはすべてに使用していた場合は、このパッチをインストールする前に関連するクライアントとドライバを更新し、HTTPS のみを使用するようにコードを変更する必要があります。
+ `#` で終わるラベルを含む CSV 一括ロードのバグを修正しました。
+ `InternalFailureException` が発生した際に特定の状況において、レスポンスコードとして `ConcurrentModificationException` が設定されるという Gremlin のバグを修正しました。
+ 特定の条件下でエッジや頂点を更新すると過渡 `InternalFailureException` が発生する可能性がある Gremlin バグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.4.0.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.8`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.4.0.R2 へのアップグレードパス
エンジンバージョン `1.0.4.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.4.0.R2 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.4.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.3.0 (2020-08-03)
2020 年 8 月 3 日現在、エンジンバージョン1.0.3.0. は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このリリースの後続のパッチリリース
+ [リリース： 1.0.3.0.R2 (2020-10-12)](engine-releases-1.0.3.0.R2.md)
+ [リリース： 1.0.3.0.R3 (2021-02-19)](engine-releases-1.0.3.0.R3.md)
## このエンジンリリースの新機能
+ Neptune は、クエリの実行を大幅に高速化できる、新しい代替クエリエンジン (DFE) を導入しました。「[Amazon Neptune 代替クエリエンジン (DFE)](neptune-dfe-engine.md)」を参照してください。
+ DFE は、新しい統計エンドポイントを介して管理される Neptune グラフデータに関する事前生成された統計情報に依存します。「[DFE 統計](neptune-dfe-statistics.md)」を参照してください。
+ 新しい `includeQueuedLoads` パラメータを FALSE に設定することで Loader Get-Status API によって返されるロード ID のリストからキューに入れられたロードジョブを除外できるようになりました。「[Neptune Loader Get-Status リクエストパラメータ](load-api-reference-status-requests.md#load-api-reference-status-parameters)」を参照してください。
+ Neptune は、応答チャンクを返し始めた後にリクエストが失敗した場合にエラーコードとメッセージを含むことができる SPARQL クエリレスポンスの末尾ヘッダーをサポートするようになりました。「[マルチパートの SPARQL レスポンスのオプションの HTTP 末尾ヘッダー](access-graph-sparql-http-trailing-headers.md)」を参照してください。
+ Neptune は、Gremlin クエリのチャンク応答エンコーディングを有効化できるようになりました。SPARQL の場合と同様に、応答チャンクには末尾のヘッダーがあり、クエリが応答チャンクを返し始めた後にエラーが発生した場合、エラーコードとメッセージを含めることができます。「[オプションの HTTP 末尾ヘッダーを使用して、複数パートの Gremlin 応答を有効にする](access-graph-gremlin-rest-trailing-headers.md)」を参照してください。
## このエンジンリリースの改良点
+ Gremlin でフルテキスト検索用のバッチリクエストのサイズを ElasticSearch に提供できるようになりました。
+ SPARQL GROUP BY クエリのメモリ使用量が改善されました。
+ 特定の非バインドフィルターをプルーニングする新しい Gremlin クエリオプティマイザを追加しました。
+ IAM を使用して認証された WebSocket 接続をオープン状態に保つことができる最大時間を 36 時間から 10 日に延長しました。
## このエンジンリリースで修正された不具合
+ POST リクエストでエンコードされていない URL パラメータを送信すると、Neptune が HTTP ステータスコード 500 と `InternalServerErrorException` を返したバグを修正しました。現在、Neptune は HTTP ステータスコード 400 と `BadRequestException` を返し `Failure to process the POST request parameters` というメッセージが表示されます。
+ WebSocket 接続の失敗が正しく報告されない Gremlin のバグを修正しました。
+ sideEffects の消失に関する Gremlin のバグを修正しました。
+ フルテキスト検索 `batchsize` パラメータが正しくサポートされていないという Gremlin のバグを修正しました。
+ `toV` に関する各方向に対して `fromV` および `bothE` を個別に処理するGremlin のバグを修正しました。
+ `Edge pathType` ステップの `hasLabel` に関する Gremlin のバグを修正しました。
+ 静的バインディングによるジョインの並べ替えが正しく動作しない SPARQL バグを修正しました。
+ 利用できない Amazon S3 バケットが正しく報告されない SPARQL UPDATE LOAD のバグを修正しました。
+ サブクエリ内のサービスノードに関する問題が正しく報告されない SPARQL バグを修正しました。
+ ネストされた FILTER EXISTS または FILTER NOT EXISTS 条件を含むクエリが適切に評価されない SPARQL のバグを修正しました。
+ 生成クエリを使用して SPARQL サービスエンドポイントを呼び出すときに、生成された重複バインディングを正しく処理するように SPARQL バグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.3.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.3`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.3.0 へのアップグレードパス
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
クラスターの `AutoMinorVersionUpgrade` パラメータが `True` に設定されている場合、クラスターは、このリリース日から 2～3 週間後、メンテナンス期間中に自動的にこのエンジンリリースにアップグレードされます。
## このリリースへのアップグレード
Amazon Neptune 1.0.3.0 が公開されました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.3.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.3.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.3.0.R3 (2021-02-19)
2021 年 2 月 19 日現在、エンジンバージョン 1.0.3.0.R3 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースで修正された不具合
+ `#` で終わるラベルを含む CSV 一括ロードのバグを修正しました。
+ `as()` ステップを使用する特定のパターンのクエリに対して結果が欠損する場合がある Gremlin のバグを修正しました。
+ `union()` のような別のステップ内にネストされている `project()` ステップを使用するとエラーとなる場合があった Gremlin のバグを修正しました。
+ `toList()` のような終了メソッドが用いられる際に実験的な DFE エンジンにおいて文字列トラバーサル実行にあった Gremlin のバグを修正しました。
+ 文字列クエリの `iterate()` ステップ使用時にトランザクションを閉じない Gremlin のバグを修正しました。
+ 特定の条件下で例外をスローする `is(P.gte(0))` パターン使用時にクエリが生じる場合があった Gremlin のバグを修正しました。
+ `ConcurrentModificationException` が発生した際に特定の状況において、レスポンスコードとして `InternalFailureException` が設定されるという Gremlin のバグを修正しました。
+ 特定の条件下でエッジや頂点を更新すると過渡 `InternalFailureException` が発生する可能性がある Gremlin バグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.3.0.R3 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.8`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.3.0.R3 へのアップグレードパス
エンジンバージョン `1.0.3.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.3.0.R3 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.3.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.3.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.3.0.R2 (2020-10-12)
2020 年 10 月 12 日現在、エンジンバージョン 1.0.3.0.R2 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースの改良点
+ `properties()` ステップの Gremlin のパフォーマンスが改善されました。
+ `BindOp` および `MultiplexerOp` 説明レポートとプロファイルレポートに関する詳細の追加。
+ SPARQL クエリレスポンスについて、`charset` を Content-Type ヘッダーに追加し、HTTP クライアントが使用されている文字セットを自動的に認識できるようにします。
## このエンジンリリースで修正された不具合
+ `CancellationException` が処理されないという SPARQL のバグを修正しました。
+ ネストされたオプションを含むクエリが正しく動作しない SPARQL バグを修正しました。
+ `ConcurrentModificationException` によりクエリがハングする可能性があった SPARQL のバグを修正しました。
+ クエリ応答が gzip 圧縮されない SPARQL バグを修正しました。
+ `groupBy()` ステップで Gremlin のバグを修正しました。
+ `local()` ステップの内側にある `aggregate()` ステップの使用に関連する Gremlin のバグを修正しました。
+ 集計値を使用する述語が続く `bothE()` の使用に関連する Gremlin のバグを修正しました。
+ `bothE()` ステップによる `repeat()` ステップの使用に関連する Gremlin のバグを修正しました。
+ `both()` ステップに関連する Gremlin メモリリークの可能性を修正しました。
+ 「/」で終わるエンドポイントが正しく処理されないため、リクエストメトリクスが欠落していたバグを修正しました。
+ リクエストキューがいっぱいでない場合でも `ThrottlingException` が発生する可能性があるバグを修正しました。
+ `LOAD_DATA_FAILED_DUE_TO_FEED_MODIFIED_OR_DELETE` のような理由でロードが失敗したときにロードステータスを取得するバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.3.0.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.3`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.3.0.R2 へのアップグレードパス
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
クラスターの `AutoMinorVersionUpgrade` パラメータが `True` に設定されている場合、クラスターは、このリリース日から 2～3 週間後、メンテナンス期間中に自動的にこのエンジンリリースにアップグレードされます。
## このリリースへのアップグレード
Amazon Neptune 1.0.3.0.R2 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.3.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.3.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.2.2 (2020-03-09)
2020 年 3 月 9 日現在、エンジンバージョン1.0.2.2. は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このリリースの後続のパッチリリース
+ [リリース： 1.0.2.2.R2 (2020-04-02)](engine-releases-1.0.2.2.R2.md)
+ [リリース： 1.0.2.2.R3 (2020-07-22)](engine-releases-1.0.2.2.R3.md)
+ [リリース： 1.0.2.2.R4 (2020-07-23)](engine-releases-1.0.2.2.R4.md)
+ [リリース：1.0.2.2.R5 (2020-10-12)](engine-releases-1.0.2.2.R5.md)
+ [リリース： 1.0.2.2.R6 (2021-02-19)](engine-releases-1.0.2.2.R6.md)
## このエンジンリリースの改良点
+ ロールバック中のトランザクションに関するステータス API に情報を追加しました。「[インスタンスのステータス](access-graph-status.md)」を参照してください。
+ Apache TinkerPop のバージョンを 3.4.3 にアップグレードしました。
バージョン 3.4.3 は、Neptune (3.4.1) でサポートされている以前のバージョンとの下位互換性があります。このバージョンには動作に小さな変更が 1 つあり、存在しないセッションを閉じようとすると、Gremlin はエラーを返さなくなりました (「[Prevent error when closing sessions that don't exist](https://issues.apache.org/jira/browse/TINKERPOP-2237)」を参照)。
+ Gremlin 全文検索ステップの実行におけるパフォーマンスのボトルネックを解消しました。
## このエンジンリリースで修正された不具合
+ クエリでの空のグラフパターン処理における SPARQL バグを修正しました。
+ URL エンコードされたクエリのエンコードされていないセミコロンの処理における SPARQL バグを修正しました。
+ `Union` ステップで繰り返される頂点の処理における Gremlin のバグを修正しました。
+ `.simplePath()` 内の `.cyclicPath()` または `.repeat()` の一部のクエリが誤った結果を返す原因となっていた Gremlin のバグを修正しました。
+ 子トラバーサルがソリューションを返さなかった場合に、`.project()` が誤った結果を返す原因となっていた Gremlin バグを修正しました。
+ 読み取り/書き込みの競合によるエラーによって、`InternalFailureException` ではなく `ConcurrentModificationException` が発生していた Gremlin のバグを修正しました。
+ `.group().by(...).by(values("property"))` 失敗の原因となっていた Gremlin のバグを修正しました。
+ 全文検索ステップのプロファイル出力における Gremlin のバグを修正しました。
+ Gremlin セッションでのリソースリークを修正しました。
+ ステータス API が注文可能な正しいバージョンを報告できないバグを修正しました。
+ バルクロードリクエストでソースとして使用する Amazon S3 以外の場所への URL を許可するバルクローダーのバグを修正しました。
+ 詳細なロードステータスのバルクローダーのバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.2.2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.3`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.2.2 へのアップグレードパス
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
クラスターの `AutoMinorVersionUpgrade` パラメータが `True` に設定されている場合、クラスターは、このリリース日から 2～3 週間後、メンテナンス期間中に自動的にこのエンジンリリースにアップグレードされます。
## このリリースへのアップグレード
Amazon Neptune 1.0.2.2 が公開されました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.2 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.2 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.2.2.R6 (2021-02-19)
2021 年 2 月 19 日現在、エンジンバージョン1.0.2.2.R6 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースで修正された不具合
+ `ConcurrentModificationException` が発生した際に特定の状況において、レスポンスコードとして `InternalFailureException` が設定されるという Gremlin のバグを修正しました。
+ 特定の条件下でエッジや頂点を更新すると過渡 `InternalFailureException` が発生する可能性がある Gremlin バグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.2.2.R6 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.8`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.2.2.R6 へのアップグレードパス
エンジンバージョン `1.0.2.2` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.2.2.R6 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.2 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.2 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.2.2.R5 (2020-10-12)
2020 年 10 月 12 日現在、エンジンバージョン1.0.2.2.R5 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースの改良点
+ `properties()` ステップの Gremlin のパフォーマンスが改善されました。
+ `BindOp` および `MultiplexerOp` 説明レポートとプロファイルレポートに関する詳細の追加。
+ SPARQL クエリレスポンスについて、`charset` を Content-Type ヘッダーに追加し、HTTP クライアントが使用されている文字セットを自動的に認識できるようにします。
## このエンジンリリースで修正された不具合
+ `CancellationException` が処理されないという SPARQL のバグを修正しました。
+ ネストされたオプションを含むクエリが正しく動作しない SPARQL バグを修正しました。
+ `ConcurrentModificationException` によりクエリがハングする可能性があった SPARQL のバグを修正しました。
+ クエリ応答が gzip 圧縮されない SPARQL バグを修正しました。
+ `groupBy()` ステップで Gremlin のバグを修正しました。
+ `local()` ステップの内側にある `aggregate()` ステップの使用に関連する Gremlin のバグを修正しました。
+ 集計値を使用する述語が続く `bothE()` の使用に関連する Gremlin のバグを修正しました。
+ `bothE()` ステップによる `repeat()` ステップの使用に関連する Gremlin のバグを修正しました。
+ `both()` ステップに関連する Gremlin メモリリークの可能性を修正しました。
+ 「/」で終わるエンドポイントが正しく処理されないため、リクエストメトリクスが欠落していたバグを修正しました。
+ リクエストキューがいっぱいでない場合でも `ThrottlingException` が発生する可能性があるバグを修正しました。
+ `LOAD_DATA_FAILED_DUE_TO_FEED_MODIFIED_OR_DELETE` のような理由でロードが失敗したときにロードステータスを取得するバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.2.2.R5 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.3`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.2.2.R5 へのアップグレードパス
エンジンバージョン `1.0.2.2` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.2.2.R5 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.2 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.2 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.2.2.R4 (2020-07-23)
2020 年 7 月 23 日現在、エンジンバージョン1.0.2.2.R4 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースの改良点
+ 未使用のメモリをより頻繁にオペレーティングシステムに解放することでメモリ使用量を改善しました。
+ SPARQL GROUP BY クエリのメモリ使用率も改善されました。
+ IAM を使用して認証された WebSocket 接続をオープン状態に保つことができる最大時間を 36 時間から 10 日に延長しました。
+ クエリのレイテンシーの診断とインスタンスタイプのチューニングに役立つ `BufferCacheHitRatio` CloudWatch メトリクスが追加されました。「[Neptune メトリクス](cw-metrics.md#cw-metrics-available)」を参照してください。
## このエンジンリリースで修正された不具合
+ アイドル状態または期限切れの IAM WebSocket 接続を閉じるバグを修正しました。Neptune は、接続を閉じる前に閉じるフレームを送信するようになりました。
+ ネストされた FILTER EXISTS および / または FILTER NOT EXISTS 条件を含むクエリの評価における SPARQL のバグを修正しました。
+ 特定の極端な条件下でサーバーにブロックされたスレッドが発生した SPARQL クエリ終了バグを修正しました。
+ `hasLabel` ステップの Edge pathType に関する Gremlin のバグを修正しました。
+ `bothE` に関する各方向に対して`toV` および `fromV` を個別に処理するGremlin のバグを修正しました。
+ sideEffects の消失に関する Gremlin のバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.2.2.R4 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.3`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.2.2.R4 へのアップグレードパス
エンジンバージョン `1.0.2.2` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.2.2.R4 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.2 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.2 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.2.2.R3 (2020-07-22)
エンジンリリース1.0.2.2.R3 は[エンジンリリース 1.0.2.2.R4](engine-releases-1.0.2.2.R4.md) に組み込まれています。
# Amazon Neptune エンジンバージョン 1.0.2.2.R2 (2020-04-02)
2020 年 4 月 2 日現在、エンジンバージョン1.0.2.2.R2 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースの改良点
+ 最大 64 個の一括ロードジョブをキューに入れることができるようになりました。ジョブが終了するのを待って次のジョブを開始する必要はありません。また、`dependencies` コマンドの `load` パラメータを使用して、以前にキューに入った 1 つ以上のロードジョブの正常な完了を条件に、キューに入っているロードリクエストを実行することもできます。「[Neptune ローダーコマンド](load-api-reference-load.md)」を参照してください。
+ 全文検索出力をソートできるようになりました ([フルテキスト検索パラメータ](full-text-search-parameters.md) を参照)。
+ Neptune ストリームを呼び出すための DB クラスターパラメータが用意されました。この機能はラボモードから移行されています。「[Neptune Streams の有効化](streams-using-enabling.md)」を参照してください。
## このエンジンリリースで修正された不具合
+ インスタンスの作成を遅らせる、サーバー起動時の確率的な障害を修正しました。
+ クエリ内の `BIND` ステートメントが結合順序計画でオプティマイザを非選択パターンで開始するという、オプティマイザの問題を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.2.2.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.3`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.2.2.R2 へのアップグレードパス
エンジンバージョン `1.0.2.2` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.2.2.R2 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.2 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.2 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.2.1 (2019-11-22)
## このリリースの後続のパッチリリース
+ [リリース：1.0.2.1.R6 (2020-04-22)](engine-releases-1.0.2.1.R6.md)
+ [リリース：1.0.2.1.R5（2020-04-22）](engine-releases-1.0.2.1.R5.md) *このパッチリリースはデプロイされませんでした。*
+ [リリース：1.0.2.1.R4（2019-12-20）](engine-releases-1.0.2.1.R4.md)
+ [リリース：1.0.2.1.R3 (2019-12-12)](engine-releases-1.0.2.1.R3.md)
+ [リリース：1.0.2.1.R2 (2019-11-25)](engine-releases-1.0.2.1.R2.md)
## このエンジンリリースの新機能
+ Amazon OpenSearch Service との統合により、フルテキスト検索機能を追加しました。[Neptune フルテキスト検索](full-text-search.md) を参照してください。
+ 多数の述語に対して 4 番目のインデックス (OSGP インデックス) を作成するためにラボモードを使用するオプションを追加しました。「[OSGP インデックス](features-lab-mode.md#features-lab-mode-features-osgp-index)」を参照してください。
+ SPARQL Explain に*詳細*モードを追加しました。詳細については、「[SPARQL `explain` を使う](sparql-explain-using.md)」と「[詳細モード出力](sparql-explain-examples.md#sparql-explain-example-details)」を参照してください。
+ エンジンステータスレポートにラボモード情報を追加しました。詳細については、「[インスタンスのステータス](access-graph-status.md)」を参照してください。
+ DB クラスターのスナップショットを AWS リージョン間でコピーできるようになりました。「[スナップショットのコピー](backup-restore-copy-snapshot.md)」を参照してください。
## このエンジンリリースの改良点
+ 多数の述語を処理する際のパフォーマンスが向上しました。
+ クエリの最適化が強化されました。これはお客様には完全に透過的ですが、アプリケーションをアップグレードする前にテストし、正常に動作することを確認することをお勧めします。
+ エラー報告のマイナーな機能強化。
+ Gremlin の `.project()` ステップと `.identity()` ステップの最適化を追加しました。
+ 非ターミナル Gremlin の `.union()` ケースの最適化を追加しました。
+ Gremlin `.path().by()` トラバーサルのネイティブサポートを追加しました。
+ Gremlin `.coalesce()` のネイティブサポートを追加しました。
+ 一括書き込みのさらなる最適化。
+ HTTPS 接続では、期限切れの安全でない暗号が使用されないように、TLS バージョン 1.2 以上の使用が要求されるようになりました。
## このエンジンリリースで修正された不具合
+ Gremlin `addE()` 内部トラバーサル処理のバグを修正しました。
+ AST 注釈が子トラバーサルから親にリークすることで引き起こされる Gremlin のバグを修正しました。
+ `.otherV()` が `select()` の後で呼び出されたときに Gremlin で発生するバグを修正しました。
+ `.hasLabel()` ステップの後に表示された場合、一部の `bothE()` ステップが失敗する原因となった Gremlin のバグを修正しました。
+ Gremlin の .sum() と .project() のマイナーな修正を行いました。
+ 閉じ括弧がない SPARQL クエリの処理に伴うバグを修正しました。
+ SPARQL Explain のいくつかのマイナーなバグを修正しました。
+ 複数のロードステータス取得リクエストの同時処理に伴うバグを修正しました。
+ 一部の Gremlin トラバーサルを `.project()` ステップで実行する際に消費されるメモリを削減しました。
+ SPARQL での特殊値の数値比較を修正しました。「[標準コンプライアンス](feature-overview-standards-compliance.md)」を参照してください。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.2.1 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.1`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.2.1 へのアップグレードパス
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
このリリースに自動的にアップグレードされることはありません。
## このリリースへのアップグレード
Amazon Neptune 1.0.2.1 が公開されました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.1 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.2.1.R6 (2020-04-22)
2020 年 4 月 22 日現在、エンジンバージョン1.0.2.1.R6 は一般にご利用いただけます。新しいリリースがすべてのリージョンで利用可能になるまでに数日かかります。
## このエンジンリリースで修正された不具合
+ `ConcurrentModificationConflictException` と `TransactionException` が `NeptuneGremlinException` に変換されず、`InternalFailureException` がお客様に返送される不具合を修正しました。
+ サーバーの準備が完了する前に、Neptune によりステータスが正常と報告されるバグを修正しました。
+ 2 つの `value->id` マッピングを同時に挿入すると、ディクショナリとユーザートランザクションのコミットが機能しない不具合を修正しました。
+ ロードステータスのシリアル化の不具合を修正しました。
+ Gremlin セッションの不具合を修正しました。
+ サーバーの起動に失敗したときに、Neptune により例外がスローされない不具合を修正しました。
+ チャンネルを閉じる前に Neptune がウェブソケットクローズフレームを送信できない不具合を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.2.1.R6 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.1`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.2.1.R6 へのアップグレードパス
エンジンバージョン `1.0.2.1` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.2.1.R6 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.1 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.2.1.R5 (2020-04-22)
エンジンリリース 1.0.2.1.R5 はデプロイされませんでした。
# Amazon Neptune エンジンバージョン 1.0.2.1.R4 (2019-12-20)
## このエンジンリリースの改良点
+ Neptune は、すべてのフルテキスト検索呼び出しを実行パイプラインで常に最初に試行するようになりました。これにより、OpenSearch への呼び出し量が減り、パフォーマンスが大幅に向上します。「[フルテキスト検索クエリの実行](full-text-search-query-execution.md)」を参照してください。
+ Neptune は、存在しないプロパティ、頂点、エッジにアクセスしようとした場合に `IllegalArgumentException` を発生させるようになりました。以前は、Neptune ではその状況で `UnsupportedOperationException` が発生しました。
たとえば、存在しない頂点を参照するエッジを追加しようとすると、`IllegalArgumentException` が発生します。
## このエンジンリリースで修正された不具合
+ `union` 内部の `project-by` トラバーサルが結果を返さないか、誤った結果が返される Gremlin のバグを修正しました。
+ ネストされた `.project().by()` ステップが誤った結果を返す原因となっていた Gremlin のバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.2.1.R4 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.1`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.2.1.R4 へのアップグレードパス
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
ただし、**このリリースへの自動更新はサポートされていません**。
## このリリースへのアップグレード
Amazon Neptune 1.0.2.1.R4 が一般的に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.1 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.2.1.R3 (2019-12-12)
## このエンジンリリースで修正された不具合
+ `OSGP` パラメータの [ラボモード](features-lab-mode.md) 値を使用して、`ObjectIndex` で機能を正しく有効化していても、`neptune_lab_mode` インデックスが無効になっていたバグを修正しました。
+ `.fold()` ステップ内にある `.project().by()` を使用して Gremlin クエリに影響したバグを修正しました。たとえば、次のクエリは不完全な結果を返します。
```
g.V().project("a").by(valueMap().fold())
```
+ RDF データのバルクロードにおけるパフォーマンスのボトルネックを修正しました。
+ ストリームが有効化され、レプリカがプライマリの前に再起動されたときに、レプリカでクラッシュするバグを修正しました。
+ インスタンスのローテーションされた SSL 証明書が、インスタンスの再起動なしに取得されなかったバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.2.1.R3 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.1`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.2.1.R3 へのアップグレードパス
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
ただし、**このリリースへの自動更新はサポートされていません**。
## このリリースへのアップグレード
Amazon Neptune 1.0.2.1.R3 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.1 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.2.1.R2 (2019-11-25)
## このエンジンリリースで修正された不具合
+ ラウンドロビン以外の副次トラバーサルと `project().by()` 以外の副次トラバーサルを使用するすべての `path()` クエリに影響するバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.2.1.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.1`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.2.1.R2 へのアップグレードパス
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
ただし、**このリリースへの自動更新はサポートされていません**。
## このリリースへのアップグレード
Amazon Neptune 1.0.2.1.R2 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.1 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.2.0 (2019-11-08)
## 重要: このバージョンは非推奨になりました。
2020 年 5 月 19 日以降、このエンジンバージョンを使用する新しいインスタンスは作成されません。
このエンジンのバージョンは[バージョン 1.0.2.1](engine-releases-1.0.2.1.md) に置き換えられました。このバージョンには、すべてのバグ修正に加え、フルテキスト検索の統合、OSGP インデックスのサポート、AWS リージョン間でのデータベーススナップショットクラスターコピーなどの追加機能が含まれています。
2020 年 6 月 1 日以降、 は、次のメンテナンスウィンドウに、このエンジンのバージョンを実行しているクラスターを [バージョン 1.0.2.1 の最新のパッチ](engine-releases-1.0.2.1.R6.md)に自動的にアップグレードします。[ここで](engine-releases-1.0.2.1.md)説明しているように、その前に手動でアップグレードできます。
アップグレードに問題がある場合は、[AWS サポート](https://aws.amazon.com/support)または [AWS 開発者フォーラム](https://forums.aws.amazon.com/forum.jspa?forumID=253)を通じてお問い合わせください。
## このリリースの後続のパッチリリース
+ [リリース： 1.0.2.0.R3 (2020-05-05)](engine-releases-1.0.2.0.R3.md)
+ [リリース： 1.0.2.0.R2 (2019-11-21)](engine-releases-1.0.2.0.R2.md)
## このエンジンリリースの新機能
このリリースでは、メンテナンスアップデートに加えて、一度に複数のエンジンバージョンをサポートする新機能が追加されています (「[Amazon Neptune DB クラスターのメンテナンス](cluster-maintenance.md)」を参照)。
その結果、エンジンリリースの番号付けが変更されました (「[エンジンリリース 1.3.0.0 より前のバージョン番号](cluster-maintenance.md#older-engine-numbers)」を参照)。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.2.0 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.1`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.2.0 へのアップグレードパス
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
このリリースに自動的にアップグレードされることはありません。
## このリリースへのアップグレード
Amazon Neptune 1.0.2.0 が公開されました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.2.0.R3 (2020-05-05)
## 重要: このバージョンは非推奨になりました。
2020 年 5 月 19 日以降、このエンジンバージョンを使用する新しいインスタンスは作成されません。
このエンジンのバージョンは[バージョン 1.0.2.1](engine-releases-1.0.2.1.md) に置き換えられました。このバージョンには、すべてのバグ修正に加え、フルテキスト検索の統合、OSGP インデックスのサポート、AWS リージョン間でのデータベーススナップショットクラスターコピーなどの追加機能が含まれています。
2020 年 6 月 1 日以降、 は、次のメンテナンスウィンドウに、このエンジンのバージョンを実行しているクラスターを [バージョン 1.0.2.1 の最新のパッチ](engine-releases-1.0.2.1.R6.md)に自動的にアップグレードします。[ここで](engine-releases-1.0.2.1.md)説明しているように、その前に手動でアップグレードできます。
アップグレードに問題がある場合は、[AWS サポート](https://aws.amazon.com/support)または [AWS 開発者フォーラム](https://forums.aws.amazon.com/forum.jspa?forumID=253)を通じてお問い合わせください。
## このエンジンリリースで修正された不具合
+ `ConcurrentModificationConflictException` と `TransactionException` が汎用 `InternalFailureException` として報告されるバグを修正しました。
+ 起動時にサーバーが頻繁に再起動するヘルスチェックの不具合を修正しました。
+ 特定の条件下でコミットが機能しないため、レプリカにデータが表示されない不具合を修正しました。
+ ロードステータスのシリアル化において、Amazon S3 のアクセス許可の不足によりロードが失敗する不具合を修正しました。
+ Gremlin セッションでのリソースリークを修正しました。
+ ヘルスチェックにおいて、IAM 認証を管理するコンポーネントの起動時に異常ステータスが非表示になる不具合を修正しました。
+ チャンネルを閉じる前に Neptune が WebSocket クローズフレームを送信できない不具合を修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.2.0.R3 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.1`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.2.0.R3 へのアップグレードパス
エンジンバージョン `1.0.2.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。
以前の Neptune エンジンリリースをこのリリースに手動でアップグレードできます。
## このリリースへのアップグレード
Amazon Neptune 1.0.2.0.R3 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.2.0.R2 (2019-11-21)
## 重要: このバージョンは非推奨になりました。
2020 年 5 月 19 日以降、このエンジンバージョンを使用する新しいインスタンスは作成されません。
このエンジンのバージョンは[バージョン 1.0.2.1](engine-releases-1.0.2.1.md) に置き換えられました。このバージョンには、すべてのバグ修正に加え、フルテキスト検索の統合、OSGP インデックスのサポート、AWS リージョン間でのデータベーススナップショットクラスターコピーなどの追加機能が含まれています。
2020 年 6 月 1 日以降、 は、次のメンテナンスウィンドウに、このエンジンのバージョンを実行しているクラスターを [バージョン 1.0.2.1 の最新のパッチ](engine-releases-1.0.2.1.R6.md)に自動的にアップグレードします。[ここで](engine-releases-1.0.2.1.md)説明しているように、その前に手動でアップグレードできます。
アップグレードに問題がある場合は、[AWS サポート](https://aws.amazon.com/support)または [AWS 開発者フォーラム](https://forums.aws.amazon.com/forum.jspa?forumID=253)を通じてお問い合わせください。
## このエンジンリリースで修正された不具合
+ サーバーでのダーティページのキャッシュ戦略を改善し、サーバーがメモリ不足状態になったときの `FreeableMemory` の回復を高速化しました。
+ サーバーで多数のロードステータスやロード開始要求を同時に処理する場合に、競合状態やクラッシュを起こす可能性があるバグを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.2.0.R2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin バージョン:* `3.4.1`
+ *SPARQL バージョン:* `1.1`
## エンジンリリース 1.0.2.0.R2 へのアップグレードパス
以前の Neptune エンジンリリースを、このリリースに手動でアップグレードできます。
ただし、**このリリースへの自動更新はサポートされていません**。
## このリリースへのアップグレード
Amazon Neptune 1.0.2.0.R2 が一般に利用可能になりました。
DB クラスターで、このリリースへのアップグレードパスがあるエンジンバージョンを実行している場合は、今すぐアップグレードできます。対象となるクラスターをアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドは、適格なクラスターをただちにアップグレードします。
Linux、OS X、Unix の場合:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.0 \
4. --apply-immediately
```
Windows の場合:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.0 ^
4. --apply-immediately
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20〜30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。
### アップグレードの前に必ずテストする
新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。
まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。
本番 DB クラスターをアップグレードする前に新しいバージョンをテストする最善の方法は、本番クラスターをクローンして、クローンで新しいエンジンバージョンを実行することです。その後、本番 DB クラスターに影響を与えずに、クローンに対してクエリを実行できます。
### アップグレードの前に必ずスナップショットを手動で作成してください
アップグレードの前に必ず DB クラスターの手動スナップショットを作成することを強く推奨します。自動スナップショットを作成しても短期的な保護しか得られませんが、手動スナップショットは明示的に削除するまで使用できます。
場合によっては、Neptune がアップグレードプロセスの一環として手動スナップショットを作成することもありますが、これを頼りにすべきではなく、どのような場合でも独自の手動スナップショットを作成する必要があります。
DB クラスターをアップグレード前の状態に戻す必要がないことが確実な場合は、自分で作成した手動スナップショットと、Neptune が作成した手動スナップショットを明示的に削除できます。Neptune が手動スナップショットを作成する場合、その名前は `preupgrade` で始まり、その後に DB クラスターの名前、ソースエンジンのバージョン、ターゲットエンジンのバージョン、および日付が続きます。
**注記**
[保留中のアクションの処理中に](manage-console-maintaining)アップグレードを試みた場合、次のようなエラーが発生する可能性があります。
```
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 クラスターのメンテナンス](cluster-maintenance.md) を参照してください。ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
# Amazon Neptune エンジンバージョン 1.0.1.2 (2020-06-10)
## 重要: このバージョンは非推奨になりました。
2021 年 4 月 27 日以降、このエンジンバージョンを使用する新しいインスタンスは作成されません。
## このエンジンリリースの改良点
+ Neptune は、存在しないプロパティ、頂点、エッジにアクセスしようとした場合に `IllegalArgumentException` を発生させるようになりました。以前は、Neptune ではその状況で `UnsupportedOperationException` が発生しました。
たとえば、存在しない頂点を参照するエッジを追加しようとすると、`IllegalArgumentException` が発生します。
## このエンジンリリースで修正された不具合
+ 2 つの `value->id` マッピングを同時に挿入すると、ディクショナリとユーザートランザクションのコミットが機能しない不具合を修正しました。
+ ロードステータスのシリアル化の不具合を修正しました。
+ インスタンスの作成を遅らせる、サーバー起動時の確率的な障害を修正しました。
+ カーソルリークを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.1.2 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin のバージョン:* `3.4.1`
+ *SPARQL のバージョン:* `1.1`
# Amazon Neptune エンジンバージョン 1.0.1.1 (2020-06-26)
## 重要: このバージョンは非推奨になりました。
2021 年 4 月 27 日以降、このエンジンバージョンを使用する新しいインスタンスは作成されません。
## このエンジンリリースで修正された不具合
+ 同時挿入時にコミットが順不同になる不具合を修正しました。
+ ロードステータスのシリアル化の不具合を修正しました。
+ インスタンスの作成を遅らせる、サーバー起動時の確率的な障害を修正しました。
+ メモリリークを修正しました。
## このリリースでサポートされるクエリ言語バージョン
DB クラスターをバージョン 1.0.1.1 にアップグレードする前に、プロジェクトが次のクエリ言語バージョンと互換性があることを確認してください。
+ *Gremlin のバージョン:* `3.3.2`
+ *SPARQL のバージョン:* `1.1`
# Amazon Neptune エンジンバージョン 1.0.1.0 (2019-07-02)
## 重要: このエンジンバージョンは非推奨になりました
2021 年 4 月 27 日以降、このエンジンバージョンを使用する新しいインスタンスは作成されません。
# Amazon Neptune エンジンの更新 (2019-10-31)
**バージョン:** 1.0.1.0.200502.0
## 重要: このエンジンバージョンは非推奨になりました
2021年 4 月 27 日以降、このエンジンバージョンを使用する新しいインスタンスは作成されません。
## このエンジンリリースで修正された不具合
+ クライアントが `tree()` を使用して (つまり GLV バイトコードを使用して) Neptune に接続するときの `traversal().withRemote(...)` ステップの応答のシリアル化における Gremlin バグが修正されました。
このリリースでは、`traversal().withRemote(...)` を使用して Neptune に接続したクライアントが、`tree()` ステップを含む Gremlin クエリに対して無効なレスポンスを受信する問題に対応しました。
+ 競合状態が原因でクエリ終了プロセスがハングし、クエリがタイムアウトする `DELETE WHERE LIMIT` クエリの SPARQL バグが修正されました。
# Amazon Neptune エンジンの更新 (2019-10-15)
**バージョン:** 1.0.1.0.200463.0
## 重要: このエンジンバージョンは非推奨になりました
2021年 4 月 27 日以降、このエンジンバージョンを使用する新しいインスタンスは作成されません。
## このエンジンリリースの新機能
+ Gremlin の説明/プロファイル機能を追加しました (「[Gremlin を使用して Neptune クエリ実行を分析する`explain`](gremlin-explain.md)」を参照)。
+ 1 つのトランザクションで複数の Gremlin トラバーサルを実行できるように [Gremlin スクリプトベースのセッションのサポート](access-graph-gremlin-sessions.md) が追加されました。
+ Neptune に SPARQL フェデレーティッドクエリ拡張のサポートを追加しました ([SPARQL 1.1 Federated Query](https://www.w3.org/TR/sparql11-federated-query/) および [`SERVICE` 拡張を使用した Neptune での SPARQL フェデレーティッドクエリ](sparql-service.md) を参照)。
+ HTTP URL パラメータまたは SPARQL `queryId` クエリヒントを使用して、Gremlin または SPARQL クエリに独自の `queryId` を挿入する機能を追加しました (「[Neptune Gremlin または SPARQL クエリにカスタム ID を挿入する](features-query-id.md)」を参照)。
+ Neptune に [ラボモード](features-lab-mode.md) 機能を追加しました。この機能を使用すると、本番環境ではまだ使用できない機能を試すことができます。
+ データベースに加えられたすべての変更を 1 週間保持するストリームに確実に記録する次の [Neptune Streams](streams.md) 機能を追加しました。この機能は、ラボモードでのみ使用できます。
+ 同時トランザクションの正式なセマンティクスを更新しました (「[Neptune でのトランザクションセマンティクス](transactions.md)」を参照)。この機能では、同時実行に関する業界標準の保証を提供します。
デフォルトでは、これらのトランザクションセマンティクスは有効になっています。シナリオによっては、この機能によって現在のロード動作が変更され、ロードパフォーマンスが低下することがあります。DB Cluster `neptune_lab_mode` パラメータを使用して、パラメータ値に `ReadWriteConflictDetection=disabled` を含めることで、前のセマンティクスに戻すことができます。
## このエンジンリリースの改良点
+ エンジンが使用している TinkerPop のバージョンと SPARQL のバージョンを報告することで、[インスタンスのステータス](access-graph-status.md) API が改善されました。
+ Gremlin サブグラフ演算子のパフォーマンスが改善されました。
+ Gremlin レスポンスのシリアル化のパフォーマンスが改善されました。
+ Gremlin Union ステップのパフォーマンスが改善されました。
+ シンプルな SPARQL クエリのレイテンシーが改善されました。
## このエンジンリリースで修正された不具合
+ 内部エラーとしてタイムアウトが誤って返される Gremlin のバグを修正しました。
+ 一部の変数セットに対する ORDER BY によって内部サーバーエラーが発生する SPARQL バグを修正しました。
# Amazon Neptune エンジンの更新 (2019-09-19)
## 重要: このエンジンバージョンは非推奨になりました
2021年 4 月 27 日以降、このエンジンバージョンを使用する新しいインスタンスは作成されません。
**バージョン:** 1.0.1.0.200457.0
Amazon Neptune 1.0.1.0.200457.0が一般展開されています。そのリージョンでエンジンの更新が完了したら、新しい Neptune DB クラスター (スナップショットから復元されたものも含む) はすべて、Neptune1.0.1.0.200457.0 で作成されるようになります。
既存のクラスターをすぐにこのリリースにアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドを使用して、DB クラスターをアップグレードできます。
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20 〜 30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。メンテナンスウィンドウの設定は、[Neptune コンソール](https://console.aws.amazon.com/neptune/home) で表示または変更できます。
ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
## このエンジンリリースで修正された不具合
+ 問題の原因となった接続述語処理のパフォーマンス改善を削除することにより、以前のエンジンリリース (1.0.1.0.200369.0) で発生した Gremlin の正確性の問題を修正しました。
+ `DISTINCT` および `OPTIONAL` に含まれている単一のパターンを使用して `InternalServerError` を生成するクエリの原因となった SPARQL バグを修正しました。
# Amazon Neptune エンジンの更新 (2019-08-13)
## 重要: このバージョンは非推奨になりました。
2021 年 4 月 27 日以降、このエンジンバージョンを使用する新しいインスタンスは作成されません。
## このエンジンリリースの新機能
+ [Neptune ローダーコマンド](load-api-reference-load.md) の `parallelism` パラメータに `OVERSUBSCRIBE` オプションを追加しましす。これにより、Neptune バルクローダーは使用可能なすべてのスレッドとリソースを使用するようになります。
## このエンジンリリースの改良点
+ 単純な論理 OR 式を含む SPARQL フィルターのパフォーマンスが向上しました。
+ 接続述語の処理における Gremlin のパフォーマンスが改善されました。
## このエンジンリリースで修正された不具合
+ `xsd:duration` から `xsd:date` を減算できない SPARQL のバグを修正しました。
+ `UNION` が存在する場合に、静的インライン化によって不完全な結果が発生する SPARQL のバグを修正しました。
+ クエリキャンセルの SPARQL のバグを修正しました。
+ タイプの昇格中にオーバーフローが発生する Gremlin のバグを修正しました。
+ `addE().from().to()` ステップでの頂点要素の処理における Gremlin のバグを修正しました。
+ 単一濃度の挿入における NaN の倍精度と浮動小数点数の処理を含む Gremlin のバグ ([エンジンバージョン 1.0.1.0.200366.0](engine-releases-1.0.1.0.200366.0.md)、2019-07-26 リリース) を修正しました。
+ プロパティベースの検索を含むクエリプランの生成のバグを修正しました。
# Amazon Neptune エンジンの更新 (2019-07-26)
**バージョン:** 1.0.1.0.200366.0
## 重要: このエンジンバージョンは非推奨になりました
2021年 4 月 27 日以降、このエンジンバージョンを使用する新しいインスタンスは作成されません。
## このエンジンリリースの新機能
+ TinkerPop 3.4.1 にアップグレードしました ([TinkerPop アップグレード情報](http://tinkerpop.apache.org/docs/3.4.1/upgrade/) および [TinkerPop 3.4.1 変更ログ](https://github.com/apache/tinkerpop/blob/3.4.1/CHANGELOG.asciidoc#release-3-4-1)を参照)。
Neptune のお客様の場合、これらの変更により、次のような新機能や改善がもたらされます。
+ `GraphBinary` がシリアル化形式として使用可能になりました。
+ TinkerPop Java ドライバーでメモリリークを引き起こすキープアライブバグが修正され、回避策は不要になりました。
ただし、場合によっては、Neptune の既存の Gremlin コードに影響する可能性があります。例:
+ `valueMap()` は、`Map` の代わりに `Map` を返すようになりました。
+ `within()` ステップの不整合な動作が修正され、他のステップと一貫して動作するようにしました。以前は、比較が機能するために型が一致する必要がありました。現在では、さまざまなタイプの数を正確に比較できるようになりました。たとえば、`33` は、以前とは異なり `33L` と同じように比較するようになりました。
+ `ReducingBarrierStep` のバグが修正され、出力に使用できる要素がない場合、値が返されないようになりました。
+ `select()` スコープの順序が変更されました (順序は `maps` 、`side-effects`、`paths` になりました)。これにより、`side-effects` と `select` を、`side-effects` と同じ `select` のキー名と組み合わせた、まれなクエリの結果が変更されます。
+ `bulkSet()` は GraphSON プロトコルの一部になりました。`toBulkSet()` で終わるクエリは、古いクライアントでは機能しません。
+ `Submit()` ステップの 1 つのパラメーター化が 3.4 クライアントから削除されました。
TinkerPop 3.4 で導入された他の多くの変更は、Neptune の現在の動作には影響しません。たとえば、Gremlin `io()` は `Traversal` にステップとして追加され、`Graph` では非推奨となりましたが、Neptune では有効になっていません 。
+ [Gremlin 用の一括ローダー](bulk-load-tutorial-format-gremlin.md#bulk-load-tutorial-format-gremlin-propheaders)に、プロパティグラフデータをロードするための、単一の頂点濃度プロパティのサポートが追加されました。
+ 一括ローダーの単一の頂点濃度プロパティの既存の値を上書きするオプションを追加しました。
+ [Gremlin クエリのステータスを取得](gremlin-api-status.md)する機能と、[Gremlin クエリをキャンセル](gremlin-api-status-cancel.md)する機能が追加されました。
+ [SPARQL クエリタイムアウトのクエリヒント](sparql-query-hints-queryTimeout.md)を追加しました。
+ ステータス API でインスタンスのロールを確認する機能を追加しました ([インスタンスのステータス](access-graph-status.md) 参照)。
+ データベースのクローン作成のサポートを追加しました (「[Neptune のデータベースのクローン化](manage-console-cloning.md)」を参照)。
## このエンジンリリースの改良点
+ FROM 句のグラフ変数が表示されるように SPARQL クエリの説明を修正しました。
+ フィルタ、equal フィルタ、VALUES 句、および範囲カウントにおける SPARQL のパフォーマンスが向上しました。
+ Gremlin ステップ順序のパフォーマンスが向上しました。
+ Gremlin `.repeat.dedup` トラバーサルのパフォーマンスが向上しました。
+ Gremlin の `valueMap()` と `path().by()` トラバーサルのパフォーマンスが向上しました。
## このエンジンリリースで修正された不具合
+ 名前付きグラフの操作を含む SPARQL プロパティパスに関する複数の問題を修正しました。
+ SPARQL CONSTRUCT クエリでメモリの問題が生じる問題を修正しました。
+ RDF Turtle パーサーとローカル名の問題を修正しました。
+ ユーザーに表示されるエラーメッセージを修正するための問題を修正しました。
+ Gremlin `repeat()...drop()` トラバーサルに関する問題を修正しました。
+ Gremlin `drop()` ステップに関する問題を修正しました。
+ Gremlin ラベルフィルタに関する問題を修正しました。
+ Gremlin クエリタイムアウトに関する問題を修正しました。
# Amazon Neptune エンジンの更新 (2019-07-02)
## 重要: このエンジンバージョンは非推奨になりました
2021年 4 月 27 日以降、このエンジンバージョンを使用する新しいインスタンスは作成されません。
## このエンジンリリースで修正された不具合
+ プロパティ名と値がバインドされた特定のパターンが最適化されないバグを修正しました。
# 以前の Neptune エンジンリリース
**Topics**
+ [Amazon Neptune エンジンの更新 (2019-06-12)](engine-releases-1.0.1.0.200310.0.md)
+ [Amazon Neptune エンジンの更新 (2019-05-01)](engine-releases-1.0.1.0.200296.0.md)
+ [Amazon Neptune エンジンの更新 (2019-01-21)](engine-releases-1.0.1.0.200267.0.md)
+ [Amazon Neptune エンジンの更新 (2018-11-19)](engine-releases-1.0.1.0.200264.0.md)
+ [Amazon Neptune エンジンの更新 (2018-11-08)](engine-releases-1.0.1.0.200258.0.md)
+ [Amazon Neptune エンジンの更新 (2018-10-29)](engine-releases-1.0.1.0.200255.0.md)
+ [Amazon Neptune エンジンの更新 (2018-09-06)](engine-releases-1.0.1.0.200237.0.md)
+ [Amazon Neptune エンジンの更新 (2018-07-24)](engine-releases-1.0.1.0.200236.0.md)
+ [Amazon Neptune エンジンの更新 (2018-06-22)](engine-releases-1.0.1.0.200233.0.md)
# Amazon Neptune エンジンの更新 (2019-06-12)
**バージョン:** 1.0.1.0.200310.0
Amazon Neptune 1.0.1.0.200310.0 が一般に入手可能です。そのリージョンでエンジンの更新が完了したら、新しい Neptune DB クラスター (スナップショットから復元されたものも含む) はすべて、Neptune 1.0.1.0.200310.0 で作成されるようになります。
既存のクラスターをすぐにこのリリースにアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドを使用して、DB クラスターをこのリリースにすぐにアップグレードできます。
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB クラスターは、システムのメンテナンス期間中に、エンジンリリース 1.0.1.0.200310.0 に自動的にアップグレードされます。更新が適用されるタイミングは、リージョンや DB クラスターのメンテナンスウィンドウの設定、および更新のタイプによって異なります。
**注記**
インスタンスメンテナンスウィンドウは、エンジンの更新には適用されません。
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20 〜 30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。メンテナンスウィンドウの設定は、[Neptune コンソール](https://console.aws.amazon.com/neptune/home) で表示または変更できます。
ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
## 改善点
+ エッジの同時挿入や削除が原因によって、同じ ID を持つエッジが複数になる可能性があるというバグを修正しました。
+ マイナー修正と機能向上。
# Amazon Neptune エンジンの更新 (2019-05-01)
**バージョン:** 1.0.1.0.200296.0
Amazon Neptune 1.0.1.0.200296.0 が一般展開されています。そのリージョンでエンジンの更新が完了したら、新しい Neptune DB クラスター (スナップショットから復元されたものも含む) はすべて、Neptune 1.0.1.0.200296.0 で作成されるようになります。
既存のクラスターをすぐにこのリリースにアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドを使用して、DB クラスターをこのリリースへとすぐにアップグレードできます。
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB クラスターは、システムのメンテナンス期間中に、エンジンリリース 1.0.1.0.200296.0 に自動的にアップグレードされます。更新が適用されるタイミングは、リージョンや DB クラスターのメンテナンスウィンドウの設定、および更新のタイプによって異なります。
**注記**
インスタンスメンテナンスウィンドウは、エンジンの更新には適用されません。
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20 〜 30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。メンテナンスウィンドウの設定は、[Neptune コンソール](https://console.aws.amazon.com/neptune/home) で表示または変更できます。
ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
## 改善点
+ クエリプランの表示および必要に応じて最適化の手順を実行するために、Neptune SPARQL クエリに新しい `explain` 機能が追加されました。詳細については、「[SPARQL `explain`SPARQL `SERVICE` 拡張](sparql-explain.md)」を参照してください。
+ SPARQL のパフォーマンスおよびレポートがさまざまな点で改善されました。
+ Gremlin のパフォーマンスと動作がさまざまな点で改善されました。
+ 実行時間の長い `drop( )` クエリのタイムアウトが改善されました。
+ `otherV( )` のクエリのパフォーマンスが改善されました。
+ DB クラスターあるいはインスタンスの Neptune ヘルスステータスのクエリ時に、返される情報に 2 つのフィールドが追加されました。エンジンバージョン番号とクラスターあるいはインスタンスの開始時間です。「[インスタンスのステータス](access-graph-status.md)」を参照してください。
+ Neptune ローダー `Get-Status` API が、ロードジョブがいつ開始されたかを記録する `startTime` フィールドを返すようになりました。
+ ローダーコマンドでは、ローダーが使用するスレッドの数を制限できる、オプションの `parallelism` パラメータが使用されるようになりました。
# Amazon Neptune エンジンの更新 (2019-01-21)
**バージョン:** 1.0.1.0.200267.0
Amazon Neptune 1.0.1.0.200267.0 が一般展開されています。そのリージョンでエンジンの更新が完了したら、新しい Neptune DB クラスター (スナップショットから復元されたものも含む) はすべて、Neptune 1.0.1.0.200267.0 で作成されるようになります。
既存のクラスターをすぐにこのリリースにアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドを使用して、DB クラスターをこのリリースへすぐにアップグレードできます。
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB クラスターは、システムのメンテナンス期間中に、エンジンリリース 1.0.1.0.200267.0 に自動的にアップグレードされます。更新が適用されるタイミングは、リージョンや DB クラスターのメンテナンスウィンドウの設定、および更新のタイプによって異なります。
**注記**
インスタンスメンテナンスウィンドウは、エンジンの更新には適用されません。
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20 〜 30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。メンテナンスウィンドウの設定は、[Neptune コンソール](https://console.aws.amazon.com/neptune/home) で表示または変更できます。
ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
## 改善点
+ Neptune は競合が解決するまで (指定されたクエリタイムアウトの範囲内で) 長く待機します。これにより、クライアントが処理する必要がある同時変更の例外数は減少します ([クエリのエラー](errors-engine-codes.md#errors-query) を参照)。
+ Gremlin 基数の使用が原因でエンジンが再起動される問題を修正しました。
+ `emit.times` 繰り返しクエリの Gremlin パフォーマンスが向上しました。
+ `repeat.until` が `.emit` ソリューションを許可していた Gremlin の問題を修正しました。
+ Gremlin のエラー処理を強化しました。
# Amazon Neptune エンジンの更新 (2018-11-19)
**バージョン:** 1.0.1.0.200264.0
Amazon Neptune 1.0.1.0.200264.0 が一般展開されています。そのリージョンでエンジンの更新が完了したら、新しい Neptune DB クラスター (スナップショットから復元されたものも含む) はすべて、Neptune 1.0.1.0.200264.0 で作成されるようになります。
既存のクラスターをすぐにこのリリースにアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドを使用して、DB クラスターをこのリリースにすぐにアップグレードできます。
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB クラスターは、システムのメンテナンス期間中に、エンジンリリース 1.0.1.0.200264.0 に自動的にアップグレードされます。更新が適用されるタイミングは、リージョンや DB クラスターのメンテナンスウィンドウの設定、および更新のタイプによって異なります。
**注記**
インスタンスメンテナンスウィンドウは、エンジンの更新には適用されません。
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20 〜 30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。メンテナンスウィンドウの設定は、[Neptune コンソール](https://console.aws.amazon.com/neptune/home) で表示または変更できます。
ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
## 改善点
+ のサポートが追加されました。[Gremlin クエリヒント](gremlin-query-hints.md)
+ IAM 認証に関するエラーメッセージが改善されました。詳細については、「[IAM 認証エラー](errors-engine-codes.md#errors-iam-auth)」を参照してください。
+ 多数の述語を使用して SPARQL クエリのパフォーマンスが改善されました。
+ SPARQL プロパティパスのパフォーマンスが改善されました。
+ `fold().coalesce(unfold(), …)`、`addV()`、および `addE()` ステップと使用されたときに、`property()` パターンなど、条件付きミューテーションの Gremlin のパフォーマンスが改善されました。
+ `by()` および `sack()` モジュレーションの Gremlin のパフォーマンスが改善されました。
+ `group()` および `groupCount()` ステップの Gremlin のパフォーマンスが改善されました。
+ `store()`、`sideEffect()`、および `cap().unfold()` ステップの Gremlin のパフォーマンスが改善されました。
+ Gremlin の単一濃度プロパティの制約に対するサポートが改善されました。
+ 単一濃度プロパティとしてマークされたエッジプロパティおよび頂点プロパティに対する単一濃度の適用が改善されました。
+ Neptune のロードジョブ中に追加のプロパティ値が既存のエッジプロパティに指定されている場合に、エラーが導入されました。
# Amazon Neptune エンジンの更新 (2018-11-08)
**バージョン:** 1.0.1.0.200258.0
Amazon Neptune 1.0.1.0.200258.0 が一般展開されています。そのリージョンでエンジンの更新が完了したら、新しい Neptune DB クラスター (スナップショットから復元されたものも含む) はすべて、Neptune 1.0.1.0.200258.0 で作成されるようになります。
既存のクラスターをすぐにこのリリースにアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドを使用して、DB クラスターをこのリリースまですぐにアップグレードできます。
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB クラスターは、システムのメンテナンス期間中に、エンジンリリース 1.0.1.0.200258.0 に自動的にアップグレードされます。更新が適用されるタイミングは、リージョンや DB クラスターのメンテナンスウィンドウの設定、および更新のタイプによって異なります。
**注記**
インスタンスメンテナンスウィンドウは、エンジンの更新には適用されません。
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20 〜 30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。メンテナンスウィンドウの設定は、[Neptune コンソール](https://console.aws.amazon.com/neptune/home) で表示または変更できます。
ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
## 改善点
+ のサポートが追加されました。[SPARQL クエリヒント](sparql-query-hints.md)
+ SPARQL FILTER (NOT) Exists クエリのパフォーマンスが改善されました。
+ SPARQL DESCRIBE クエリのパフォーマンスが改善されました。
+ Gremlin のパターンまでの繰り返しのパフォーマンスが改善されました。
+ Gremlin のエッジ追加のパフォーマンスが改善されました。
+ 場合によって SPARQL Update DELETE クエリで障害が発生する問題を修正しました。
+ Gremlin WebSocket サーバーを使用したタイムアウトの処理に関する問題を修正しました。
# Amazon Neptune エンジンの更新 (2018-10-29)
**バージョン:** 1.0.1.0.200255.0
Amazon Neptune 1.0.1.0.200255.0 が一般展開されています。そのリージョンでエンジンの更新が完了したら、新しい Neptune DB クラスター (スナップショットから復元されたものも含む) はすべて、Neptune 1.0.1.0.200255.0 で作成されるようになります。
既存のクラスターをすぐにこのリリースにアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドを使用して、DB クラスターをこのリリースにすぐにアップグレードできます。
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB クラスターは、システムのメンテナンス期間中に、エンジンリリース 1.0.1.0.200255.0 に自動的にアップグレードされます。更新が適用されるタイミングは、リージョンや DB クラスターのメンテナンスウィンドウの設定、および更新のタイプによって異なります。
**注記**
インスタンスメンテナンスウィンドウは、エンジンの更新には適用されません。
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20 〜 30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。メンテナンスウィンドウの設定は、[Neptune コンソール](https://console.aws.amazon.com/neptune/home) で表示または変更できます。
ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
## 改善点
+ IAM 認証情報が監査ログに追加されました。
+ IAM ロールおよびインスタンスプロファイルを使用する一時的な認証情報のサポートが追加されました。
+ アクセス許可が取り消されたとき、または IAM ユーザーやロールが削除されたときに、IAM 認証の WebSocket 接続の終了が追加されました。
+ WebSocket 接続の最大数がインスタンスあたり 60,000 に制限されました。
+ 小さいインスタンスタイプの一括ロードパフォーマンスが改善されました。
+ Gremlin の `and()`、`or()`、`not()`、`drop()` 演算子を含むクエリのパフォーマンスが改善されました。
+ NTriples パーサーが、空白文字が含まれている URI などの無効な URI を拒否するようになりました。
# Amazon Neptune エンジンの更新 (2018-09-06)
**バージョン:** 1.0.1.0.200237.0
Amazon Neptune 1.0.1.0.200237.0 が一般展開されています。そのリージョンでエンジンの更新が完了したら、新しい Neptune DB クラスター (スナップショットから復元されたものも含む) はすべて、 Neptune 1.0.1.0.200237.0 で作成されるようになります。
既存のクラスターをすぐにこのリリースにアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドを使用して、DB クラスターをこのリリースにすぐにアップグレードできます。
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB クラスターは、システムのメンテナンスウィンドウズに、エンジンリリース 1.0.1.0.200237.0 に自動的にアップグレードされます。更新が適用されるタイミングは、リージョンや DB クラスターのメンテナンスウィンドウの設定、および更新のタイプによって異なります。
**注記**
インスタンスメンテナンスウィンドウは、エンジンの更新には適用されません。
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20 〜 30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。メンテナンスウィンドウの設定は、[Neptune コンソール](https://console.aws.amazon.com/neptune/home) で表示または変更できます。
ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
## 改善点
+ 一部の `SPARQL COUNT(DISTINCT)` クエリが失敗する問題が修正されました。
+ `COUNT` 句がある `SUM`、`MIN`、`DISTINCT` クエリがメモリ不足になることがあった問題が修正されました。
+ `BLOB` タイプデータが Neptune ローダージョブの失敗の原因となる問題が修正されました。
+ 重複した挿入がトランザクションの失敗の原因となる問題が修正されました。
+ `DROP ALL` クエリがキャンセルできない問題が修正されました。
+ Gremlin クライアントが断続的にフリーズする問題が修正されました。
+ 150M より大きいペイロードのすべてのエラーコードを `HTTP 400` に更新しました。
+ 単一トリプルパターンの `COUNT()` クエリのパフォーマンスと正確度が改善されました。
+ `SPARQL UNION` 句の `BIND` クエリのパフォーマンスが改善されました。
# Amazon Neptune エンジンの更新 (2018-07-24)
**バージョン:** 1.0.1.0.200236.0
Amazon Neptune 1.0.1.0.200236.0 が一般に入手可能です。そのリージョンでエンジンの更新が完了したら、新しい Neptune DB クラスター (スナップショットから復元されたものも含む) はすべて、Neptune 1.0.1.0.200236.0 で作成されるようになります。
既存のクラスターをすぐにこのリリースにアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドを使用して、DB クラスターをこのリリースにすぐにアップグレードできます。
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB クラスターは、システムのメンテナンス期間中に、エンジンリリース 1.0.1.0.200236.0 に自動的にアップグレードされます。更新が適用されるタイミングは、リージョンや DB クラスターのメンテナンスウィンドウの設定、および更新のタイプによって異なります。
**注記**
インスタンスメンテナンスウィンドウは、エンジンの更新には適用されません。
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20 〜 30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。メンテナンスウィンドウの設定は、[Neptune コンソール](https://console.aws.amazon.com/neptune/home) で表示または変更できます。
ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
## 改善点
+ `xsd:string` datatype. xsd:string の更新された SPARQL シリアル化は、JSON シリアル化が他の出力形式と一致するようになったため、これに含まれなくなりました。
+ SPARQL 1.1 UPDATE および SPARQL 1.1 Query などのすべての SPARQL データローダー形式で、`xsd:double`/`xsd:float` infinity. `-INF`、`NaN`、および `INF` 値の固定処理が適切に認識され処理されるようになりました。
+ 空の文字列値のある Gremlin クエリが予期せず失敗する問題を修正しました。
+ 空のグラフで、Gremlin `aggregate()` および `cap()` が予期せずに失敗する問題を修正しました。
+ 基数の指定が無効な場合 (例: `.property(set,id,'10')` および `.property(single,id,'10')`)、Gremlin に対して誤ったエラーレスポンスが返される問題を修正しました。
+ InternalFailureException として無効な Gremlin 構文が返される問題を修正しました。
+ エラーメッセージのスペルを `TimeLimitExceeededException` から `TimeLimitExceededException` に修正しました。
+ スクリプトが提供されない場合の SPARQL および GREMLIN エンドポイントのレスポンスを変更しました。
+ 多すぎる同時リクエストのエラーメッセージを明確にしました。
# Amazon Neptune エンジンの更新 (2018-06-22)
**バージョン:** 1.0.1.0.200233.0
Amazon Neptune 1.0.1.0.200233.0 が一般展開されています。そのリージョンでエンジンの更新が完了したら、新しい Neptune DB クラスター (スナップショットから復元されたものも含む) はすべて、Neptune 1.0.1.0.200233.0 で作成されるようになります。
既存のクラスターをすぐにこのリリースにアップグレードするには、コンソールの DB クラスターオペレーションまたは SDK を使用します。次の CLI コマンドを使用して、DB クラスターをこのリリースにすぐにアップグレードできます。
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB クラスターは、システムのメンテナンス期間中に、エンジンリリース 1.0.1.0.200233.0 に自動的にアップグレードされます。更新が適用されるタイミングは、リージョンや DB クラスターのメンテナンスウィンドウの設定、および更新のタイプによって異なります。
**注記**
インスタンスメンテナンスウィンドウは、エンジンの更新には適用されません。
更新は、DB クラスター内のすべてのインスタンスに同時に適用されます。更新では、DB クラスター内のすべてのインスタンスでデータベースを再起動する必要があるため、20 〜 30 秒から数分のダウンタイムが発生します。その後、DB クラスターの使用を再開できます。メンテナンスウィンドウの設定は、[Neptune コンソール](https://console.aws.amazon.com/neptune/home) で表示または変更できます。
ご質問やご不明点がございましたら、コミュニティフォーラムや [AWS プレミアムサポート](https://aws.amazon.com/support)から AWS サポートチームにお問い合わせください。
## 改善点
+ 大量の一括ロードリクエストが連続して発行されてエラーが発生する問題を修正しました。
+ InternalServerError でクエリが失敗する可能性のあるデータ依存の問題を修正しました。以下の例では、該当するクエリのタイプを示しています。
```
g.V("my-id123").as("start").outE("knows").has("edgePropertyKey1", P.gt(0)).as("myedge").inV()
.as("end").select("start", "end", "myedge").by("vertexPropertyKey1")
.by("vertexPropertyKey1").by("edgePropertyKey1")
```
+ Gremlin Java クライアントが長時間実行しているクエリのタイムアウト後に同じ WebSocket 接続を使用してサーバーに接続できない問題を修正しました。
+ HTTP を介した Gremlin クエリまたは WebSocket 接続を介した文字列ベースのクエリに含まれるエスケープシーケンスが正しく処理されない問題を修正しました。