Fusionner plusieurs fichiers Excel en un seul tableau

Connecteur de dossiers · Dossier Excel

Transformer un dossier de classeurs Excel en Tables SQL vous pouvez interroger n'importe où

Configurez l'agent Query Streams pour qu'il pointe vers le dossier. Il lit les fichiers sur son ordinateur, crée les tables dans un cache local et les maintient à jour en fonction des fichiers ajoutés, modifiés ou supprimés. Vous pouvez ensuite les interroger depuis Excel, Google Sheets, Nova, Claude ou l'API REST. Aucun fichier n'est téléchargé, converti ou modifié.

Environ 15 minutes Aucun codage nécessaire Les fichiers restent sur votre réseau Le forfait gratuit le couvre

Ce que vous obtiendrez

Vous finissez par avoir une table SQL par feuille, par exemple. fileset.data_orders, contenant les lignes de cette feuille de calcul de chaque classeur du dossier, avec un _fichier_source une colonne indiquant le classeur d'origine de chaque ligne. Insérez le classeur du mois suivant et ses lignes rejoindront le tableau lors de la prochaine analyse ; corrigez un classeur existant et ses lignes seront remplacées. L'agent lit le .xlsx Les fichiers sont stockés sur l'ordinateur où le programme s'exécute et met en cache les lignes, de sorte que les classeurs restent sur votre réseau.

Tout se trouve dans un seul schéma DuckDB appelé ensemble de fichiers, mis en cache sur l'ordinateur de l'agent. Les tables sont nommées pour vous, car il n'y a pas de Nom de la table champ. Chaque rangée contient _fichier_source et _row_id.

Chaque connecteur de dossier vous offre également fichiers, fichiers_événements, annuaires, instantanés_de_répertoire et volumes, qui répertorient les classeurs eux-mêmes, leur historique de modifications et la taille des dossiers.

Là où elle gagne sa vie :

• Rapports régionaux : chaque région enregistre le même modèle de classeur sur un espace partagé, et le siège social interroge une seule table data_orders au lieu de copier les feuilles.
• Budgets mensuels : un nouveau classeur est créé chaque mois, et le tableau fusionné s’agrandit d’un fichier sans que personne n’ait besoin de le réimporter.
• Les classeurs mixtes provenant de différentes équipes deviennent chacun leur propre tableau, avec un tableau par mise en page, nommé à partir de la partie commune de leurs noms de fichiers.

Ce dont vous aurez besoin

Un compte Query Streams

Les connecteurs de dossiers sont inclus dans tous les forfaits, même le forfait gratuit. Le forfait gratuit est permanent, et non une période d'essai. Le nombre de fichiers qu'un dossier peut contenir est illimité.

L'Agent, version 2.6.0 ou ultérieure

Installé sur un ordinateur capable d'ouvrir le dossier : le serveur de fichiers lui-même, un ordinateur de bureau ou la machine sur laquelle les fichiers sont stockés. Une version plus ancienne d'Agent affiche les fiches de dossier grisées avec un Agent 2.6.0+ badge. Windows, Mac ou Linux.

Le chemin du dossier, tel que l'agent le voit

Un chemin local, ou un partage réseau écrit comme \\serveur\partage\dossier. The Agent runs as a service, so it cannot see drives you mapped at your login (Z: and friends). On Windows it can sign in to a share with a login you store; on Linux or a Mac, mount the share first (Linux under /mnt ou /médias, a Mac under /Volumes).

Configurez-le en cinq étapes

1. Installez l'agent sur un ordinateur capable d'ouvrir le dossier.

   Connectez-vous, ouvrez TéléchargerInstallez ensuite l'agent sur l'ordinateur capable d'ouvrir un dossier contenant des classeurs Excel : le serveur de fichiers ou tout autre ordinateur toujours allumé et accessible depuis le partage. L'installation prend une minute et s'effectue ensuite automatiquement. La version 2.6.0 ou ultérieure est requise ; la page de téléchargement propose toujours la version la plus récente.

   Pourquoi un petit programme plutôt qu'un pilote ? L'agent s'installe en une seule étape sur Windows, Mac ou Linux (environ 85 Mo sous Windows, un peu plus de 100 Mo sous Mac et Linux). Il établit une connexion sortante chiffrée vers Query Streams, unique chemin réseau nécessaire : aucun port entrant ni VPN ne sont requis. Il lit le répertoire sur lequel il est installé ; les fichiers restent donc en place et seules les lignes renvoyées par une requête transitent par Internet vers l'extension, le navigateur ou le client d'IA installé sur votre serveur.

   La page de téléchargement affiche Votre clé d'accèsCollez-le dans l'Agent lorsqu'il vous le demande, et attendez que le badge affiche Connecté aux flux de requêtesC'est la seule chose que vous ferez sur l'ordinateur de l'agent ; tout le reste se passe dans votre navigateur.

   Des guides complets sont disponibles si vous le souhaitez : Fenêtres, Mac, Linux.

2. Pointez-le vers un dossier de classeurs Excel.

   Retournez dans votre navigateur ouvert Données → Agents de donnéesTrouvez l'agent que vous venez d'installer et cliquez dessus. Ajouter un connecteur bouton. Ouvrez le Fichiers et dossiers pilule et choisir le Dossier Excel carte. Vous ne savez pas quelle carte convient ? Choisissez Fichiers dans un dossier En revanche : l’agent examine le dossier, indique son contenu sur une page « Ce que nous avons trouvé » et ouvre pour vous la fiche correspondante, préremplie.

   Le magicien court Dossiers → Vérifier → Paramètres → Domaine → Consulter. Sur Dossiers:

   Dossiers racine

   One path per line, as the Agent’s computer sees it. Each folder shows a status (reachable, denied, missing, unreachable, credentials invalid or not mounted) as soon as you add it. On a Windows Agent a share that needs a login gets one from the folder’s Credential column, stored once per server; on Linux or a Mac, mount the share first.

   Analyser les sous-dossiers, profondeur maximale

   Activé, et 8 niveaux, par défaut.

   Inclure des motifs, exclure des motifs

   Quels fichiers sont pris en compte ? Le modèle d'inclusion commence par le bon glob pour cette carte. Un connecteur lit un seul type de fichier : un dossier contenant des fichiers CSV. et Les fichiers Parquet comportent deux connecteurs sur le même dossier, un par type.

   Suivez les liens symboliques et les jonctions

   Désactivé par défaut. L'agent ne suit pas les raccourcis ni les espaces réservés dans le cloud, sauf si vous activez cette option.

   Commencez par le Ajouter un connecteur bouton d'un agent permettant d'ouvrir le dossier. Ouvrir Fichiers et dossiers et cliquez sur Dossier Excel carte.

   • Dossiers racineUn dossier par ligne, correspondant aux chemins d'accès sur l'ordinateur de l'agent. Saisissez un partage réseau comme \\serveur\partage\dossier, et non pas comme une lettre de lecteur mappée.
   • Inclure des motifs commence par **/*.xlsx. Analyser les sous-dossiers est allumé.
   • Il n'y a pas Nom de la table champ. Les feuilles deviennent des tableaux tels que commandes de données. Utiliser Feuilles limiter les feuilles lues.
   • Choisissez un Mise en page du tableau. Une disposition épinglée (par défaut) Convient aux classeurs qui partagent tous les mêmes feuilles et colonnes. Une table par mise en page des dossiers adaptés que les gens assemblent à la main, jusqu'à 25 mises en page.

3. Vérifiez ce que cela va construire

   Sur Vérifier L'agent lit un échantillon de 64 fichiers maximum et affiche ce qu'il va créer. Rien n'est encore créé. Le bouton affiche : Test de connexion jusqu'à ce qu'un verdict soit rendu, alors Suivant; Réessayer L'échantillon est relancé après toute modification. Vous verrez l'un des quatre titres suivants :

   Prêt à créer

   Chaque fichier échantillonné est correctement formaté. Les puces situées en dessous indiquent le nombre de dossiers accessibles, le nombre de fichiers et de lignes, ainsi que les tables présentes.

   Prêt, avec notes

   Certains fichiers seront mis de côté, ou leur mise en page sera refusée. Une bannière orange indique précisément lesquels : « {n} des {m} fichiers seront mis de côté » avec un Afficher les fichiers concernés et pourquoi liste, et « Vous pouvez le créer quand même — le connecteur continuera à vérifier et indiquera la raison dans son onglet Manifeste. »

   Nécessite une attention particulière

   L'agent est hors ligne ou un dossier est manquant. Veuillez résoudre ce problème avant de continuer ; même si l'agent est hors ligne, la page l'indique et vous permet de poursuivre.

   « Ce dossier contient {n} différents formats de fichiers. » Un panneau bleu ciel signifie que les fichiers échantillonnés ne partagent pas tous le même ensemble de colonnes. Mise en page du tableau par défaut Une mise en page épinglée, qui exige que chaque fichier corresponde. Cliquez Passez à une table par mise en page et chaque mise en page devient sa propre table (jusqu'à 25).

   Un refus ou un fichier mis de côté ne vous bloque jamais : cliquez SuivantTerminez l'assistant et corrigez les fichiers problématiques ultérieurement. Seul un agent hors ligne ou un dossier manquant peut interrompre l'assistant.

   Sur VérifierL'agent lit un échantillon de 64 classeurs maximum et liste les tables qu'il va créer. Rien n'est encore créé. Un classeur auquel il manque une feuille épinglée est comptabilisé dans la bannière orange « {n} sur {m} fichiers seront mis de côté ». Afficher les fichiers concernés et pourquoi pour les voir tous. Un fichier qui n'est pas un véritable classeur, comme un fichier CSV renommé, y est également répertorié avec une raison telle que « illisible comme Excel : non lisible comme classeur XLSX ». Si les classeurs ont des mises en page différentes… Mise en page du tableau est toujours épinglé, un panneau bleu ciel offre Passez à une table par mise en pageSi aucun classeur ne contient l'ensemble complet de feuilles, la recherche est refusée et aucun tableau n'est créé tant que vous n'aurez pas corrigé ou exclu un fichier.

4. Choisissez la fréquence d'analyse, puis créez-le

   Les valeurs par défaut sur Paramètres Convient à un dossier qui reçoit quelques fichiers par jour. Quatre éléments que vous pourriez vouloir modifier :

   Intervalle de balayage

   Toutes les heures Par défaut, la fréquence est paramétrable ; vous pouvez choisir une fréquence de 5 minutes à une fréquence quotidienne. Chaque analyse compare la taille et la date de modification des fichiers afin de détecter les fichiers nouveaux, modifiés et supprimés.

   Surveillez le dossier pour détecter les modifications (quasi en temps réel).

   Désactivé par défaut. Activé, l'agent réagit en quelques secondes sur les disques locaux ; sur les partages réseau, il fonctionne au mieux et l'analyse planifiée reste la seule garantie. période calme (15 secondes) attend la fin de l'écriture d'un fichier.

   Actualisez la page avant de répondre à une question.

   Désactivé par défaut. Activé, une requête effectue une nouvelle analyse lorsque la dernière analyse est antérieure à la date de début. fenêtre de vieillissement (60 secondes), en attendant au maximum le limite d'attente des requêtes (5 secondes). Cela s'applique aux personnes et aux modules complémentaires, et non aux sondages d'alerte.

   Lorsqu'un fichier disparaît

   Supprimez ses lignes par défaut, ou Conserver les lignes, marquer les lignes supprimées (pierre tombale). Le Ratio de garde d'effacement (0.5) refuse une analyse qui perd plus de la moitié des fichiers à la fois et conserve l'inventaire précédent, ce à quoi ressemble un partage hors ligne.

   Ensuite, choisissez le Domaine des données les lignes sont comptabilisées, vérifiez Revoir et cliquez Créer un connecteurLe premier scan démarre immédiatement. Le connecteur Manifeste L'onglet affiche ce qu'il a construit et tous les fichiers qu'il a mis de côté.

5. Regardez vos tables

   Ouvrez le connecteur : le Manifeste L'onglet liste les tables qu'il a créées. Dans le Générateur de requêtes les mêmes tables se trouvent sous le ensemble de fichiers schéma. Trois requêtes fonctionnelles dès le premier jour :

   Combien de lignes chaque classeur ajoute-t-il à la feuille de commandes ?

   SELECT _source_file, COUNT(*) AS row_count, MIN(_row_id) AS first_row_id FROM fileset.data_orders GROUP BY _source_file ORDER BY row_count DESC LIMIT 100

   Confirme que chaque classeur régional ou mensuel a été intégré au tableau fusionné et indique la contribution de chacun.

   Quels cahiers d'exercices sont arrivés, ont été modifiés ou ont disparu cette semaine ?

   SELECT relative_path, event_type, size_bytes, prev_size_bytes, event_at FROM fileset.files_events WHERE event_type IN ('appeared', 'modified', 'vanished') AND event_at >= now() - INTERVAL 7 DAY ORDER BY event_at DESC LIMIT 100

   Affiche l'historique des modifications du dossier, vous permettant ainsi de voir qui a envoyé un nouveau classeur et quand un ancien classeur a été modifié.

   Chaque classeur du dossier, avec son propriétaire Windows

   SELECT relative_path, owner, size_bytes, modified_utc FROM fileset.files ORDER BY modified_utc DESC LIMIT 100

   Liste les classeurs que l'agent peut consulter et indique qui a enregistré chacun d'eux en dernier ; le champ propriétaire est renseigné uniquement sous Windows.

   Chaque connecteur de dossier utilise également les mêmes tables de comptabilité, le tout dans le ensemble de fichiers schéma:

   Tableau	Ce qu'il contient
   fichiers	Chaque fichier actuellement présent dans le dossier : chemin, nom, extension, taille, dates de création et de modification, première et dernière consultation. Vue d'ensemble fichiers_actuels, qui conserve également les fichiers disparus.
   fichiers_événements	L'historique des modifications : une ligne par fichier. apparu, était modifié, disparu, a été mis de côté (dérive) ou était refusé, avec le temps en événement_à, comment cela a été remarqué dans détecté par et la raison dans détail.
   annuaires, instantanés_de_répertoire, volumes	Nombre et taille des dossiers, leur évolution et les disques ou partages sur lesquels résident les fichiers racines.
   _fichier_source, _row_id	Deux colonnes par ligne de données : le fichier d’origine et un identifiant unique au sein de ce fichier. Grouper par _fichier_source comparer les fichiers.

Reaching a file on a network share

The Agent opens files as a background service, not as you, so a file on another computer needs one extra step. Which step depends on the computer the Agent runs on.

If the test cannot get to the share, look for these words in its result: unreachable means the Agent’s computer got no answer from the server. On Linux or a Mac, not mounted means the share still has to be mounted, and that message includes the exact mount command for your server.

When a folder is not reachable

Every folder on the Dossiers step shows a status as soon as you add it. Hover the status to read the Agent’s own message; its first words say which case it is.

Utilisez-le partout

Le connecteur est une source de données comme une autre dans Query Streams. Enregistrez une requête une seule fois dans le Générateur de requêtes (le dialecte est DuckDB) et utilisez-le depuis :

Excel

Les modules complémentaires Diffuser une requête Insère les lignes dans une feuille et se relance en un clic. Exécuter du SQL dans Excel.

Google Sheets

Le Flux de requêtes Le module complémentaire remplit un onglet que vous sélectionnez. Power Query pour Google Sheets.

Claude, Cursor et autres clients IA

Par l'intermédiaire du serveur MCP Query Streams, Claude connaît le modèle de dossiers, y compris _fichier_source et fichiers_événements. Dossier Excel avec Claude via MCP.

API REST

Chaque requête enregistrée devient un point de terminaison en lecture seule avec sa propre clé, sur chaque forfait. API REST du dossier Excel.

Nova

Posez des questions claires et concises sur le plan d'affaires ; Nova connaît chaque dossier, tableau et colonne grâce à ses descriptions intégrées.

Automatisations

Synchronisez les lignes avec Airtable, Smartsheet, Baserow, SeaTable ou une feuille de calcul selon un calendrier prédéfini. Guides d'automatisation.

Les tables de dossiers sont également liées à vos autres connecteurs : une requête fédérée peut correspondre _fichier_source noms ou identifiants de commande dans un dossier de classeurs Excel associés à une base de données sur le même agent.

Affichage des fichiers nouveaux, modifiés et supprimés

Fichiers mis de côté

Trois mots apparaissent à l'étape « Vérifier » et dans l'onglet « Manifeste ». Ils ont des significations différentes :

Mettre de côté (stationné)

Le fichier ne correspond pas à la mise en page définie, ou est illisible, déchiré, verrouillé ou masqué. Chaque fichier est traité de manière binaire : un fichier mis en attente ne contribue à aucune ligne. fichiers_événements enregistre un dérive rangée dont détail Le nom du fichier et de la colonne est indiqué. Le fichier est ignoré tant que sa taille et sa date de modification restent inchangées, et une nouvelle tentative est effectuée dès que ces informations sont modifiées.

Illisible

L'agent n'a pas pu ouvrir ni analyser le fichier en raison de son type : il ne s'agit pas d'un classeur valide, il est verrouillé par un autre programme, il s'agit d'un espace réservé dans le cloud ou il contient des octets indéchiffrables. Il se met en pause et le reste du dossier est traité. Seul un dossier ne contenant aucun fichier lisible refuse l'ensemble du traitement.

Refusé

L'agent n'a pu épingler aucune mise en page, par exemple parce que les fichiers ne définissent pas le type d'une colonne. Aucune table de données n'existe encore. fichiers_événements obtient un refusé dispute avec la raison dans détailL'agent effectue une nouvelle tentative à chaque analyse jusqu'à ce qu'une configuration soit trouvée. Corrigez ou excluez le fichier mentionné pour que le message disparaisse.

Où regarder : la bannière ambrée sur Vérifier (Afficher les fichiers concernés et pourquoi), le connecteur Manifeste tabulation ensuite. En SQL : SELECT relative_path, event_type, detail FROM fileset.files_events WHERE event_type IN ('drift','refused') TRIER PAR event_at DESC.

Des limites qu'il vaut la peine de connaître

Il n'y a pas de limite au nombre de dossiers ni de fichiers. Les lignes sont comptabilisées dans votre espace de données, comme pour tout autre connecteur. Vous pouvez modifier les valeurs par défaut du connecteur.

Limites de contenu, qui consistent à stocker un fichier plutôt qu'à le tronquer : 2 000 000 lignes ou 512 Mio par fichier, 10 000 000 lignes ou 2 Gio par analyse. Un dossier peut contenir au maximum 25 agencements différents. Une table par mise en page mode.

Questions que se posent les gens

• Système de fichiers
• Dossier CSV
• Dossier en parquet
• Dossier SQLite
• Dossier JSONL
• Fichier CSV multi-enregistrements
• Journaux de machines
• Journaux du serveur Web
• Journaux de conteneurs
• Journaux d'application
• Journaux système
• Journaux personnalisés