本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用服務受管分佈的生產者 API 行為
在串流上啟用服務受管記錄分佈時,下列行為適用於 PutRecord 和 PutRecords APIs:
-
PartitionKey – 選用。如果提供,則會忽略碎片放置的值。服務會使用內部演算法來分配記錄。
-
ExplicitHashKey – 如果提供,則會忽略碎片放置的值,與 相同
PartitionKey。服務會使用內部演算法來分配記錄。 -
SequenceNumberForOrdering (僅限 PutRecord) – 不得提供。包含此欄位的
PutRecord請求會遭到 拒絕InvalidArgumentException。排序不適用於服務受管分佈。此欄位不存在於 上PutRecords。
注意
啟用服務受管模式時,提供分割區索引鍵的現有生產者應用程式會繼續運作,而無需修改。此服務會忽略分割區索引鍵值,這表示您可以在生產串流上啟用此功能,而無需協調整個團隊的程式碼部署。
如果您使用 KPL 傳送不含分割區索引鍵的記錄,請升級至最新的 KPL 版本。如果您直接使用 AWS SDK,只要您繼續提供分割區索引鍵,就不需要變更 SDK;若要省略分割區索引鍵,您必須升級至最新的 SDK 版本。如需詳細資訊,請參閱重要考量及具有服務受管串流的 KPL 和 KCL。