Voir les catégories

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
Vous êtes bloqué à un moment donné ? N'hésitez pas à nous demander. Ouvrir Soutien Dans la section « Flux de requêtes » (menu en haut à droite → Assistance), envoyez-nous un message. De vraies personnes le liront, et « Je ne comprends pas ce que cet écran demande » est une question tout à fait légitime.

Ce que vous obtiendrez

Icône du dossier ExcelVous 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.

TableauCe qu'il contient
fileset.data_ordersAvec Une mise en page épinglée, un tableau par feuille nommé données_<feuille>, contenant les lignes de cette feuille provenant de chaque classeur. Feuilles limite quelles feuilles deviennent des tableaux.
ensemble de fichiers.budgetAvec Une table par mise en pageChaque mise en page contient une table, nommée d'après la partie commune de son nom de fichier (les chiffres de fin étant supprimés), ou d'après le nom de la feuille si aucune donnée exploitable n'est disponible. Les noms restent inchangés tant que la mise en page est épinglée.

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.

OÙ VIENNENT LES DOSSIERSun ordinateur ou un partage de fichiers que l'agent peut ouvrirVotre dossierdes fichiersLes fichiers restent où ils sont.Agent de flux de requêtesanalyse le dossier, construit des tablesdans un cache local, exécute la requête SQLSélection uniquement, appliquée iciFlux de requêtesun lien sortantvérifie qui peut voir quoi · enregistre chaque requêteOÙ VOUS L'UTILISEZn'importe quel ordinateur, n'importe quel navigateurExcel · Google Sheets · NovaClaude · API REST · AutomatisationsVoyez les lignes, jamais les fichiers
L'agent lit le dossier sur son propre ordinateur, stocke les lignes dans un cache local chiffré et effectue chaque requête sur ce cache. Seules les lignes renvoyées par une requête sont transmises, via une unique connexion sortante. Aucun port à ouvrir, aucun VPN, aucun transfert de données.

Là où elle gagne sa vie :

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\dossierL'agent s'exécute en tant que service et ne peut donc pas accéder aux lecteurs mappés lors de votre connexion (Z: et autres). Sous Windows, il peut se connecter à un partage avec un identifiant enregistré ; sous Linux ou macOS, il faut d'abord monter le partage (sous Linux, sous macOS). /mnt ou /médias, un Mac sous /Volumes).

Où se déroule le travail ? Sur l'ordinateur exécutant l'agent, celui-ci analyse le dossier et copie les lignes dans un cache local chiffré (un schéma, nommé ensemble de fichiers) et exécute chaque requête sur ce cache. Vos fichiers sont lus, jamais modifiés, déplacés ni téléchargés.

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
    Un chemin par ligne, tel que vu par l'ordinateur de l'agent. Chaque dossier affiche un statut (accessible, refusé, manquant, inaccessible, informations d'identification invalides ou non monté) dès son ajout. Sur un agent Windows, un partage nécessitant une authentification obtient celle du dossier. Attestation colonne, stockée une seule fois par serveur ; sous Linux ou Mac, montez d’abord le partage.
    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:

    TableauCe qu'il contient
    fichiersChaque 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énementsL'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, volumesNombre et taille des dossiers, leur évolution et les disques ou partages sur lesquels résident les fichiers racines.
    _fichier_source, _row_idDeux 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.

C'est ça. Déposez un nouveau fichier dans le dossier et, après la prochaine analyse, il figurera dans le tableau. Les fichiers n'ont jamais quitté l'ordinateur sur lequel ils se trouvaient.

Accéder à un fichier sur un partage réseau

L'agent ouvre les fichiers en tant que service en arrière-plan, et non en tant qu'utilisateur. Par conséquent, un fichier situé sur un autre ordinateur nécessite une étape supplémentaire. Cette étape dépend de l'ordinateur sur lequel l'agent est exécuté.

Fenêtres

Saisissez le chemin réseau, comme \\serveur\partage\dossier, jamais une lettre de lecteur mappée telle que S:, que l'agent ne peut pas voir. Si le partage n'autorise que les personnes nommées, cliquez Identité de service (la puce sous le chemin, ou celle d'un dossier) Attestation colonne) et stocker un identifiant de connexion pour ce serveur : un compte de domaine d’entreprise ou un compte créé sur le serveur lui-même avec Domaine Si ce champ est laissé vide, l'agent se connecte au serveur et lit le fichier. Chaque connecteur de cet agent qui accède au même serveur doit utiliser les mêmes identifiants. Sans identifiant, la lecture se fait avec son propre compte de service, que le domaine de l'entreprise interprète comme l'ordinateur lui-même. Étape par étape sous Windows

Linux

Les identifiants de partage enregistrés dans le portail ne sont pas utilisés sous Linux : un administrateur monte d’abord le partage sur l’ordinateur de l’agent, dans un dossier situé sous /mnt ou /médias, car le service de l'agent ne peut pas voir /maison ou /run/utilisateurDans le connecteur, conservez le \\serveur\partage chemin, que l'agent mappe sur le point de montage, ou saisissez directement le chemin du point de montage, par exemple : /mnt/fileserver-shared/Comptes. Comment monter un partage réseau sous Linux

Mac

Les identifiants de partage enregistrés dans le portail ne sont pas utilisés sur un Mac : montez d’abord le partage depuis le Terminal avec sudo, dans un dossier sous /Volumes, afin que le service d'arrière-plan de l'agent puisse le voir. Dans le connecteur, conservez le \\serveur\partage chemin, que l'agent mappe sur le point de montage, ou saisissez directement le chemin du point de montage, par exemple : /Volumes/fileserver-shared/Accounts. Comment monter un partage sur un Mac

Si le test ne parvient pas à accéder à l'action, recherchez ces mots dans son résultat : injoignable Cela signifie que l'ordinateur de l'agent n'a reçu aucune réponse du serveur. Sous Linux ou Mac, non monté Cela signifie que le partage doit encore être monté, et ce message inclut la commande de montage exacte pour votre serveur.

Des dossiers sur un partage ? Sous Windows, une seule connexion permet de couvrir tous les dossiers ajoutés depuis le même serveur. Surveillez le dossier pour les modifications Cela fonctionne également sur un partage, au mieux de nos capacités ; l'analyse planifiée garantit que chaque modification est prise en compte.

Lorsqu'un dossier est inaccessible

Chaque dossier sur le Dossiers L'étape affiche un statut dès son ajout. Survolez le statut pour lire le message de l'agent ; les premiers mots indiquent de quelle affaire il s'agit.

Statut ou messageCe que cela signifieCe qu'il faut faire
refuséLe partage n'a pas permis à l'agent d'accéder au système. En l'absence d'identifiants enregistrés, l'agent Windows se présente comme utilisant son propre compte de service, que le domaine de l'entreprise interprète comme l'ordinateur lui-même.Windows : cliquez Identité de service dans le dossier Attestation Ajoutez une colonne et stockez un identifiant de connexion permettant de lire le partage, ou demandez à l'administrateur du serveur d'accorder un accès en lecture à l'identifiant stocké. Linux ou Mac : le partage est monté, mais ses permissions empêchent l'agent d'y accéder ; vérifiez comment il est monté (Linux, Mac).
identifiants invalides, ou Les informations d'identification enregistrées pour \\serveur ont été refusées.Le serveur a rejeté l'identifiant enregistré : faute de frappe, domaine incorrect ou mot de passe modifié. L'agent patiente une minute avant de réessayer la connexion afin d'éviter le blocage du compte.Cliquez sur le nom du compte dans le Attestation Saisissez à nouveau votre identifiant dans la colonne. Pour un compte créé directement sur le serveur, laissez le champ vide. Domaine vide.
manquantAucun dossier à cet emplacement. Sous Windows, un nom de serveur introuvable ou un partage absent du serveur est également signalé comme manquant.Vérifiez les noms ou choisissez le dossier contenant Ajouter le dossier depuis l'agent au lieu de le taper.
injoignable, ou Le serveur n'a pas répondu.Aucune réponse du serveur : il est hors service, le nom est incorrect ou un pare-feu bloque le partage de fichiers.Ouvrez le même \\serveur\partage Le chemin d'accès sur l'ordinateur de l'agent. Si cela échoue également, il s'agit d'un problème de réseau.
non monté (Linux ou Mac)Le partage n'est pas monté sur l'ordinateur de l'agent. Survolez l'état ou le Non monté puce dans le Attestation colonne, pour la commande de montage exacte.Monter l'action (Linux, Mac), puis testez à nouveau le dossier.
Un autre connecteur sur cet agent se connecte déjà à \\serveur en tant que…Windows autorise un compte par serveur de fichiers sur chaque ordinateur, et un autre connecteur sur cet agent utilise un compte différent.Utilisez les mêmes identifiants que pour ce connecteur, ou modifiez-les sur chaque connecteur qui accède à ce serveur.
Windows possède déjà un compte de connexion à \\serveur pour…Un autre processus sur l'ordinateur de l'agent est connecté à ce serveur avec un autre compte, et l'agent ne ferme jamais une connexion qu'il n'a pas établie.Suivez le message : il indique le compte Windows sous lequel l’agent s’exécute et précise si Utiliser l'identité de service La lecture du partage se ferait via l'identifiant de connexion existant.
Cette version de l'agent ne peut pas se connecter à \\serveur avec les informations d'identification enregistrées.Un agent plus ancien qui ne peut pas utiliser un identifiant de partage enregistré.Mettez à jour l'agent, puis testez à nouveau.

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 nouveaux et modifiés

Sur chaque Intervalle de balayage (ou en quelques secondes avec Dossier de surveillance un nouveau fichier qui correspond à la mise en page voit ses lignes ajoutées et reçoit un apparu Un fichier modifié est relu en une seule transaction : ses anciennes lignes disparaissent, ses nouvelles lignes sont insérées, et il reçoit un modifié événement.

Fichiers supprimés

Un fichier qui disparaît supprime par défaut ses lignes, ou les conserve marquées comme supprimées si vous avez choisi l'option de suppression, et reçoit un disparu Si plus de la moitié des fichiers disparaissent simultanément, l'analyse est refusée et l'inventaire précédent est conservé : un partage hors ligne ressemble exactement à cela.

Fichiers mis de côté

Un fichier qui ne correspond pas à la mise en page, qui ne peut pas être ouvert ou qui dépasse la limite de taille est mis de côté en entier : aucune de ses lignes n’est chargée, et fichiers_événements obtient un dérive Indiquez la ligne contenant le nom du fichier et la colonne. Corrigez le fichier et enregistrez-le ; la prochaine analyse tentera de le traiter à nouveau.

Ce que je vois est-il vraiment frais ?

Les requêtes répondent à partir de la dernière analyse. Il n'y a pas de bouton « Analyser à nouveau » ou « Synchroniser maintenant » ; l'intervalle d'analyse, la surveillance des dossiers et Actualisez la page avant de répondre à une question. ce sont les trois commandes. MAX(dernière_vue_utc) à partir de fichiers_actuels vous indique la date et l'heure de la dernière consultation par l'agent.

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.

Pour un dossier de classeurs Excel qui ressemble généralement à ceci : Un fichier appelé Q3-summary.xlsx, qui est en réalité un fichier CSV renommé, est mis de côté et apparaît sous « Afficher les fichiers et pourquoi », puis plus tard comme ligne de dérive dans files_events, avec le détail « illisible en tant qu'Excel : impossible de le lire en tant que classeur XLSX (l'enregistrement de fin du répertoire central est introuvable) ».

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.

ParamètreDéfautCe que cela fait
Profondeur maximale8Combien de niveaux de dossiers sous chaque racine sont analysés (1–64).
Nombre maximal de fichiers par numérisation100,000Fichiers examinés en une seule fois.
Taille maximale du fichier à hacher32 MioSeules les questions avec Contenu du fichier de hachage sur.
conservation des journaux d'événements30 joursCombien de temps fichiers_événements Les rangées sont conservées.
Parallélisme de balayage par racine2Les dossiers sont lus une seule fois par racine.

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

Mes cahiers d'exercices contiennent des feuilles différentes. Que se passe-t-il ?

Avec Une mise en page épingléeUn classeur auquel il manque une feuille épinglée est mis de côté et aucune de ses lignes ne se charge. L'étape Vérifier propose Passez à une table par mise en page, ce qui donne à chaque mise en page sa propre table, jusqu'à 25. Les noms des tables ne changent jamais tant que la mise en page reste épinglée.

Un nouveau classeur avec une nouvelle mise en page apparaîtra-t-il automatiquement ?

Non. Il est mis de côté avec une note indiquant qu'il s'agit d'une nouvelle disposition. Modifiez et enregistrez toute option de connecteur, comme par exemple : FeuillesL'agent échantillonne à nouveau le dossier et ajoute la nouvelle table. Les noms des tables existantes sont conservés.

Est-ce qu'il lit les fichiers .xls ou .xlsm ?

Le conducteur lit .xlsx, et Inclure des motifs commence par **/*.xlsx. Enregistrer les anciennes versions .xls cahiers d'exercices .xlsx Premièrement. Un fichier qui n'est pas un vrai .xlsx Le cahier d'exercices est mis de côté car illisible et nommé sous Afficher les fichiers concernés et pourquoi.

Que se passe-t-il si quelqu'un a un classeur Excel ouvert au moment de l'analyse ?

Un fichier verrouillé par un autre programme est illisible ; ce classeur est donc mis de côté tandis que le reste du dossier continue de se charger. fichiers_événements enregistre un dérive la ligne est nommée. Une fois le classeur enregistré et fermé, la prochaine analyse le relit.

Si je modifie un classeur, est-ce que j'obtiens des lignes en double ?

Non. Les anciennes lignes d'un classeur modifié sont supprimées et celui-ci est relu intégralement en une seule étape. Ainsi, le tableau ne contient jamais deux versions d'un même fichier. Les modifications sont détectées à partir de la taille et de la date de modification ; activez cette option. Contenu du fichier de hachage pour détecter les modifications qui conservent l'horodatage.

Mes fichiers sont-ils téléchargés quelque part ?

Non. L'agent lit les fichiers sur son propre ordinateur et conserve les lignes dans un cache local chiffré. Une requête est exécutée sur ce cache et seules les lignes renvoyées quittent la machine, via une unique connexion sortante. Les fichiers ne sont jamais modifiés, déplacés ni convertis.

Dois-je ouvrir un port ou utiliser un VPN ?

Non. L'agent établit une seule connexion sortante sur le port 443, et les requêtes comme les lignes transitent par ce port. Si le protocole HTTPS sortant fonctionne, cela fonctionne également.

Le dossier peut-il se trouver sur un partage réseau, ou dans OneDrive ou Dropbox ?

Oui. Saisissez une action comme \\serveur\partage\dossierL'Agent s'exécute en tant que service et ne peut pas accéder aux lecteurs mappés avec votre compte utilisateur. Sous Windows, enregistrez un compte pour le serveur si le partage n'autorise l'accès qu'à des personnes nommées ; sans compte, l'Agent se connectera avec son propre compte de service. Sous Linux ou macOS, montez d'abord le partage. Un dossier OneDrive ou Dropbox synchronisé fonctionne lorsque ses fichiers sont stockés sur l'ordinateur : configurez le dossier pour qu'il soit accessible. Gardez toujours cet appareil alluméL'agent ne télécharge pas les fichiers stockés uniquement dans le cloud.

Le dossier contient plusieurs types de fichiers. Un ou deux connecteurs ?

Chaque connecteur lit un seul type de fichier. Un dossier contenant des fichiers CSV et Parquet nécessite deux connecteurs à la racine, un par type. Les fichiers ne correspondant pas au modèle d'inclusion sont ignorés, et non mis de côté.

Existe-t-il un bouton « Réanalyser » ?

Non. L'agent effectue des scans sur le Intervalle de balayage, réagit aux changements lorsque Dossier de surveillance Cette option est activée et permet de relancer l'analyse avant de répondre à une requête. Modifiez le connecteur pour changer l'un des trois paramètres.

Le forfait gratuit couvre-t-il vraiment cela ?

Oui. L'offre gratuite est un forfait permanent, et non une période d'essai. Les connecteurs de dossiers n'ont pas de limite de fichiers propre ; les lignes sont comptabilisées dans votre espace de données comme pour tout autre connecteur. Consultez la liste des fonctionnalités incluses dans chaque forfait. page de tarification.

Toujours bloqué ? Ouvrir Soutien Dans Query Streams, indiquez-nous l'étape à laquelle vous vous trouvez et ce que vous voyez. Nous vous mettrons en relation.

Chaque guide pour Excel Folder

Ce n'est pas tout à fait votre configuration ?

  • Vous avez seulement besoin d'une liste de fichiers avec leur taille, leur date et leurs modifications ? Le système de fichiers le fait sans lire les fichiers. File System

Problème de configuration ?

  • L'agent indique que le fichier ou le dossier n'existe pas, ou que l'accès est refusé ? Les lecteurs réseau mappés, les partages réseau, OneDrive et les dossiers personnels Linux nécessitent chacun une solution → Où l'agent peut lire des fichiers à partir de
  • L'agent est indiqué comme hors ligne, ou les options « Tester la connexion » et « Parcourir » sont grisées ? Vérifiez que l'agent est en ligne → L'agent est-il en ligne ?
Updated on 12 octobre 2026

Powered by BetterDocs