向量数据库快速入门

快速部署

详见容器镜像安装。

创建向量表

DataVec新增多种向量数据类型（vector、bitvector、sparsevector等），向量表的创建与openGauss原生语法保持一致，创建时指定存储向量类型即可。

1. CREATE TABLE [TABLE_NAME]
2. (
3. COL1 DATATYPE,
4. ...,
5. COLN VECTORTYPE,
6. );

示例1：创建一个带有3维向量的表。

1. openGauss=# CREATE TABLE items (val vector(3));

数据插入

向量的数据插入与openGauss原生语法保持一致，使用INSERT或者COPY插入，指定数据类型即可。

1. INSERT INTO [TABLE_NAME] VALUES
2. (
3. DATA1,
4. ...,
5. [0.1, 0.3, 0.6, ...]
6. );

示例2：向量数据的插入。

1. openGauss=# INSERT INTO items (val) VALUES ('[1,2,3]'), ('[4,5,6]');

向量索引创建

DataVec目前支持了IVFFLAT、HNSW、IVFPQ及HNSWPQ等算法的向量索引，基于openGauss中的ASTORE存储实现，通过索引结构能够高效地检索出查询结果。

1. CREATE INDEX [INDEX_NAME]
2. ON [TABLE_NAME]
3. USING [ivfflat|hnsw|...]
4. WITH (
5. lists=<LISTS>,|
6. m=<M>,
7. ef_construction=<EF_CONSTRUCTION>,
8. ...
9. );

示例3：索引创建。

1. openGauss=# CREATE INDEX ON items USING ivfflat (val vector_l2_ops) WITH (lists = 100);
2. openGauss=# CREATE INDEX ON items USING hnsw (val vector_cosine_ops) WITH (m = 16, ef_construction=200);

向量检索

通过ANN索引，DataVec可以进行高效的近似搜索；此外还可以进行非索引的精确检索。

1. SELECT COL1, COLN
2. FROM [TABLE_NAME]
3. ORDER BY COLN [VECTOR_OPERATER]  '[0.1, 0.3, 0.7, ...]'
4. LIMIT <TOPK>;

示例4：计算最近邻。

1. openGauss=# SELECT * FROM items ORDER BY val <-> '[3,1,2]' LIMIT 5;
2. openGauss=# SELECT * FROM items ORDER BY val <#> '[3,1,2]' LIMIT 5;
3. openGauss=# SELECT * FROM items ORDER BY val <=> '[3,1,2]' LIMIT 5;

快速入门指南 - 图1 说明： 如果使用当前索引中不存在的距离计算操作符来进行扫描，即使关闭顺序扫描后仍会执行顺序扫描。

如果表中向量存在空值或者距离计算结果为NAN，查询结果会将其自动过滤。

目前向量索引查询语法仅支持order by <字段> <操作符> <查询向量>子句，order by子句增加desc、非order by子句等均不支持走向量索引。

更多使用细节请参考：