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á.
Use o estado Map para executar um conjunto de etapas do fluxo de trabalho para cada item em um conjunto de dados. As iterações do estado Map são executadas em paralelo, o que possibilita o processamento rápido de um conjunto de dados. Os estados Map podem usar uma variedade de tipos de entrada, incluindo uma matriz JSON, uma lista de objetos do Amazon S3 ou um arquivo CSV.
O Step Functions fornece dois tipos de modos de processamento para usar o estado Map em seus fluxos de trabalho: modo Inline e modo Distribuído.
dica
Para implantar um exemplo de fluxo de trabalho que usa um Map estado, consulte Processamento de matrizes de dados com Choice and Map
Modos de processamento do estado do mapa
O Step Functions fornece os seguintes modos de processamento para o estado Map, dependendo de como você deseja processar os itens em um conjunto de dados.
-
Em linha — modo de concorrência limitada. Nesse modo, cada iteração do estado
Mapé executada no contexto do fluxo de trabalho que contém o estadoMap. O Step Functions adiciona o histórico de execução dessas iterações ao histórico de execuções do fluxo de trabalho principal. Por padrão, os estadosMapsão executados no modo Em linha.Nesse modo, o estado
Mapaceita somente uma matriz JSON como entrada. Além disso, esse modo oferece suporte para até 40 iterações simultâneas.Para obter mais informações, consulte Usar o estado de mapa no modo inline em fluxos de trabalho do Step Functions.
-
Distribuído — modo de alta simultaneidade. Nesse modo, o estado
Mapexecuta cada iteração como uma execução de fluxo de trabalho secundário, o que permite um processamento simultâneo de até 10 mil execuções paralelas de fluxo de trabalho secundário. Cada execução de fluxo de trabalho secundário tem seu próprio histórico de execução separado do fluxo de trabalho principal.Nesse modo, o estado
Mappode aceitar uma matriz JSON ou uma fonte de dados do Amazon S3, como um arquivo CSV, como entrada.Para obter mais informações, consulte Modo distribuído.
O modo a ser utilizado depende de como você deseja processar os itens em um conjunto de dados. Use o estado Map no modo Em linha se o histórico de execução do fluxo de trabalho não exceder 25 mil entradas ou se você não precisar de mais de 40 iterações simultâneas.
Use o estado Map no modo distribuído quando precisar orquestrar workloads paralelas em grande escala que atendam a qualquer combinação das seguintes condições:
O tamanho do seu conjunto de dados excede 256 KiB.
O histórico de eventos de execução do fluxo de trabalho excederia 25.000 entradas.
Você precisa de uma simultaneidade de mais de 40 iterações simultâneas.
Diferenças entre o modo Em linha e Distribuído
A tabela a seguir destaca as diferenças entre os modos Em linha e Distribuído.
| Modo inline | Modo distribuído |
|---|---|
| Supported data sources | |
Aceita uma matriz JSON transmitida de uma etapa anterior no fluxo de trabalho como entrada. |
Aceita as seguintes fontes de dados como entrada:
|
| Map iterations | |
|
Nesse modo, cada iteração do estado |
Nesse modo, o estado |
| Maximum concurrency for parallel iterations | |
Permite que você execute até 40 iterações da maneira mais simultânea possível. |
Permite executar até 10 mil execuções paralelas de fluxo de trabalho secundário para processar milhões de itens de dados ao mesmo tempo. |
| Input payload and event history sizes | |
Impõe um limite de 256 KiB no tamanho da carga de entrada e 25.000 entradas no histórico de eventos de execução. |
Permite superar a limitação do tamanho de payload porque o estado Nesse modo, também é possível superar as limitações do histórico de execução, porque as execuções do fluxo de trabalho secundário iniciadas pelo estado |
| Monitoring and observability | |
|
Você pode revisar o histórico de execução de fluxo de trabalho no console ou invocando a ação da API Você também pode visualizar o histórico de execução por meio CloudWatch de um X-Ray. |
Ao executar um estado Para obter mais informações, consulte Visualizar uma execução de mapa distribuído no Step Functions. |
