> For the complete documentation index, see [llms.txt](https://ksaar.gitbook.io/ksaar-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ksaar.gitbook.io/ksaar-documentation/tutoriels/sauvegarder-ses-donnees.md).
# Sauvegarder ses données
## La sauvegarde qu’est-ce que c’est?
Une sauvegarde est une copie datée des données contenues dans une table à un instant précis.\
Elle permet de conserver de façon sécurisée les enregistrements existants, et offre la possibilité de restaurer ces données dans la table d’origine à une date ultérieure en cas de besoin (erreur, perte accidentelle ou retour nécessaire à un état antérieur)
### Faire une sauvegarde
La création de sauvegarde se déclenche depuis la vue data, uniquement depuis l'environnement de production.
Dans les paramètres de la vue data
Lors de la création d’une sauvegarde, il est possible :
* d’ajouter une description et de sélectionner les tables à sauvegarder
* de choisir les tables à sauvegarder / sélectionner de sauvegarder toutes les tables
La pop-up de sauvegarde de données
### Restaurer une sauvegarde
La restauration de données permet de revenir à un état précédent des enregistrements de table. Il suffit de choisir les tables à restaurer, la méthode voulue et de valider la restauration.
La pop-up de restauration de données
{% hint style="danger" %}
L’opération de validation est conçue afin que le maker soit conscient de l’aspect permanent et irréversible de l’action.
Si des données non sauvegardées sont supprimées, elles ne pourront pas être restaurées.
{% endhint %}
### Pourquoi sauvegarder ses données ?
La sauvegarde abrite le *maker* d’une perte de données lors d’une fausse manipulation ou d’un changement d’avis. La sauvegarde mémorise la structure et les enregistrements d’une table afin de les restaurer si besoin. La sauvegarde peut aussi être utilisée comme archive si besoin.
La restauration est utile notamment lors d’une manipulation erronée des tables, leur fonctionnement, ou les données qui s’y trouvent. Comme cité précédemment, la restauration de données ne change pourtant pas leur structure.
{% hint style="info" %}
Il est seulement possible de créer une sauvegarde à partir de l’environnement des données en production.
{% endhint %}
{% hint style="success" %}
Pour le moment, il n'est pas possible de sauvegarder des tables d’utilisateurs.
{% endhint %}
### Sauvegardes et multi-environnement
Lors de la restauration d’une table, seule la donnée est restaurée : la structure de la table cible reste inchangée.
Si la structure de la table source (la sauvegarde) est différente de celle de la table cible (par exemple, lorsqu’on restaure une sauvegarde réalisée sur une version antérieure de l’application), tous les champs présents dans la sauvegarde seront restaurés :
* Si un champ existait déjà dans la sauvegarde, mais a depuis été supprimé dans la structure actuelle de la table cible, ses données seront bien restaurées, mais resteront non visibles tant que ce champ ne sera pas réintégré dans la structure actuelle de la table.
* Si un champ a été ajouté à la structure de la table cible après la sauvegarde, ce champ existera bien dans la table restaurée, mais restera vide (sans données) puisque le champ ne pouvait pas être rempli à l'instant de la sauvegarde
Les données restaurées mais actuellement non visibles redeviendront automatiquement accessibles si la structure de la table est modifiée lors d’une mise en production ultérieure, en réintroduisant ces champs.
Récapitulons sur un schéma, lorsque l'app est versionnée :
Fonctionnement de la sauvegarde de données dans le contexte du multi-environnement
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://ksaar.gitbook.io/ksaar-documentation/tutoriels/sauvegarder-ses-donnees.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.