> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solya.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Bac à sable

> Validez un fichier par rapport à vos spécifications d'ingestion avant de le promouvoir en production.

Le **bac à sable** vous permet de tester l'ingestion de manière sûre. Vous téléchargez un fichier, Solya l'analyse et
le valide sans toucher aux données de production, et vous examinez les conclusions avant
de décider de **promouvoir**.

## Deux étapes

<Steps>
  <Step title="Ingérer (valider)">
    Téléchargez un fichier. Une **exécution d'ingestion de bac à sable** l'analyse, correspond à une spécification d'ingestion (ou celle que vous forcez), écrit dans les tables temporaires et produit des **conclusions**.
  </Step>

  <Step title="Promouvoir (publier)">
    Si les conclusions semblent bonnes, une **exécution de promotion de bac à sable** copie les données validées dans
    la couche silver pour utilisation en production.
  </Step>
</Steps>

## Conclusions

Chaque conclusion a une **gravité** — `error`, `warning` ou `info` — et une **étape** où elle
est apparue (detect, parse, map, loader, strict scan, quarantine). Les codes de conclusion courants incluent
la perte de coercition, les champs supplémentaires, la dérive de forme, l'exception de loader, la validation des lignes, l'erreur d'analyse,
et "aucune spécification ne correspondait". L'exécution conserve les conclusions principales et les logs complets.

## Statuts d'exécution

Les exécutions d'ingestion et de promotion passent par `PENDING → RUNNING → SUCCESS / FAILED`.

<Note>
  Une exécution de promotion peut se terminer comme **SUCCESS mais interrompue** — elle s'est exécutée correctement mais a refusé de
  copier parce que l'ingestion avait des erreurs et vous n'aviez pas autorisé la promotion avec erreurs. C'est un
  refus sûr, pas un échec. Vous pouvez ré-exécuter en autorisant les erreurs si vous avez l'intention de procéder.
</Note>
