View a markdown version of this page

使用服務受管分佈的生產者 API 行為 - Amazon Kinesis Data Streams

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

使用服務受管分佈的生產者 API 行為

在串流上啟用服務受管記錄分佈時,下列行為適用於 PutRecord 和 PutRecords APIs:

  • PartitionKey – 選用。如果提供,則會忽略碎片放置的值。服務會使用內部演算法來分配記錄。

  • ExplicitHashKey – 如果提供,則會忽略碎片放置的值,與 相同PartitionKey。服務會使用內部演算法來分配記錄。

  • SequenceNumberForOrdering (僅限 PutRecord) – 不得提供。包含此欄位的PutRecord請求會遭到 拒絕InvalidArgumentException。排序不適用於服務受管分佈。此欄位不存在於 上PutRecords。

注意

啟用服務受管模式時,提供分割區索引鍵的現有生產者應用程式會繼續運作,而無需修改。此服務會忽略分割區索引鍵值,這表示您可以在生產串流上啟用此功能,而無需協調整個團隊的程式碼部署。

如果您使用 KPL 傳送不含分割區索引鍵的記錄,請升級至最新的 KPL 版本。如果您直接使用 AWS SDK,只要您繼續提供分割區索引鍵,就不需要變更 SDK;若要省略分割區索引鍵,您必須升級至最新的 SDK 版本。如需詳細資訊,請參閱重要考量及具有服務受管串流的 KPL 和 KCL。