Convierta cualquier carpeta de archivos en Tablas SQL que se mantienen actualizados
Trece conectores de carpetas, una idea: configure el Agente de Flujos de Consulta para que apunte a una carpeta en su red y este creará las tablas, etiquetará cada fila con el archivo de origen y las mantendrá actualizadas a medida que los archivos lleguen, cambien o desaparezcan. Puede consultarlas desde Excel, Google Sheets, Nova, Claude o la API REST. No se carga, convierte ni edita ningún archivo.
Seleccione la guía para sus archivos
Cada tarjeta a continuación es un conector y una guía. Cada guía sigue los mismos cinco pasos: instalar el Agente, indicarle la carpeta, comprobar qué creará, elegir la frecuencia de escaneo y consultar las tablas. A continuación, muestra las tablas, las consultas y los problemas específicos de ese tipo de archivo. ¿No está seguro de cuál se ajusta a sus necesidades? En la selección del Portal Archivos en una carpeta: El agente analiza la carpeta y abre la tarjeta correcta para usted.
Sistema de archivos
Un inventario consultable de todos los archivos dentro de sus carpetas, con tamaños, fechas, historial de cambios y crecimiento de la carpeta, sin necesidad de leer el contenido de los archivos.
Carpeta CSV
Todos los archivos CSV de la carpeta se fusionaron en una sola tabla, o una tabla por diseño, y cada fila se etiquetó con el archivo del que procedía.
Carpeta de parquet
una carpeta de archivos Parquet como una tabla tipificada, con columnas y tipos tomados de los pies de página de los archivos.
Carpeta de Excel
Las hojas de cada libro de trabajo se fusionaron en una tabla por hoja, como por ejemplo: pedidos_de_datoso una tabla por diseño para libros de trabajo mixtos.
Carpeta SQLite
Se consultan varios archivos SQLite como si fueran una sola base de datos, fusionando las tablas con el mismo nombre y etiquetando cada fila con su archivo correspondiente.
CSV de múltiples registros
una tabla por tipo de registro, como por ejemplo: data_hdr y elemento_de_datos, unible por archivo y número de secuencia.
Registros de máquinas
Los registros de CNC, PLC y robots se conectaban a un eventos tabla, además de tablas de alarmas, ciclos y tiempos de inactividad para los controladores compatibles.
Registros del servidor web
Una fila por solicitud de los registros de nginx, Apache, IIS o Caddy, con la IP del cliente, la ruta, el estado y los bytes como columnas.
Registros de contenedores
Las líneas de registro del contenedor Docker se muestran como filas, con el nombre del contenedor, el flujo y el mensaje como columnas.
Registros de la aplicación
Registros de la aplicación en formato JSON y texto como filas con nivel, registrador y mensaje, con seguimientos de pila guardados con su evento.
Registros personalizados
Cualquier registro de texto analizado en las columnas que usted describa, con las líneas no analizadas mantenidas en una tabla de líneas sin procesar.
Cómo funciona cada conector de carpeta
Un conector de base de datos apunta a un servidor que ya tiene tablas. Un conector de carpeta apunta a carpetas en la computadora del Agente. El Agente lee los archivos, fija un diseño de una muestra de hasta 64 de ellos, crea las tablas en una caché local cifrada (un esquema DuckDB, llamado conjunto de archivosy los actualiza según la programación que usted elija. Los archivos que no se ajustan al formato se apartan y se notifican, nunca se descartan silenciosamente ni se modifican para que encajen. Un conector lee un tipo de archivo; una carpeta con archivos CSV y Parquet corresponde a dos conectores en la misma carpeta.
Cada conector de carpeta también sirve a las mismas tablas de contabilidad, todas en el conjunto de archivos esquema:
| Mesa | Lo que contiene |
|---|---|
archivos | Cada archivo que se encuentra actualmente en la carpeta: ruta, nombre, extensión, tamaño, fechas de creación y modificación, primera y última vez que se vio. Una vista general archivos_actual, que también guarda archivos que han desaparecido. |
eventos_de_archivos | El historial de cambios: una fila por archivo que apareció, era modificado, desapareció, fue apartado (deriva) o era rechazado, con el tiempo en evento_en, cómo se notó en detectado_por y la razón en detalle. |
directorios, instantáneas_de_directorio, volúmenes | Cantidad y tamaño de las carpetas, cómo crecieron y en qué discos o carpetas compartidas se encuentran sus archivos raíz. |
_archivo_fuente, _row_id | Dos columnas en cada fila de datos: de qué archivo proviene la fila y un ID de fila estable dentro de ese archivo. Agrupar por _archivo_fuente para comparar archivos. |
Lo que necesitarás
Una cuenta de Query Streams
Los conectores de carpetas están disponibles en todos los planes, incluido el gratuito. El plan gratuito es permanente, no una prueba que caduca. No hay límite en la cantidad de archivos que puede contener una carpeta.
El Agente, versión 2.6.0 o posterior
Instalado en un equipo que pueda abrir la carpeta: el propio servidor de archivos, un equipo de oficina o la máquina en la que se almacenan los archivos. Un agente anterior muestra las tarjetas de carpeta atenuadas con un Agente 2.6.0+ Insignia. Windows, Mac o Linux.
La ruta de la carpeta, tal como la ve el Agente.
Una ruta local o un recurso compartido de red escrito como \\servidor\recurso compartido\carpeta. 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 o /medios de comunicación, a Mac under /Volumes).
¿Dónde se realiza el trabajo? En el ordenador que ejecuta el Agente. Escanea la carpeta, copia las filas en una caché local cifrada allí (un esquema, llamado conjunto de archivos) y ejecuta cada consulta contra esa caché. Tus archivos se leen, nunca se modifican, mueven ni suben.
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.
Folders on a share? On Windows, one login covers every folder you add from the same server. Vigila la carpeta para ver los cambios. works on a share too, on a best-effort basis; the scheduled scan is what guarantees every change is picked up.
Cómo se muestran los archivos nuevos, modificados y eliminados
Archivos nuevos y modificados
En cada Intervalo de escaneo (o en cuestión de segundos con Carpeta de relojes en) un nuevo archivo que se ajusta al diseño tiene sus filas añadidas y obtiene un apareció evento. Un archivo modificado se vuelve a leer en una transacción: sus filas antiguas van, sus filas nuevas llegan y se obtiene un modificado evento.
Archivos eliminados
Un archivo que desaparece elimina sus filas por defecto, o las mantiene marcadas como eliminadas si eligió la opción de lápida, y obtiene un desapareció evento. Si desaparece más de la mitad de los archivos a la vez, se rechaza el escaneo y se mantiene el inventario anterior: un recurso compartido sin conexión se ve exactamente así.
Archivos reservados
Un archivo que no se ajusta al diseño, no se puede abrir o supera un límite se aparta por completo: ninguna de sus filas se carga y eventos_de_archivos obtiene un deriva Fila que indica el nombre del archivo y la columna. Corrija el archivo y guárdelo; el siguiente escaneo lo intentará de nuevo.
¿Qué tan fresco está lo que veo?
Las consultas responden desde el último escaneo. No hay botón de Volver a escanear o Sincronizar ahora; el intervalo de escaneo, el monitor de carpetas y Actualiza la página antes de responder a una consulta. son los tres controles. MAX(última_vista_utc) de archivos_actual Te indica cuándo fue la última vez que el Agente miró.
Archivos que se apartan
En el paso de verificación y en la pestaña Manifiesto aparecen tres palabras. Significan cosas diferentes:
- Apartado (estacionado)
- El archivo no coincide con el diseño fijado, o bien es ilegible, está roto, bloqueado o cubierto por una tapa. Es un proceso de todo o nada para cada archivo: un archivo aparcado no aporta ninguna fila.
eventos_de_archivosregistra underivafila cuyodetalleSe especifica el nombre del archivo y de la columna. El archivo se omite mientras su tamaño y fecha de modificación permanezcan iguales, y se vuelve a intentar en cuanto cambien. - Ilegible
- El agente no pudo abrir ni analizar el archivo debido a su tipo: no era un libro de trabajo real, estaba bloqueado por otro programa, era un marcador de posición en la nube o contenía bytes indecodificables. Se detiene automáticamente y el resto de la carpeta continúa. Solo una carpeta sin archivos legibles rechaza todo el conjunto.
- Rechazado
- El agente no pudo fijar ningún diseño, por ejemplo, porque los archivos no coinciden en el tipo de columna. Aún no existe ninguna tabla de datos.
eventos_de_archivosobtiene unrechazadodiscusión con la razón endetalley el Agente vuelve a intentarlo en cada escaneo hasta que se fija un diseño. Corrija o excluya el archivo que menciona y el mensaje desaparecerá.
Dónde mirar: el banner ámbar en Controlar (Mostrar qué archivos y por qué), el conector Manifiesto tabulación después. En SQL: SELECCIONAR ruta_relativa, tipo_evento, detalle DE fileset.files_events DONDE tipo_evento EN ('deriva','refused') ORDENAR POR event_at DESC.
Utilice las mesas en todas partes.
El conector es una fuente de datos como cualquier otra en Query Streams. Guarde una consulta una vez en el Generador de consultas (el dialecto es DuckDB) y úselo desde:
Excel
El complemento Transmitir una consulta Inserta las filas en una hoja de cálculo y las vuelve a ejecutar con un clic. Ejecutar SQL en Excel.
Hojas de cálculo de Google
El Transmisión de consultas El complemento ocupa la pestaña que usted seleccione. Power Query para Google Sheets.
Claude, Cursor y otros clientes de IA
A través del servidor MCP de Query Streams, Claude conoce el modelo de carpetas, incluyendo _archivo_fuente y eventos_de_archivos. Carpeta CSV con Claude vía MCP.
API REST
Cualquier consulta guardada se convierte en un punto final de solo lectura con su propia clave, en todos los planes. API REST de carpetas CSV.
Nova
Pregunte en lenguaje sencillo sobre el plan de negocios; Nova conoce cada carpeta, tabla y columna gracias a sus descripciones integradas.
Automatizaciones
Sincroniza las filas con Airtable, Smartsheet, Baserow, SeaTable o una hoja de cálculo según un cronograma. Guías de automatización.
Las tablas de carpetas también se unen a sus otros conectores: una consulta federada puede coincidir _archivo_fuente nombres o identificadores de pedidos en una carpeta de archivos CSV contra una base de datos en el mismo Agente.
Límites que vale la pena conocer
No hay límite de carpetas ni de archivos en el plan. Las filas se contabilizan en su Data Realm como en cualquier otro conector. Valores predeterminados que puede aumentar o disminuir en el conector:
| Configuración | Por defecto | Lo que hace |
|---|---|---|
| Profundidad máxima | 8 | ¿Cuántos niveles de carpetas por debajo de cada raíz se escanean (1–64)? |
| Número máximo de archivos por escaneo | 100,000 | Archivos considerados en una sola pasada. |
| Tamaño máximo de archivo para el hash | 32 MiB | Solo importa con Contenido del archivo hash en. |
| retención de registros de eventos | 30 días | Cuánto tiempo eventos_de_archivos Se conservan las filas. |
| Escaneo de paralelismo por raíz | 2 | Las carpetas se leen una a una por cada carpeta raíz. |
Límites de contenido, que almacenan un archivo en lugar de truncarlo: 2.000.000 de filas o 512 MiB por archivo, 10.000.000 de filas o 2 GiB por escaneo. Una carpeta puede contener como máximo 25 diseños distintos en Una mesa por diseño modo.
Preguntas que hace la gente
¿Mis archivos están subidos a algún sitio?
No. El agente lee los datos en su propio ordenador y guarda las filas en una caché local cifrada. Se realiza una consulta a esa caché y solo las filas que devuelve salen del sistema, a través de una única conexión saliente. Los archivos nunca se modifican, mueven ni convierten.
¿Necesito abrir un puerto o usar una VPN?
No. El agente establece una única conexión saliente en el puerto 443, y tanto las solicitudes como las filas viajan a través de ella. Si HTTPS saliente funciona, esto también funciona.
¿Puede la carpeta estar en un recurso compartido de red, o en OneDrive o Dropbox?
Yes. Type a share as \\servidor\recurso compartido\carpeta, because the Agent runs as a service and cannot see drives mapped at your login. On Windows, store a login for the server if the share lets in only named people; without one the Agent reads as its own service account. On Linux or a Mac, mount the share first. A synced OneDrive or Dropbox folder works when its files are stored on the computer: set the folder to Manténgalo siempre en este dispositivo.El agente no descarga archivos que solo se encuentren en la nube.
La carpeta contiene más de un tipo de archivo. ¿Un conector o dos?
Un conector lee un tipo de archivo. Una carpeta con archivos CSV y Parquet requiere dos conectores en la misma raíz, uno por cada tipo de archivo. Los archivos que no coinciden con el patrón de inclusión se ignoran, no se apartan.
¿Hay un botón para volver a escanear?
No. El agente escanea en el Intervalo de escaneoreacciona a los cambios cuando Carpeta de relojes Está activado y puede volver a escanear antes de responder a una consulta cuando lo actives. Edita el conector para cambiar cualquiera de los tres.
¿El plan gratuito realmente cubre esto?
Sí. El plan gratuito es permanente, no una prueba que caduca. Los conectores de carpetas no tienen límite de archivos propio; las filas se contabilizan en su Data Realm como cualquier otro conector. Consulte lo que incluye cada plan en la página de precios.
Setup trouble?
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish