NOUVEAUPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Voir le changelog →

Base de données

PostgreSQL, une ligne tapée.

Une véritable base de données PostgreSQL 18 pour chaque projet, accessible depuis votre application avec un SDK fluide, protégée par une sécurité au niveau des lignes et saisie à partir de votre propre schéma.

16
Version PostgreSQL
2
moteurs : PostgreSQL, MongoDB
db.tsTS
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(
'https://my-project.aurabase.cloud',
'aura_anon_xxx',
)
const { data, error } = await aura.db
.from('posts')
.select('id,title,author:authors(*)')
.eq('published', true)
.order('created_at', 'desc')
.limit(10)

Ce qui est inclus

Une base de données avec laquelle votre application peut communiquer. Sans écrire d’API.

Moteur

Vrai PostgreSQL 18

Vos données résident dans PostgreSQL, avec leurs types, contraintes, déclencheurs et fonctions.

Générateur de requêtes

Requêtes fluides et dactylographiées

Filtres d’égalité, de plage, de motif, de tableau, de type plage et de texte intégral, classement, comptage et pagination.

Relations

Intégrations

Récupérez les lignes associées dans une seule requête avec une intégration telle que author:authors(*).

Fonctions

Appeler des fonctions avec rpc()

Exposez les fonctions PostgreSQL à votre application. Les fonctions de retour d’ensemble filtrent comme des tables.

Sécurité

Sécurité au niveau des lignes

Écrivez des politiques en SQL avec auth.uid() afin que chaque utilisateur n’atteigne que ses propres lignes. La base de données les applique, pas le client.

Espèces

Types TypeScript générés

Générez un type de base de données à partir de votre schéma et obtenez des colonnes tapées, des insertions et des arguments de fonction.

IA

Vecteurs avec pgvecteur

L’extension pgvector est livrée avec l’image de la base de données, pour la recherche de similarité.

S’inscrire

GraphQL par projet

Activez pg_graphql pour un projet lorsque vous souhaitez une API GraphQL sur son schéma.

Moteur alternatif

MongoDB, si vous préférez les documents

Choisissez MongoDB comme moteur d’un projet. L’isolation utilise alors les propriétaires de documents au lieu de la sécurité au niveau des lignes.

Comment ça marche

D’une table à une requête typée.

  1. 1

    Créer un tableau

    Utilisez l’éditeur de table Studio ou du SQL simple.

  2. 2

    Ajouter une politique

    Activez la sécurité au niveau des lignes et décrivez qui peut voir quelles lignes.

  3. 3

    Générer des types

    Exécutez aurabase-gen pour obtenir un type de base de données pour votre client.

  4. 4

    Requête

    Appelez aura.db.from(…) depuis votre application, avec la session de l’utilisateur.

API REST

Vous préférez le HTTP simple ? Tout est ici.

Le SDK constitue une fine couche sur ces routes. Envoyez la clé API de votre projet avec chaque demande.

MéthodePoint de terminaisonDescriptif
GET/v1/db/{table}Lisez les lignes, avec des filtres, un classement et des intégrations.
POST/v1/db/{table}Insérez une ou plusieurs lignes, ou upsert.
PATCH/v1/db/{table}Mettez à jour les lignes.
DELETE/v1/db/{table}Supprimez des lignes.
POST/v1/db/rpc/{function}Appelez une fonction PostgreSQL.
GET/v1/db/schemaRépertoriez les tables et les fonctions du projet.
GET/v1/db/functionsLister les fonctions définies dans le projet.
POST/v1/db/rawExécutez une instruction SQL. Réservé au rôle de service.

Questions

Bon à savoir.

Est-ce du vrai PostgreSQL ?+
Oui. Les projets exécutent PostgreSQL 18 avec l’extension pgvector, afin que votre SQL, vos contraintes, vos déclencheurs et vos fonctions fonctionnent comme écrit.
Comment puis-je garder les utilisateurs à l’écart des données des autres ?+
Activez la sécurité au niveau des lignes sur une table et écrivez une politique qui compare une colonne avec auth.uid(). La base de données l’applique à chaque demande effectuée avec le jeton d’un utilisateur.
Puis-je exécuter du SQL brut ?+
Oui, avec le rôle de service, via aura.db.sql() ou l’éditeur SQL dans Studio. Il n’est pas disponible pour les utilisateurs anonymes ou connectés, alors conservez-le sur le serveur.
Est-ce que je reçois des types TypeScript pour mes tables ?+
Oui. Exécutez npx aurabase-gen pour écrire un fichier database.types.ts , puis transmettez son type de base de données à createClient .
Comment puis-je paginer les résultats ?+
Utilisez limit() et offset() . La pagination du curseur n’est disponible que sur les projets MongoDB et sur le chemin du moteur natif.
Qu’est-ce qui change avec MongoDB ?+
Il n’y a pas de sécurité au niveau des lignes. Les lectures effectuées par les utilisateurs connectés sont filtrées selon les documents qu’ils possèdent, et les documents créés avec le rôle de service n’ont pas de propriétaire, les utilisateurs ne peuvent donc pas les voir.

Prêt à stocker des données ?

Votre base de données est à un projet.

Une base de données est incluse dans chaque projet. Aucune carte de crédit requise.