HOWTO · Pandas
Comment ajouter des données à un fichier CSV avec Pandas
Ce tutoriel montre comment ajouter des données à un fichier CSV existant en utilisant to_csv() en mode append
Sur cette page
Utilisez Pandas to_csv() avec mode="a" pour ajouter des lignes d’un DataFrame après celles déjà présentes dans un fichier CSV. Le mode ajout préserve le contenu existant. Définissez header=False si le fichier possède déjà un en-tête, et index=False si l’index du DataFrame ne doit pas devenir une colonne supplémentaire du CSV.
Ajouter un DataFrame à un fichier CSV existant
Cet exemple crée un premier fichier CSV, puis y ajoute un second DataFrame. Dans votre propre code, indiquez le chemin de votre fichier CSV. Conservez les colonnes ajoutées dans le même ordre que celles du fichier existant : les fichiers CSV ne stockent pas de schéma permettant de réordonner automatiquement les valeurs selon le nom des colonnes.
Exécutez cet exemple :
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
from pathlib import Path
from tempfile import TemporaryDirectory
import pandas as pd
with TemporaryDirectory() as directory:
path = Path(directory) / "records.csv"
original = pd.DataFrame({"name": ["Ava"], "score": [8]})
added = pd.DataFrame({"name": ["Noah"], "score": [9]})
original.to_csv(path, index=False)
added.to_csv(path, mode="a", header=False, index=False)
print(path.read_text(), end="")
La première écriture crée le fichier et son en-tête. La seconde utilise mode="a" pour ajouter une ligne à la fin du fichier. header=False évite de répéter les noms de colonnes, et index=False empêche Pandas d’ajouter l’index des lignes. Le fichier final contient la ligne d’origine, suivie de la ligne ajoutée. Pour inclure l’index du DataFrame comme colonne, omettez index=False et tenez compte de cette colonne supplémentaire lors de la lecture du CSV. Dans la sortie affichée, les noms de colonnes name et score restent en anglais, car le bloc de code est conservé à l’identique.
Écrire l’en-tête uniquement lorsque le fichier CSV est vide
Si le fichier cible peut être vide ou ne pas encore exister, ouvrez-le en mode ajout et vérifiez sa position actuelle. Ouvrir un chemin inexistant avec mode="a" crée le fichier. L’appel tell() indique la position actuelle ; juste après l’ouverture en mode ajout, une position de 0 signifie que le fichier est vide. Écrivez l’en-tête uniquement dans ce cas.
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
from pathlib import Path
from tempfile import TemporaryDirectory
import pandas as pd
with TemporaryDirectory() as directory:
path = Path(directory) / "records.csv"
rows = pd.DataFrame({"name": ["Mia"], "score": [7]})
with path.open("a", encoding="utf-8", newline="") as csv_file:
write_header = csv_file.tell() == 0
rows.to_csv(csv_file, header=write_header, index=False)
Cette méthode fonctionne aussi bien avec un nouveau fichier qu’avec un CSV existant : un fichier nouvellement créé ou vide reçoit les noms de colonnes, tandis qu’un fichier déjà rempli ne reçoit que la nouvelle ligne. Utilisez le même ordre de colonnes et des champs compatibles à chaque ajout. Si plusieurs processus de votre programme peuvent modifier le même fichier en même temps, coordonnez les écritures afin que la vérification de l’en-tête et l’écriture de la ligne ne puissent pas s’entremêler avec celles d’un autre processus.
Vérifier les lignes ajoutées et éviter les erreurs courantes
Relisez le CSV après l’écriture si vous devez en vérifier le contenu. Dans le premier exemple, le fichier contient un en-tête, puis la ligne d’origine et celle qui a été ajoutée. Lorsque vous exécutez le code, l’instruction print(path.read_text(), end="") affiche le contenu exact du fichier sous forme de texte sélectionnable.
Lors de l’adaptation des exemples, vérifiez les points suivants :
- Les colonnes du DataFrame ajouté doivent correspondre à celles du CSV et respecter le même ordre. Pandas écrit les valeurs selon leur position ; lors d’un ajout, il ne fait pas correspondre les colonnes du CSV à partir de leurs noms.
- Utilisez
header=Falsesi le fichier non vide possède déjà un en-tête. Un en-tête répété serait lu comme une ligne de données ordinaire. - Choisissez
index=Falsesi l’index des lignes ne fait pas partie de vos données. Sinon, incluez la colonne d’index dans la structure du fichier et tenez-en compte. - Le mode ajout ajoute du texte à la fin d’un fichier ; il ne vérifie ni ne corrige les différences de colonnes, de délimiteurs ou d’encodage. Conservez des paramètres cohérents avec ceux du CSV existant.
- Si le fichier est vide, écrivez l’en-tête une seule fois avant sa première ligne de données. La vérification avec
tell()ci-dessus s’appuie sur la position du fichier ouvert en mode ajout pour prendre cette décision.
Pour vérifier rapidement le résultat en Python, chargez le fichier obtenu avec pd.read_csv(path) et examinez les lignes ainsi que les noms de colonnes. Vous vérifierez ainsi le tableau interprété et le texte écrit sur le disque.