View a markdown version of this page

Comportement de l'API du producteur avec une distribution gérée par les services - Amazon Kinesis Data Streams

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Comportement de l'API du producteur avec une distribution gérée par les services

Lorsque la distribution d'enregistrements gérée par le service est activée sur un flux, le comportement suivant s'applique aux API PutRecordet PutRecords:

  • PartitionKey : facultatif. Si elle est fournie, la valeur est ignorée pour le placement des partitions. Le service distribue l'enregistrement à l'aide d'algorithmes internes.

  • ExplicitHashKey— Si elle est fournie, la valeur est ignorée pour le placement des partitions, commePartitionKey. Le service distribue l'enregistrement à l'aide d'algorithmes internes.

  • SequenceNumberForOrdering(PutRecorduniquement) — Ne doit pas être fourni. PutRecordles demandes qui incluent ce champ sont rejetées avec unInvalidArgumentException. La commande ne s'applique pas à la distribution gérée par des services. Ce champ n'existe pas surPutRecords.

Note

Les applications de production existantes qui fournissent des clés de partition continuent de fonctionner sans modification lorsque le mode de gestion des services est activé. Le service ignore les valeurs des clés de partition, ce qui signifie que vous pouvez activer cette fonctionnalité sur les flux de production sans coordonner les déploiements de code au sein de vos équipes.

Si vous utilisez le KPL pour envoyer des enregistrements sans clé de partition, passez à la dernière version du KPL. Si vous utilisez directement le AWS SDK, aucune modification du SDK n'est requise tant que vous continuez à fournir une clé de partition ; pour omettre la clé de partition, vous devez passer à la dernière version du SDK. Pour plus d’informations, consultez Considérations importantes et KPL et KCL avec des flux gérés par des services.