SurrealDB est une base de données écrite en Rust qui sert des documents, des graphes, des tables relationnelles et des paires clé-valeur depuis un seul moteur, et un client peut s'y connecter directement depuis le navigateur via WebSocket. Le moteur est livré sous Business Source License 1.1, une licence qui n'est pas ouverte, et chaque décision de déploiement commence là.
Ce que SurrealDB fait et ne fait pas
Le moteur expose un seul langage de requête, SurrealQL, et un seul ensemble d'instructions de schéma : DEFINE TABLE, DEFINE FIELD, DEFINE INDEX, DEFINE ACCESS, DEFINE USER, DEFINE SEQUENCE. Les enregistrements portent des identifiants construits à partir d'un nom de table et d'une clé, les liens entre eux s'écrivent avec RELATE, et les abonnements aux changements viennent de LIVE SELECT. L'authentification se trouve dans le même processus, donc il n'y a pas de couche d'autorisation séparée à écrire.
Tu exécutes la base comme un serveur ou tu l'embarques dans une application Rust. Le stockage se choisit avec des fonctionnalités de compilation : dans le crate surrealdb en version 3.2.4, ce sont kv-mem, kv-rocksdb, kv-surrealkv, kv-indxdb et kv-tikv. L'ensemble de fonctionnalités par défaut est protocol-ws plus rustls, tandis que protocol-http, scripting, ml, jwks et http s'activent séparément.
[dependencies]
surrealdb = { version = "3.2.4", default-features = false, features = ["protocol-http", "rustls"] }Ce que SurrealDB ne fait pas compte tout autant. Il ne remplace pas PostgreSQL là où un planificateur de requêtes mature et vingt ans d'outils autour décident du résultat. Ce n'est pas une base vectorielle dédiée au sens de Qdrant, même s'il porte des index vectoriels. Ce n'est pas non plus un backend fini dans le style de PocketBase, car un panneau d'administration et des règles d'accès sont deux choses différentes.
La Business Source License 1.1, lue littéralement
Le fichier LICENSE à la racine du dépôt surrealdb/surrealdb contient le texte complet de la Business Source License 1.1 avec son en-tête de paramètres. Le concédant est SurrealDB Ltd., l'œuvre sous licence est décrite comme SurrealDB 3.0 avec un copyright détenu par SurrealDB Limited depuis 2025, la Change Date tombe le 1er janvier 2030, et la Change License est l'Apache License 2.0. Le texte de la licence lui-même déclare clairement qu'elle n'est pas une licence open source.
Les droits que la BSL accorde sans condition sont plus étroits qu'une lecture rapide ne le suggère : copier, modifier, créer des œuvres dérivées, redistribuer et utiliser hors production. L'usage en production n'est autorisé que dans le périmètre fixé par le paramètre Additional Use Grant, et ce paramètre est le cœur du sujet.
L'Additional Use Grant de ce dépôt dit que tu peux utiliser l'œuvre sous licence à condition de ne pas l'utiliser comme un Database Service. La définition suit dans le même paragraphe : tout produit, service, plateforme ou offre commerciale dans lesquels SurrealDB fournit des fonctionnalités de base de données à des tiers, autres que tes propres employés et prestataires qui travaillent pour ton compte, d'une manière qui permet à ces tiers de créer, gérer ou contrôler des schémas ou des tables.
Traduit en cas concrets, cela donne ceci. Une application SaaS où tu définis le schéma et où les clients ne font que saisir des données se trouve dans le périmètre autorisé. Une analytique interne pour ton propre personnel aussi, car les employés sont exclus par définition de la formulation sur les tiers. Vendre de l'hébergement SurrealDB à des clients, non. Une plateforme low-code ou un backend-as-a-service où les tenants définissent leurs propres tables non plus, et c'est précisément la classe de produits pour laquelle SurrealDB paraît le plus tentant. Quiconque en construit un a besoin d'une licence commerciale séparée de l'éditeur.
La date de transformation fonctionne par version. La licence dit que les droits de la Change License prennent effet à la Change Date ou au quatrième anniversaire de la première distribution publique d'une version donnée, selon ce qui arrive en premier. La version 3.2.4 a été publiée le 3 août 2026, donc son quatrième anniversaire tombe le 3 août 2030, tandis que la Change Date tombe le 1er janvier 2030, et c'est la plus proche des deux. Cette version précise devient donc du code Apache 2.0 le premier janvier 2030. Les anciennes lignes portent leurs propres paramètres : le fichier de licence sous le tag v2.3.7 décrit l'œuvre sous licence comme SurrealDB 2.0 et donne une Change Date du 17 septembre 2029. Il n'y a pas de date unique pour tout le projet.
Trois autres clauses complètent le tableau. La licence doit être affichée de façon visible sur chaque copie, originale et modifiée. Une violation met fin à tes droits sur la version courante et sur toutes les autres versions de l'œuvre sous licence. La licence n'accorde aucun droit sur les marques ou logos de l'éditeur au-delà de l'usage qu'elle exige elle-même.
Trois sources de licence et ce qui ne s'aligne pas
Un audit de dépendances vérifie trois endroits, car ils divergent.
| Source | Ce qu'elle montre pour SurrealDB |
|---|---|
| Fichier du dépôt | LICENSE à la racine, texte complet de la BSL 1.1 |
| Registre de paquets | crates.io indique non-standard pour surrealdb, surrealdb-core, surrealdb-types |
| Artefact publié | le paquet .crate 3.2.4 contient un fichier LICENSE avec le texte de la BSL 1.1 |
La première source est sans ambiguïté. J'ai aussi vérifié les variantes d'orthographe et les fichiers qui décrivent un arrangement de licence : LICENSE.md, LICENSING.md, NOTICE et COPYING à la racine de la branche principale renvoient tous 404, donc aucun document supplémentaire ne change le tableau.
La deuxième source paraît suspecte mais a une explication banale. Le Cargo.toml du paquet publié ne porte aucun identifiant SPDX dans le champ license, seulement license-file = "LICENSE". Le registre crates.io n'a alors aucun nom à afficher et écrit non-standard. Les scanners de dépendances qui font confiance au champ du registre afficheront donc une chaîne sans signification pour SurrealDB au lieu de BSL. Si tu tiens un inventaire de licences au travail, saisis à la main Business Source License 1.1 avec la Change Date, car aucune automatisation ne le fera pour toi.
La troisième source confirme la déclaration. Le paquet surrealdb décompressé en version 3.2.4 contient un fichier LICENSE avec le texte de la BSL 1.1, un répertoire src avec soixante-treize fichiers .rs, des répertoires benches et tests, build.rs, Cargo.lock et README.md. Le code est dans le paquet, le fichier de licence est dans le paquet, et son contenu correspond à ce qui se trouve dans le dépôt.
Côté JavaScript, le même test donne un résultat pire. Le paquet npm surrealdb en version 2.0.8 déclare Apache-2.0 dans package.json, alors que son archive contient exactement sept fichiers et qu'aucun n'est un fichier de licence.
npm pack surrealdb@2.0.8
tar tzf surrealdb-2.0.8.tgz
# package/package.json
# package/README.md
# package/dist/surrealdb.cjs, .d.ts, .mjs, surrealdb.server.cjs, surrealdb.server.mjsLe texte Apache 2.0 vit dans le dépôt surrealdb/surrealdb.js mais n'atteint jamais l'artefact. Si ton processus de conformité exige un fichier de licence à l'intérieur du paquet distribué, celui-ci n'en a pas. Le paquet Python a une lacune différente : les métadonnées PyPI de la version 2.0.0 ne portent ni champ license ni classificateur de licence, alors que le fichier LICENSE du dépôt surrealdb/surrealdb.py est Apache 2.0.
Les clients portent une autre licence que le serveur
Cette distinction décide de ce qui entre réellement dans ton produit.
| Composant | Version | Licence |
|---|---|---|
Serveur et crate surrealdb | 3.2.4 | BSL 1.1 |
Crates surrealdb-core, surrealdb-types | 3.2.4 | BSL 1.1 |
Paquet npm surrealdb | 2.0.8 | Apache 2.0 |
Paquet PyPI surrealdb | 2.0.0 | Apache 2.0 d'après le dépôt |
Le kit de développement Rust n'est pas une exception à la BSL, il en fait partie. Le crate surrealdb en 3.2.4 dépend de surrealdb-core, surrealdb-types et surrealdb-types-derive, tous figés à la même version 3.2.4, et chacun livre le même fichier BSL dans le paquet. J'ai décompressé surrealdb-types en 3.2.4 et le texte de la licence est identique, avec la même Change Date. Un client Rust est donc du code BSL, pas une bibliothèque permissive.
Les kits JavaScript et Python sont sous Apache 2.0, une licence permissive. Le code que tu livres au navigateur est libre des restrictions de la BSL. La restriction s'applique au serveur que tu exploites.
Le paquet npm a une couche de dépendances mince et les métadonnées le montrent : une dépendance de production, @surrealdb/sqon à la version exacte 0.1.0, plus des dépendances peer typescript dans la plage ^5.0.0 || ^6.0.0 et tslib dans la plage ^2.6.3. Il n'y a pas de champ engines, donc le paquet ne déclare aucune version minimale de Node. Une dépendance de ligne zéro figée exactement signifie qu'un correctif dans @surrealdb/sqon demande une nouvelle version du paquet principal.
Les versions, ou ce qui est stable aujourd'hui
Les numéros de version demandent une lecture attentive ici, car les versions les plus récentes de la liste sont des préversions.
curl -s -H "User-Agent: check" https://crates.io/api/v1/crates/surrealdb | \
python3 -c "import json,sys; c=json.load(sys.stdin)['crate']; print(c['max_stable_version'], c['newest_version'])"
# 3.2.4 3.3.0-beta.3La version stable la plus récente est la 3.2.4, publiée le 3 août 2026. La ligne 3.3.0 n'existe qu'en bêta : 3.3.0-beta.1 du 14 août, 3.3.0-beta.2 du 18 août et 3.3.0-beta.3 du 20 août 2026. Le rythme stable précédent était dense : 3.2.0 le 2 juillet, 3.2.1 le 10 juillet, 3.2.2 et 3.2.3 le même jour du 21 juillet, 3.2.4 le 3 août. Aucune des quatorze versions les plus récentes du registre n'est marquée comme retirée (yanked).
Les dates dans le flux des releases GitHub divergent de celles du registre, car l'horodatage y décrit la création ou la modification de la note de version plutôt que la publication du paquet. L'entrée de la version 3.2.4 porte un horodatage du 18 août 2026, alors que le paquet du registre date du 3 août. Pour planifier un déploiement, prends la date du registre.
La compatibilité entre versions est la deuxième raison de surveiller de près cette ligne. La documentation de l'éditeur décrit les migrations automatiques de données comme un mécanisme disponible seulement à partir de la 3.3.0. Le datastore enregistre alors la version qui l'a ouvert en dernier et applique les migrations en attente avant la première requête, consignées dans un registre qui couvre tout le cluster. La conséquence va dans un seul sens : un retour à une version plus ancienne est refusé si le datastore a exécuté une migration que l'ancien build ne connaît pas, et revenir en arrière demande alors un export via surreal export et une réimportation dans un datastore créé par l'ancienne version.
La première de ces migrations répare un défaut qu'il vaut mieux connaître avant de déployer la 3.2.x. Sur les versions de la 3.0 à la 3.2, la disposition des clés pour DEFINE SEQUENCE recoupe les tables dont le nom commence par sq. Une base qui contient une telle table cesse de répondre à INFO FOR DB, ne peut pas être supprimée avec REMOVE DATABASE et reste donc impossible à supprimer, et un export qui inclut les séquences échoue. Aucune séquence n'a besoin d'exister pour que cela arrive. Le correctif est dans la 3.3.0, qui est aujourd'hui en bêta.
La numérotation des kits de développement ne suit pas celle du serveur. Le serveur est à la 3.2.4, le paquet npm à la 2.0.8 du 21 juillet 2026, et le paquet PyPI stable à la 2.0.0 du 23 avril 2026, avec aussi des builds en préversion 3.0.0b8 dans le registre. Je n'ai trouvé aucun tableau de compatibilité avec le serveur dans le README du paquet npm, donc considère l'association d'un kit donné avec un serveur donné comme quelque chose à tester plutôt qu'à supposer.
Accès depuis le navigateur et permissions en SurrealQL
La particularité de SurrealDB est que le navigateur se connecte à la base sans backend à toi. Cela ressemble à ceci :
import { Surreal } from "surrealdb"
const db = new Surreal()
await db.connect("wss://my-instance.aws-euw1.surreal.cloud")
await db.use({ namespace: "test", database: "test" })
await db.signin({ username: "root", password: "root" })Ce dernier appel sous cette forme est exactement l'erreur qui finit en fuite, et la raison tient à la séparation d'identités intégrée au moteur. SurrealDB connaît les utilisateurs système, définis via DEFINE USER au niveau root, namespace ou base de données, et les utilisateurs d'enregistrement, définis via DEFINE ACCESS avec le type RECORD. Les permissions de table ne s'appliquent qu'au second groupe. Dans le code d'exécution de la 3.2.4, la vérification pour un utilisateur système se réduit à savoir si l'acteur détient un rôle qui autorise les lectures ou les modifications et si le namespace et la base cibles se trouvent dans le niveau de l'acteur. La clause PERMISSIONS n'est pas du tout consultée. Des identifiants root dans le navigateur donnent donc un accès complet en lecture et en écriture, quoi que tu aies écrit à côté de tes tables.
Le réglage par défaut est fermé de lui-même. L'analyseur de la 3.2.4 attribue NONE pour les quatre opérations à une table définie sans clause PERMISSIONS, donc un utilisateur d'enregistrement ne voit rien tant que tu n'écris pas de règle. La fuite ne vient pas de la valeur par défaut, elle vient de PERMISSIONS FULL tapé pendant le développement et oublié, ou d'une clé d'administration dans le bundle du frontend.
DEFINE ACCESS user ON DATABASE TYPE RECORD
SIGNUP ( CREATE user SET email = $email, pass = crypto::argon2::generate($pass) )
SIGNIN ( SELECT * FROM user WHERE email = $email AND crypto::argon2::compare(pass, $pass) )
DURATION FOR TOKEN 15m, FOR SESSION 12h;
DEFINE TABLE note SCHEMAFULL
PERMISSIONS
FOR select, update, delete WHERE owner = $auth.id
FOR create WHERE $auth.id != NONE;Le paramètre $auth est un nom protégé dans le moteur, à côté de $access, $token et $session, et il pointe vers l'enregistrement pour lequel la session a été émise. DURATION prend des valeurs séparées pour le token et pour la session, et aussi pour les grants avec les types d'accès qui en émettent. L'instruction DEFINE ACCESS prend en charge les variantes OVERWRITE et IF NOT EXISTS, ce qui compte pendant les migrations de schéma.
Le rayon d'une erreur est total, car le client envoie du SurrealQL arbitraire. La méthode db.query prend une chaîne, donc il n'y a pas de liste d'autorisation de requêtes côté serveur pour servir de seconde ligne de défense. Quiconque ouvre les outils de développement voit les trames WebSocket et les rejoue avec le même token. Face à une table réglée sur PERMISSIONS FULL, cela signifie lire tous les enregistrements et pouvoir les supprimer. Un autre cas limite existe : quand l'authentification du serveur est désactivée et que la session est anonyme, la vérification des permissions ne s'exécute pas du tout. Ce mode est pratique en local et un désastre quand il est exposé sur une adresse publique.
Le modèle d'accès est ici plus proche de PocketBase et de Supabase que d'une base de données classique, mais la différence compte. Dans Supabase, les règles s'écrivent comme des politiques d'accès dans une base relationnelle, dans PocketBase comme des expressions de règles sur une collection, et dans SurrealDB comme des clauses dans la définition de la table. Dans les trois cas, une règle vide ou trop large est la seule chose qui se tient entre tes données et Internet.
Tarifs de Surreal Cloud
La page de tarifs de l'éditeur affiche le texte des offres sans JavaScript, donc les chiffres peuvent se lire dans le HTML brut. Le calculateur interactif ne fonctionne qu'une fois les scripts exécutés et son texte statique n'indique pas les spécifications des configurations payantes, donc je ne les devine pas.
| Offre | Prix | Ce qu'elle inclut |
|---|---|---|
| Start | 0 USD par heure, puis à partir de 0,021 USD par heure | une instance gratuite, 1 Go de stockage et 1 Go de sortie mensuelle (egress) sans frais |
| Scale | 0,192 USD par nœud et par heure | déploiement sur plusieurs zones de disponibilité, mise à l'échelle horizontale |
| Enterprise | devis sur mesure | déploiement auto-hébergé, audit, support |
La configuration gratuite du calculateur est de 0,25 vCPU et 1 Go de mémoire à 0,000 USD par heure. L'arithmétique des offres payantes se calcule ainsi : 0,021 USD par heure sur 730 heures par mois donne environ 15,33 USD par mois pour l'instance payante la moins chère, et 0,192 USD par nœud et par heure donne environ 140,16 USD par mois par nœud, soit environ 420,48 USD par mois pour trois nœuds avant d'ajouter le stockage et l'egress. L'extension Agent Memory a des offres en libre-service séparées à partir de 29 USD par mois avec une semaine d'essai.
Deux éléments de la liste de fonctionnalités des offres Start et Scale sont marqués d'un astérisque décrit comme « bientôt disponible », dont le branching de base de données. Considère-les comme une annonce plutôt que comme quelque chose sur quoi un plan de déploiement peut reposer.
SurrealDB face aux alternatives
| Option | Modèle de données | Licence du moteur | Client dans le navigateur |
|---|---|---|---|
| SurrealDB 3.2.4 | document, graphe, relationnel, clé-valeur | BSL 1.1, Apache 2.0 à partir du 2030-01-01 | oui, via WebSocket |
| PostgreSQL | relationnel plus extensions | permissive | non, via une couche intermédiaire |
| MongoDB Community | document | SSPL version 1 | pas directement |
| Neo4j | graphe natif, Cypher | communautaire ou commerciale | pas directement |
| PocketBase | relationnel sur SQLite | MIT | oui, via REST |
| Supabase | relationnel sur PostgreSQL | permissive | oui, via REST et temps réel |
SurrealDB gagne là où le même jeu de données doit être lu une fois comme un document et une fois comme un graphe, et où tu veux un seul processus au lieu de trois. Une requête qui parcourt des liens, filtre sur des champs de documents et classe par similarité vectorielle est une seule requête en SurrealQL, alors qu'une pile construite avec PostgreSQL, Neo4j et Qdrant signifie trois requêtes plus du code qui fusionne les résultats, plus la synchronisation de trois copies des données.
Il perd là où le risque compte plus que le confort. La licence exclut toute une classe de produits. La ligne stable n'a pas encore de migrations automatiques. L'écosystème d'outils d'exploitation est jeune face à ce qu'offrent PostgreSQL ou même Redis. Si l'argument principal est un démarrage rapide avec un accès côté client, PocketBase et Supabase font le même travail sous des licences que personne n'a besoin d'expliquer à un juriste.
Erreurs courantes
Appeler SurrealDB un projet open source. La BSL n'est pas une licence ouverte et le dit d'elle-même en termes clairs. Si le mot « ouvert » apparaît dans une présentation au conseil, quelqu'un décidera sur une fausse prémisse.
Sauter l'Additional Use Grant en construisant un produit multi-tenant. La restriction ne concerne pas la vente de logiciels en général, elle concerne le fait de donner à des tiers la possibilité de créer et de gérer des schémas et des tables. Un produit où les tenants conçoivent leurs propres modèles de données tombe dans cette restriction.
Copier la valeur non-standard de crates.io dans un inventaire de licences. C'est un artefact de l'absence d'identifiant SPDX, pas un nom de licence. L'entrée doit indiquer Business Source License 1.1 avec la Change Date.
Livrer au navigateur des identifiants d'utilisateur système. Un compte root ignore les clauses PERMISSIONS, donc aucune règle de table ne protège les données de quiconque lit la clé dans le bundle du frontend.
Laisser PERMISSIONS FULL en place après le développement. La valeur par défaut pour une table sans cette clause est fermée, donc une règle large est toujours la saisie délibérée de quelqu'un qui a ensuite été oubliée.
Supposer que le numéro de version du kit de développement correspond à celui du serveur. Le paquet npm 2.0.8 dialogue avec le serveur 3.2.4, et ces numéros n'ont aucun rapport.
Créer une table dont le nom commence par sq sur les versions 3.0 à 3.2. Le résultat est une base qui ne peut être ni supprimée ni décrite via INFO FOR DB.
FAQ
SurrealDB est-il un logiciel open source ?
Non. Le moteur est livré sous Business Source License 1.1, et ce texte de licence déclare qu'elle n'est pas une licence open source, en promettant seulement que l'œuvre sous licence le deviendra plus tard. Les kits de développement JavaScript et Python sont une autre affaire et portent la licence Apache 2.0.
Puis-je utiliser SurrealDB dans un produit commercial ?
Oui, tant que le produit n'est pas un service de base de données au sens de l'Additional Use Grant. Une application où tu fixes le schéma et où les clients saisissent des données se trouve dans le périmètre autorisé. Une plateforme où les clients créent et gèrent leurs propres tables exige un accord séparé avec l'éditeur.
Quand le code devient-il disponible sous Apache 2.0 ?
La Change Date du fichier de licence actuel est le 1er janvier 2030 et la licence cible est Apache 2.0. La date se compte séparément pour chaque version et prend effet au plus tard au quatrième anniversaire de la première distribution publique de cette version. La ligne 2.x porte dans son propre fichier une Change Date du 17 septembre 2029.
Quelle version déployer aujourd'hui ?
La stable est la 3.2.4 du 3 août 2026. La ligne 3.3.0 compte trois builds en préversion pour l'instant et apporte les migrations automatiques de données ainsi que le correctif du défaut sur les noms de tables qui commencent par sq. Exécuter une bêta en production pour un seul correctif revient à échanger un risque contre un autre.
L'accès depuis le navigateur est-il sûr ?
Il l'est quand le navigateur se connecte comme un utilisateur d'enregistrement défini via DEFINE ACCESS de type RECORD, et que chaque table porte une clause PERMISSIONS qui renvoie à $auth. Les comptes système contournent ces clauses, donc une clé d'administration dans le code du frontend donne un accès complet à la base.
Dois-je recharger les données lors d'une mise à niveau ?
Pour monter vers la 3.3.0, non, car le datastore applique lui-même les migrations en attente avant la première requête. Pour revenir à une version plus ancienne, oui : le serveur refuse d'ouvrir un datastore qui a exécuté une migration qu'il ne connaît pas, et tu dois exporter les données et les charger dans un datastore créé par l'ancienne version.