向量数据库数据库人工智能后端【免费下载链接】lancedbDeveloper-friendly OSS embedded retrieval library for multimodal AI. Search More; Manage Less.项目地址https://gitcode.com/gh_mirrors/la/lancedb点击查看免费下载导读在 LanceDB 的 Node.js 客户端中MaterializedViewSelect是创建物化视图Materialized View时用来描述“视图包含哪些列”的类型别名支持裸列名、[别名, SQL 表达式]对以及记录三种等价写法可理解为物化视图版的行投影projection。本文基于 MaterializedViewSelect 类型别名文档结合 materialized_view.ts 的归一化实现与 materialized_view.test.ts 的测试用例完整讲解它的三种形式、底层引用规则identifier quoting、与createMaterializedView其他选项的组合用法以及创建物化视图前必须满足的前置条件。读完你将能熟练写出正确、可复现的物化视图列投影代码。类型定义速览该类型别名在文档中的定义如下type MaterializedViewSelect: (string | [string, string])[] | Recordstring, string;即它接受两种大类写法数组形式(string | [string, string])[]数组中的每个元素要么是一个字符串裸列名要么是一个二元组[别名, SQL 表达式]记录形式Recordstring, string即{ 别名: SQL 表达式 }的对象映射。语义上它描述的是“视图的列”列名、[别名, SQL 表达式]对或同样内容的记录裸名bare name会投影自身projects itself即直接选取源表中同名的列。在源码 materialized_view.ts 中类型定义与文档完全一致并作为createMaterializedView的select选项类型对外导出见 index.ts 的重新导出。三种写法的语义详解写法一裸列名数组直接投影select: [name, age]数组中的每个字符串按字面含义投影自身视图将包含name与age两个与源表同名的列。这是最简单的用法等价于 SQL 的SELECT name, age FROM ...。写法二[别名, SQL 表达式]对计算列select: [ name, [shout, upper(name)], ]二元组的第一个元素是输出列的别名第二个元素是SQL 表达式。上例会在视图中生成一个名为shout的列其值由表达式upper(name)计算得到。这与测试用例 materialized_view.test.ts 中的用法完全一致const view await db.createMaterializedView(adults, people, { select: [name, [shout, upper(name)]], where: age 18, }); // 查询视图shout 列即为 name 的大写形式 const rows await view.table().query().toArray(); expect(rows.map((r) r.shout).sort()).toEqual([ADA, GRACE]);写法三记录形式等价的对象映射select: { name: name, shout: upper(name), }记录形式的键是别名、值是 SQL 表达式与写法二的[别名, 表达式]对在语义上完全等价。从实现看normalizeSelect 对记录形式直接调用Object.entries(select)转换为[alias, expression]对因此你可以根据代码风格任选其一。底层归一化引用规则与表达式保持原样理解三种写法行为差异的关键在于normalizeSelect函数的实现materialized_view.tsexport function normalizeSelect( select?: MaterializedViewSelect, ): [string, string][] | undefined { if (select undefined) { return undefined; } if (Array.isArray(select)) { return select.map((item) typeof item string ? [item, quoteIdentifier(item)] : item, ); } return Object.entries(select); }其核心规则有两条可以概括为裸名会被自动加反引号引用当数组元素是纯字符串时normalizeSelect会调用quoteIdentifier将其包装为反引号标识符function quoteIdentifier(name: string): string { return name.replace(//g, ) ; }这意味着任意合法的列名都能工作包括含空格、保留字等无法直接用裸标识符书写的列名。测试 materialized_view.test.ts 验证了这一点——对名为order item的列使用select: [order item]依然可以正确投影await db.createTable(odd_names, [{ order item: widget }], { storageOptions: { newTableEnableStableRowIds: true }, }); const view await db.createMaterializedView(quoted, odd_names, { select: [order item], withNoData: true, }); const result await view.refresh(); expect(Number(result.rowsWritten)).toBe(1);表达式保持原样verbatim成对项[alias, expression]与记录形式的右值会被原样透传不做任何引用处理因为它们的右侧是表达式而非标识符。例如[shout, upper(name)]中的upper(name)会被直接写入底层 SQL而不是被包上反引号。这一设计保证了你可以在表达式里使用函数调用upper(name)、运算符、甚至引用其他列的复杂计算同时裸名列又不会因为特殊字符而失败——引用与表达式两条路径各司其职。在 createMaterializedView 中的完整用法MaterializedViewSelect作为select选项出现在连接层createMaterializedView的签名中connection.tsabstract createMaterializedView( name: string, source: string, options?: { select?: MaterializedViewSelect; where?: string; limit?: number; withNoData?: boolean; }, ): PromiseMaterializedView;一个综合示例把三种投影形式与过滤条件组合起来import { connect } from lancedb/lancedb; const db await connect(data/example-db); // 源表必须开启稳定行 IDstable row ids否则创建物化视图会失败 await db.createTable( people, [ { name: ada, age: 36, city: london }, { name: kid, age: 7, city: paris }, { name: grace, age: 85, city: london }, ], { storageOptions: { newTableEnableStableRowIds: true } }, ); // 数组形式裸列 [别名, 表达式] 对 const view await db.createMaterializedView(adults, people, { select: [name, [shout, upper(name)], [adult_city, city]], where: age 18, }); // 视图本身是一张普通表可以查询 const rows await view.table().query().toArray(); console.log(rows); // [{ name: ada, shout: ADA, adult_city: london }, // { name: grace, shout: GRACE, adult_city: london }] // 记录形式完全等价 const view2 await db.createMaterializedView(adults2, people, { select: { name: name, shout: upper(name) }, where: age 18, });select与其他选项的组合规则whereSQL 过滤谓词与select组合形成SELECT columns FROM source WHERE predicatelimit限制视图行数必须是安全非负整数。连接层在传给 Rust 之前会通过validateNonNegativeIntegermaterialized_view.ts拒绝负数、小数、Infinity、NaN等非法值测试见 materialized_view.test.tswithNoData若为true只创建视图定义和空的后备表不立即填充数据之后再调用view.refresh()填充见同文件的“refreshes incrementally after an append”用例。前置条件源表必须启用稳定行 ID这是使用select创建物化视图时最容易踩的坑。源码注释connection.ts明确指出源表必须拥有稳定行 IDstable row ids——创建表时需传入存储选项newTableEnableStableRowIds: true它们保证视图的溯源provenance在源表压缩compaction后依然有效并且不能在表创建之后再开启。测试 materialized_view.test.ts 验证了未开启时会抛出stable row ids错误。定义存储与刷新select 如何进入视图生命周期select最终会被合并进物化视图的“定义”definition——一段规范拼写的 SQL 查询随表的结构化元数据持久化键为mv.definition见 materialized_view.ts 中的DEFINITION_META_KEY与MaterializedViewDefinition接口。旧版本写入的结构化布局含projections、filter、limit等字段也会被解析回等价的查询文本legacyQuery测试 materialized_view.test.ts 展示了典型还原结果SELECT name, upper(name) AS Shout FROM ns.people WHERE age 18 LIMIT 42从中可以看到裸名name被引用为name表达式upper(name)保持原样并以AS Shout形式携带别名——与前面normalizeSelect的规则一一对应。若遇到更高版本的存储格式客户端会明确拒绝刷新而非猜测见 definitionFromJson。创建完成后MaterializedView句柄提供view.table()把视图当作普通表查询、建索引、搜索view.definition()读回定义查询view.refresh()增量刷新源表变化可对账时或全量重建{ full: true }强制重建{ sourceVersion }可刷新到指定源版本materialized_view.ts。错误排查要点结合测试用例select相关的常见失败场景如下场景表现处理方式表达式引用了不存在的列创建时抛出类似missing的 SQL 解析错误核对表达式中的列名测试见 materialized_view.test.ts列名含空格/特殊字符直接写裸名可能解析失败交给normalizeSelect自动加反引号即可如[order item]源表未开启稳定行 ID创建时抛出stable row ids错误在createTable时传storageOptions: { newTableEnableStableRowIds: true }limit/sourceVersion为负数、小数或Infinity抛出non-negative integer先经validateNonNegativeInteger校验结语MaterializedViewSelect虽然只是一个类型别名却完整定义了 LanceDB 物化视图的列投影能力裸名列自动引用、表达式原样透传、数组与记录两种书写风格自由切换。结合 createMaterializedView 的where/limit/withNoData选项你可以在创建视图时一次性声明“取哪些列、如何计算、过滤哪些行”而视图本身仍是可查询、可建索引的普通表。需要深入源码时可依次阅读 materialized_view.ts、materialized_view.test.ts以及在 Rust 侧 对应的增量刷新对账逻辑。赞分享向量数据库数据库人工智能后端【免费下载链接】lancedbDeveloper-friendly OSS embedded retrieval library for multimodal AI. Search More; Manage Less.项目地址https://gitcode.com/gh_mirrors/la/lancedb点击查看免费下载相关推荐LanceDB Node.js SDK 向量列类型配置指南深入理解 VectorColumnOptionsLanceDB Node.js SDK 向量列类型配置指南深入理解 VectorColumnOptions VectorColumnOptions 是 Lan向量数据库数据库人工智能后端LanceDB Node.js SDK 中的 IntoVector 类型别名向量查询输入的完整指南LanceDB Node.js SDK 中的 IntoVector 类型别名向量查询输入的完整指南 IntoVector 是 LanceDB Node.js向量数据库数据库人工智能后端LanceDB Node.js SDK 的 IntoSql 类型别名类型安全的 SQL 字面量转换机制详解LanceDB Node.js SDK 的 IntoSql 类型别名类型安全的 SQL 字面量转换机制详解 导读 本文围绕 LanceDB Node.js向量数据库数据库人工智能后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考