SuperAPI AI 工具集

tanstack-db-playbook-tanstack-db-live-queries

前端与建站

查看项目

更新于 10-16 00:02

技能介绍

用途:该技能总结 TanStack DB 实时查询的常见模式,适合在 React 前端中做过滤、联表、聚合、排序与响应式数据绑定。实时查询基于 differential dataflow,数据变化时增量更新而非重跑,资料称在 10 万条以上集合上仍可达亚毫秒级性能。

主要能力:通过 useLiveQuery 声明查询,支持 where 过滤(eq、gt、and、or、inArray、like 等表达式函数)、select 转换与字符串函数(concat、upper、lower、length)、跨集合 join(left/inner/right/full 及 leftJoin、innerJoin 便捷方法)、groupBy 聚合(count、sum、avg、min、max)配合 having 与 orderBy、limit/offset 分页、findOne 取单条、条件查询(返回 undefined 可禁用查询)、子查询与依赖数组重跑。另提供 useLiveSuspenseQuery 以配合 React Suspense,其 data 始终有定义。

使用方式:从 @tanstack/react-db 导入 useLiveQuery,从 @tanstack/db 导入表达式函数,按 from/where/select/join/groupBy/orderBy/limit 链式书写,并可用依赖数组控制重跑;Suspense 场景使用 useLiveSuspenseQuery 并包在 Suspense 中。

适用场景与限制:适用于需要前端实时反映集合变化的列表、看板、聚合统计等界面。资料中的详细参考文件包括 query-builder、joins、aggregations、subqueries、functional-variants、performance,但未提供安装命令、版本要求、收费与平台支持等信息。