athenadb

？athenadb⚡️

CloudFlareワーカー、ワーカーAI、D1、およびVectorizeで書かれたAPIとして、サーバーレスの分散ベクトルデータベース。

AthenAdbは、APIとして使用できるシンプルでサーバーレスの分散ベクトルデータベースです。 CloudFlareワーカーAI、D1、Vectorizeで書かれています。

特徴

• シンプルなAPIエンドポイント：AthenAdbは、さまざまなデータベース操作に簡単なエンドポイントを提供し、あらゆるスキルレベルの開発者がアクセスできるようにします。
• 分散の性質：複数のデータセンターにわたってデータレプリケーションを使用すると、AthenAdbは高可用性と回復力を保証します。
• 組み込みのデータレプリケーション：CloudFlare Workersの基礎となるアーキテクチャにより、データは自動的にデータセンター間で複製されます。
• スケーラビリティ：AthenAdbは、大量のベクトルテキストデータを処理するように設計されており、データ量が多いプロジェクトに適しています。
• サーバーレスアーキテクチャ：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に貼り付けます。次に、次の2つのコマンドを実行します。

npm run init-db
npm run deploy

API URLで出力を取得する必要があります。これで、APIエンドポイントを使用できます。

APIエンドポイント

POST /:namespace/insert

テキストデータをデータベースに挿入します。テキストは、CloudFlare AIを使用して埋め込みに変換され、一意の識別子とともに保存されます。

• リクエストボディ：
  • input ：単一の文字列（最大1024文字）。
  • inputs ：文字列の配列（各最大1024文字）。

POST /:namespace/query

同様のテキスト埋め込みのデータベースをクエリします。 specify ?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クライアント