サービスマネージドディストリビューションを使用したプロデューサー API の動作

ストリームでサービスマネージドレコードディストリビューションが有効になっている場合、PutRecord API と PutRecords API には次の動作が適用されます。 APIs

• PartitionKey – オプション。指定した場合、シャード配置の値は無視されます。サービスは、内部アルゴリズムを使用してレコードを配布します。

• ExplicitHashKey – 指定した場合、値は と同じシャード配置では無視されますPartitionKey。サービスは、内部アルゴリズムを使用してレコードを配布します。

• SequenceNumberForOrdering (PutRecord のみ) – 指定しないでください。このフィールドを含むPutRecordリクエストは で拒否されますInvalidArgumentException。注文はサービスマネージドディストリビューションには適用されません。このフィールドは に存在しませんPutRecords。

注記

サービスマネージドモードが有効になっている場合、パーティションキーを提供する既存のプロデューサーアプリケーションは変更することなく動作し続けます。サービスはパーティションキー値を無視します。つまり、チーム間でコードデプロイを調整することなく、本番ストリームでこの機能を有効にできます。

KPL を使用してパーティションキーなしでレコードを送信する場合は、最新の KPL バージョンにアップグレードします。 AWS SDK を直接使用する場合、パーティションキーを提供し続ける限り SDK の変更は必要ありません。パーティションキーを省略するには、最新の SDK バージョンにアップグレードする必要があります。詳細については、「重要な考慮事項」および「サービスマネージドストリームを使用した KPL と KCL」を参照してください。