athenadb

? Athenadb⚡️

Base de données vectorielle sans serveur et distribuée en tant qu'API écrite avec des travailleurs CloudFlare, des travailleurs AI, D1 et Vectorize.

Athenadb est une base de données vectorielle simple, sans serveur et distribuée qui peut être utilisée comme API. Il est écrit avec CloudFlare Workers AI, D1, Vectorize.

Caractéristiques

• Points de terminaison API simples : Athenadb fournit des points de terminaison simples pour diverses opérations de base de données, ce qui le rend accessible aux développeurs de tous niveaux de compétence.
• Nature distribuée : Avec la réplication des données dans plusieurs centres de données, Athenadb assure une grande disponibilité et une résilience.
• Réplication de données intégrée : En raison de l'architecture sous-jacente des travailleurs CloudFlare, les données sont répliquées automatiquement entre les centres de données.
• Évolutivité : Athenadb est conçu pour gérer de grandes quantités de données de texte vectorielles, ce qui le rend adapté aux projets avec des volumes de données élevés.
• Architecture sans serveur : ATHENADB étant sans serveur, vous n'avez pas à vous soucier de la gestion de l'infrastructure, ce qui permet de se concentrer davantage sur le développement.

Commencer

• Téléchargements et installer Wrangler.
• Connectez-vous à Wrangler avec wrangler login . Athenadb nécessite un abonnement des travailleurs de 5 $ / mois pour fonctionner.
• Exécutez les commandes suivantes:

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

Copiez l'ID de base de données de sortie et collez-le dans wrangler.toml sous database_id . Ensuite, exécutez les deux commandes suivantes:

npm run init-db
npm run deploy

Vous devriez obtenir une sortie avec votre URL de l'API. Vous pouvez désormais utiliser les points de terminaison de l'API.

Points de terminaison API

POST /:namespace/insert

Insère des données de texte dans la base de données. Le texte est converti en intégres à l'aide de CloudFlare AI et stocké avec un identifiant unique.

• Corps de demande :
  • input : une seule chaîne (caractères max 1024).
  • inputs : un tableau de chaînes (chaque caractères max 1024).

POST /:namespace/query

Interroge la base de données pour des intérêts de texte similaires. Spécifiez ?limit=number dans l'URL pour spécifier le nombre de résultats à retourner. La valeur par défaut est 5, le maximum est de 20.

• Corps de demande :
  • input : une seule chaîne pour la requête. (MAX 1024 caractères)
  • inputs : un tableau de chaînes pour le requête par lots. (chaque caractères max 1024)

GET /:namespace/:uuid

Récupère une entrée spécifique de la base de données à l'aide de son identifiant unique (UUID). Ajoutez des paramètres de requête ?vector=true pour récupérer le vecteur avec l'entrée. Ajoutez des paramètres de requête ?db_id=true pour récupérer l'ID de table SQL avec l'entrée.

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

Récupère toutes les entrées de l'espace de noms donné. La limite peut être définie sur un maximum de 100 entrées. Ajoutez des paramètres de requête ?vector=true pour récupérer les vecteurs avec les entrées. Ajoutez des paramètres de requête ?db_id=true pour récupérer l'ID de table SQL avec les entrées.

DELETE /:namespace/:uuid

Supprime une entrée spécifique de la base de données à l'aide de son identifiant unique (UUID). Avertissement : cette action est irréversible.

DELETE /:namespace

Supprime toutes les entrées de l'espace de noms donné. Avertissement : cette action est irréversible.

POST /embeddings

Génère des intégres pour un texte donné sans le stocker dans la base de données.

• Corps de demande :
  • text : une chaîne dont l'incorporation doit être générée.

GET /

Un point de terminaison de test qui retourne «Hello World! comme réponse.

Exemples d'utilisation

Insertion de texte

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

Interroger la base de données

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

Récupérer une entrée

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

Suppression d'une entrée

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

Générer des intérêts

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

Clients

• Client python