View a markdown version of this page

使用服务托管分发的生产者 API 行为 - Amazon Kinesis Data Streams

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

使用服务托管分发的生产者 API 行为

在直播上启用服务管理的记录分发后,以下行为适用于PutRecord和 PutRecordsAPI:

  • PartitionKey:可选。如果提供,则在分片放置时会忽略该值。该服务使用内部算法分发记录。

  • ExplicitHashKey— 如果提供,则在分片放置时会忽略该值,与PartitionKey。该服务使用内部算法分发记录。

  • SequenceNumberForOrdering(PutRecord仅限)— 不得提供。 PutRecord包含此字段的请求会被拒绝InvalidArgumentException。订购不适用于服务管理的分发。上不存在此字段PutRecords。

注意

启用服务管理模式后,提供分区键的现有生产者应用程序无需修改即可继续运行。该服务会忽略分区键值,这意味着您可以在生产流上启用此功能,而无需协调团队间的代码部署。

如果您使用 KPL 发送没有分区键的记录,请升级到最新的 KPL 版本。如果您直接使用 AWS SDK,则只要继续提供分区键,就无需更改 SDK;要省略分区键,必须升级到最新的 SDK 版本。有关更多信息,请参阅重要注意事项和带有服务管理流的 KPL 和 KCL。