Converter uma pasta de arquivos JSON em tabelas SQL

Conector de pastas · Pasta JSONL

Transformar uma pasta de arquivos JSON em Tabelas SQL Você pode consultar em qualquer lugar.

Aponte o Agente de Fluxos de Consulta para a pasta. Ele lê os arquivos em seu próprio computador, cria as tabelas em um cache local e as mantém atualizadas conforme os arquivos chegam, são alterados ou desaparecem. Você pode consultá-las a partir do Excel, Planilhas Google, Nova, Claude ou da API REST. Nada é carregado e nenhum arquivo é convertido ou editado.

Cerca de 15 minutos Não é necessário programar Os arquivos permanecem na sua rede. O plano gratuito cobre isso.

O resultado final será o que você obterá.

Você acaba com uma tabela SQL, nomeada por você, que contém cada linha de cada arquivo JSONL na pasta. Se você a chamar de [nome da tabela]. eventos, você pergunta conjunto de arquivos.eventosOs objetos aninhados são organizados em colunas até a profundidade escolhida, os valores mais profundos são mantidos como texto JSON e cada linha contém _arquivo_fonte Assim, você saberá de qual arquivo ele veio. Se a pasta contiver arquivos de formatos diferentes, você pode ter uma tabela para cada formato. O Agente lê a pasta em seu próprio computador e armazena as linhas em cache em um armazenamento local criptografado, disponibilizando-as em seguida como SQL para o Excel, Planilhas Google, Construtor de Consultas ou qualquer outro cliente. Os arquivos permanecem em sua rede.

Cada tabela está em um esquema chamado conjunto de arquivos. Com Um layout fixadoPor padrão, você obtém uma tabela com o nome do Nome da tabela você digita, por exemplo conjunto de arquivos.eventos, contendo as linhas de cada arquivo correspondente. Objetos aninhados tornam-se colunas até Achatar a profundidadePor padrão, 2, e qualquer coisa mais profunda é convertida em texto JSON. Cada linha contém _arquivo_fonte e um estável _row_id.

Com Uma mesa por layoutCada forma distinta torna-se sua própria tabela, até um máximo de 25, nomeada de acordo com a parte compartilhada de seus nomes de arquivo, com os números finais removidos. Arquivos orders_2026_01.jsonl para orders_2026_03.jsonl tornar-se conjunto de arquivos.pedidosSe nada mais for utilizável, o nome da tabela será usado. Os nomes nunca mudam enquanto o layout estiver fixado, e não há uma visualização automática que empilhe os layouts.

Cada conector de pastas também fornece as tabelas de contabilidade. arquivos, arquivos_eventos, diretórios, snapshots_de_diretório e volumes.

Onde se justifica o seu sustento:

• Consulte os eventos exportados do aplicativo ou os registros de conversas do LLM, gravados como linhas JSON, no Excel ou no Google Sheets.
• Contabilize e filtre eventos em um dia inteiro de arquivos JSONL sem precisar de um script por arquivo.
• Ao alterar os campos enviados por um fornecedor, cada formato de exportação deve ter sua própria tabela.

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

Configure em cinco etapas

1. Instale o Agente em um computador que possa abrir a pasta.

   Faça login e abra DownloadInstale o Agente para o seu sistema no computador que consegue abrir uma pasta com arquivos JSON: o servidor de arquivos ou qualquer computador sempre ligado que consiga acessar o compartilhamento. A instalação leva um minuto e, a partir daí, o Agente inicia automaticamente. Você precisa da versão 2.6.0 ou posterior; a página de Downloads sempre tem a versão mais recente.

   Por que um programa pequeno em vez de um driver? O Agente é instalado em um único programa para Windows, Mac ou Linux (cerca de 85 MB no Windows, um pouco mais de 100 MB no Mac e Linux). Ele abre uma conexão criptografada de saída para o Query Streams, sendo esse o único caminho de rede necessário: não é preciso abrir nenhuma porta de entrada, nem usar VPN. Ele lê a pasta onde está instalado, portanto os arquivos permanecem no mesmo local e apenas as linhas retornadas por uma consulta trafegam pela internet até o complemento, navegador ou cliente de IA do seu lado.

   A página de download mostra Sua chave de acessoCole o código no Agente quando solicitado e aguarde até que o crachá exiba a mensagem. Conectado a fluxos de consultaEssa é a única coisa que você faz no computador do Agente; todo o resto acontece no seu navegador.

   Guias completos, se você quiser: Janelas, Mac, Linux.

2. Aponte para uma pasta contendo arquivos JSON.

   Volte ao seu navegador e abra Dados → Agentes de DadosLocalize o agente que você acabou de instalar e clique nele. Adicionar conector botão. Abra o Arquivos e pastas pílula e escolha a Pasta JSONL Cartão. Não tem certeza de qual cartão serve? Escolha Arquivos em uma pasta Em vez disso: o Agente examina a pasta, indica o que ela contém em uma página "O que encontramos" e abre o cartão correto para você, já preenchido.

   O mago corre Pastas → Verificar → Configurações → Domínio → Revisar. Sobre Pastas:

   Pastas raiz

   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.

   Digitalizar subpastas, Profundidade máxima

   Ligado, e 8 níveis, por padrão.

   Incluir padrões, Excluir padrões

   Quais arquivos são contabilizados. O padrão de inclusão começa com o padrão glob correto para este cartão. Um conector lê um tipo de arquivo: uma pasta com arquivos CSV. e Os arquivos Parquet consistem em dois conectores na mesma pasta, um para cada tipo.

   Siga links simbólicos e junções

   Desativado por padrão. O Agente não segue atalhos ou marcadores na nuvem, a menos que você ative essa opção.

   Instale o Agente de Fluxos de Consulta em um computador que possa abrir a pasta. É necessário o Agente 2.6.0 ou posterior. A partir desse Agente... Adicionar conector botão, abrir Arquivos e pastas e escolha o Pasta JSONL cartão.

   • Pastas raiz: as pastas no computador do Agente a serem verificadas, uma por linha. Digite compartilhamentos de rede como \\servidor\compartilhamento\pasta, não uma letra de unidade mapeada.
   • Incluir padrões começa como **/*.jsonlAdicione um padrão se seus arquivos usarem outra extensão.
   • Nome da tabela É obrigatório. Digite um nome como eventos.
   • Achatar a profundidade: quantos níveis de objetos aninhados se tornam colunas. O padrão é 2, com um intervalo de 1 a 8. Valores mais profundos são convertidos em texto JSON.
   • Layout da tabela: deixar Um layout fixado (padrão) Quando todos os arquivos compartilham um mesmo layout, como no caso de exportações recorrentes. Selecione Uma mesa por layout Para pastas que as pessoas montam manualmente, onde cada layout distinto recebe sua própria mesa, até 25.

3. Verifique o que ele irá construir.

   Sobre Verificar O agente lê uma amostra de até 64 arquivos e mostra o que irá construir. Nada foi criado ainda. O botão exibe a mensagem: Teste de conexão até que haja um veredicto, então Próximo; Teste novamente Executa novamente a amostra depois que você fizer alguma alteração. Você verá um dos quatro títulos a seguir:

   Pronto para criar

   Cada arquivo amostrado se encaixa. Os chips abaixo indicam quantas pastas eram acessíveis, quantos arquivos e linhas havia e quais tabelas existirão.

   Pronto, com anotações.

   Alguns arquivos serão deixados de lado ou a verificação de layout será recusada. Um aviso em âmbar indica exatamente quais: “{n} de {m} arquivo(s) serão deixados de lado” com um Mostre quais arquivos e por quê. lista, e “Você pode criá-la mesmo assim — o conector continuará verificando e relatará o motivo em sua guia Manifesto.”

   Precisa de atenção

   O agente está offline ou uma pasta está faltando. Corrija isso antes de prosseguir; mesmo com o agente offline, a página exibe essa informação e permite que você continue.

   “Esta pasta contém {n} layouts de arquivo diferentes.” Um painel azul-celeste significa que os arquivos amostrados não compartilham o mesmo conjunto de colunas. Layout da tabela por padrão Um layout fixado, que espera que todos os arquivos correspondam. Clique Mude para uma tabela por layout. e cada layout se torna sua própria mesa (até 25).

   Arquivos recusados ou arquivados nunca te impedem de acessar: clique PróximoConclua o assistente e corrija os arquivos problemáticos mais tarde. Somente um agente offline ou uma pasta ausente interrompem o assistente.

   Sobre VerificarO agente lê uma amostra de até 64 arquivos e exibe a contagem de arquivos, o tamanho, a estimativa de linhas e a tabela que será criada. Nada foi criado ainda. O que essa fonte mais frequentemente relata são formatos mistos. Se a amostra contiver vários layouts enquanto Layout da tabela A pasta ainda está fixada, um painel azul exibe a mensagem "Esta pasta contém 3 layouts de arquivo diferentes" e explica que um layout fixado espera que todos os arquivos compartilhem o mesmo layout. Clique em Mude para uma tabela por layout. e cada forma se torna sua própria tabela. Os arquivos que o Agente não conseguiu ler como JSONL aparecem em Mostre quais arquivos e por quê. como separado, e o restante ainda carrega. Você pode criar o conector de qualquer maneira; ele continua verificando e relata o motivo em seu Manifesto aba.

4. Escolha a frequência com que a função verifica e, em seguida, crie-a.

   Os padrões em Configurações Adequado para uma pasta que recebe poucos arquivos por dia. Quatro opções que você talvez queira alterar:

   Intervalo de varredura

   A cada hora Por padrão, escolha entre a cada 5 minutos ou diariamente. Cada verificação compara o tamanho e a data de modificação para encontrar arquivos novos, alterados e que desapareceram.

   Acompanhe as alterações na pasta (quase em tempo real)

   Desativado por padrão. Quando ativado, o Agente reage em segundos em discos locais; em compartilhamentos de rede, ele age da melhor forma possível e a verificação agendada continua sendo a garantia. Período de silêncio (15 segundos) aguarda a conclusão da gravação de um arquivo.

   Atualize a página antes de responder à pergunta.

   Desativado por padrão. Ativado, uma consulta realiza uma nova verificação quando a última verificação é mais antiga que o Janela de obsolescência (60 segundos), aguardando no máximo o Limite de espera da consulta (5 segundos). Aplica-se a pessoas e complementos, não à pesquisa de alertas.

   Quando um arquivo desaparece

   Solte suas fileiras por padrão, ou Manter linhas, marcar como excluído (lápide). O Proporção de guarda de desaparecimento (0.5) rejeita uma verificação que perde mais da metade dos arquivos de uma só vez e mantém o inventário anterior, que é como um compartilhamento offline se parece.

   Em seguida, escolha o Domínio de dados As linhas contam em relação a, verifique Análise e clique em Criar conectorA primeira varredura começa imediatamente. O conector Manifesto A aba mostra o que foi compilado e quaisquer arquivos que foram separados.

5. Observe suas tabelas.

   Abra o conector: o Manifesto A guia lista as tabelas que foram criadas. Na Construtor de consultas as mesmas mesas ficam embaixo do conjunto de arquivos Esquema. Três consultas que funcionam desde o primeiro dia:

   Linhas por arquivo JSONL

   SELECT _source_file, COUNT(*) AS row_count FROM fileset.events GROUP BY _source_file ORDER BY row_count DESC LIMIT 100

   Uma linha por arquivo, para que você possa ver quantas linhas cada arquivo JSONL contribuiu.

   Arquivos que foram alterados no último dia

   SELECT relative_path, size_bytes, modified_utc FROM fileset.files WHERE modified_utc >= now() - INTERVAL 1 DAY ORDER BY modified_utc DESC LIMIT 100

   Os arquivos que o Agente visualizou foram alterados desde ontem, do mais recente para o mais antigo.

   Processos arquivados ou recusados, e porquê.

   SELECT 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 20

   Todos os arquivos cujas linhas foram omitidas, com a devida justificativa, incluindo arquivos com novo formato.

   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.

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

Use-o 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 JSONL 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 de pastas JSONL.

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 JSON em um banco de dados no mesmo agente.

Como os arquivos novos, alterados e excluídos são exibidos

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_eventos registra um deriva fila cuja detalhe O 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_eventos recebe um recusado linha com o motivo em detalheE 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.

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:

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

• Sistema de arquivos
• Pasta CSV
• Pasta Parquet
• Pasta do Excel
• Pasta SQLite
• CSV com vários registros
• Registros de máquinas
• Registros do servidor web
• Registros do contêiner
• Registros de aplicativos
• Registros do sistema
• Registros personalizados