Barrel
EN GitHub

Ce qui fonctionne aujourd’hui, et ce qui ne fonctionne pas encore.

Chaque page de ce site utilise les mêmes trois marques. Cette page liste chaque capacité avec sa marque, d’après le tableau des fonctionnalités du dépôt Barrel.

Les trois marques

Fonctionne aujourd’hui
Utilisable maintenant sans installation supplémentaire, et couvert par les suites de tests. Dans le tableau ci-dessous : Prêt.
Optionnel, à installer
Utilisable maintenant, mais désactivé par défaut ou derrière un profil de build : un backend à activer, une bibliothèque à installer, une clé à fournir. Dans le tableau ci-dessous : Optionnel.
Prévu
Pas encore construit. Décrit pour que vous puissiez en tenir compte, jamais présenté comme fonctionnel. Dans le tableau ci-dessous : Prévu.

Ce que Barrel fait aujourd’hui et ce qui est prévu, par capacité. Lisez cette page pour savoir quelles fonctionnalités sont utilisables maintenant, lesquelles sont optionnelles et lesquelles restent à venir. Chaque ligne renvoie à un guide quand il existe.

Légende des statuts

  • Prêt : utilisable maintenant, avec des tests.
  • Optionnel : utilisable maintenant, désactivé par défaut ou derrière un profil de build.
  • Prévu : pas encore construit.

Modèle de données

Un enregistrement barrel est un identifiant avec trois faces : un document JSON, ses pièces jointes (blobs) et son vecteur. Les documents vivent dans barrel_docdb, les vecteurs dans barrel_vectordb, les blobs sont des pièces jointes de documents. L’API barrel les compose ; chaque application sous-jacente reste utilisable seule.

Capacités

CapacitéStatutNotes
Documents (CRUD, MVCC, requêtes)Prêtbarrel_docdb ; find/2 sur l’index de chemins. Voir embedding.
Lots (put_docs/get_docs/delete_docs, vector_add_batch)PrêtRésultats par élément, dans l’ordre. Une entrée de put_docs peut être {Doc, DocOpts} avec ses propres tags outbox et son propre indicateur sync.
Débit d’écriturePrêtLes écritures concurrentes sur une même base partagent un lot et une synchronisation disque (group commit, max_group) ; les documents sont préparés dans l’appelant et un processus committer écrit chaque groupe (write_chunk). Voir apps/barrel_docdb/docs/benchmarks.md.
Ouvertures en lecture seulePrêtread_only => true sur barrel:open/2, barrel_docdb et barrel_vectordb : RocksDB OpenForReadOnly, aucun fichier créé ni réécrit, plusieurs nœuds peuvent servir un même répertoire. Les écritures répondent {error, read_only}.
Pièces jointes (blobs)PrêtPièces jointes de documents ; backend interchangeable par base via barrel_att_backend (RocksDB BlobDB par défaut, none pour les bases sans pièces jointes). Lecture et écriture en streaming.
Backend de pièces jointes S3Optionnelbarrel_att_s3 (rebar3 as s3) : pièces jointes dans un stockage compatible S3, avec réplication et GC des envois multipart.
Recherche vectoriellePrêtbarrel_vectordb ; HNSW par défaut.
Mode enregistrement (indexation vectorielle pilotée par une politique)PrêtLes documents sont vectorisés automatiquement selon la politique ; en asynchrone (rattrapé) ou en synchrone (lecture de sa propre écriture) ; vecteurs explicites via une option de put. Voir record-mode.
Recherche par mots-clés BM25OptionnelÀ activer avec bm25_backend => memory (ou disk) à l’ouverture ; disk par défaut en mode enregistrement. L’index disque survit à la fermeture et à l’arrêt brutal ; l’index mémoire est reconstruit à l’ouverture à partir du texte stocké.
Recherche de sous-chaînes et d’expressions régulières par trigrammesOptionnelbarrel_ngram : un index sur les documents barrel_docdb avec des segments vérifiés par somme de contrôle (verify_segments) ; exposé comme outil MCP ngram_search.
Recherche hybride (vecteur + BM25)OptionnelNécessite BM25 activé ; les résultats portent texte et métadonnées. Les requêtes textuelles nécessitent un embedder (ou query_vector).
EmbeddingsOptionnelbarrel_embed (Python local, Ollama, OpenAI, ...). La vectorisation automatique et l’hybride textuel en ont besoin. barrel:embedder_info/1 donne l’identité du modèle et une fingerprint : deux bases avec la même empreinte produisent des scores vectoriels comparables. Voir record-mode.
RerankingOptionnelbarrel_rerank (cross-encoder).
Backend d’index FAISSOptionnelbarrel_faiss ; nécessite la bibliothèque C++ FAISS, exclu du build par défaut (rebar3 as faiss).
Flux de changementsPrêtchanges/2, subscribe/2 ; curseur HLC via hlc_encode/1.
Requêtes BQLPrêtDialecte PartiQL sur les documents, les vecteurs et BM25 ; requêtes SUBSCRIBE en direct. Les résultats portent la version observée (instance_id, last_seq) ; la route REST de requête accepte max_rows et deadline_ms et renvoie bound. Voir query-bql.
ContextesPrêtJeux de données nommés sur ce nœud ou sur d’autres nœuds barrel_server, interrogés ensemble par une seule instruction BQL ; statut, version et couverture par source ; ensembles de travail avec tranches enregistrées et snapshots importés qui répondent hors ligne. Erlang (barrel_ctx), REST (/contexts, /worksets) et MCP (outils context_*). Voir contexts.
Export et import en lecture seulePrêtbarrel_ctx_export : une copie d’une base avec somme de contrôle, importée et vérifiée ailleurs et servie en lecture seule. Voir contexts.
Cycle de vie des basesPrêtbarrel_dbs : fermeture après inactivité, éviction LRU, épinglage, baux comptés, détentions exclusives, ouvertures must_exist.
Synchronisation / réplicationPrêtDans la même VM et sur HTTP (/db/:db/_sync/*) ; documents, pièces jointes, canaux, tâches continues. Authentification bearer, requêtes signées Ed25519 et mTLS (optionnelles ; bearer par défaut). Les vecteurs sont reconstruits localement. Voir synchronization.
Timeline (branche, PITR, fusion)PrêtForks en O(1), retour à un instant donné, fusion en retour sous forme de synchronisation. Voir timeline.
Audit et provenancePrêtJournal d’historique conservé ; acteur/session/source sur les écritures ; corps passés par version. Voir audit-provenance.
TTL des documentsPrêtOption d’écriture expires_at, expiration paresseuse, balayage optionnel (ttl_sweep_interval).
Chiffrement au reposOptionnelClés par base via barrel_keyprovider ; EncryptedEnv plus un chiffrement par secteur pour les fichiers plats. Voir encryption.
Serveur REST/JSONOptionnelbarrel_server sur livery, rebar3 as server ; sert HTTP/1.1 (par défaut) plus HTTP/2 et HTTP/3 sur TLS en option. Voir rest-server.
Couche agents (espaces, capacités, sessions, passations)Prêtbarrel_spaces ; porteurs de capacités sur REST et MCP. Voir spaces.
Point d’accès MCP (outils, ressources, requêtes en direct)Optionnel/mcp dans barrel_server, activé par défaut dans celui-ci. Voir mcp.
Client navigateur (barrel-lite)PrêtClient TypeScript offline-first (clients/barrel-lite) : stockage OPFS, écritures horodatées HLC, synchronisation sur le réseau (polling ou SSE continu), multi-onglets, synchronisation des pièces jointes, un sous-ensemble BQL local identique au serveur, et recherche vectorielle (récupération des embeddings + top-k cosinus en force brute sur l’ensemble synchronisé, avec délégation au /search du serveur ; pas d’ANN dans le navigateur). Voir barrel-lite.
CORS + jetons de capacité sur /dbPrêtMiddleware CORS et porteurs bsp_ limités aux routes /db de leur espace, pour que les navigateurs puissent synchroniser. Voir rest-server.
gRPC, WebTransport, socket unix, OpenAPIPrévuTransports à venir sur barrel_server.
API SQL, agentfsPrévuPlus tard.

Où les choses s’exécutent

  • Embarqué : dépendez de barrel (aucun transport n’est tiré). Voir embedding.
  • Serveur : lancez barrel_server pour HTTP. Voir rest-server.

Traduit de docs/features.md. Les corrections se font dans le dépôt.

Haut et bas pour se déplacerEntrée pour ouvrir