NEUPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Siehe Changelog →

Datenbank

PostgreSQL, eine getippte Zeile entfernt.

Eine echte PostgreSQL 18-Datenbank für jedes Projekt, erreichbar über Ihre App mit einem flüssigen SDK, geschützt durch Sicherheit auf Zeilenebene und typisiert aus Ihrem eigenen Schema.

16
PostgreSQL-Version
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)

Was ist enthalten?

Eine Datenbank, mit der Ihre App kommunizieren kann. Ohne eine API zu schreiben.

Motor

Echtes PostgreSQL 18

Ihre Daten befinden sich in PostgreSQL mit ihren Typen, Einschränkungen, Triggern und Funktionen.

Abfrage-Generator

Fließende, getippte Abfragen

Gleichheits-, Bereichs-, Muster-, Array-, Bereichstyp- und Volltextfilter, Reihenfolge, Zählung und Paginierung.

Beziehungen

Einbettet

Rufen Sie verwandte Zeilen in einer Anfrage mit einer Einbettung wie „author:authors(*)“ ab.

Funktionen

Funktionen mit rpc() aufrufen

Stellen Sie Ihrer App PostgreSQL-Funktionen zur Verfügung. Funktionen, die Mengen zurückgeben, filtern wie Tabellen.

Sicherheit

Sicherheit auf Zeilenebene

Schreiben Sie Richtlinien in SQL mit auth.uid(), damit jeder Benutzer nur seine eigenen Zeilen erreicht. Die Datenbank erzwingt sie, nicht der Client.

Typen

Generierte TypeScript-Typen

Generieren Sie einen Datenbanktyp aus Ihrem Schema und erhalten Sie typisierte Spalten, Einfügungen und Funktionsargumente.

KI

Vektoren mit pgvector

Die pgvector-Erweiterung wird mit dem Datenbankbild für die Ähnlichkeitssuche geliefert.

Opt-in

GraphQL pro Projekt

Aktivieren Sie pg_graphql für ein Projekt, wenn Sie eine GraphQL-API über dessen Schema wünschen.

Alternativer Motor

MongoDB, wenn Sie Dokumente bevorzugen

Wählen Sie MongoDB als Engine für ein Projekt. Bei der Isolierung werden dann Dokumentbesitzer anstelle der Sicherheit auf Zeilenebene verwendet.

Wie es funktioniert

Von einer Tabelle zu einer typisierten Abfrage.

  1. 1

    Erstellen Sie eine Tabelle

    Verwenden Sie den Studio-Tabelleneditor oder einfaches SQL.

  2. 2

    Fügen Sie eine Richtlinie hinzu

    Aktivieren Sie die Sicherheit auf Zeilenebene und beschreiben Sie, wer welche Zeilen sehen kann.

  3. 3

    Typen generieren

    Führen Sie aurabase-gen aus, um einen Datenbanktyp für Ihren Client abzurufen.

  4. 4

    Abfrage

    Rufen Sie aura.db.from(…) aus Ihrer App mit der Sitzung des Benutzers auf.

REST-API

Bevorzugen Sie einfaches HTTP? Es ist alles hier.

Das SDK ist eine dünne Schicht über diesen Routen. Senden Sie bei jeder Anfrage den API-Schlüssel Ihres Projekts.

MethodeEndpunktBeschreibung
GET/v1/db/{table}Zeilen lesen, mit Filtern, Reihenfolge und Einbettungen.
POST/v1/db/{table}Fügen Sie eine oder mehrere Zeilen ein bzw. upsert.
PATCH/v1/db/{table}Zeilen aktualisieren.
DELETE/v1/db/{table}Zeilen löschen.
POST/v1/db/rpc/{function}Rufen Sie eine PostgreSQL-Funktion auf.
GET/v1/db/schemaListen Sie die Tabellen und Funktionen des Projekts auf.
GET/v1/db/functionsListen Sie die im Projekt definierten Funktionen auf.
POST/v1/db/rawFühren Sie eine SQL-Anweisung aus. Reserviert für die Servicerolle.

Fragen

Gut zu wissen.

Ist das echtes PostgreSQL?+
Ja. Projekte führen PostgreSQL 18 mit der pgvector-Erweiterung aus, sodass Ihre SQL, Einschränkungen, Trigger und Funktionen wie beschrieben funktionieren.
Wie halte ich Benutzer davon ab, untereinander Daten zu nutzen?+
Aktivieren Sie Sicherheit auf Zeilenebene für eine Tabelle und schreiben Sie eine Richtlinie, die eine Spalte mit auth.uid() vergleicht. Die Datenbank wendet es auf jede Anfrage an, die mit dem Token eines Benutzers gestellt wird.
Kann ich rohes SQL ausführen?+
Ja, mit der Servicerolle, über aura.db.sql() oder den SQL-Editor in Studio. Es steht anonymen oder angemeldeten Benutzern nicht zur Verfügung. Behalten Sie es daher auf dem Server.
Bekomme ich TypeScript-Typen für meine Tabellen?+
Ja. Führen Sie npx aurabase-gen aus, um eine Datenbank.types.ts Datei zu schreiben, und übergeben Sie dann ihren Datenbanktyp an createClient .
Wie paginiere ich Ergebnisse?+
Verwenden Sie limit() und offset() . Die Cursor-Paginierung ist nur in MongoDB-Projekten und im nativen Engine-Pfad verfügbar.
Was ändert sich mit MongoDB?+
Es gibt keine Sicherheit auf Zeilenebene. Lesevorgänge durch angemeldete Benutzer werden auf die Dokumente gefiltert, deren Eigentümer sie sind. Mit der Dienstrolle erstellte Dokumente haben keinen Eigentümer, sodass Benutzer sie nicht sehen können.

Bereit zum Speichern von Daten?

Ihre Datenbank ist nur ein Projekt entfernt.

In jedem Projekt ist eine Datenbank enthalten. Keine Kreditkarte erforderlich.