View a markdown version of this page

Comportamento da API do produtor com distribuição gerenciada por serviços - Amazon Kinesis Data Streams

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Comportamento da API do produtor com distribuição gerenciada por serviços

Quando a distribuição de registros gerenciados por serviços é ativada em um stream, o seguinte comportamento se aplica às APIs PutRecorde PutRecords:

  • PartitionKey: opcional. Se fornecido, o valor será ignorado para colocação de fragmentos. O serviço distribui o registro usando algoritmos internos.

  • ExplicitHashKey— Se fornecido, o valor é ignorado para colocação de fragmentos, o mesmo quePartitionKey. O serviço distribui o registro usando algoritmos internos.

  • SequenceNumberForOrdering(PutRecordsomente) — Não deve ser fornecido. PutRecordsolicitações que incluem esse campo são rejeitadas com umInvalidArgumentException. O pedido não é aplicável à distribuição gerenciada por serviços. Esse campo não existe emPutRecords.

nota

Os aplicativos de produção existentes que fornecem chaves de partição continuam funcionando sem modificações quando o modo gerenciado por serviços está ativado. O serviço ignora os valores da chave de partição, o que significa que você pode habilitar esse recurso em fluxos de produção sem coordenar as implantações de código em suas equipes.

Se você usar o KPL para enviar registros sem uma chave de partição, atualize para a versão mais recente do KPL. Se você usa o AWS SDK diretamente, nenhuma alteração no SDK é necessária, desde que você continue fornecendo uma chave de partição. Para omitir a chave de partição, você deve atualizar para a versão mais recente do SDK. Para obter mais informações, consulte Considerações importantes e KPL e KCL com fluxos gerenciados por serviços.