Consultar archivos CSV con múltiples registros mediante SQL.

Conector de carpetas · Registro múltiple

Convierta archivos CSV que mezclan varios tipos de registros en Tablas SQL Puedes consultar en cualquier lugar

Dirige el agente de Query Streams a la carpeta. Este lee los archivos en su propio ordenador, crea las tablas en una caché local y las mantiene actualizadas a medida que llegan, cambian o desaparecen archivos. Puedes consultarlas desde Excel, Google Sheets, Nova, Claude o la API REST. No se carga ningún archivo ni se convierte ni se edita.

Aproximadamente 15 minutos No se necesita programar Los archivos permanecen en tu red. El plan gratuito lo cubre

Lo que obtendrás al final

Al final, se obtiene una tabla SQL por cada tipo de registro. Un archivo CSV cuyas líneas están etiquetadas como HDR, ITM y TRL se convierte en... conjunto_de_archivos.data_hdr, conjunto_de_archivos.elemento_de_datos y conjunto_de_archivos.data_trl, cada una contiene ese tipo de registro de cada archivo en la carpeta. Las columnas están numeradas por posición, campo_1 a campo_Ny cada fila lleva _archivo_fuente y _seqDe esta forma, puedes vincular un encabezado a sus detalles con dos columnas. El agente lee la carpeta en su propio ordenador, almacena en caché las filas en un repositorio local cifrado y las sirve como SQL a Excel, Google Sheets, el Generador de consultas o cualquier otro cliente. Los archivos permanecen en tu red.

Cada tabla se encuentra en un esquema llamado conjunto de archivosLas tablas se nombran automáticamente, una por cada etiqueta de registro: datos_<etiqueta>, por lo que la etiqueta HDR se convierte en conjunto_de_archivos.data_hdr. Con Alcance de la tabla empezar a Una tabla por extensión de archivo y etiqueta, el nombre se convierte en datos_<extensión>_<etiqueta>, que mantiene separada la misma etiqueta de diferentes tipos de archivos. Las columnas son campo_1 a campo_N por posición, sin incluir la columna de etiquetas. Cada fila también contiene _seq, la ocurrencia basada en 0 de esa etiqueta dentro del archivo y la clave de unión entre tipos de registro, más _archivo_fuente y un _row_id del formato ruta:línea.

Cada conector de carpeta también le proporciona las tablas de contabilidad. archivos, eventos_de_archivos, directorios, instantáneas_de_directorio y volúmenes.

Donde justifica su coste:

• Consulta archivos por lotes de tipo EDI, ya sean bancarios, de nómina o de consulta que combinen líneas de encabezado, detalle y pie de página.
• Concilie los totales de los tráileres de cada archivo con sus líneas de detalle en una sola consulta.
• Cargue los archivos por lotes entrantes en Excel o Google Sheets como tablas propiamente dichas, en lugar de dividirlos manualmente.

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).

Configúralo en cinco pasos.

1. Instale el agente en un ordenador que pueda abrir la carpeta.

   Iniciar sesión, abrir DescargarInstale el Agente para su sistema en el equipo que pueda abrir archivos CSV que combinen varios tipos de registros: el servidor de archivos o cualquier equipo siempre activo con acceso a la carpeta compartida. El proceso tarda un minuto y se inicia automáticamente. Necesita la versión 2.6.0 o posterior; la página de descargas siempre tiene la versión más reciente.

   ¿Por qué un programa pequeño en lugar de un controlador? El agente se instala una sola vez en Windows, Mac o Linux (aproximadamente 85 MB en Windows y algo más de 100 MB en Mac y Linux). Abre una conexión cifrada saliente a Query Streams, siendo esta la única ruta de red que necesita: no requiere abrir ningún puerto de entrada ni usar VPN. Lee la carpeta donde se encuentra, por lo que los archivos permanecen en su lugar y solo las filas que devuelve una consulta se transmiten por internet al complemento, navegador o cliente de IA en su equipo.

   La página de descarga muestra Su clave de accesoPégalo en el Agente cuando te lo pida y espera a que aparezca la insignia. Conectado a flujos de consultaEso es lo único que debes hacer en el ordenador del agente; todo lo demás ocurre en tu navegador.

   Si lo deseas, aquí tienes las guías completas: Ventanas, Impermeable, Linux.

2. Apúntalo a archivos CSV que combinen varios tipos de registros.

   Volver a abrir el navegador Datos → Agentes de datos, busque el Agente que acaba de instalar y haga clic en su Agregar conector botón. Abrir el Archivos y carpetas pastilla y elige la CSV de múltiples registros tarjeta. ¿No estás seguro de qué tarjeta encaja? Elige Archivos en una carpeta En cambio, el agente analiza la carpeta, indica su contenido en una página de "Lo que encontramos" y abre la tarjeta correspondiente, que ya viene rellenada.

   El mago corre Carpetas → Comprobar → Configuración → Dominio → Revisar. En Carpetas:

   Carpetas raíz

   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.

   Escanear subcarpetas, Profundidad máxima

   Encendido y 8 niveles, por defecto.

   Incluir patrones, excluir patrones

   ¿Qué archivos cuentan? El patrón de inclusión comienza con el glob correcto para esta tarjeta. Un conector lee un tipo de archivo: una carpeta con CSV. y Los archivos Parquet constan de dos conectores en la misma carpeta, uno por tipo.

   Siga los enlaces simbólicos y las uniones.

   Desactivado por defecto. El agente no sigue los accesos directos ni los marcadores de posición en la nube a menos que actives esta opción.

   Instale el Agente de Query Streams (2.6.0 o posterior) en un equipo que pueda abrir la carpeta. Desde ese Agente Agregar conector botón, abrir Archivos y carpetas y elige el CSV de múltiples registros tarjeta.

   • Carpetas raíz: las carpetas en el equipo del Agente que se van a escanear, una por línea. Escriba recursos compartidos de red como \\servidor\recurso compartido\carpeta, no es una letra de unidad asignada.
   • Incluir patrones comienza como **/*.csv.
   • Diseño de archivo, Columna de etiqueta de registro (número) y Delimitador: qué columna contiene la etiqueta del registro y qué separa los campos.
   • Alcance de la tabla: dejar la configuración predeterminada para una tabla por etiqueta. Elegir Una tabla por extensión de archivo y etiqueta para mantener la misma etiqueta de diferentes tipos de archivos en tablas separadas.

   No hay Nombre de la tabla campo y no Diseño de la tabla Elección. Las tablas se nombran datos_<etiqueta>Una nota explica que todos los archivos coincidentes deben compartir un mismo diseño, fijado a partir de una muestra en la primera sincronización; los archivos que posteriormente no coincidan se apartan y se informan.

3. Comprueba lo que construirá

   En Controlar El agente lee una muestra de hasta 64 archivos y muestra lo que creará. Todavía no se ha creado nada. El botón dice: Probar la conexión hasta que exista un veredicto, entonces Siguiente; Inténtalo de nuevo Vuelve a ejecutar la muestra después de que hayas cambiado algo. Verás uno de cuatro encabezados:

   Listo para crear

   Todos los archivos muestreados encajan. Los chips que se encuentran debajo indican cuántas carpetas eran accesibles, cuántos archivos y filas hay, y qué tablas existirán.

   Listo, con notas

   Algunos archivos se apartarán o se rechazará la detección de diseño. Un banner ámbar indica exactamente cuál: “{n} de {m} archivo(s) se apartarán” con un Mostrar qué archivos y por qué lista, y “Puedes crearlo de todos modos; el conector seguirá comprobando e informará del motivo en su pestaña Manifiesto”.

   Necesita atención

   El agente está desconectado o falta una carpeta. Solucione esto antes de continuar; si el agente está desconectado, la página lo indicará y aun así le permitirá continuar.

   Un rechazo o archivos reservados nunca te bloquean: haz clic SiguienteFinaliza el asistente y corrige los archivos que falten más tarde. Solo un agente sin conexión o una carpeta faltante detiene el asistente.

   En ControlarEl agente lee una muestra de hasta 64 archivos y muestra la cantidad de archivos, el tamaño, la estimación de filas y las tablas que creará, una por cada etiqueta de registro que encontró, en un chip como "3 tablas: data_hdr, data_itm, data_trl". Todavía no se ha creado nada. Si la columna de etiquetas está configurada incorrectamente, las etiquetas que el agente enumera no se parecerán a sus tipos de registro, lo que indica que debe volver atrás y cambiarlas. Columna de etiqueta de registro (número) o DelimitadorLos archivos que el Agente no pudo leer como CSV aparecen en Mostrar qué archivos y por qué como reservado, con el banner “1 de 12 archivo(s) se reservará”, y el resto aún se carga. Puede crear el conector de cualquier manera; sigue volviendo a comprobar e informa el motivo en su Manifiesto pestaña.

4. Elige con qué frecuencia escanea y luego créalo.

   Los valores predeterminados en Configuración Adecuado para una carpeta que recibe pocos archivos al día. Cuatro que quizás quieras cambiar:

   Intervalo de escaneo

   Cada hora Por defecto, puede elegir entre cada 5 minutos o diariamente. Cada análisis compara el tamaño y la fecha de modificación para encontrar archivos nuevos, modificados o desaparecidos.

   Monitorear la carpeta para detectar cambios (casi en tiempo real)

   Desactivado por defecto. Activado, el agente reacciona en segundos en discos locales; en recursos compartidos de red, se realiza con el mejor esfuerzo posible y el análisis programado sigue siendo la garantía. Período tranquilo (15 segundos) espera a que termine de escribirse un archivo.

   Actualiza la página antes de responder a una consulta.

   Desactivado por defecto. Activado, una consulta vuelve a escanear primero cuando el último escaneo es anterior a la Ventana de estancamiento (60 segundos), esperando como máximo el Límite de espera de la consulta (5 segundos). Se aplica a personas y complementos, no a sondeos de alertas.

   Cuando un archivo desaparece

   Deja caer sus filas por defecto, o Conservar filas, marcar como eliminadas (lápida). El Relación de guarda de Vanish (0.5) rechaza un escaneo que pierde más de la mitad de los archivos a la vez y mantiene el inventario anterior, que es como se ve un recurso compartido sin conexión.

   Luego elige el Ámbito de los datos las filas cuentan contra, verifique Revisar y haga clic Crear conector. El primer escaneo comienza de inmediato. El conector Manifiesto La pestaña muestra lo que construyó y cualquier archivo que haya guardado.

5. Mira tus mesas

   Abra el conector: el Manifiesto La pestaña enumera las tablas que construyó. En el Generador de consultas Las mismas mesas se encuentran debajo de la conjunto de archivos Esquema. Tres consultas que funcionan desde el primer día:

   Registros de encabezado, en orden de archivo

   SELECCIONAR _source_file, _seq, field_1, field_2 DE fileset.data_hdr ORDENAR POR _source_file, _seq LIMITAR 100

   Cada línea de encabezado de cada archivo, con el archivo de origen y su posición entre los encabezados de ese archivo.

   El encabezado de cada archivo junto a su pie de página.

   SELECCIONAR h._source_file, h._seq, h.field_1 COMO header_field_1, t.field_1 COMO trailer_field_1 DE fileset.data_hdr COMO h UNIR fileset.data_trl COMO t EN t._source_file = h._source_file Y t._seq = h._seq ORDENAR POR h._source_file, h._seq LIMITAR 100

   Une dos tipos de registros en las dos columnas compartidas, _source_file y _seq, de modo que el enésimo encabezado coincida con el enésimo pie de página en el mismo archivo.

   Archivos reservados para una etiqueta desconocida o un ancho incorrecto.

   SELECCIONAR ruta_relativa, tipo_evento, detectado_por, detalle, evento_en_tiempo FROM fileset.files_eventos WHERE tipo_evento IN ('refused', 'drift') ORDENAR POR evento_en_tiempo DESC LIMIT 20

   Todos los archivos cuyas filas se omitieron, con la razón detallada.

   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.

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 Carpetas 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.

Úsalo 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. Grabación multigrabada con Claude a través de 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 múltiples registros.

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 archivos CSV que combinan varios tipos de registros en una base de datos en el mismo Agente.

Cómo se muestran los archivos nuevos, modificados y eliminados

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_archivos registra un deriva fila cuyo detalle Se 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_archivos obtiene un rechazado discusión con la razón en detalley 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.

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:

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

• Sistema de archivos
• Carpeta CSV
• Carpeta de parquet
• Carpeta de Excel
• Carpeta SQLite
• Carpeta JSONL
• Registros de máquinas
• Registros del servidor web
• Registros de contenedores
• Registros de la aplicación
• Registros del sistema
• Registros personalizados