Mesclar vários arquivos do Excel em uma única tabela.

Conector de pastas · Pasta do Excel

Transformar uma pasta de planilhas do Excel 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 por planilha, por exemplo. conjunto de arquivos.data_orders, contendo as linhas dessa planilha de todas as pastas de trabalho na pasta, com um _arquivo_fonte coluna que nomeia a planilha de onde cada linha veio. Insira a planilha do próximo mês e suas linhas serão adicionadas à tabela na próxima verificação; corrija uma planilha antiga e suas linhas serão substituídas. O Agente lê o .xlsx Os arquivos são armazenados no computador onde o programa é executado e as linhas são armazenadas em cache nesse local, de forma que as planilhas permaneçam na sua rede.

Tudo está contido em um esquema DuckDB chamado conjunto de arquivos, armazenadas em cache no computador do Agente. As tabelas recebem nomes para você, pois não há Nome da tabela campo. Cada linha contém _arquivo_fonte e _row_id.

Cada conector de pasta também lhe oferece arquivos, arquivos_eventos, diretórios, snapshots_de_diretório e volumes, que listam as próprias planilhas, seu histórico de alterações e tamanhos das pastas.

Onde se justifica o seu sustento:

• Relatórios regionais: cada região salva o mesmo modelo de planilha em um compartilhamento, e a sede consulta uma única tabela data_orders em vez de copiar planilhas.
• Orçamentos mensais: uma nova planilha é gerada a cada mês, e a tabela consolidada aumenta em um arquivo sem que ninguém precise importá-la novamente.
• Pastas de trabalho mistas de diferentes equipes se tornam tabelas individuais, com uma tabela por layout, nomeadas a partir da parte compartilhada de seus nomes de arquivo.

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 planilhas do Excel: 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 planilhas do Excel.

   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 do Excel 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.

   Comece pelo Adicionar conector botão de um Agente que pode abrir a pasta. Abrir Arquivos e pastas e clique no Pasta do Excel cartão.

   • Pastas raiz: uma pasta por linha, como caminhos no computador do Agente. Digite um compartilhamento de rede como \\servidor\compartilhamento\pasta, não como uma letra de unidade mapeada.
   • Incluir padrões começa como **/*.xlsx. Analisar subpastas está ligado.
   • Não existe Nome da tabela campo. Planilhas se transformam em tabelas, como por exemplo pedidos_de_dados. Usar Folhas Para limitar quais folhas são lidas.
   • Escolha um Layout da tabela. Um layout fixado (padrão) É adequado para planilhas que compartilham as mesmas folhas e colunas. Uma mesa por layout Pastas para ternos que as pessoas montam à mão, com até 25 layouts.

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 pastas de trabalho e lista as tabelas que serão criadas. Nada foi criado ainda. Uma pasta de trabalho sem uma planilha fixada é indicada no aviso "{n} de {m} arquivo(s) serão reservados"; abra Mostre quais arquivos e por quê. para visualizar cada um. Um arquivo que não seja uma planilha real, como um CSV renomeado, também é listado lá com um motivo como "ilegível como Excel: não legível como uma planilha XLSX". Se as planilhas tiverem layouts diferentes, Layout da tabela ainda está fixado, um painel azul-celeste oferece Mude para uma tabela por layout.Se nenhuma pasta de trabalho contiver o conjunto completo de planilhas, a verificação será rejeitada e nenhuma tabela será criada até que você corrija ou exclua um arquivo.

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:

   Quantas linhas cada planilha contribui para a folha de pedidos?

   SELECT _source_file, COUNT(*) AS row_count, MIN(_row_id) AS first_row_id FROM fileset.data_orders GROUP BY _source_file ORDER BY row_count DESC LIMIT 100

   Confirma se todas as planilhas regionais ou mensais foram incluídas na tabela consolidada e quanto cada uma adicionou.

   Quais cadernos de exercícios chegaram, foram alterados ou desapareceram esta semana?

   SELECT relative_path, event_type, size_bytes, prev_size_bytes, event_at FROM fileset.files_events WHERE event_type IN ('appeared', 'modified', 'vanished') AND event_at >= now() - INTERVAL 7 DAY ORDER BY event_at DESC LIMIT 100

   Mostra o histórico de alterações da pasta, permitindo ver quem enviou uma nova planilha e quando uma antiga foi editada.

   Cada pasta de trabalho na pasta, com seu respectivo proprietário do Windows.

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

   Lista as pastas de trabalho que o Agente pode visualizar e quem salvou cada uma delas pela última vez; o proprietário é preenchido apenas no Windows.

   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 do Excel 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 do Excel.

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 planilhas do Excel 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 SQLite
• 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