保持 Baserow 与你的 DuckDB 文件保持一致, 按计划
只需编写一次 SQL 语句。Query Streams 会按照您设定的计划运行它,从每五分钟一次到每周一次都可以,并将结果行写入您的 Baserow 表。您可以按键匹配行,这样编辑操作就能保留在原位,而查询未覆盖的行则会被删除,或者也可以简单地追加数据。无需 Zapier、脚本或导出功能。首次运行大约需要十五分钟,免费套餐即可满足需求。
你最终会得到什么
Baserow 表用于存储 DuckDB 查询返回的行,并按计划更新,更新频率从每五分钟到每周一次不等,每次更新都会记录更改内容。例如:
DuckDB 将您的数据存储在一个文件中。您的团队在 Baserow 中工作。通常的桥接方式是使用 Zapier 或 Make,或者上传一个 CSV 文件,但这种方式会静默地进行数据分离,然后逐行复制。Query Streams Automation 则采用了不同的方式:它内置的代理程序可以读取您的 DuckDB 文件,并按计划运行您保存的 SQL 语句,然后将所有结果一次性写入 Baserow。该代理程序通过键值对行进行匹配,从而保持表的正确性,避免表数据不断增长。
你需要准备什么
DuckDB 通过 Agent 连接
在存放 DuckDB 文件的计算机上,或者在从网络共享读取该文件的计算机上,安装代理程序,并在“数据代理”中添加连接。还没完成吗? 首先连接 DuckDB大约需要十分钟。
您的 Baserow 登录信息
输入您的 Baserow 服务器地址(默认为 api.baserow.io)、您的电子邮件地址和密码。Query Streams 会将这些信息加密存储,并在同步运行时自动为您登录。
工作在哪里进行? 在运行代理程序的计算机上,它会按计划运行查询并将结果行写入 Baserow,因此该计算机需要保持开机状态。您可以关闭浏览器。查询流本身不会存储这些结果行。
文件在另一台电脑上? 代理程序不必运行在存放 DuckDB 文件的计算机上:它可以从网络共享中读取文件。 访问网络共享上的文件下面展示了这需要哪些步骤。
分六步完成设置
-
保存要保持同步的查询
打开 查询生成器选择你的 DuckDB 连接(尚未连接?) 从这里开始),并编写 SELECT 语句,使其返回 Baserow 中所需的确切行和列。以下语句从 Baserow 中提取几列。 命令 桌子:
示例 · SQLSELECT order_id, customer_name, order_total FROM main.orders ORDER BY order_total DESC LIMIT 100;
运行它,然后 节省 给它起一个容易识别的名字,例如“Baserow 的订单”。在 SELECT 语句中保留一个每行都唯一的列,如下所示。 订单ID这就是完全同步功能用于就地更新行的关键所在。稍后编辑并重新保存查询,自动化程序会在下次运行时获取到这些更改。
-
打开自动化并选择 Baserow
在门户中,打开 自动化 (顶部菜单) 流 → 定时 → 自动化)并点击 新自动化巫师有五个简单的步骤。 步骤 1 点击 Baserow 卡片。
看到的是“开始之前”吗? 只有当代理在线并建立连接且至少存在一个已保存的查询时,该向导才会打开。页面会列出缺少哪一项,并提供指向该查询的链接。
-
连接基准行
在 步骤 2 填写 服务器 URL (留空表示使用 Baserow 云),您的 电子邮件 和 密码然后点击 测试连接输入您的 Baserow 服务器地址(默认为 api.baserow.io)、您的电子邮件地址和密码。Query Streams 会将这些信息加密存储,并在同步运行时自动为您登录。
-
选择行的落点。
在 步骤 3 选择 数据库然后是 桌子 数据行应该会同步到该表。如果您想要一个空表,请先在 Baserow 中创建该表。如果表中已有数据行,预览会显示这些数据行,并说明每种同步模式会对其执行哪些操作。每个表只能执行一个自动化操作。
-
选择查询语句,并决定如何显示数据行。
在 步骤 4 打开 保存的查询 列出并选择步骤 1 中的查询。查询流会运行一次该查询以读取列,并告诉您返回的行数,以及两个选项:
追加 · 快速附加
每次运行都会将查询结果添加到表的底部。不会更新或删除任何数据,因此它是快速收集日志、事件和历史记录的理想选择。无需键列。未更改的行不会再次添加;值发生更改的行会作为新行添加到下方,而原行则保留。
完全同步 · 镜像完全同步
行通过以下方式匹配: 钥匙 例如订单 ID 这样的列。新行会被添加,已更改的行会就地更新,查询不再返回的行会被删除,包括用户手动输入的行,因此手动输入的行会保存在另一个表中。这种方式适用于库存、销售管道、主数据和仪表盘。
完全同步是按列设置的,这使得它在共享表中非常有用:
- 钥匙
- 例如,标识行的列。 订单ID它在查询结果中必须是唯一的;查询流会自动检查这一点并拒绝重复项。
- 同步
- 每次运行都会从 DuckDB 覆盖数据。如果有人编辑了 Baserow 中的同步列,下次运行会恢复源值。
- 保存
- 该数据行在首次到达时写入,之后不会再进行比较,因此 DuckDB 中对该数据的更改不会触发更新。对于团队手动输入的备注、所有者和后续日期,请使用根本不在查询中的列:仅存在于 Baserow 中的列永远不会被同步操作修改。
哪个更快? 追加写入操作不会先读取表。完全同步操作会读取表,比较每一行,然后只写入差异部分,因此耗时更长,但表始终与查询结果匹配。您可以稍后从自动化流程的编辑面板中切换操作。
要查看您信任的表格,请点击 将所有列设置为同步然后点击钥匙图标 订单ID 使其成为 钥匙查询流会扫描整个结果以确认键的唯一性,如果不是,则会发出警告。您可以将团队的备注保存在与查询无关的列中;这些列不会被修改。要查看只会不断增长的日志,请点击此处。 将所有列设置为保留 而是跳过密钥。点击 继续.
-
设置日程,命名,创建它
在 步骤 5 选择 按计划运行 并选择 频率:
频率 跑 每5分钟 每 5 分钟一次,最快允许时间 每15分钟 每隔15分钟 每隔30分钟 每隔30分钟 每小时 每小时整点 每天上午9点 每天上午 9:00,默认 每天早上6点 每天早上6点 工作日上午9点 周一至周五上午 9:00 每周一(上午 9 点) 每周一上午9:00 自定义日程 您自己的分钟、小时、星期几或月份几日。 时代如是 时区 你选择,它最初是你浏览器的默认设置。你也可以选择 仅限手动 并按 运行 您可以随时设置计划任务;稍后可以从自动化流程的“编辑”面板添加计划任务。计划任务会在代理程序上运行,因此即使浏览器关闭,任务也会继续运行。如果运行代理程序的计算机在任务到期时处于关机状态,则会在代理程序重新启动后不久执行一次错过的运行。
给它一个 集成名称例如“每日发往Baserow的订单”,请检查 准备创建 摘要和点击 创建自动化返回“自动化”页面,按 运行 现在就执行第一次同步,无需等待预定计划。打开 Baserow:行就在那里,位于列标题下方。
就是这样。 从现在开始,该表将自动保持最新状态。除了查询返回的行之外,没有任何数据会离开您的网络,而且任何人都无需记住运行任何操作。
你之后看到的
这 自动化页面 列出所有自动化流程及其状态、源、目标、键、计划、上次同步时间和行数。打开一个查看详情。 执行 标签页:记录每次运行及其触发条件(手动或计划)、持续时间以及创建、更新、删除和未更改的行数。 表现 该标签页显示 7 至 90 天内处理的数据和成功率。
它会在停止时通知你。
每个组织都有 同步问题 从第一天起就设置了警报规则:同步失败时发送应用内通知和电子邮件,同步恢复后再发送一封邮件。每次事件只发送一条消息,不会每次重试都发送一条消息。您可以关闭此功能或在“流”→“警报和报告”中更改渠道。
它会在应该暂停的时候暂停。
如果 Baserow 停止接受连接,或者数据连接器被删除,自动化流程将暂停并显示原因。重新连接或选择新的数据源,然后点击“恢复”。其他错误会继续执行计划,并在行中显示。
关键列缺失
如果有人重命名或删除 Baserow 中的关键列,则完全同步会在写入任何内容之前停止并显示相关信息。 修复选项请将列恢复到原来的名称,然后再次运行。同步操作不会删除其他列。
这些计划允许什么?
所有套餐(包括免费套餐)都包含自动化功能,且创建的自动化数量没有限制。每个套餐的限制在于每次查询运行返回的行数:
| 计划 | 每次运行的行数 |
|---|---|
| 免费 | 125 |
| 个人核心 | 500 |
| 个人加强版 | 1,000 |
| 核心业务 | 2,500 |
| 商务+ | 5,000 |
| 商业最大 | 10,000 |
| 企业核心 | 25,000 |
| 企业增强版 | 100,000 |
| 企业版 Max | 250,000 |
如果查询返回的结果较多,则运行会继续进行而不是提前终止,自动化流程会告知您哪个计划更合适,或者建议添加筛选条件,例如日期范围。每次成功运行都会占用您的数据域配额,该配额与您的 Excel 和 Sheets 查询使用的配额相同。 请查看定价页面 津贴。
下一步行动不错。
- 添加筛选器 查询条件可以是最近 90 天的数据,这样表的大小和速度就能保持稳定,并且符合你的计划的行数限制。
- 将手写笔记单独列保存。位于查询之外,因此它们在每次同步中都能保留下来。
- 将自动化流程分组 在编辑面板中添加几个元素后,自动化页面会按组进行筛选。
访问网络共享上的文件
代理程序以后台服务的形式打开文件,而不是以用户身份打开,因此打开另一台计算机上的文件需要额外的步骤。具体步骤取决于代理程序运行所在的计算机。
如果测试无法获取份额,请在测试结果中查找以下词语: 无法连接 这意味着代理的计算机没有收到服务器的响应。在 Linux 或 Mac 系统上, 未安装 这意味着还需要挂载共享文件夹,并且该消息包含了适用于您服务器的确切挂载命令。
DuckDB 文件放在共享文件夹里? DuckDB 一次只允许一个写入程序,因此代理程序无法打开其他程序正在写入的文件; \\server\share 测试结果显示它 可供其他程序编写要么就此关闭,要么将连接器指向一个无人写入的文件。每次查询都会通过网络读取文件,因此大文件的响应速度比从本地磁盘读取要慢。
共享测试失败?
每次运行都以与连接测试相同的方式访问文件。如果文件服务器上的某些内容发生更改后(例如,密码已更改),运行开始失败,请打开连接器。 数据代理 并点击 测试连接测试结果以及文件路径下方的行指明了问题所在:
| 留言 | 原因 | 使固定 |
|---|---|---|
| 未找到DuckDB数据库文件: 然后是一个 \\server\share 你明知正确的道路 | 由于没有存储登录信息,代理尝试使用自己的帐户访问共享文件,但无法访问:共享文件拒绝了该帐户的访问,或者服务器没有响应。在第一种情况下,路径下方的行显示: 代理服务帐户访问被拒绝. | 点击 服务标识 在路径下方存储一个可以读取共享的登录信息。如果路径下方的行未显示“访问被拒绝”,请检查代理的计算机是否可以打开该共享。 |
| 共享服务器:访问被拒绝 — 为此服务器添加凭据 | 已存储登录信息,但该帐户没有共享权限,或者同一服务器上的另一个登录帐户正在阻止访问;此行之前的消息说明了具体是哪个帐户。 | 请服务器管理员授予该账户读取权限,或者存储一个拥有该权限的账户。关于登录问题,请参见下方关于每个服务器一个登录名的两行说明。 |
| 共享服务器:凭据被拒绝 - 请检查用户名和密码 | 服务器拒绝了已保存的登录信息:可能是拼写错误、域名错误,或者密码在保存后发生了更改,这也导致以前可以正常运行的程序停止运行。 | 点击路径下方的芯片并再次输入密码;如果是服务器端创建的帐户,请退出。 领域 空白。登录失败后,代理程序会等待一分钟后再尝试登录,以避免账户被锁定;保存更正后的密码后,代理程序会立即尝试登录。 |
| 共享服务器:代理计算机无法访问该服务器 | 代理的计算机没有收到服务器的响应:服务器名称错误、服务器已关闭或防火墙阻止了文件共享。 | 在特工的电脑上,打开相同的文件。 \\server\share 在文件资源管理器中查找路径。如果仍然失败,则说明是网络运营商的网络问题。 |
| 此代理上的另一个连接器已以…身份登录到\\server。 | Windows 一次只允许一台计算机使用一个帐户登录到服务器,而此代理上的另一个连接器使用不同的登录名登录到该服务器。 | 存储与其他连接器相同的登录信息,或者在每个读取该服务器的连接器上更改登录信息。 |
| Windows 已经保存了对 \\server 的登录信息…… | 代理计算机上除了代理本身之外的其他程序已经以不同的帐户登录到该服务器,而代理永远不会关闭它自己没有进行的登录。 | 按照消息的其余部分指示操作:在此连接器上使用同一帐户,或关闭代理计算机上的其他登录帐户。如果消息提示共享内容已可通过该登录帐户读取,请选择 使用服务标识 请在登录框中输入。 |
| 此代理版本无法使用已存储的凭据登录到 \\server。 | 该代理程序版本较旧,无法使用已保存的登录信息。 | 更新代理,然后再次测试。 |
| 此 Linux 代理上未挂载 \\server\share。 (或) macOS 代理) | 代理程序运行在 Linux 或 Mac 系统上,但尚未将共享文件夹挂载到其计算机上;门户中存储的登录信息不会在该代理程序中使用。 | 使用消息中提供的命令挂载它,然后再次测试。步骤如下: 在 Linux 系统上 · 在 Mac 上. |
| ……可供其他程序编写 | DuckDB 一次只允许一个写入者,另一个程序则打开该文件进行写入。 | 关闭该程序中的文件,或者将连接器指向一个无人写入的文件。 |
人们提出的问题
同步操作会覆盖我的团队在 Baserow 中添加的笔记吗?
如果备注位于单独的列中,则不会出现这种情况。仅存在于 Baserow 中而不存在于您的查询中的列永远不会被修改,因此请在已同步的列旁边添加“备注”或“所有者”列,并在其中输入内容。标记的列 同步 每次运行时都会恢复到 DuckDB 的值; 保存 当数据行首次到达时,列会被填充,之后不再进行比较。
我的 DuckDB 数据会被查询流存储吗?
不。代理程序会在您这边运行查询,并通过加密链接将数据行直接发送到 Baserow。查询流保存的是配置、计划和每次运行的行数,而不是数据行本身。
我的电脑需要一直开着吗?
运行代理程序的计算机负责执行查询并将数据写入 Baserow。您自己的笔记本电脑和浏览器可以关闭。如果在查询到期时计算机处于关机状态,则错过的查询会在代理程序重新启动后不久执行一次。
我可以稍后修改查询吗?
是的。在查询构建器中编辑并保存,下次运行时会自动使用新版本。如果添加或删除列,请打开自动化的编辑面板进行映射。
两个自动化脚本可以写入同一张表吗?
不,每个表只能有一个自动化脚本。第二个自动化脚本可以指向不同的表,或者扩展第一个脚本背后的查询范围。
免费套餐真的包含这些吗?
是的。“免费”套餐是永久有效的,不是会过期的试用版。每个套餐都包含自动化功能;不同套餐的区别在于每次查询可以返回的行数。请查看“免费”套餐的具体内容。 定价页面.
相关指南
每份指南 DuckDB
这不是你想要的配置?
- 如果您的文件夹里是 Parquet 文件而不是 DuckDB 数据库文件,Parquet 文件夹会将它们全部读取为一个表 → Parquet Folder
设置有问题吗?
- 代理提示文件或文件夹不存在,或访问被拒绝?映射驱动器、网络共享、OneDrive 和 Linux 用户主文件夹都需要修复 → 代理程序可以从哪里读取文件
- 代理显示离线,或者“测试连接”和“浏览”按钮呈灰色?请检查代理是否在线 → 经纪人在线吗?

