Transforme qualquer pasta de arquivos em Tabelas SQL que se mantêm atuais
Treze conectores de pastas, uma ideia: aponte o Agente de Fluxos de Consulta para uma pasta na sua rede e ele criará as tabelas, marcará cada linha com o arquivo de origem e as manterá atualizadas conforme os arquivos chegam, são alterados ou desaparecem. Consulte-as a partir do Excel, Planilhas Google, Nova, Claude ou da API REST. Nada é carregado, convertido ou editado.
Selecione o guia para seus arquivos
Cada cartão abaixo representa um conector e um guia. Todos os guias seguem os mesmos cinco passos: instalar o Agente, indicar a pasta, verificar o que será criado, escolher a frequência de verificação e analisar as tabelas. Em seguida, são exibidas as tabelas, consultas e detalhes específicos para aquele tipo de arquivo. Não tem certeza de qual usar? Selecione a opção no Portal. Arquivos em uma pastaO agente examina a pasta e abre o cartão correto para você.
Sistema de arquivos
Um inventário consultável de todos os arquivos em suas pastas, com tamanhos, datas, histórico de alterações e crescimento da pasta, sem precisar ler o conteúdo dos arquivos.
Pasta CSV
Todos os arquivos CSV da pasta foram mesclados em uma única tabela, ou uma tabela por layout, com cada linha identificada com o arquivo de origem.
Pasta Parquet
Uma pasta de arquivos Parquet como uma tabela digitada, com colunas e tipos extraídos dos rodapés dos arquivos.
Pasta do Excel
Todas as planilhas da pasta de trabalho foram mescladas em uma única tabela por planilha, como por exemplo: pedidos_de_dadosou uma tabela por layout para pastas de trabalho mistas.
Pasta SQLite
Vários arquivos SQLite consultados como um único banco de dados, com tabelas de mesmo nome mescladas e cada linha etiquetada com o arquivo correspondente.
CSV com vários registros
uma tabela por tipo de registro, como por exemplo dados_hdr e dados_itm, que pode ser unido por arquivo e número de sequência.
Registros de máquinas
Registros de CNC, PLC e robôs agrupados em um eventos tabela, além de tabelas de alarme, ciclo e tempo de inatividade para controladores compatíveis.
Registros do servidor web
Uma linha por solicitação dos logs do nginx, Apache, IIS ou Caddy, com o IP do cliente, caminho, status e bytes como colunas.
Registros do contêiner
Linhas de log do contêiner Docker como linhas, com o nome do contêiner, o fluxo e a mensagem como colunas.
Registros de aplicativos
Registros de aplicativos em formato JSON e texto, apresentados como linhas com nível, logger e mensagem, com rastreamentos de pilha mantidos junto ao evento.
Registros do sistema
Os arquivos syslog e journald são armazenados como linhas contendo host, programa, PID e mensagem.
Registros personalizados
Qualquer registro de texto analisado em colunas conforme descrito, com as linhas não analisadas mantidas em uma tabela de linhas brutas.
Como funciona cada conector de pastas
Um conector de banco de dados aponta para um servidor que já possui tabelas. Um conector de pasta aponta para pastas no computador do Agente. O Agente lê os arquivos, fixa um layout a partir de uma amostra de até 64 deles e constrói as tabelas em um cache local criptografado (um esquema DuckDB, chamado conjunto de arquivose os atualiza de acordo com a programação que você escolher. Arquivos que não se encaixam no layout são separados e relatados, nunca descartados silenciosamente ou ajustados para se adequarem ao formato. Um conector lê um tipo de arquivo; uma pasta com arquivos CSV e Parquet requer dois conectores na mesma pasta.
Cada conector de pasta também serve para as mesmas tabelas de contabilidade, todas no mesmo lugar. conjunto de arquivos esquema:
| Mesa | O que contém |
|---|---|
arquivos | Todos os arquivos atualmente na pasta: caminho, nome, extensão, tamanho, data de criação e modificação, primeira e última visualização. Uma visão geral. arquivos_atual, que também guarda arquivos que desapareceram. |
arquivos_eventos | O histórico de alterações: uma linha por arquivo que apareceu, era modificado, desapareceu, foi deixado de lado (deriva) ou era recusado, com o tempo em evento_em, como isso foi notado em detectado_por e a razão em detalhe. |
diretórios, snapshots_de_diretório, volumes | Contagem e tamanho das pastas, como elas cresceram e os discos ou compartilhamentos onde as raízes estão localizadas. |
_arquivo_fonte, _row_id | Duas colunas em cada linha de dados: o arquivo de origem da linha e um ID de linha fixo dentro desse arquivo. Agrupar por _arquivo_fonte para comparar arquivos. |
O que você vai precisar
Uma conta do Query Streams
Os conectores de pastas estão disponíveis em todos os planos, inclusive no plano gratuito. O plano gratuito é permanente, não um período de teste com prazo de validade. Não há limite para a quantidade de arquivos que uma pasta pode conter.
O Agente, versão 2.6.0 ou posterior
Instalado em um computador que possa abrir a pasta: o próprio servidor de arquivos, um computador do escritório ou a máquina onde os arquivos são armazenados. Um Agente mais antigo exibe os cartões de pasta acinzentados com um Agente 2.6.0+ Distintivo. Windows, Mac ou Linux.
O caminho da pasta, conforme visto pelo Agente.
Um caminho local ou um compartilhamento de rede escrito como \\servidor\compartilhamento\pasta. The Agent runs as a service, so it cannot see drives you mapped at your login (Z: and friends). On Windows it can sign in to a share with a login you store; on Linux or a Mac, mount the share first (Linux under /mnt ou /mídia, a Mac under /Volumes).
Onde o trabalho é realizado? No computador que executa o Agente. Ele examina a pasta, copia as linhas para um cache local criptografado (um esquema, chamado conjunto de arquivose executa todas as consultas nesse cache. Seus arquivos são lidos, nunca modificados, movidos ou carregados.
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. Acompanhe as alterações na pasta. works on a share too, on a best-effort basis; the scheduled scan is what guarantees every change is picked up.
Como os arquivos novos, alterados e excluídos são exibidos
Arquivos novos e alterados
Em todos os Intervalo de varredura (ou em segundos com Pasta de monitoramento Um novo arquivo que se encaixa no layout tem suas linhas adicionadas e recebe um apareceu evento. Um arquivo modificado é relido em uma transação: suas linhas antigas são removidas, suas novas linhas são inseridas e ele recebe um modificado evento.
Arquivos excluídos
Um arquivo que desaparece descarta suas linhas por padrão, ou as mantém marcadas como excluídas se você escolheu a opção de exclusão permanente, e recebe um desapareceu evento. Se mais da metade dos arquivos desaparecerem de uma vez, a verificação é recusada e o inventário anterior é mantido: um compartilhamento offline se parece exatamente com isso.
Arquivos reservados
Um arquivo que não se encaixa no layout, não pode ser aberto ou excede o limite é descartado por completo: nenhuma de suas linhas é carregada e arquivos_eventos recebe um deriva Insira o nome do arquivo na linha e o nome da coluna. Corrija o arquivo e salve-o; a próxima verificação tentará novamente.
Quão fresco é o que eu vejo?
Respostas às consultas da última verificação. Não há botão "Verificar novamente" ou "Sincronizar agora"; o intervalo de verificação, o monitor de pastas e Atualize a página antes de responder à pergunta. São os três controles. MÁXIMO(última_vista_utc) a partir de arquivos_atual Indica quando o agente verificou pela última vez.
Arquivos que são separados
Três palavras aparecem na etapa Verificar e na guia Manifesto. Elas têm significados diferentes:
- Estacionado (de lado)
- O arquivo não corresponde ao layout fixado, ou está ilegível, rasgado, bloqueado ou sobre uma borda. É tudo ou nada por arquivo: um arquivo estacionado contribui com zero linhas.
arquivos_eventosregistra umderivafila cujadetalheO arquivo é nomeado e a coluna é identificada. O arquivo é ignorado enquanto seu tamanho e data de modificação permanecerem os mesmos, e a execução é repetida assim que houver alteração. - Ilegível
- O agente não conseguiu abrir ou analisar o arquivo devido ao seu tipo: não é uma planilha válida, está bloqueado por outro programa, é um marcador na nuvem ou contém bytes indecodificados. Ele é interrompido automaticamente e o restante da pasta continua sendo processado. Somente uma pasta com zero arquivos legíveis rejeita todo o conjunto.
- Recusado
- O agente não conseguiu fixar nenhum layout, por exemplo, porque os arquivos divergem quanto ao tipo de coluna. Ainda não existe nenhuma tabela de dados.
arquivos_eventosrecebe umrecusadolinha com o motivo emdetalheE o Agente tenta novamente a cada verificação até que um layout seja fixado. Corrija ou exclua o arquivo mencionado e a mensagem desaparecerá.
Onde procurar: a bandeira âmbar em Verificar (Mostre quais arquivos e por quê.), o conector Manifesto Em seguida, pressione a tecla Tab. Em SQL: SELECT relative_path, event_type, detail FROM fileset.files_events WHERE event_type IN ('drift','refused') ORDER BY event_at DESC.
Use as mesas em todos os lugares.
O conector é uma fonte de dados como qualquer outra no Query Streams. Salve uma consulta uma única vez no Construtor de consultas (o dialeto é DuckDB) e use-o a partir de:
Excel
O suplemento Transmita uma consulta Insere as linhas em uma planilha e executa novamente com um clique. Executando SQL no Excel.
Planilhas Google
O Fluxo de consulta O complemento preenche uma aba que você escolher. Power Query para Google Sheets.
Claude, Cursor e outros clientes de IA
Por meio do servidor Query Streams MCP, Claude conhece o modelo de pastas, incluindo _arquivo_fonte e arquivos_eventos. Pasta CSV com Claude via MCP.
API REST
Em todos os planos, qualquer consulta salva se torna um endpoint somente leitura com sua própria chave. API REST para pastas CSV.
Nova
Faça perguntas em linguagem simples sobre o plano Business; a Nova conhece cada tabela, coluna e pasta por meio de suas descrições integradas.
Automações
Sincronize as linhas com o Airtable, Smartsheet, Baserow, SeaTable ou uma planilha de acordo com um cronograma. Guias de automação.
As tabelas de pastas também se conectam aos seus outros conectores: uma consulta federada pode corresponder. _arquivo_fonte nomes ou IDs de pedidos em uma pasta de arquivos CSV em relação a um banco de dados no mesmo agente.
Limites que vale a pena conhecer
Não há limite de pastas ou de arquivos no plano. As linhas são contabilizadas no seu Data Realm, como em qualquer outro conector. Você pode aumentar ou diminuir os valores padrão no conector:
| Contexto | Padrão | O que faz |
|---|---|---|
| Profundidade máxima | 8 | Quantos níveis de pastas abaixo de cada raiz são verificados (1–64). |
| Número máximo de arquivos por digitalização | 100,000 | Arquivos analisados de uma só vez. |
| Tamanho máximo do arquivo para gerar o hash | 32 MiB | Só importa com Conteúdo do arquivo hash sobre. |
| Retenção do registro de eventos | 30 dias | Quanto tempo arquivos_eventos As fileiras são mantidas. |
| Paralelismo de varredura por raiz | 2 | As pastas são lidas de uma só vez por raiz. |
Limites de conteúdo, que armazenam um arquivo em vez de truncá-lo: 2.000.000 linhas ou 512 MiB por arquivo, 10.000.000 linhas ou 2 GiB por verificação. Uma pasta pode conter no máximo 25 layouts distintos. Uma mesa por layout modo.
Perguntas que as pessoas fazem
Meus arquivos foram enviados para algum lugar?
Não. O Agente lê os arquivos em seu próprio computador e armazena as linhas em um cache local criptografado. Uma consulta é executada nesse cache e somente as linhas retornadas saem da máquina, por meio de uma única conexão de saída. Os arquivos nunca são modificados, movidos ou convertidos.
Preciso abrir uma porta ou usar uma VPN?
Não. O agente faz uma conexão de saída na porta 443 e tanto as requisições quanto as linhas trafegam por ela. Se o HTTPS de saída funcionar, isso funciona.
A pasta pode estar em um compartilhamento de rede, no OneDrive ou no Dropbox?
Yes. Type a share as \\servidor\compartilhamento\pasta, 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 Mantenha sempre este dispositivo ligado.O agente não baixa arquivos exclusivos da nuvem.
A pasta contém mais de um tipo de arquivo. Um conector ou dois?
Um conector lê um tipo de arquivo. Uma pasta com arquivos CSV e Parquet requer dois conectores na mesma raiz, um para cada tipo. Arquivos que não correspondem ao padrão de inclusão são ignorados, não armazenados separadamente.
Existe um botão "Reescanear"?
Não. O agente realiza a varredura no Intervalo de varredura, reage às mudanças quando Pasta de monitoramento Está ativado e pode realizar uma nova verificação antes de responder a uma consulta quando você o habilita. Edite o conector para alterar qualquer uma das três opções.
O plano gratuito realmente cobre isso?
Sim. A versão gratuita é um plano permanente, não um período de teste com prazo de validade. Os conectores de pastas não possuem limite de arquivos próprio; as linhas são contabilizadas no seu Data Realm como qualquer outro conector. Veja o que cada plano inclui na página de detalhes do plano. página de preços.
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