Logotipo da pasta Parquet

Arquivos colunares Novo

Consultar um Pasta Parquet Com SQL — no Excel, Planilhas Google, IA e REST

Consultar uma pasta de arquivos Parquet como uma única tabela. O Parquet possui seus próprios tipos de coluna, portanto, nada é inferido — um decimal permanece um decimal e um timestamp permanece um timestamp.

Comece gratuitamente 13 destinos Guia de pastas Parquet

Uma conexão, todas as superfícies

Onde seus dados da pasta Parquet podem ser armazenados.

Pasta Parquet muitos arquivos → uma mesa ao vivo cada
Consultas federadas + qualquer outro conector · um SQL de todas as fontes · todos os planos
Agente de rede
  • 1 conexão de saída
  • 0 portas de entrada
  • Somente leitura · os arquivos permanecem no mesmo lugar

funciona em

O Query Streams transforma uma pasta de arquivos Parquet em uma única tabela SQL ativa, legível pelo Microsoft Excel, Google Sheets, assistentes de IA via MCP, API REST e Power BI. O Parquet possui seus próprios tipos de coluna, portanto, o agente auto-hospedado lê o esquema do rodapé de cada arquivo em vez de amostrar linhas — um decimal permanece decimal, um timestamp permanece timestamp e não há possibilidade de erro de amostragem. Os arquivos permanecem em sua máquina; apenas os resultados da consulta saem da rede.

Um dos 9 drivers de conjunto de arquivos em um mecanismo de pastas — as tabelas de inventário, o histórico de alterações e as regras de recusa em Recursos são compartilhadas pela família Pasta Parquet Sistema de arquivos Pasta CSV Pasta do Excel Pasta SQLite Pasta JSONL CSV com vários registros Registros de máquinas Registros do servidor web

  1. Para sua equipe, fornecedores e parceiros.

  2. Pasta Parquet para Excel Microsoft Excel · Suplemento do Excel

    Extraia resultados de pastas Parquet em tempo real diretamente para uma planilha e atualize-os sob demanda — Excel para desktop, Excel Online, Microsoft 365.

    Como funciona o Excel

  3. Pasta Parquet para Planilhas Google Suplemento de planilhas

    Execute uma consulta salva da Pasta Parquet na barra lateral e arraste as linhas para a planilha. Os colaboradores que compartilharam a planilha podem atualizá-la por conta própria.

    Como funciona o Google Sheets

  4. Pergunte à Nova sobre a pasta Parquet. Nova AI · texto para SQL

    Faça uma pergunta em linguagem simples. O Nova já conhece suas tabelas de pastas Parquet, escreve e executa o SQL, explica a resposta e a exibe em um gráfico — sem necessidade de escrever consultas ou fornecer credenciais.

    Como funciona o Nova

  5. Pasta Parquet para Visualizador de Dados Compartilhamento de resultados · equipe, fornecedores, parceiros · celular, tablet, computador

    Compartilhe o resultado de uma pasta Parquet em tempo real com qualquer pessoa — um colega, um fornecedor, um parceiro — como uma grade que pode ser adicionada aos favoritos e que é atualizada automaticamente ao ser aberta em um celular, tablet ou computador. Eles veem os resultados, nunca o SQL ou os arquivos.

    Como funciona o Visualizador de Dados
  6. Para aplicativos e sistemas

  7. API REST de pastas Parquet endpoint HTTP

    Publique uma consulta de pasta Parquet como um endpoint JSON autenticado que qualquer aplicativo pode chamar, com uma especificação OpenAPI 3.1 e coleções prontas para Postman, Insomnia e Hoppscotch. Nenhuma porta de banco de dados é aberta.

    Como funciona a API REST

  8. Pasta Parquet para Power BI Power Query M

    Cole o arquivo M do Power Query gerado no Editor Avançado do Power BI e o relatório lerá os resultados da pasta Parquet em tempo real via HTTPS — sem driver ODBC, sem porta de banco de dados aberta.

    Como funciona o Power BI

  9. Pasta Parquet para Airtable Plataforma de automação

    Sincronize as linhas da pasta Parquet com uma base do Airtable de acordo com um agendamento ou busque-as dentro de um script de automação do Airtable.

    Como funciona o Airtable

  10. Pasta Parquet para Linha Base Plataforma de automação

    Envie uma tabela do Baserow a partir de uma pasta Parquet através do endpoint REST — hospedado localmente ou na nuvem do Baserow.

    Como funciona o Baserow

  11. Pasta Parquet para SeaTable Plataforma de automação

    Mantenha uma base SeaTable atualizada com dados de pastas Parquet sem exportar um arquivo ou expor o banco de dados.

    Como funciona o SeaTable

  12. Pasta Parquet para Smartsheet Plataforma de automação

    Inserir os resultados da pasta Parquet em uma grade do Smartsheet permite que os planos e relatórios sejam lidos do sistema de origem, e não da exportação da semana passada.

    Como funciona o Smartsheet

  13. Pasta Parquet para Bigorna Anvil Works · Plataforma de aplicativos

    Faça backup de um aplicativo Anvil Python com pasta Parquet por meio do endpoint REST, em vez de incorporar as credenciais do banco de dados no aplicativo.

    Como funciona o Anvil
  14. Para ferramentas de IA

  15. Servidor MCP de pastas Parquet Clientes Claude, Cursor e MCP

    Conceda a um assistente de IA acesso somente leitura à pasta Parquet com o esquema necessário para escrever SQL corretamente — sem credenciais no chat.

    Como funciona o MCP
  16. Entregue às pessoas

  17. Alertas e relatórios de pastas Parquet Slack · Discord · E-mail · Webhook

    Programe uma consulta em uma pasta Parquet e receba as linhas no Slack, Discord, por e-mail ou por um webhook assinado — ou retenha a mensagem até que a contagem de linhas, um limite ou uma variação percentual ultrapasse o valor definido.

    Como funcionam os alertas e relatórios

Como funciona

5 etapas, sem alteração no firewall de entrada

01

Instale o Agente de Rede em um local onde ele possa acessar a pasta — um diretório de exportação, um pequeno data lake, um diretório de distribuição do fornecedor.

02

Aponte o conector para a pasta ou para a árvore inteira; todos os arquivos .parquet serão correspondidos.

03

O Parquet armazena seu esquema dentro de cada arquivo, portanto o agente lê essas descrições em vez de amostrar linhas. Nenhum tipo é inferido do texto e nenhum erro de amostragem é possível.

04

Os arquivos são carregados em uma tabela, empilhados, com uma coluna _source_file em cada linha, indicando o nome do arquivo.

05

Consulte-o com o mesmo SQL usado em seus bancos de dados e faça a junção com eles na mesma instrução.

Análise detalhada do recurso

O que a pasta Parquet oferece

Por que este é exatamente o correto?

  • Os tipos vêm do próprio arquivo. — decimais, registros de data e hora e números inteiros chegam exatamente como são.
  • União de colunas — se alguns arquivos tiverem uma coluna que os outros não têm, ela simplesmente será lida como vazia para esses arquivos, em vez de quebrar o conjunto.
  • Se dois arquivos discordarem de fato quanto ao tipo de uma coluna, o conector se recusará a fixá-los, optando por convertê-los em texto. Você será informado qual arquivo e qual coluna apresentam essa discrepância.
-- Linhas e receita por arquivo de exportação SELECT _source_file, COUNT(*) AS rows, SUM(amount) AS total FROM data GROUP BY _source_file

Após a primeira sincronização

Um arquivo posterior que adiciona uma coluna, remove uma coluna fixa ou altera um tipo é retido e registrado em `files_events` pelo nome. O restante da pasta continua sendo carregado, de modo que uma exportação malformada nunca tira a tabela do ar. A leitura é barata: apenas os arquivos que foram realmente alterados são relidos.

Compartilhado por toda a família File Set.

Cada conector de pasta também lhe oferece

  • arquivos_atual — um inventário em tempo real: todos os arquivos que o conector consegue visualizar no momento, com seu caminho, tamanho e data de modificação.
  • arquivos_eventos — o registro de auditoria: o que apareceu, o que mudou, o que desapareceu e tudo o que foi retido, com o nome do arquivo e o motivo.
  • diretórios e volumes — totais por pasta, histórico de crescimento diário e quanto espaço resta na unidade.
  • Apenas os arquivos que foram efetivamente alterados são relidos a cada sincronização; portanto, uma pasta com 50.000 arquivos não é analisada novamente só porque uma nova exportação foi concluída.

Bom saber

  • Somente leitura, obrigatório — uma instrução por vez, somente SELECT e comandos similares. Seus arquivos nunca são gravados, movidos ou renomeados.
  • Nada foi carregado. — os dados são armazenados em cache e criptografados em sua própria máquina, ao lado do agente. Somente o resultado de uma consulta sai da sua rede.
  • Padrões sensatos — até 250.000 arquivos, 16 níveis de pastas, 512 MB por arquivo, tudo ajustável. Lixeiras, .git e node_modules são sempre ignorados.
  • O dialeto SQL é DuckDB. — o mesmo SQL que você escreveria para qualquer outro conector.

SQL entre fontes diferentes

Una a pasta Parquet ao restante dos seus dados.

Uma pasta de arquivos é um conjunto de tabelas SQL como qualquer outro, portanto, uma única instrução pode uni-la a um banco de dados e a uma API simultaneamente. Cada fonte executa apenas a parte que consegue processar, transmite o resultado de volta e a junção ocorre de forma centralizada — as fontes nunca se comunicam entre si e nada é copiado para lugar nenhum.

3 conexões · 3 agentes

Pasta Parquet Arquivos colunares
PostgreSQL Motor relacional
Listrado Pagamentos e faturamento

Uma declaração

-- nada copiado, nada mesclado, nada agendado
SELECIONAR   c.região, COUNT(*) AS pedidos, SUM(i.valor_devido) AS faturado
DE     lago parquet.conjunto.de.dados1 f
JUNTAR     pg_crm.clientes.públicos2   c LIGADO c.id = f.id_do_cliente
JUNTAR     cobrança.stripe.faturas3   i LIGADO i.cliente = c.stripe_id
GRUPO POR c.região
ORDER BY faturado DESC;

As três partes são conexão, esquema e tabela — e o nome da conexão é o que você escolheu. Colunas ilustrativas; suas tabelas serão suas tabelas. O acesso somente leitura se aplica a cada componente: apenas SELECT, WITH e EXPLAIN, com um limite máximo de dados que uma única fonte pode fornecer para uma consulta. Como funcionam as consultas federadas

Detalhes da conexão

O que a pasta Parquet precisa

Pasta
One or more roots — local disk or a network share typed as \\server\share (never a mapped drive letter; on Linux or a Mac, mounted first); every .parquet file is matched, subfolders included
Esquema
Leitura a partir do rodapé Parquet de cada arquivo — sem amostragem, sem inferência, sem tipo deduzido do texto.
União de colunas
Uma coluna que contém valores apenas em alguns arquivos está vazia em outros, em vez de quebrar o conjunto.
conflitos de tipo
Se dois arquivos discordarem genuinamente quanto ao tipo de uma coluna, o conector se recusará a fixá-la e nomeará o arquivo e a coluna, em vez de convertê-los em texto.
Tabelas
Uma tabela, com todos os arquivos empilhados nela, cada linha contendo uma coluna _source_file nomeando o arquivo.
Limites
Até 250.000 arquivos, 16 níveis de pastas, 512 MB por arquivo — tudo ajustável.
Credenciais
Nenhum — não há servidor; o agente lê os arquivos diretamente no local.
dialeto SQL
DuckDB — SQL padrão, sem nada específico de pastas para aprender.

Nesta imagem, não há servidor de banco de dados. O agente lê os arquivos .parquet em seu local original, armazena as linhas em cache em um banco de dados DuckDB criptografado na mesma máquina e lê novamente apenas os arquivos que foram alterados — uma pasta com 50.000 arquivos não é analisada novamente porque uma nova exportação foi recebida. Nada é enviado para o Query Streams; a única coisa que sai da sua rede é o resultado de uma consulta.

O Parquet é o único formato dessa família em que nada precisa ser inferido. Todos os outros conectores de pastas descobrem o tipo de uma coluna analisando seus valores; o Parquet já sabe, então o agente lê a descrição em vez dos dados. Isso torna a configuração barata mesmo em pastas muito grandes — apenas os rodapés são examinados — e elimina todo o problema de uma coluna parecer numérica nas primeiras mil linhas e depois se descobrir que não é.

Documentação do fornecedor: parquet.apache.org

Perguntas frequentes

Perguntas sobre pasta Parquet

Quais ferramentas conseguem ler dados de pastas Parquet por meio de fluxos de consulta?

Tudo isso, a partir de uma única conexão: Excel, Planilhas Google, MCP, API REST, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, alertas e relatórios agendados. Conecte a pasta uma única vez e todas as plataformas lerão a mesma conexão somente leitura — não há configuração por ferramenta nem necessidade de uma segunda cópia dos dados.

Meus arquivos são enviados para o Query Streams?

Não. O Agente de Rede lê os arquivos no local e armazena as linhas em cache em um repositório criptografado na mesma máquina. Os arquivos em si nunca saem da sua rede — apenas as linhas de resultado de uma consulta saem, por meio de uma única conexão de saída criptografada, sem porta de firewall de entrada.

O Query Streams pode alterar, mover ou renomear meus arquivos?

Não. Os arquivos são abertos estritamente em modo somente leitura e nunca são gravados, movidos ou renomeados. As consultas são executadas em modo somente leitura no momento da execução — uma instrução por vez, apenas SELECT e similares.

O que o Query Streams precisa para se conectar à pasta Parquet?

A folder path the agent machine can see — no server, no credentials, no drivers to install. Folder: One or more roots — local disk or a network share typed as \\server\share (never a mapped drive letter; on Linux or a Mac, mounted first); every .parquet file is matched, subfolders included. Schema: Read from each file's own Parquet footer — no sampling, no inference, no type worked out from text. Column union: A column only some files carry reads as empty in the others rather than breaking the set. Type conflicts: If two files genuinely disagree on a column's type the connector refuses to pin and names the file and the column, instead of flattening both to text.

Posso adicionar uma pasta de arquivos a um banco de dados na mesma consulta?

Sim, trata-se de uma consulta federada. Uma única instrução pode referenciar a Pasta Parquet e suas outras conexões simultaneamente, escritas como conexão.esquema.tabela. Cada origem executa apenas a parte que consegue e transmite o resultado de volta; a junção ocorre centralmente, portanto as origens nunca se conectam entre si e nada é copiado ou agendado. O modo somente leitura se aplica a cada parte — SELECT, WITH e EXPLAIN apenas — e há um limite para a quantidade de dados que uma origem pode fornecer para uma única consulta. Consultas federadas são um recurso do plano; a página de consultas federadas contém os limites atuais de origem e tamanho.

Coloque a pasta Parquet no local onde o trabalho será realizado.

Instale o agente, aponte-o para a sua pasta e escolha um destino.

Comece gratuitamente Todos os conectores

Somente leitura Apenas envio As credenciais permanecem com o agente.