athenadb

？

无服务器，分布式矢量数据库作为API，由Cloudflare工人，工人AI，D1和Vectorize编写。

Athenadb是一个简单，无服务器的分布式矢量数据库，可以用作API。它用Cloudflare工人AI，D1，矢量化编写。

特征

• 简单的API端点：Athenadb为各种数据库操作提供了直接的端点，使所有技能级别的开发人员都可以使用。
• 分布式性质：随着多个数据中心的数据复制，Athenadb确保了高可用性和弹性。
• 内置数据复制：由于Cloudflare工人的基础体系结构，数据将自动复制。
• 可伸缩性：Athenadb旨在处理大量矢量文本数据，使其适用于具有较高数据量的项目。
• 无服务器体系结构：由于雅典娜无服务器，您不必担心管理基础架构，因此可以更多地关注开发。

入门

• 下载并安装牧马人。
• 用wrangler login登录牧马人。 Athenadb需要每月5美元的工人来订阅职能。
• 运行以下命令：

git clone https://github.com/TimeSurgeLabs/athenadb.git
cd athenadb
npm run create-vector
npm run create-db

复制输出数据库ID并将其粘贴到database_id下的wrangler.toml中。然后，运行以下两个命令：

npm run init-db
npm run deploy

您应该使用API​​ URL获得输出。您现在可以使用API​​端点。

API端点

POST /:namespace/insert

将文本数据插入数据库。文本使用CloudFlare AI转换为嵌入式，并与唯一的标识符一起存储。

• 请求主体：
  • input ：一个字符串（最大1024个字符）。
  • inputs ：一系列字符串（每个最大1024个字符）。

POST /:namespace/query

查询数据库中的类似文本嵌入。指定URL中的?limit=number以指定要返回的结果数。默认值为5，最大值为20。

• 请求主体：
  • input ：一个用于查询的字符串。 （最大1024个字符）
  • inputs ：批次查询的一系列字符串。 （每个最大1024个字符）

GET /:namespace/:uuid

使用其唯一标识符（UUID）从数据库中检索特定条目。添加查询参数?vector=true以与条目一起检索矢量。添加查询参数?db_id=true以便与条目一起检索SQL表ID。

GET /:namespace?limit=10&offset=0

从给定的名称空间中检索所有条目。限制最多可以设置为100个条目。添加查询参数?vector=true以与条目一起检索向量。添加查询参数?db_id=true以与条目一起检索SQL表ID。

DELETE /:namespace/:uuid

使用其唯一标识符（UUID）从数据库中删除特定条目。警告：此操作是不可逆转的。

DELETE /:namespace

从给定的名称空间中删除所有条目。警告：此操作是不可逆转的。

POST /embeddings

生成给定文本的嵌入，而无需将其存储在数据库中。

• 请求主体：
  • text ：要生成嵌入的字符串。

GET /

返回“ Hello World！”的测试端点作为回应。

用法示例

插入文字

 fetch ( 'https://athenadb.yourusername.workers.dev/your-namespace/insert' , {
  method : 'POST' ,
  headers : { 'Content-Type' : 'application/json' } ,
  body : JSON . stringify ( { input : 'Your text here' } )
} )

查询数据库

 fetch ( 'https://athenadb.yourusername.workers.dev/your-namespace/query' , {
  method : 'POST' ,
  headers : { 'Content-Type' : 'application/json' } ,
  body : JSON . stringify ( { input : 'Query text' } )
} )

检索条目

 fetch ( 'https://athenadb.yourusername.workers.dev/your-namespace/your-uuid' , {
  method : 'GET'
} )

删除条目

 fetch ( 'https://athenadb.yourusername.workers.dev/your-namespace/your-uuid' , {
  method : 'DELETE'
} )

生成嵌入

 fetch ( 'https://athenadb.yourusername.workers.dev/embeddings' , {
  method : 'POST' ,
  headers : { 'Content-Type' : 'application/json' } ,
  body : JSON . stringify ( { text : 'Your text here' } )
} ) 

客户

• Python客户端