SQLite-Vec 安装和配置指南

SQLite-Vec 安装和配置指南

sqlite-vec Work-in-progress vector search SQLite extension that runs anywhere. 项目地址: https://gitcode.com/gh_mirrors/sq/sqlite-vec

1. 项目基础介绍和主要编程语言

SQLite-Vec 是一个轻量级的向量搜索 SQLite 扩展，能够在任何运行 SQLite 的环境中使用。该项目的主要编程语言是 C，这意味着它不需要任何外部依赖，可以在各种平台上运行，包括 Linux、MacOS、Windows，甚至在浏览器中通过 WASM 运行。

2. 项目使用的关键技术和框架

SQLite-Vec 使用了以下关键技术和框架：

• SQLite: 一个轻量级的嵌入式数据库，广泛用于各种应用程序中。
• 向量搜索: 通过向量相似度进行数据检索的技术，适用于机器学习和数据分析等领域。
• 虚拟表: SQLite 的虚拟表机制，允许用户在不修改数据库文件的情况下扩展数据库功能。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在开始安装之前，请确保你的系统已经安装了以下工具和环境：

• Git: 用于从 GitHub 克隆项目代码。
• C 编译器: 如 GCC 或 Clang，用于编译 C 代码。
• SQLite: 确保你的系统上已经安装了 SQLite。

详细安装步骤

步骤 1: 克隆项目代码

首先，使用 Git 克隆 SQLite-Vec 项目到你的本地机器：

git clone https://github.com/asg017/sqlite-vec.git
cd sqlite-vec

步骤 2: 编译项目

进入项目目录后，使用 Makefile 编译项目：

make

编译完成后，你会在项目目录中看到生成的 sqlite-vec.so 或 sqlite-vec.dll 文件，具体文件名取决于你的操作系统。

步骤 3: 配置 SQLite

将编译生成的扩展文件复制到 SQLite 的扩展目录中，或者在运行 SQLite 时指定扩展文件的路径。

例如，在 Linux 系统上，你可以将扩展文件复制到 /usr/local/lib 目录：

sudo cp sqlite-vec.so /usr/local/lib/

步骤 4: 加载扩展

启动 SQLite 并加载扩展：

sqlite3
sqlite> .load /usr/local/lib/sqlite-vec.so

步骤 5: 创建虚拟表

在 SQLite 中创建一个虚拟表来存储向量数据：

CREATE VIRTUAL TABLE vec_examples USING vec0(sample_embedding FLOAT[8]);

步骤 6: 插入和查询数据

插入一些示例数据并进行查询：

INSERT INTO vec_examples(rowid, sample_embedding) VALUES (1, '[-0.200, 0.250, 0.341, -0.211, 0.645, 0.935, -0.316, -0.924]');

SELECT rowid, distance FROM vec_examples WHERE sample_embedding MATCH '[0.890, 0.544, 0.825, 0.961, 0.358, 0.0196, 0.521, 0.175]' ORDER BY distance LIMIT 2;

通过以上步骤，你已经成功安装并配置了 SQLite-Vec 扩展，并可以在 SQLite 中进行向量搜索操作。

sqlite-vec Work-in-progress vector search SQLite extension that runs anywhere. 项目地址: https://gitcode.com/gh_mirrors/sq/sqlite-vec