Skip to content

Release v0.2.1

Choose a tag to compare

@lnfjpt lnfjpt released this 30 Sep 09:03

NeuG v0.2.1 Release Notes

*Released: 2026-09-30

Highlights

  • Native Windows wheels, x86_64 and ARM64: pip install neug now works on Windows (Python 3.8–3.13 on x86_64; 3.11+ on ARM64), built and tested on Windows CI with a dedicated wheel release pipeline
  • Named path aliases: bind and reuse named paths (p) across single-hop, variable-length, and multi-segment patterns, with path functions (nodes(p), rels(p), properties(...)) and path predicates (IS_TRAIL, IS_ACYCLIC)
  • Full-text search enhancements: stopword support and nested tokenizer wrappers for FTS indexes
  • Dynamic parameters: LIMIT/SKIP and text predicates now accept query parameters
  • COPY FROM in explicit write transactions: bulk loads can be grouped with ordinary DML and committed atomically
  • Systematic NULL semantics fixes across predicates, functions, and ordering

New Features

  • Named path aliases with IS_TRAIL / IS_ACYCLIC path semantics functions (#1005)
  • Dynamic LIMIT and SKIP parameters (#1045); dynamic parameters in text predicates (#1011)
  • COPY FROM inside explicit read-write transactions (#1053)
  • Compact default values for vector arrays (#1004)
  • Carquet (Parquet) reads through the IO interfaces (#1047) and complete writer via QueryExportWriter (#1048)
  • HNSW top-k support for correlated graph patterns (#1052); index rows are filtered before top-k ranking (#1111)

Performance Improvements

  • Skip redundant dirty checks for runtime checkpoint files (#1114)
  • Stream CSV COPY FROM directly into storage (#1070, #1002)

Bug Fixes

Query semantics

  • Three-valued logic with strict boolean predicates (#1021); NULL handling in CASE expressions (#1036), string functions (#1035), list membership (#1034), DISTINCT (#1040), and ORDER BY / DURATION comparison (#1032)
  • Namespace predicates in variable-length paths (#1097)
  • Comments are ignored when analyzing query access mode (#1084)

Storage & transactions

  • Service query concurrency limit is now honored (#1119)
  • CSR batch deletion is idempotent (#1072); local WAL files are created lazily (#1092)
  • Null vertices preserved in column unions (#1075); input offsets preserved when triangle candidates are empty (#1078)

IO & extensions

  • Complete file predicates enforced within readers (#1023); output stream finalization semantics enforced (#1012)
  • httpfs is registered in SHOW_LOADED_EXTENSIONS (#1095)
  • batch_size is unambiguously byte-based; new unified batch_rows option for row counts (#1091)
  • VARCHAR maximum length validated (#1013)

Documentation & Internal

  • Restructured transaction & checkpoint docs for user-first reading (#1050); improved C++ API reference (#1025); NULL handling in UNWIND docs (#1038)
  • Removed the compiler transaction compatibility layer (#1082) and unused compiler Arrow code (#1067)
  • Bumped jackson-databind to 2.18.9 in the Java driver (#1031) and pypa/gh-action-pypi-publish to 1.13.0 (#1064)

NeuG v0.2.1 发布说明

发布日期:2026-09-30(自 v0.2.0,2026-09-02 以来)

亮点

  • Windows 原生 wheel,覆盖 x86_64 与 ARM64:pip install neug 现已支持 Windows(x86_64 需 Python 3.8–3.13;ARM64 需 3.11+),由 Windows CI 构建测试并配备独立的 wheel 发布流水线
  • 命名路径别名:命名路径(p)可在单跳、变长、多段模式间绑定与复用,支持路径函数(nodes(p)、rels(p)、properties(...))与路径谓词(IS_TRAIL、IS_ACYCLIC)
  • 全文检索增强:FTS 索引支持停用词(stopwords)与嵌套分词器包装
  • 动态参数:LIMIT/SKIP 与文本谓词现已接受查询参数
  • 显式写事务支持 COPY FROM:批量加载可与普通 DML 分组并原子提交
  • NULL 语义系统性修复:覆盖谓词、函数与排序

新功能

  • 命名路径别名,含 IS_TRAIL / IS_ACYCLIC 路径语义函数(#1005)
  • FTS 索引停用词支持(#1096)与嵌套分词器包装(#1103)
  • 显式读写事务内执行 COPY FROM(#1053)
  • 向量数组的紧凑默认值(#1004)
  • Carquet(Parquet)通过现有 IO 接口读取(#1047),并经 QueryExportWriter 实现完整写入(#1048)
  • HNSW top-k 支持关联图模式(#1052);索引行先过滤再参与 top-k 排序(#1111)

性能改进

  • 运行时 checkpoint 文件跳过冗余脏检查(#1114)
  • CSV COPY FROM 以流式方式直接写入存储(#1070、#1002)

缺陷修复

查询语义

  • 严格布尔谓词的三值逻辑(#1021);CASE 表达式(#1036)、字符串函数(#1035)、列表成员判断(#1034)、DISTINCT(#1040)、ORDER BY 与 DURATION 比较(#1032)中的 NULL 处理
  • 变长路径中的命名空间谓词(#1097)
  • 查询访问模式分析时忽略注释(#1084)

存储与事务

  • 服务查询并发上限现被正确遵守(#1119)
  • CSR 批量删除具备幂等性(#1072);本地 WAL 文件延迟创建(#1092)
  • 列并集保留空顶点(#1075);三角形候选为空时保留输入偏移(#1078)

IO 与扩展

  • 读取器内强制完整文件谓词(#1023);输出流终结语义强制执行(#1012)
  • batch_size 明确为字节语义;新增统一的 batch_rows 行数选项(#1091)
  • VARCHAR 最大长度校验(#1013)

文档与内部改进

  • 面向用户重排事务与 checkpoint 文档(#1050);改进 C++ API 参考(#1025);UNWIND 文档补充 NULL 处理(#1038)
  • 移除编译器事务兼容层(#1082)与未使用的编译器 Arrow 代码(#1067)
  • Java driver 中 jackson-databind 升级至 2.18.9(#1031);pypa/gh-action-pypi-publish 升级至 1.13.0(#1064)