Blog | dbVisitor - Java 数据库开发工具

Milvus JDBC 入门：向量写入与检索

2026年09月18日 · 阅读需 5 分钟

如果项目已经使用 Java 和 JDBC，接入 Milvus 后，能不能继续用 PreparedStatement 传参数、用 ResultSet 读取结果？

jdbc-milvus 提供了这样的入口。比如，下面的命令是在文章类别中查找与给定向量最接近的两条记录：

SELECT id, title, score FROM blog_jdbc_articles
WHERE category = ?
ORDER BY embedding <-> ? LIMIT 2;

第一个参数是类别，第二个参数是向量。你仍然需要理解向量检索，但不用为这次查询重新组织一套 Java 调用方式。

JSON 字段映射：存取 Java 对象与 Map

ZhaoYongChun

2026年09月17日 · 阅读需 4 分钟

主题颜色、通知渠道等用户偏好，通常一起读取、一起修改。如果每次都手工把对象序列化成 JSON，再在查询后反序列化，这段转换逻辑很容易散落在多个 DAO 中。

dbVisitor 可以把这项约定写到类型上：一个 Java 对象，对应数据库里的一个字段值。

一个 Mapper 中组合构造器、注解与 XML

ZhaoYongChun

2026年09月17日 · 阅读需 4 分钟

选择数据访问方式时，并不一定要在“全部写 Lambda”和“全部写 XML”之间做决定。

以订单模块为例：带条件的列表适合构造器；按 ID 查询只有一行 SQL；统计报表需要更明确地维护语句。dbVisitor 允许这三种写法放在同一个 Mapper 接口里。

Mapper 实战：Redis 商品缓存读写

ZhaoYongChun

2026年09月17日 · 阅读需 4 分钟

Redis 没有关系型表，怎么会和 Mapper 放在一起？关键不是把 Redis 变成 SQL 数据库，而是复用 Java 接口、参数绑定和结果映射。

例如，一个商品缓存接口可以只有三个业务方法：save、load、evict。方法背后执行的仍是 Redis 的 SET、GET 和 DEL。

Milvus 实体映射与 DAO 封装

ZhaoYongChun

2026年09月16日 · 阅读需 4 分钟

第一次向量查询跑通后，业务代码通常还需要一个稳定的入口：新增文章、按类别检索、修改标题。每个调用方都去处理 ResultSet，并不是唯一选择。

这一篇在 jdbc-milvus 之上使用 dbVisitor，把集合映射为实体，再把操作收进一个 Mapper 接口。调用方只需要知道业务方法，不必重复处理列名和结果转换。

Milvus 混合检索：组合关键词与向量查询

ZhaoYongChun

2026年09月12日 · 阅读需 4 分钟

查技术文章时，有人输入概念描述，也有人输入准确的产品名。向量检索可以利用 embedding 表达的接近程度，关键词检索则保留词项匹配这条线索。

如果两条线索都需要，应该怎样组织查询？jdbc-milvus 提供 ORDER BY HYBRID，把多路检索和重排表达在一条命令里。

Milvus 数据入库：三种写入方式与选择

ZhaoYongChun

2026年09月08日 · 阅读需 4 分钟

几条在线数据、持续到达的一批记录、已经准备好的大型文件，并不适合一律逐条 INSERT。

jdbc-milvus 提供三种不同的入口。选择的依据首先是数据在哪里、怎样产生，其次才是调整单次发送多少条。

用 SQL 操作 Milvus：从检索到 ORM

ZhaoYongChun

2026年09月02日 · 阅读需 8 分钟

Java 应用通常通过 Milvus SDK 写入数据和检索向量。对关系型数据库开发者来说，SQL 和 JDBC 更熟悉。jdbc-milvus 让这套使用方式也能用于 Milvus：

SELECT id, title, score FROM intro_articles -- score 为 L2 平方距离，越小越接近
WHERE category = 'java'                    -- 只在 Java 类别内检索
ORDER BY embedding <-> [1,0] LIMIT 2;       -- 按向量距离取最近的两条

加入 dbVisitor，还可以用实体映射和查询构造器完成同样的检索：

@Table("intro_articles")
public class Article {
    @Column(primary = true)
    private Long id;
    private String title;
    private String category;
    private List<Float> embedding;
    // 省略标准 getter、setter
}

LambdaTemplate lambda = new LambdaTemplate(conn);
List<Article> articles = lambda.query(Article.class)
        .eq(Article::getCategory, "java")
        .orderByL2(Article::getEmbedding, List.of(1F, 0F))
        .initPage(2, 0)
        .queryForList();