NUOVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Vedi il registro delle modifiche →

Database

PostgreSQL, una riga di testo più in là.

Un vero database PostgreSQL 18 per ogni progetto, raggiungibile dalla tua app con un SDK fluente, protetto dalla sicurezza a livello di riga e digitato dal tuo schema.

16
Versione PostgreSQL
2
motori: 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)

Cosa è incluso

Un database con cui la tua app può comunicare. Senza scrivere un'API.

Motore

PostgreSQL reale 16

I tuoi dati risiedono in PostgreSQL, con i suoi tipi, vincoli, trigger e funzioni.

Costruttore di query

Query digitate e fluide

Uguaglianza, intervallo, modello, array, filtri di tipo intervallo e testo completo, ordinamento, conteggio e impaginazione.

Relazioni

Incorpora

Recupera le righe correlate in un'unica richiesta con un incorporamento come autore:autori(*).

Funzioni

Chiama funzioni con rpc()

Esponi le funzioni PostgreSQL alla tua app. Le funzioni di restituzione degli insiemi filtrano come le tabelle.

Sicurezza

Sicurezza a livello di riga

Scrivi policy in SQL con auth.uid() in modo che ogni utente raggiunga solo le proprie righe. Il database li applica, non il client.

Tipi

Tipi TypeScript generati

Genera un tipo di database dal tuo schema e ottieni colonne tipizzate, inserimenti e argomenti di funzione.

AI

Vettori con pgvettore

L'estensione pgvettoriale viene fornita con l'immagine del database, per la ricerca di somiglianze.

Accettazione

GraphQL per progetto

Attiva pg_graphql per un progetto quando desideri un'API GraphQL sul suo schema.

Motore alternativo

MongoDB, se preferisci i documenti

Scegli MongoDB come motore per un progetto. L'isolamento utilizza quindi i proprietari dei documenti anziché la sicurezza a livello di riga.

Come funziona

Da una tabella a una query digitata.

  1. 1

    Crea una tabella

    Utilizza l'editor di tabelle di Studio o il semplice SQL.

  2. 2

    Aggiungi una politica

    Attiva la sicurezza a livello di riga e descrivi chi può vedere quali righe.

  3. 3

    Genera tipi

    Esegui aurabase-gen per ottenere un tipo di database per il tuo cliente.

  4. 4

    Domanda

    Chiama aura.db.from(…) dalla tua app, con la sessione dell'utente.

API REST

Preferisci il semplice HTTP? È tutto qui.

L'SDK è uno strato sottile su questi percorsi. Invia la chiave API del tuo progetto con ogni richiesta.

MetodoPunto finaleDescrizione
GET/v1/db/{table}Leggi le righe, con filtri, ordinamento e incorporamenti.
POST/v1/db/{table}Inserisci una o più righe oppure aggiungi.
PATCH/v1/db/{table}Aggiorna righe.
DELETE/v1/db/{table}Elimina righe.
POST/v1/db/rpc/{function}Chiama una funzione PostgreSQL.
GET/v1/db/schemaElenca le tabelle e le funzioni del progetto.
GET/v1/db/functionsElencare le funzioni definite nel progetto.
POST/v1/db/rawEsegui un'istruzione SQL. Riservato al ruolo di servizio.

Domande

Buono a sapersi.

È questo vero PostgreSQL?+
SÌ. I progetti eseguono PostgreSQL 18 con l'estensione pgvector, quindi SQL, vincoli, trigger e funzioni funzionano come scritti.
Come faccio a tenere gli utenti lontani dai reciproci dati?+
Abilita la sicurezza a livello di riga su una tabella e scrivi una policy che confronti una colonna con auth.uid(). Il database lo applica ad ogni richiesta effettuata con il token di un utente.
Posso eseguire SQL grezzo?+
Sì, con il ruolo di servizio, tramite aura.db.sql() o l'editor SQL in Studio. Non è disponibile per gli utenti anonimi o che hanno effettuato l'accesso, quindi conservalo sul server.
Ottengo i tipi TypeScript per le mie tabelle?+
Sì. Eseguire npx aurabase-gen per scrivere un file database.types.ts , quindi passare il tipo di database a createClient .
Come posso impaginare i risultati?+
Utilizza limit() e offset() . L'impaginazione del cursore è disponibile solo sui progetti MongoDB e sul percorso del motore nativo.
Cosa cambia con MongoDB?+
Non esiste alcuna sicurezza a livello di riga. Le letture degli utenti che hanno effettuato l'accesso vengono filtrate in base ai documenti di loro proprietà e i documenti creati con il ruolo del servizio non hanno proprietario, quindi gli utenti non possono vederli.

Pronto per archiviare i dati?

Il tuo database è a un progetto di distanza.

In ogni progetto è incluso un database. Nessuna carta di credito richiesta.