Combinar vários arquivos de banco de dados SQLite em uma única tabela.

Conector de pastas · Pasta SQLite

Transformar uma pasta de arquivos de banco de dados SQLite 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 um banco de dados construído a partir de todos os arquivos SQLite na pasta. Uma tabela chamada eventos Em cada arquivo, torna-se uma tabela mesclada. conjunto de arquivos.dados_eventose cada linha carrega um _arquivo_fonte coluna que nomeia o arquivo de origem. Não há script ATTACH nem mesclagem manual. O Agente abre cada arquivo em modo somente leitura, copia as linhas para um cache local criptografado em seu próprio computador e as disponibiliza como SQL para o Excel, Planilhas Google, Construtor de Consultas, alertas ou qualquer outro recurso que consulte Fluxos de Consulta. Os arquivos nunca saem da sua rede.

Cada tabela está em um esquema chamado conjunto de arquivosAs tabelas recebem nomes personalizados. Cada tabela membro encontrada nos bancos de dados se torna... dados_<membro>, então uma tabela chamada eventos torna-se conjunto de arquivos.dados_eventos e uma mesa chamada Usuários torna-se conjunto de arquivos.dados_usuáriosUma tabela mesclada contém as linhas da tabela membro de cada arquivo correspondente. Os tipos de coluna declarados devem ser iguais entre os arquivos; caso contrário, o Agente nomeia o arquivo que apresenta a discrepância e não cria nenhuma tabela até que você corrija ou exclua o arquivo. Cada linha contém _arquivo_fonte e um estável _row_id.

Cada conector de pastas também fornece as tabelas de contabilidade. arquivos, arquivos_eventos, diretórios, snapshots_de_diretório e volumesAssim, você poderá ver quais arquivos estão presentes e o que foi alterado.

Onde se justifica o seu sustento:

• Gere relatórios em um único banco de dados SQLite por loja, site ou dispositivo, sem precisar copiá-los para um banco de dados de servidor.
• Compare a mesma tabela em vários bancos de dados de aplicativos ou sensores, classificados por arquivo.
• Mantenha uma pasta com os arquivos exportados do SQLite no Excel ou no Google Sheets, atualizando-a conforme novos arquivos forem chegando.

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 os arquivos do banco de dados SQLite: 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 de banco de dados SQLite.

   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 SQLite 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 SQLite cartão.

   • Pastas raiz: as pastas no computador do Agente a serem verificadas, uma por linha. Digite compartilhamentos de rede como \\servidor\compartilhamento\pastaNão se trata de uma letra de unidade mapeada. O Agente é executado como um serviço e não consegue visualizar unidades mapeadas no seu login.
   • Incluir padrões começa como **/*.db e **/*.sqlite. O -wal e -jornal Os arquivos adjacentes a um banco de dados nunca coincidem.
   • TabelasSelecione quais tabelas de membros deseja ler. Deixe em branco para selecionar todas.

   Não existe Nome da tabela campo e nenhum Layout da tabela escolha. As mesas são nomeadas dados_<membro>Uma nota explica que todos os arquivos correspondentes devem compartilhar um layout: os primeiros pinos de sincronização que seguem um padrão, e os arquivos que apresentarem discrepâncias posteriores são descartados e relatados.

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.

   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 das pastas e mostra o que irá construir. Nada foi criado ainda. Com uma pasta limpa, você vê... Pronto para criar e um chip como “3 tabelas: data_events, data_users, data_settings”. O problema que esta fonte relata com mais frequência é uma discrepância no tipo declarado: um arquivo armazena uma coluna como TEXT enquanto os outros a declaram REAL. Então, o aviso exibe “A verificação do esquema foi recusada: …” com o arquivo e a coluna nomeados, e nenhuma tabela de dados é criada até que você corrija ou exclua esse arquivo. Em vez disso, um único banco de dados bloqueado ou corrompido aparece em Mostre quais arquivos e por quê. como definido, e o restante dos arquivos 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 de banco de dados

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

   Uma linha por arquivo SQLite, para que você possa ver a contribuição de cada banco de dados para a tabela consolidada.

   Quais arquivos de banco de dados estão na pasta agora?

   SELECT relative_path, size_bytes, modified_utc FROM fileset.files ORDER BY modified_utc DESC LIMIT 100

   O registro atual do arquivo, com a alteração mais recente primeiro, contendo o tamanho de cada banco de dados.

   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 respectiva justificativa.

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

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 de banco de dados SQLite em relação a 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 JSONL
• 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