View a markdown version of this page

Verhalten der Produzenten-API bei serviceverwalteter Verteilung - Amazon Kinesis Data Streams

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verhalten der Produzenten-API bei serviceverwalteter Verteilung

Wenn die serviceverwaltete Datensatzverteilung in einem Stream aktiviert ist, gilt das folgende Verhalten für die APIs PutRecordund PutRecords:

  • PartitionKey – Optional. Falls angegeben, wird der Wert bei der Shard-Platzierung ignoriert. Der Dienst verteilt den Datensatz mithilfe interner Algorithmen.

  • ExplicitHashKey— Falls angegeben, wird der Wert bei der Platzierung des Shards ignoriert, genau wie. PartitionKey Der Dienst verteilt den Datensatz mithilfe interner Algorithmen.

  • SequenceNumberForOrdering(PutRecordnur) — Darf nicht bereitgestellt werden. PutRecordAnfragen, die dieses Feld enthalten, werden mit einem abgelehntInvalidArgumentException. Die Bestellung gilt nicht für den servicegesteuerten Vertrieb. Dieses Feld existiert nicht amPutRecords.

Anmerkung

Bestehende Producer-Anwendungen, die Partitionsschlüssel bereitstellen, funktionieren weiterhin ohne Änderungen, wenn der vom Service verwaltete Modus aktiviert ist. Der Dienst ignoriert die Partitionsschlüsselwerte, was bedeutet, dass Sie diese Funktion für Produktionsstreams aktivieren können, ohne die Codebereitstellung zwischen Ihren Teams zu koordinieren.

Wenn Sie die KPL zum Senden von Datensätzen ohne Partitionsschlüssel verwenden, führen Sie ein Upgrade auf die neueste KPL-Version durch. Wenn Sie das AWS SDK direkt verwenden, ist keine SDK-Änderung erforderlich, solange Sie weiterhin einen Partitionsschlüssel angeben. Um den Partitionsschlüssel wegzulassen, müssen Sie auf die neueste SDK-Version aktualisieren. Weitere Informationen erhalten Sie unter Wichtige Überlegungen und KPL und KCL mit serviceverwalteten Streams.