文件系统徽标

文件夹元数据 新

查询 文件系统 在 Excel、Google Sheets、AI 和 REST 中使用 SQL

使任何文件夹都可查询——每个文件的名称、大小、日期和更改历史记录都以行的形式呈现。在 SQL 中回答“文件是否到达？”、“什么文件消失了？”和“什么占用了驱动器空间？”等问题。不读取文件内容。

免费开始 13个目的地 文件系统指南

一个连接，每个表面

文件系统数据可以放在哪里

文件系统 许多文件 → 每桌一张实时桌
联合查询 + 任何其他连接器 · 一条 SQL 跨来源 · 每个计划
网络代理
  • 1 出站连接
  • 0 入境口岸
  • 只读文件保留在原处

运行

Query Streams 将任何文件夹转换为实时 SQL 表——每个文件的名称、大小、日期和更改历史记录都以行的形式呈现——可从 Microsoft Excel、Google Sheets、MCP 上的 AI 助手、REST API 和 Power BI 读取。自托管代理会遍历文件夹树并记录其发现的内容；它从不打开文件，因此不会读取任何内容。每次重新扫描都会与上次扫描进行比较，因此您可以查询已出现、已修改和已删除的文件行，而不是需要您自行比较差异的快照。

一个文件夹引擎上的 9 个文件集驱动程序之一——库存表、更改跟踪和拒绝规则 功能 由家人共享 文件系统 CSV文件夹 镶木地板文件夹 Excel文件夹 SQLite文件夹 JSONL文件夹 多记录 CSV 机器日志 Web服务器日志

  1. 为您的团队、供应商和合作伙伴

  2. 文件系统到 Excel 微软 Excel · Excel 加载项

    将实时文件系统结果直接提取到工作表中，并按需刷新——桌面版 Excel、Excel Online、Microsoft 365。

    Excel 的工作原理

  3. 文件系统到 Google 表格 表格插件

    从侧边栏运行已保存的文件系统查询，并将结果行拖放到工作表中。共享协作者可以自行刷新工作表。

    Google 表格的工作原理

  4. 向 Nova 询问文件系统相关问题 Nova AI · 文本转 SQL

    用简单的英语提问。Nova 已经了解你的文件系统表，会自动编写并运行 SQL 语句，解释答案并绘制图表——无需编写查询语句，也无需提供任何凭据。

    Nova 的工作原理

  5. 文件系统到数据查看器 结果共享 · 团队、供应商、合作伙伴 · 手机、平板电脑、台式机

    您可以与任何人（同事、供应商、合作伙伴）共享实时文件系统结果，以可添加书签的网格形式呈现，无论在手机、平板电脑还是台式机上打开，结果都会自动更新。他们看到的是结果，而不是 SQL 语句或文件。

    数据查看器的工作原理
  6. 对于应用程序和系统

  7. 文件系统 REST API HTTP 端点

    将文件系统查询发布为任何应用程序都可以调用的已认证 JSON 端点，符合 OpenAPI 3.1 规范，并预置了 Postman、Insomnia 和 Hoppscotch 集合。无需打开数据库端口。

    REST API 的工作原理

  8. 文件系统到 Power BI Power Query M

    将生成的 Power Query M 粘贴到 Power BI 高级编辑器中，报表将通过 HTTPS 读取实时文件系统结果——无需 ODBC 驱动程序，也无需打开数据库端口。

    Power BI 的工作原理

  9. 文件系统到 Airtable 自动化平台

    按计划将文件系统行同步到 Airtable，或者在 Airtable 自动化脚本中获取它们。

    Airtable 的工作原理

  10. 文件系统到基行 自动化平台

    通过 REST 端点从文件系统向 Baserow 表提供数据——无论是自托管还是 Baserow 云。

    Baserow 的工作原理

  11. 文件系统到 SeaTable 自动化平台

    无需导出文件或暴露数据库，即可使用文件系统数据保持 SeaTable 数据库的最新状态。

    SeaTable 的工作原理

  12. 文件系统到 Smartsheet 自动化平台

    将文件系统推送结果导入 Smartsheet 网格，以便计划和报告从源系统读取数据，而不是从上周的导出数据读取数据。

    Smartsheet 的工作原理

  13. 文件系统到铁砧 Anvil Works · 应用平台

    通过 REST 端点为 Anvil Python 应用程序提供文件系统支持，而不是将数据库凭据嵌入到应用程序中。

    Anvil 的工作原理
  14. 人工智能工具

  15. 文件系统 MCP 服务器 Claude、Cursor 和 MCP 客户端

    赋予 AI 助手对文件系统的只读访问权限，并提供它编写正确 SQL 所需的架构——聊天中无需提供凭据。

    MCP 的工作原理
  16. 已送达

  17. 文件系统警报和报告 Slack · Discord · 电子邮件 · Webhook

    将文件系统查询添加到计划中，并将查询结果发送到 Slack、Discord、电子邮件或签名 webhook，或者等到行数、阈值或百分比变化超过您设定的界限时才发送消息。

    警报和报告的工作原理

工作原理

5 个步骤，无需更改入站防火墙规则

01

将网络代理安装在可以看到该文件夹的机器上——文件服务器、NAS 共享或导出文件所在的 PC。

02

将其指向一个或多个根文件夹。您可以自行设置包含和排除模式；系统会自动跳过回收站、.git 和 node_modules 文件夹。

03

该代理会遍历树状结构（默认深度为 16 层），并记录每个文件的路径、大小、时间戳以及文件是否仍然存在。它从不打开文件。

04

每次重新扫描都会与上一次进行比较，因此您可以获得更改轨迹而不是快照：出现、修改、消失。

05

像查询任何表一样查询它，并将其连接到数据库——例如，ERP 系统中没有匹配文件在文件夹下的发票。

专题深度解析

文件系统能给你带来什么？

您可以查询的内容

  • files_current — 当前每个文件一行：路径、文件夹、扩展名、大小和修改日期。
  • 文件事件 ——每次更改一行。这样你就可以回答“昨晚发生了什么？”或者“谁删除了三月份的文件夹？”
  • 目录 — 每个文件夹的计数和总数，以及无法读取文件夹时所说明的原因。
  • 目录快照 — 每个文件夹每日大小系列，因此增长情况可以用图表表示，而不是靠猜测。
  • 卷 — 为每根根系所在的驱动器提供容量和自由空间。

将文件名转换为列

导出文件几乎都遵循一定的命名规则。给连接器指定一个文件名模式，每个部分就会成为单独的一列，这样就可以按日期和客户筛选 INV_2026-08-24_ACME.csv 文件，而无需进行字符串修改。文件夹名称也可以用同样的方法获取。

-- 过去一天到达的所有文件，按大小排序 SELECT relative_path, size_bytes, modified_utc FROM files_current WHERE modified_utc > now() - INTERVAL 1 DAY ORDER BY size_bytes DESC

它故意不做的事情

文件系统是文件夹的索引，而非数据的索引。它不会读取任何文件内容。如果您需要文件中的行，请使用 CSV、Parquet、Excel、SQLite、JSONL 或多记录 CSV 文件夹——它们不仅提供相同的库存表，还提供数据本身。

由整个文件集系列共享

每个文件夹连接器还会给你提供

  • files_current — 实时清单：连接器当前可以看到的每个文件，包括其路径、大小和修改日期。
  • 文件事件 — 审计跟踪：出现了什么，改变了什么，消失了什么，以及任何被保留的内容，包括文件名和原因。
  • 目录和卷 — 每个文件夹的总数、每日增长历史记录以及驱动器上剩余的空间。
  • 每次同步时只会重新读取实际更改的文件，因此不会因为新增了一个导出文件就重新解析包含 50,000 个文件的文件夹。

知道这个很有用

  • 只读，强制执行 每次只执行一条语句，仅限 SELECT 及其相关语句。您的文件绝不会被写入、移动或重命名。
  • 未上传任何内容。 — 数据会缓存并加密存储在您自己的机器上，与代理程序并存。只有查询结果才会离开您的网络。
  • 合理的默认值 最多可存储 25 万个文件，16 层文件夹，每个文件 512 MB，所有设置均可调整。回收站、.git 和 node_modules 目录始终会被跳过。
  • SQL 方言是 DuckDB — 与针对任何其他连接器编写的 SQL 语句相同。

跨源 SQL

将文件系统与其余数据连接起来

文件夹索引与其他 SQL 表一样，都是一组 SQL 表。您的记录系统知道哪些文档应该存在，您的支付处理系统知道哪些文档已经结算——只有文件夹索引知道实际到账的文档是什么，一条语句可以查询所有这三个系统。每个数据源只运行它能够处理的部分，并将结果流式传输回来，连接操作在中心进行——各个数据源之间互不通信，也不会复制任何数据。

3 个连接 · 3 个代理

文件系统 文件夹元数据
微软 SQL 服务器 关系引擎
条纹 付款与账单

一份声明

——在ERP系统中发出，到达文件夹，在Stripe系统中结算
选择    e.发票号，e.开票日期，f.首次查看UTC时间，i.状态
从      ERP SQL.dbo.invoices2              e
左连接 文件夹.fileset.files_current1 f ON f.invoice_no = e.invoice_no
左连接 计费.stripe.invoices3           i ON i.number = e.invoice_no
ORDER BY  e.issued_on DESC;

这三个部分分别是连接、模式和表——连接名称就是您自己命名的。示例列；您的表就是您自己的表。invoice_no 是一个文件名列：给连接器指定命名约定，文件名的每个部分都会变成一个可用于连接的列。空值表示文档从未出现过。所有部分都采用只读模式：仅支持 SELECT、WITH 和 EXPLAIN 语句，并且限制了单个数据源在单次查询中可以传输的数据量。 联合查询的工作原理

连接详情

文件系统需要什么

文件夹
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); subfolders included, include and exclude patterns supported
阅读
仅获取文件名、大小、日期和路径——文件本身从未被打开，因此内容也从未被解析。
表格
files_current、files_events、目录、目录快照和卷——清单、变更跟踪、每个文件夹的总计、每日大小序列和驱动器容量
更改历史记录
每次重新扫描都会与上次扫描进行比较，因此出现、修改和消失的行都是您可以查询的记录。
文件名列
设定命名规则后，每个部分都会成为单独的一列；文件夹名称也可以用同样的方法记录。
限制
最多可存储 25 万个文件，16 层文件夹深度——两者均可调节
凭据
无——没有服务器；代理程序直接读取文件夹。
SQL方言
DuckDB——使用标准的 SQL，无需学习任何特定于文件夹的内容。

这里没有数据库服务器，也没有文件数据——这个连接器索引的是文件夹，而不是文件夹内的内容。代理会遍历文件夹树，将每个文件的路径、大小和时间戳记录到同一台机器上加密的 DuckDB 存储中，并将每次遍历的结果与上一次的记录进行比较。没有任何数据会上传到查询流；唯一离开您网络的内容是查询结果。

当问题与文件本身相关时，这张卡片就能派上用场：例如，昨晚的出口货物是否已到达，哪些文件丢失了，硬盘空间被哪些文件占满，ERP 系统中哪些发票在收件箱中没有对应的文档。如果您需要查看文件中的行，CSV、Parquet、Excel、SQLite、JSONL 和多记录 CSV 卡片会提供相同的库存表以及相应的数据。

常问问题

关于文件系统的问题

哪些工具可以通过查询流读取文件系统数据？

只需一次连接，即可访问所有工具：Excel、Google Sheets、MCP、REST API、Airtable、Baserow、SeaTable、Smartsheet、Anvil、Power BI、定时提醒和报表。只需连接一次文件夹，所有平台即可读取同一个只读连接——无需为每个工具单独设置，也无需创建数据副本。

我的文件会上传到查询流吗？

不。网络代理会直接读取文件，并将结果行缓存到同一台机器上的加密存储中。文件本身永远不会离开您的网络——只有查询结果行会通过单个出站加密连接传输，无需任何入站防火墙端口。

查询流可以更改、移动或重命名我的文件吗？

不。文件以只读方式打开，绝不会写入、移动或重命名。查询语句在执行时也强制执行只读模式——一次只执行一条语句，仅限 SELECT 及其相关语句。

查询流需要连接到文件系统的什么？

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); subfolders included, include and exclude patterns supported. Reads: Names, sizes, dates and paths only — the file itself is never opened, so contents are never parsed. Tables: files_current, files_events, directories, directory_snapshots and volumes — inventory, change trail, per-folder totals, a daily size series and drive capacity. Change history: Every rescan is compared against the last, so appeared, modified and vanished are rows you can query.

我可以在同一个查询中将一个包含多个文件的文件夹连接到数据库吗？

是的——这就是联合查询。一条语句可以同时引用文件系统和其他连接，格式为 connection.schema.table。每个数据源只运行它能够处理的部分，并将结果流式传输回来；连接操作在中心进行，因此数据源之间不会相互连接，也不会进行任何复制或调度。所有部分（SELECT、WITH 和 EXPLAIN）都采用只读模式，并且单个数据源在单次查询中可以传输的数据量有限制。联合查询是计划功能；联合查询页面会显示当前的数据源和大小限制。

将文件系统放在工作发生的地方

安装代理程序，将其指向您的文件夹，然后选择目标位置。

免费开始 所有连接器

只读 仅限出站 凭证保留在代理人身上。