Dossier JSON → tables SQL · avec Query Streams
Avec Query Streams, un dossier de fichiers JSON Lines devient des tables SQL en lecture seule : les fichiers restent à leur emplacement, l’Agent installé sur cet ordinateur les lit dans un cache local chiffré et maintient les tables à jour à mesure que des fichiers arrivent, changent ou disparaissent. Rien n’est téléversé et aucun fichier n’est modifié. Comptez environ quinze minutes la première fois ; le forfait Free couvre cette utilisation.
Commencez gratuitement
Ce que vous obtiendrez
Vous obtenez ainsi une seule table SQL, que vous nommez, qui contient chaque ligne de chaque fichier JSONL du dossier. Si vous l'appelez événements, vous demandez ensembles de fichiers.événementsLes objets imbriqués sont aplatis en colonnes jusqu'à la profondeur choisie ; les valeurs plus profondes sont conservées au format JSON, et chaque ligne contient _fichier_source Vous savez ainsi de quel fichier il provient. Si le dossier contient des fichiers de formats différents, vous pouvez créer une table par format. L'agent lit le dossier sur son ordinateur et met en cache les lignes dans un espace de stockage local chiffré, puis les transmet sous forme de requêtes SQL à Excel, Google Sheets, au générateur de requêtes ou à tout autre client. Les fichiers restent sur votre réseau.
des fichiers qui arrivent au fil du temps
| ventes_2026_07.jsonl |
| ventes_2026_08.jsonl |
| ventes_2026_09.jsonl |
les lignes de chaque fichier, une table
| _fichier_source | nombre_de_lignes | première_ligne_id |
|---|---|---|
| ventes_2026_07.jsonl | … | … |
| ventes_2026_08.jsonl | … | … |
| ventes_2026_09.jsonl | … | … |
Chaque table se trouve dans un schéma nommé ensemble de fichiers. Avec Une mise en page épingléePar défaut, vous obtenez une table nommée d'après le Nom de la table vous tapez, par exemple ensembles de fichiers.événements, contenant les lignes de chaque fichier correspondant. Les objets imbriqués deviennent des colonnes jusqu'à Aplatir la profondeur, 2 par défaut, et tout élément plus profond est converti en texte JSON. Chaque ligne contient _fichier_source et une stabilité _row_id.
Avec Une table par mise en pageChaque forme distincte devient sa propre table, jusqu'à 25, nommée d'après la partie commune de ses noms de fichiers, les chiffres de fin étant supprimés. Fichiers commandes_2026_01.jsonl à commandes_2026_03.jsonl devenir ensembles de fichiers.ordresSi aucune donnée utilisable ne subsiste, le nom du tableau est conservé. Les noms restent inchangés tant que la mise en page est épinglée, et il n'existe pas d'affichage automatique permettant d'empiler les mises en page.
Chaque connecteur de dossier vous donne également accès aux tables de comptabilité. fichiers, fichiers_événements, annuaires, instantanés_de_répertoire et volumes.
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
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 fichiers JSON : le serveur de fichiers ou tout autre ordinateur toujours allumé et accessible depuis le partage. L'installation prend une minute et l'agent s'exécute 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.
-
Indiquez-lui l'emplacement d'un dossier contenant des fichiers de lignes JSON.
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 JSONL 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.
Installez l'agent Query Streams sur un ordinateur capable d'ouvrir le dossier. Il nécessite la version 2.6.0 ou ultérieure. À partir de cet agent : Ajouter un connecteur bouton, ouvrir Fichiers et dossiers et choisissez le Dossier JSONL carte.
- Dossiers racine: les dossiers à analyser sur l'ordinateur de l'agent, un par ligne. Indiquez les partages réseau comme
\\serveur\partage\dossier, et non une lettre de lecteur mappée. - Inclure des motifs commence par
**/*.jsonlAjoutez un modèle si vos fichiers utilisent une autre extension. - Nom de la table un champ est obligatoire. Saisissez un nom tel que
événements. - Aplatir la profondeur: nombre de niveaux d'objets imbriqués transformés en colonnes. Par défaut : 2, plage : 1 à 8. Les valeurs plus imbriquées sont converties en texte JSON.
- Mise en page du tableau: partir Une disposition épinglée (par défaut) lorsque tous les fichiers partagent une même mise en page, comme pour les exportations récurrentes. Choisissez Une table par mise en page pour les dossiers que les gens assemblent à la main, où chaque mise en page distincte a sa propre table, jusqu'à 25.
-
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 fichiers maximum et affiche le nombre de fichiers, leur taille, une estimation du nombre de lignes et le tableau qu'il va créer. Aucun fichier n'est encore créé. Cette source signale le plus souvent des formats mixtes. Si l'échantillon contient plusieurs mises en page… Mise en page du tableau Le fichier est toujours épinglé ; un panneau bleu indique « Ce dossier contient 3 structures de fichiers différentes » et explique qu’une structure épinglée exige que chaque fichier partage la même structure. Cliquez Passez à une table par mise en page et chaque forme devient sa propre table. Les fichiers que l'agent n'a pas pu lire au format JSONL apparaissent sous Afficher les fichiers concernés et pourquoi comme prévu, et le reste se charge toujours. Vous pouvez créer le connecteur de l'une ou l'autre manière ; il vérifie constamment et indique la raison sur son Manifeste languette.
-
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é.
-
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 fichiersschéma. Trois requêtes fonctionnelles dès le premier jour :Lignes par fichier JSONLSELECT _source_file, COUNT(*) AS row_count FROM fileset.events GROUP BY _source_file ORDER BY row_count DESC LIMIT 100
Une ligne par fichier, vous pouvez donc voir le nombre de lignes que chaque fichier JSONL a contribué.
Fichiers modifiés au cours des dernières 24 heuresSELECT relative_path, size_bytes, modified_utc FROM fileset.files WHERE modified_utc >= now() - INTERVAL 1 DAY ORDER BY modified_utc DESC LIMIT 100
Les fichiers que l'agent a vus modifiés depuis hier, du plus récent au plus ancien.
Dossiers mis de côté ou refusés, et pourquoiSELECT relative_path, event_type, detected_by, detail, event_at FROM fileset.files_events WHERE event_type IN ('refused', 'drift') ORDER BY event_at DESC LIMIT 20Chaque fichier dont des lignes ont été omises, avec la raison détaillée, y compris un fichier avec une nouvelle forme.
Chaque connecteur de dossier utilise également les mêmes tables de comptabilité, le tout dans le
ensemble de fichiersschéma:Tableau Ce 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, étaitmodifié,disparu, a été mis de côté (dérive) ou étaitrefusé, avec le temps enévénement_à, comment cela a été remarqué dansdétecté paret la raison dansdé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_sourcecomparer 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é.
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 message | Ce que cela signifie | Ce 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. |
| manquant | Aucun 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 JSONL 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 de dossier JSONL.
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 fichiers de lignes JSON par rapport à 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énementsenregistre undériverangée dontdétailLe 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énementsobtient unrefusédispute avec la raison dansdé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 fichiers de lignes JSON qui ressemble généralement à ceci : Un fichier web-03.jsonl exporté, dont les lignes contiennent un ensemble de clés différent de la disposition épinglée, est mis de côté sans qu'aucune de ses lignes ne soit chargée ; files_events reçoit une ligne de dérive avec detected_by pin dont le détail nomme le fichier et, en mode par disposition, indique « nouvelle disposition — modifiez les options du pilote du connecteur ou les remplacements du manifeste (toute modification de ces derniers est re-sniffée) pour l'ajouter en tant que nouvelle table ».
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ètre | Défaut | Ce que cela fait |
|---|---|---|
| Profondeur maximale | 8 | Combien de niveaux de dossiers sous chaque racine sont analysés (1–64). |
| Nombre maximal de fichiers par numérisation | 100,000 | Fichiers examinés en une seule fois. |
| Taille maximale du fichier à hacher | 32 Mio | Seules les questions avec Contenu du fichier de hachage sur. |
| conservation des journaux d'événements | 30 jours | Combien de temps fichiers_événements Les rangées sont conservées. |
| Parallélisme de balayage par racine | 2 | Les 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
Comment les objets JSON imbriqués sont-ils gérés ?
Elles s'aplatissent en colonnes jusqu'au Aplatir la profondeur Vous définissez la profondeur, 2 par défaut et 8 au maximum. Au-delà, les données restent sous forme de texte JSON dans une seule colonne, sans perte d'information. Augmentez la profondeur si vous devez régulièrement analyser du texte JSON dans vos requêtes. La modification de cette profondeur entraîne un nouvel échantillonnage du dossier et la reconstruction du tableau.
Mes fichiers ont des formats différents. Est-il tout de même possible de les interroger ?
Oui. Choisissez Une table par mise en page Chaque forme devient sa propre table, jusqu'à 25. Chaque table porte le nom de la partie commune de son nom de fichier. Si l'étape de vérification détecte plusieurs formes alors que vous êtes encore sur une mise en page épinglée, elle vous le signale et vous propose des alternatives. Passez à une table par mise en pageIl n'existe pas de vue automatique qui empile les mises en page, mais vous pouvez les UNION dans une requête.
Que se passe-t-il lorsqu'un fichier de format différent arrive ultérieurement ?
Elle est mise de côté et aucune de ses lignes n'est chargée. En mode par disposition fichiers_événements L'enregistrement porte la mention « nouvelle mise en page ». Les nouvelles mises en page ne sont pas ajoutées automatiquement. Modifiez et enregistrez toute option de connecteur, telle que la profondeur d'aplatissement ; l'agent effectue alors de nouveaux prélèvements et ajoute la nouvelle table tout en conservant les noms existants.
Mes fichiers ont l'extension .json ou .ndjson, et non .jsonl. Seront-ils lus ?
Seuls les fichiers correspondants Inclure des motifs sont lues, et la valeur par défaut est **/*.jsonlAjoutez un motif tel que **/*.ndjson Pour les autres extensions, chaque fichier doit toujours contenir un objet JSON par ligne. Un connecteur lit un seul type de fichier ; par conséquent, un dossier contenant également des fichiers CSV nécessite un second connecteur dans ce même dossier.
Existe-t-il une limite concernant la taille des fichiers ou le nombre de lignes ?
Les paramètres par défaut de l'agent sont de 2 000 000 lignes et 512 Mio par fichier, et de 10 000 000 lignes ou 2 Gio par synchronisation. Un fichier dépassant cette limite est mis de côté et signalé. fichiers_événementsIl n'y a pas de limite au nombre de dossiers ou de fichiers. Si vous souhaitez également que Claude interroge la table, consultez Connectez un dossier de fichiers JSONL à Claude avec MCP..
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.
Chaque guide pour JSONL Folder
Ce n'est pas tout à fait votre configuration ?
- S'agit-il des fichiers journaux de votre application qui ne cessent de grossir ? Application Logs lit les nouvelles lignes au fur et à mesure de leur écriture et extrait le niveau, le journaliseur et le message. App Logs
- 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 ?




