ItemBatcher (Carte)

Spécifie le nombre maximum d'éléments traités par chaque exécution de flux de travail enfant. L'interpréteur limite le nombre d'éléments groupés dans le Items tableau à cette valeur. Si vous spécifiez à la fois un numéro de lot et une taille, l'interpréteur réduit le nombre d'articles dans un lot pour éviter de dépasser la limite de taille de lot spécifiée.

Si vous ne spécifiez pas cette valeur mais que vous fournissez une valeur pour la taille de lot maximale, Step Functions traite autant d'éléments que possible lors de chaque exécution du flux de travail enfant sans dépasser la taille de lot maximale en octets.

Par exemple, imaginez que vous exécutiez une exécution avec un fichier JSON d'entrée contenant 1 130 nœuds. Si vous spécifiez une valeur maximale de 100 articles pour chaque lot, Step Functions crée 12 lots. Parmi ceux-ci, 11 lots contiennent 100 articles chacun, tandis que le douzième lot contient les 30 articles restants.

Vous pouvez également spécifier le nombre maximum d'éléments pour chaque lot comme chemin de référence vers une paire clé-valeur existante dans l'entrée d'état de votre carte distribuée. Ce chemin doit être résolu en un entier positif.

Par exemple, avec les données d'entrée suivantes :

{
  "maxBatchItems": 500
}

Vous pouvez spécifier le nombre maximum d'articles à regrouper en utilisant un chemin de référence (JSONPath uniquement) comme suit :

{
  ...
  "Map": {
    "Type": "Map",
    "MaxConcurrency": 2000,
    "ItemBatcher": {
      "MaxItemsPerBatchPath": "$.maxBatchItems"
    }
    ...
    ...
  }
}

Pour les états JSONatabasés, vous pouvez également fournir une JSONata expression dont le résultat est un entier positif.

Spécifie la taille maximale d'un lot en octets, jusqu'à 256 KiB. Si vous spécifiez à la fois un numéro de lot et une taille maximum, Step Functions réduit le nombre d'articles dans un lot pour éviter de dépasser la limite de taille de lot spécifiée.

Vous pouvez également spécifier la taille de lot maximale comme chemin de référence vers une paire clé-valeur existante dans l'entrée d'état de votre carte distribuée. Ce chemin doit être résolu en un entier positif.

Par exemple, avec les données d'entrée suivantes :

{
  "batchSize": 131072
}

Vous pouvez spécifier la taille de lot maximale à l'aide d'un chemin de référence comme suit :

{
  ...
  "Map": {
    "Type": "Map",
    "MaxConcurrency": 2000,
    "ItemBatcher": {
      "MaxInputBytesPerBatchPath": "$.batchSize"
    }
    ...
    ...
  }
}

Pour les états JSONatabasés, vous pouvez également fournir une JSONata expression dont le résultat est un entier positif.

Vous pouvez également éventuellement spécifier une entrée JSON fixe à inclure dans chaque lot transmis à chaque exécution de flux de travail enfant. Step Functions fusionne cette entrée avec celle de chaque exécution de flux de travail enfant individuelle. Par exemple, étant donné la saisie fixe suivante d'une date de vérification des faits sur un tableau d'éléments :

"ItemBatcher": {
    "BatchInput": {
        "factCheck": "December 2022"
    }
}

Chaque exécution d'un flux de travail enfant reçoit les informations suivantes en entrée :

{
  "BatchInput": {
    "factCheck": "December 2022"
  },
  "Items": [
    {
      "verdict": "true",
      "statement_date": "6/11/2008",
      "statement_source": "speech"
    },
    {
      "verdict": "false",
      "statement_date": "6/7/2022",
      "statement_source": "television"
    },
    ...
  ]
}

Pour les états JSONatabasés, vous pouvez fournir des JSONata expressions directement ou utiliser des JSONata expressions dans des objets ou des tableaux JSON. BatchInput