数据可视化【免费下载链接】vegaA visualization grammar.项目地址https://gitcode.com/gh_mirrors/ve/vega点击查看免费下载project是 Vega 数据流中的关系代数投影变换relational projection它从源数据对象中选取一个或多个字段生成一条新的派生数据对象流并支持对复制字段进行重命名。本指南以 project 官方文档 为主线结合 vega-transforms 源码 与其 测试用例系统讲解该变换的参数语义、典型用法与底层实现原理帮助你在实际图表规范中精准裁剪与整形数据。一、什么是 Project Transformprojecttransform 对应关系代数中的“投影”projection操作。在 Vega 的数据流模型中每个 transform 接收上游数据流pulse经过处理后输出新的数据流。project 的作用是从源数据对象中复制指定字段生成一组全新的派生数据对象从而精简数据对象只保留下游如编码、聚合、其他 transform真正需要的字段通过as参数对字段进行重命名统一后续表达式或编码对字段的引用借助点号.路径语法展开嵌套对象把深层子字段提升为顶层字段。一个需要特别强调的区别是project 与 cartographic projection地图投影完全是两回事。前者是关系代数的列裁剪与重命名操作作用于数据对象流后者用于将经纬度坐标映射到平面 (x, y) 坐标相关变换有geopath、geopoint、geoshape等详见 projections 文档。实际开发中不要因名称相似而混淆。二、在数据流中的位置project 属于“基础变换”Basic Transform典型用法是写在数据定义的transform数组内。所有 transforms 都要求一个type属性来指定变换名称参见 transforms 总览。一个完整的数据定义如下{ data: [ { name: table, url: data/movies.json, transform: [ { type: project, fields: [title, release_date], as: [title, date] }, { type: filter, expr: datum.date 2000 } ] } ] }由于 project 既不会过滤数据也不会生成新的数据对象数量1 进 1 出它同样可以放在 mark 定义 的transform数组中作为post-encoding transform使用此时作用于该 mark 的编码数据流。这一点在 transforms 总览 中有明确说明。三、变换参数详解project transform 共支持两个参数均定义在 Project.js 的 Definition 中属性类型说明fieldsField[]需要复制到投影结果中的源数据字段。如果省略则复制全部字段且保持原有字段名不变。asString[]与fields数组逐元素对应的输出字段名用于为派生数据对象重命名。对应的源码参数声明为params: [ { name: fields, type: field, array: true }, { name: as, type: string, null: true, array: true } ]几点重要语义fields数组中的每个元素是“字段访问器”field accessor支持点号路径访问嵌套字段如foo.a。as数组可以部分指定。当as中某个位置没有给出名字时该字段沿用其在fields中的名称。这一点在 util.js 的 fieldNames 函数 中实现export function fieldNames(fields, as) { if (!fields) return null; return fields.map((f, i) as[i] || accessorName(f)); }即“要么用别名要么用访问器解析出的原字段名”。测试用例Project aliases tuples正是验证了这一行为fields: [id, foo]、as: [key]时id被命名为key而foo仍保留原名。四、基础用法4.1 选取部分字段{type: project, fields: [foo, bar]}该配置生成一条仅包含foo和bar两个字段的派生数据对象流其余字段被丢弃。4.2 全部字段原样保留不指定fields时所有字段都会被复制并使用原有名称即相当于数据的“透传”/拷贝。这在需要保留完整数据但又想脱离原对象引用关系的场景中很有用。五、字段重命名通过as可以为投影字段指定新的输出名称便于下游统一字段引用{type: project, fields: [foo, bar], as: [a, b]}该配置生成的对象中a保存源字段foo的值b保存源字段bar的值即完成了一次字段级“列改名”。在数据源字段名冗长、或不同数据源需要统一字段命名时非常实用。六、嵌套属性展开Un-nestingproject 最有价值的能力之一是展开嵌套属性。Vega 的字段访问器天然支持点号路径因此可以直接把嵌套对象中的子字段投影为顶层字段。考虑如下输入数据[ {foo: {a: 5, b: abc}, bar: 0}, {foo: {a: 6, b: def}, bar: 1}, {foo: {a: 7, b: ghi}, bar: 2} ]要提取bar字段以及foo对象中的a、b子字段并生成扁平的新对象使用如下 transform{ type: project, fields: [bar, foo.a, foo.b], as: [bar, a, b] }输出结果[ {bar:0, a:5, b:abc}, {bar:1, a:6, b:def}, {bar:2, a:7, b:ghi} ]可以看到深层嵌套的foo.a、foo.b被“摊平”成了顶层字段a、b这使得后续的filter、formula、aggregate乃至编码表达式都能用简洁的datum.a直接访问数据。该行为同样有测试覆盖Project projects tuples with nested properties用例使用field(obj.foo.bar)访问三层嵌套并将结果投影为顶层foo字段见 project-test.js。七、源码级实现原理了解底层实现有助于把握 project 的性能特征与增量更新语义。核心实现位于 packages/vega-transforms/src/Project.js其元数据声明为metadata: {generates: true, changes: true}generates: true该变换会生成新的派生数据对象而不是修改原对象changes: true它会把源数据流映射为新的对象集合。transform方法的关键逻辑如下见 Project.js L30-L65输出流分叉pulse.fork(pulse.NO_SOURCE)创建一个不携带源对象的新 pulse用于承载派生对象派生函数选择若指定了fields则使用project(s, t, fields, as)逐字段拷贝否则使用rederive原样复制全部字段function project(s, t, fields, as) { for (let i0, nfields.length; in; i) { t[as[i]] fieldsi; } return t; }派生对象缓存lut算子内部维护一张tupleid(源对象) - 派生对象的查找表。首轮通过pulse.addAll()灌入全部数据并建立映射增量更新针对脉冲中的三种变更分别处理——REM删除取出 lut 中缓存的派生对象压入out.rem并清空映射槽位ADD新增用ingest({})创建新对象执行派生函数后写入out.add并登记到 lutMOD修改直接在缓存的派生对象上重新执行派生函数derive(t, lut[tupleid(t)])更新后的对象进入out.mod。这一设计意味着只要源字段未变派生对象会被原地复用而非每次重新创建从而保证高频增量更新如交互过滤、信号驱动修改下的效率。测试Project projects tuples完整验证了插入、同时删除与新增、修改、删除四条路径下add/rem/mod三种输出缓冲区的正确性并断言派生对象与源对象不是同一引用t.notEqual(p.add[0], data[0])佐证了“生成新对象”的语义见 project-test.js。八、与其他 Transform 的组合使用project 通常出现在数据管线的前端用于“瘦身 整形”再交给后续变换处理。常见组合模式project filter先裁剪字段再用简洁字段名编写过滤表达式project aggregate投影出聚合所需的维度与度量字段避免不必要的字段参与分组计算project formula先展开嵌套字段再基于新字段计算派生值project stack / bin在布局或分箱前统一字段命名。例如在 transforms 总览 给出的示例中filter后接stack完成堆叠布局若数据含冗余嵌套结构可在最前面插入一个 project 来保证后续表达式书写的简洁与字段引用的稳定。九、小结project执行关系代数投影按fields复制字段、按as重命名可省略fields以全量复制点号路径让project具备嵌套属性展开能力是把深层 JSON 结构“摊平”的首选工具它不修改源对象始终生成新的派生对象并通过内部查找表支持高效的增量更新与地图投影cartographic projection无关使用时注意区分。在编写 Vega 规范时善用 project 能让数据管线更清晰、下游表达式更简洁也为跨数据集的字段统一提供了一条低成本的规范化路径。赞分享数据可视化【免费下载链接】vegaA visualization grammar.项目地址https://gitcode.com/gh_mirrors/ve/vega点击查看免费下载相关推荐MongoDB Join Optimization 之 $project 投影与字段重命名Golden 测试解析与执行计划解读MongoDB Join Optimization 之 $project 投影与字段重命名Golden 测试解析与执行计划解读 导读 本文以 MongoDB数据库文档数据库后端SeaTunnel FieldRename Transform 深度指南字段重命名的五种规则与实战配置SeaTunnel FieldRename Transform 深度指南字段重命名的五种规则与实战配置 FieldRename transform plugi数据集成ETL大数据批处理流处理变更数据捕获Vega Collect Transform 详解数据收集与多字段排序实战指南Vega Collect Transform 详解数据收集与多字段排序实战指南 collect 是 Vega 可视化语法VegaA Visualizati数据可视化创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
