NIEUWPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Zie de changelog →

Database

PostgreSQL, één getypte regel verwijderd.

Een echte PostgreSQL 18-database voor elk project, bereikbaar vanuit uw app met een vloeiende SDK, beschermd door beveiliging op rijniveau en getypt vanuit uw eigen schema.

16
PostgreSQL-versie
2
motoren: 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)

Wat is inbegrepen

Een database waarmee uw app kan praten. Zonder een API te schrijven.

Motor

Echte PostgreSQL 18

Uw gegevens leven in PostgreSQL, met zijn typen, beperkingen, triggers en functies.

Query-bouwer

Vlotte, getypte vragen

Gelijkheid, bereik, patroon, array, bereiktype en full-text filters, volgorde, tellen en paginering.

Relaties

Insluitingen

Haal gerelateerde rijen op in één verzoek met een embed zoals auteur:auteurs(*).

Functies

Functies oproepen met rpc()

Stel PostgreSQL-functies beschikbaar voor uw app. Set-retournerende functies filteren als tabellen.

Beveiliging

Beveiliging op rijniveau

Schrijf beleid in SQL met auth.uid() zodat elke gebruiker alleen zijn eigen rijen bereikt. De database handhaaft ze, niet de klant.

Soorten

Gegenereerde TypeScript-typen

Genereer een databasetype op basis van uw schema en ontvang getypte kolommen, invoegingen en functieargumenten.

AI

Vectoren met pgvector

De pgvector-extensie wordt geleverd met de databaseafbeelding, voor zoeken naar overeenkomsten.

Aanmelden

GraphQL per project

Schakel pg_graphql in voor een project als u een GraphQL API via het schema wilt.

Alternatieve motor

MongoDB, als u de voorkeur geeft aan documenten

Kies MongoDB als de engine voor een project. Bij isolatie worden vervolgens documenteigenaren gebruikt in plaats van beveiliging op rijniveau.

Hoe het werkt

Van een tabel tot een getypte query.

  1. 1

    Maak een tabel

    Gebruik de Studio-tabeleditor of gewone SQL.

  2. 2

    Voeg een beleid toe

    Schakel beveiliging op rijniveau in en beschrijf wie welke rijen kan zien.

  3. 3

    Genereer typen

    Voer aurabase-gen uit om een databasetype voor uw klant op te halen.

  4. 4

    Vraag

    Roep aura.db.from(…) aan vanuit uw app, met de sessie van de gebruiker.

REST-API

Liever gewone HTTP? Het is allemaal hier.

De SDK is een dunne laag over deze routes. Stuur bij elk verzoek de API-sleutel van uw project mee.

MethodeEindpuntBeschrijving
GET/v1/db/{table}Lees rijen, met filters, volgorde en insluitingen.
POST/v1/db/{table}Voeg een of meerdere rijen in, of naar boven.
PATCH/v1/db/{table}Rijen bijwerken.
DELETE/v1/db/{table}Rijen verwijderen.
POST/v1/db/rpc/{function}Roep een PostgreSQL-functie aan.
GET/v1/db/schemaMaak een lijst van de tabellen en functies van het project.
GET/v1/db/functionsMaak een lijst van de functies die in het project zijn gedefinieerd.
POST/v1/db/rawVoer een SQL-instructie uit. Gereserveerd voor de dienstverlenende rol.

Vragen

Goed om te weten.

Is dit echte PostgreSQL?+
Ja. Projecten draaien PostgreSQL 18 met de pgvector-extensie, zodat uw SQL, beperkingen, triggers en functies werken zoals geschreven.
Hoe houd ik gebruikers uit elkaars gegevens?+
Schakel beveiliging op rijniveau in voor een tabel en schrijf een beleid dat een kolom vergelijkt met auth.uid(). De database past het toe op elk verzoek dat met het token van een gebruiker wordt gedaan.
Kan ik onbewerkte SQL uitvoeren?+
Ja, met de servicerol, via aura.db.sql() of de SQL-editor in Studio. Het is niet beschikbaar voor anonieme of ingelogde gebruikers, dus bewaar het op de server.
Krijg ik TypeScript-typen voor mijn tabellen?+
Ja. Voer npx aurabase-gen uit om een ​​ database.types.ts bestand te schrijven en geef het databasetype vervolgens door aan createClient .
Hoe pagineer ik resultaten?+
Gebruik limit() en offset() . Cursorpaginering is alleen beschikbaar voor MongoDB-projecten en op het native enginepad.
Wat verandert er met MongoDB?+
Er is geen beveiliging op rijniveau. Lezingen door ingelogde gebruikers worden gefilterd op de documenten waarvan zij de eigenaar zijn, en documenten die met de servicerol zijn gemaakt, hebben geen eigenaar, zodat gebruikers ze niet kunnen zien.

Klaar om gegevens op te slaan?

Uw database is één project verwijderd.

Bij elk project is een database inbegrepen. Geen creditcard vereist.