

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

# Amazon Neptune エンジンバージョン 1.0.3.0 (2020-08-03)
<a name="engine-releases-1.0.3.0"></a>

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

## このリリースの後続のパッチリリース
<a name="engine-releases-1.0.3.0-patches"></a>
+ [リリース： 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) 

## このエンジンリリースの新機能
<a name="engine-releases-1.0.3.0-features"></a>
+ 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)」を参照してください。

## このエンジンリリースの改良点
<a name="engine-releases-1.0.3.0-improvements"></a>
+ Gremlin でフルテキスト検索用のバッチリクエストのサイズを ElasticSearch に提供できるようになりました。
+ SPARQL GROUP BY クエリのメモリ使用量が改善されました。
+ 特定の非バインドフィルターをプルーニングする新しい Gremlin クエリオプティマイザを追加しました。
+ IAM を使用して認証された WebSocket 接続をオープン状態に保つことができる最大時間を 36 時間から 10 日に延長しました。

## このエンジンリリースで修正された不具合
<a name="engine-releases-1.0.3.0-defects"></a>
+ 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 バグを修正しました。

## このリリースでサポートされるクエリ言語バージョン
<a name="engine-releases-1.0.3.0-query-versions"></a>

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

## エンジンリリース 1.0.3.0 へのアップグレードパス
<a name="engine-releases-1.0.3.0-upgrade-paths"></a>

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

クラスターの `AutoMinorVersionUpgrade` パラメータが `True` に設定されている場合、クラスターは、このリリース日から 2～3 週間後、メンテナンス期間中に自動的にこのエンジンリリースにアップグレードされます。

## このリリースへのアップグレード
<a name="engine-releases-1.0.3.0-upgrading"></a>

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 クラスターの使用を再開できます。

### アップグレードの前に必ずテストする
<a name="engine-1.0.3.0-test-before-upgrading"></a>

新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。

まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。

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

### アップグレードの前に必ずスナップショットを手動で作成してください
<a name="engine-1.0.3.0-snapshot-before-upgrading"></a>

アップグレードの前に必ず 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)
<a name="engine-releases-1.0.3.0.R3"></a>

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

## このエンジンリリースで修正された不具合
<a name="engine-releases-1.0.3.0.R3-defects"></a>
+ `#` で終わるラベルを含む CSV 一括ロードのバグを修正しました。
+ `as()` ステップを使用する特定のパターンのクエリに対して結果が欠損する場合がある Gremlin のバグを修正しました。
+ `union()` のような別のステップ内にネストされている `project()` ステップを使用するとエラーとなる場合があった Gremlin のバグを修正しました。
+ `toList()` のような終了メソッドが用いられる際に実験的な DFE エンジンにおいて文字列トラバーサル実行にあった Gremlin のバグを修正しました。
+ 文字列クエリの `iterate()` ステップ使用時にトランザクションを閉じない Gremlin のバグを修正しました。
+ 特定の条件下で例外をスローする `is(P.gte(0))` パターン使用時にクエリが生じる場合があった Gremlin のバグを修正しました。
+ `ConcurrentModificationException` が発生した際に特定の状況において、レスポンスコードとして `InternalFailureException` が設定されるという Gremlin のバグを修正しました。
+ 特定の条件下でエッジや頂点を更新すると過渡 `InternalFailureException` が発生する可能性がある Gremlin バグを修正しました。

## このリリースでサポートされるクエリ言語バージョン
<a name="engine-releases-1.0.3.0.R3-query-versions"></a>

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

## エンジンリリース 1.0.3.0.R3 へのアップグレードパス
<a name="engine-releases-1.0.3.0.R3-upgrade-paths"></a>

エンジンバージョン `1.0.3.0` を実行している場合、クラスターは次のメンテナンス期間中に自動的にこのパッチリリースにアップグレードされます。

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

## このリリースへのアップグレード
<a name="engine-releases-1.0.3.0.R3-upgrading"></a>

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 クラスターの使用を再開できます。

### アップグレードの前に必ずテストする
<a name="engine-1.0.3.0.R3-test-before-upgrading"></a>

新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。

まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。

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

### アップグレードの前に必ずスナップショットを手動で作成してください
<a name="engine-1.0.3.0.R3-snapshot-before-upgrading"></a>

アップグレードの前に必ず 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)
<a name="engine-releases-1.0.3.0.R2"></a>

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

## このエンジンリリースの改良点
<a name="engine-releases-1.0.3.0.R2-improvements"></a>
+ `properties()` ステップの Gremlin のパフォーマンスが改善されました。
+ `BindOp` および `MultiplexerOp` 説明レポートとプロファイルレポートに関する詳細の追加。
+ SPARQL クエリレスポンスについて、`charset` を Content-Type ヘッダーに追加し、HTTP クライアントが使用されている文字セットを自動的に認識できるようにします。

## このエンジンリリースで修正された不具合
<a name="engine-releases-1.0.3.0.R2-defects"></a>
+ `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` のような理由でロードが失敗したときにロードステータスを取得するバグを修正しました。

## このリリースでサポートされるクエリ言語バージョン
<a name="engine-releases-1.0.3.0.R2-query-versions"></a>

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

## エンジンリリース 1.0.3.0.R2 へのアップグレードパス
<a name="engine-releases-1.0.3.0.R2-upgrade-paths"></a>

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

クラスターの `AutoMinorVersionUpgrade` パラメータが `True` に設定されている場合、クラスターは、このリリース日から 2～3 週間後、メンテナンス期間中に自動的にこのエンジンリリースにアップグレードされます。

## このリリースへのアップグレード
<a name="engine-releases-1.0.3.0.R2-upgrading"></a>

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 クラスターの使用を再開できます。

### アップグレードの前に必ずテストする
<a name="engine-1.0.3.0.R2-test-before-upgrading"></a>

新しいメジャーまたはマイナーバージョンの Neptune エンジンがリリースされたら、アップグレードする前に、まず最初に Neptune アプリケーションをテストしてください。マイナーアップグレードでも、コードに影響する新しい機能や動作が導入される可能性があります。

まず、現在のバージョンのリリースノートページと対象バージョンのリリースノートページを比較して、クエリ言語のバージョンに変更があるか、その他の重大な変更がないかを確認します。

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

### アップグレードの前に必ずスナップショットを手動で作成してください
<a name="engine-1.0.3.0.R2-snapshot-before-upgrading"></a>

アップグレードの前に必ず 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 サポートチームにお問い合わせください。