View a markdown version of this page

重要な考慮事項 - Amazon Kinesis Data Streams

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

重要な考慮事項

  • null パーティションキーの KPL アップグレード – パーティションキーなしでレコードを送信する場合は、最新の KPL バージョンにアップグレードする必要があります。パーティションキーを引き続き提供するお客様は、KPL または KCL の変更は必要ありません。詳細については、「サービスマネージドストリームを使用した KPL と KCL」を参照してください。

  • AWS SDK に関する考慮事項 – AWS SDK を直接 (KPL や KCL ではなく) 使用してサービスマネージドストリームに対して生成または消費する場合は、 を有効にする前に以下を確認してくださいAUTO。

    • プロデューサー – 最新の SDK バージョンにアップグレードして、サービスマネージドストリームに書き込むときにパーティションキーを省略します。最新の SDK では、 PartitionKeyはオプションであるため、これPutRecordsなしで PutRecordおよび を呼び出すことができます。パーティションキーを引き続き指定する場合、SDK の変更は必要ありません。サービスは値を受け入れ、シャード配置を無視します。既存のコンシューマーが読み取り元のストリームで null パーティションキーを有効にAUTOして送信を開始する前に、それらのコンシューマーを更新して、存在しない を処理しますPartitionKey。

    • コンシューマー – サービスマネージドストリームでは、 GetRecords は なしで書き込まれたレコードの欠落 (null) 値PartitionKeyとして SubscribeToShard を返します。読み取りPartitionKeyを行い、常に存在すると想定するコンシューマーは、そのようなレコードを読み取るときに実行時に失敗する可能性があります。これは SDK バージョンに関係なく適用されます。これらのレコードを安全に読み取るために最新の SDK バージョンにアップグレードし、欠落した値を処理するようにコードを更新します。 AWS SDK for Go、 AWS SDK for Kotlin、および AWS SDK for Rust の場合、アップグレードするとさらにオプションタイプPartitionKeyに変更されるため、未処理の欠落値はアップグレード時にコンパイル時のエラーとして表示されます。読み取りを行わないコンシューマーPartitionKeyは影響を受けません。

  • 集約はサポートされていません – KPL 集約は、KPL バージョンのサービスマネージドストリームではサポートされていません。サービスマネージドレコードディストリビューションを使用する場合は、集約を無効にすることを検討してください。詳細については、「サービスマネージドストリームを使用した KPL と KCL」を参照してください。

  • ストリーム内で混合することはできません – レコード分散戦略はストリーム全体に適用されます。サービスマネージドパーティションキーとユーザーマネージドパーティションキーの両方を同じストリームで同時に使用することはできません。順序付きデータと順序なしデータの両方を必要とするワークロードの場合は、個別のストリームを作成します。

  • 新しいサービス制限なし – サービスマネージドレコードディストリビューションでは、新しい制限は導入されません。既存の Kinesis Data Streams の制限は引き続き適用されます。これには、レコードあたり最大 1 MB、書き込み用にシャードあたり 1 秒あたり 1,000 レコード、PutRecords リクエストあたり 500 レコードが含まれます。