athenadb

? Athenadb⚡️

Database vektor tanpa server yang terdistribusi sebagai API yang ditulis dengan pekerja cloudflare, pekerja AI, D1, dan vektor.

Athenadb adalah basis data vektor sederhana, tanpa server, terdistribusi yang dapat digunakan sebagai API. Ini ditulis dengan CloudFlare Workers AI, D1, Vectorize.

Fitur

• Titik Akhir API Sederhana : Athenadb menyediakan titik akhir langsung untuk berbagai operasi basis data, membuatnya dapat diakses oleh pengembang dari semua tingkat keterampilan.
• Nature Terdistribusi : Dengan replikasi data di beberapa pusat data, Athenadb memastikan ketersediaan dan ketahanan yang tinggi.
• Replikasi data bawaan : Karena arsitektur yang mendasari pekerja CloudFlare, data direplikasi di seluruh pusat data secara otomatis.
• Skalabilitas : Athenadb dirancang untuk menangani sejumlah besar data teks vektor, membuatnya cocok untuk proyek dengan volume data tinggi.
• Arsitektur Tanpa Server : Dengan Athenadb yang tanpa server, Anda tidak perlu khawatir tentang mengelola infrastruktur, memungkinkan untuk lebih fokus pada pengembangan.

Memulai

• Unduh dan instal Wrangler.
• Masuk ke Wrangler dengan wrangler login . Athenadb membutuhkan langganan pekerja $ 5/bulan untuk berfungsi.
• Jalankan perintah berikut:

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

Salin ID database output dan tempel di wrangler.toml di bawah database_id . Kemudian, jalankan dua perintah berikut:

npm run init-db
npm run deploy

Anda harus mendapatkan output dengan URL API Anda. Anda sekarang dapat menggunakan titik akhir API.

Titik akhir API

POST /:namespace/insert

Menyisipkan data teks ke dalam database. Teks diubah menjadi embeddings menggunakan CloudFlare AI dan disimpan bersama dengan pengidentifikasi yang unik.

• Badan Permintaan :
  • input : satu string (maks 1024 karakter).
  • inputs : Array string (masing -masing karakter maks 1024).

POST /:namespace/query

Menanyakan database untuk embeddings teks yang serupa. Tentukan ?limit=number dalam URL untuk menentukan jumlah hasil yang akan dikembalikan. Standarnya adalah 5, maksimum adalah 20.

• Badan Permintaan :
  • input : satu string untuk kueri. (Maks 1024 karakter)
  • inputs : Array string untuk permintaan batch. (masing -masing karakter maks 1024)

GET /:namespace/:uuid

Mengambil entri spesifik dari database menggunakan Identifier Uniknya (UUID). Tambahkan parameter kueri ?vector=true untuk mengambil vektor bersama dengan entri. Tambahkan parameter kueri ?db_id=true untuk mengambil ID tabel SQL bersama dengan entri.

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

Mengambil semua entri dari namespace yang diberikan. Batas dapat diatur ke maksimum 100 entri. Tambahkan parameter kueri ?vector=true untuk mengambil vektor bersama dengan entri. Tambahkan parameter kueri ?db_id=true untuk mengambil ID tabel SQL bersama dengan entri.

DELETE /:namespace/:uuid

Menghapus entri tertentu dari database menggunakan Identifier Uniknya (UUID). Peringatan : Tindakan ini tidak dapat diubah.

DELETE /:namespace

Menghapus semua entri dari namespace yang diberikan. Peringatan : Tindakan ini tidak dapat diubah.

POST /embeddings

Menghasilkan embeddings untuk teks yang diberikan tanpa menyimpannya di database.

• Badan Permintaan :
  • text : Sebuah string yang embeddingnya akan dihasilkan.

GET /

Titik akhir tes yang mengembalikan 'Hello World!' sebagai tanggapan.

Contoh penggunaan

Memasukkan teks

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

Menanyakan database

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

Mengambil entri

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

Menghapus entri

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

Menghasilkan embeddings

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

Klien

• Klien Python