

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.

# Meilleures pratiques pour les articles en vrac dans DynamoDB

Voici les meilleures pratiques relatives à l'utilisation d'articles vendus en vrac.

## Répartissez votre saisie sur plusieurs objets S3 de taille similaire
<a name="BulkPutItems.BestPractices.SplitInput"></a>

DynamoDB lit et traite les objets S3 en parallèle, de sorte qu'un ensemble d'objets de taille similaire s'exécute plus rapidement qu'un seul objet de grande taille ou une combinaison d'objets très grands et très petits. Chaque opération prend en charge jusqu'à 50 000 objets S3, et chaque objet peut atteindre 5 Go. Si votre jeu de données contient plus de 50 000 objets, consolidez-les en objets plus petits et plus grands.

## Respectez la limite de taille correspondant à votre niveau de performance
<a name="BulkPutItems.BestPractices.SizeLimit"></a>

Chaque niveau de performance a sa propre limite quant à la taille d'entrée totale d'une opération. Pour charger un jeu de données supérieur à la limite, divisez-le en plusieurs opérations ou utilisez le niveau de performances accélérées si votre table le permet. Pour les limites, voir [Quotas pour les articles vendus en vrac](ServiceQuotas.md#limits-bulk-put-items).

## Répartissez les écritures de manière uniforme sur l'espace clavier
<a name="BulkPutItems.BestPractices.DistributeKeys"></a>

Les éléments placés en bloc donnent de meilleurs résultats lorsque vos données comportent des clés de partition à cardinalité élevée qui sont réparties uniformément dans l'espace clé. Si un objet S3 contient des éléments triés par clé de partition, les écritures consécutives ciblent la même partition, ce qui crée une partition dynamique et ralentit l'opération. Répartissez aléatoirement l'ordre des données triées avant de démarrer l'opération. Pour plus d’informations, consultez [Distribution efficace de l’activité d’écriture pendant le chargement de données dans DynamoDB](bp-partition-key-data-upload.md).

## Validez votre saisie avant de commencer
<a name="BulkPutItems.BestPractices.ValidateInput"></a>

Exécutez une passe de validation sur un échantillon de vos fichiers avant de soumettre une opération importante, car un seul enregistrement que DynamoDB ne peut pas analyser l'empêche de lire le reste de cet objet et peut mettre fin à l'ensemble de l'opération `FAILED`. Pour connaître les conditions qui arrêtent un objet, voir [Erreurs de validation qui arrêtent un objet](BulkPutItems.Format.md#BulkPutItems.Format.ValidationErrors).

## Utiliser des expressions conditionnelles pour protéger les données existantes
<a name="BulkPutItems.BestPractices.Conditions"></a>

Si vous ne devez pas remplacer des données existantes ou plus récentes, ajoutez une condition d'insertion uniquement ou une protection de version à chaque enregistrement, y compris les clés que votre application écrit pendant l'exécution de l'opération. Pour la syntaxe et des exemples, voir [Per-item expressions de condition](BulkPutItems.Format.md#BulkPutItems.Format.Conditions) et [Ecritures simultanées sur les mêmes touches](BulkPutItems.Considerations.md#BulkPutItems.Considerations.ConcurrentWrites).

## Ne modifiez pas les objets S3 pendant une opération active
<a name="BulkPutItems.BestPractices.NoModification"></a>

Conservez vos objets S3 source inchangés pendant qu'une opération est en cours. La modification d'un objet d'entrée peut entraîner l'échec de l'opération avec un code d'échec `ObjectModifiedInS3DuringImport`. Attendez la fin de l'opération avant de modifier les fichiers source et redémarrez-la avec une version stable des objets si cette erreur s'affiche.

## Utiliser un jeton client lorsque vous réessayez une demande de démarrage
<a name="BulkPutItems.BestPractices.ClientToken"></a>

Passez un [ClientToken](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_StartBulkPutItems.html#DDB-StartBulkPutItems-request-ClientToken) avec [StartBulkPutItems](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_StartBulkPutItems.html) chaque fois que vous pourriez réessayer la demande, de sorte qu'une nouvelle tentative renvoie l'opération existante au lieu d'en démarrer une seconde. Pour savoir comment fonctionne le jeton, voir [Démarrage d'une opération de vente d'articles en vrac](BulkPutItems.Requesting.md#BulkPutItems.Requesting.Start).

## Protégez les consommateurs des flux en aval
<a name="BulkPutItems.BestPractices.Streams"></a>

Sur une table sur laquelle DynamoDB Streams ou un flux de données Kinesis est activé, chaque écriture en masse produit un enregistrement de flux au taux d'écriture de l'opération. Les consommateurs dimensionnés pour un trafic normal peuvent prendre du retard. DynamoDB Streams conserve les enregistrements pendant 24 heures. Set [MaxWriteRequestUnits](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_StartBulkPutItems.html#DDB-StartBulkPutItems-request-MaxWriteRequestUnits) pour plafonner le taux d'écriture des articles vendus en gros à un niveau que vos consommateurs peuvent maintenir.

Ne pas régler `MaxWriteRequestUnits` inférieur à ce dont vous avez besoin. Un plafond bas ralentit l'opération, de sorte qu'une opération de grande envergure risque de ne pas se terminer dans les délais de traitement maximum et de se terminer `FAILED` avec code d'échec `Timeout`, en laissant les éléments restants non écrits. Choisissez le taux le plus élevé que vos consommateurs peuvent supporter. Pour plus d'informations, consultez [Valeurs de statut](BulkPutItems.Requesting.md#BulkPutItems.Requesting.Describe.Status).