NUEVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Ver el registro de cambios →

Base de datos

PostgreSQL, a una línea escrita de distancia.

Una base de datos PostgreSQL 18 real para cada proyecto, accesible desde su aplicación con un SDK fluido, protegida por seguridad de nivel de fila y escrita desde su propio esquema.

16
Versión PostgreSQL
2
motores: 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)

¿Qué está incluido?

Una base de datos con la que su aplicación puede comunicarse. Sin escribir una API.

motor

PostgreSQL 18 real

Sus datos residen en PostgreSQL, con sus tipos, restricciones, desencadenantes y funciones.

Generador de consultas

Consultas escritas con fluidez

Filtros de igualdad, rango, patrón, matriz, tipo de rango y texto completo, ordenación, conteo y paginación.

Relaciones

Incrustaciones

Obtenga filas relacionadas en una solicitud con una inserción como autor:autores(*).

Funciones

Llamar funciones con rpc()

Exponga las funciones de PostgreSQL a su aplicación. Las funciones de retorno de conjuntos se filtran como tablas.

Seguridad

Seguridad a nivel de fila

Escriba políticas en SQL con auth.uid() para que cada usuario solo llegue a sus propias filas. La base de datos los impone, no el cliente.

Tipos

Tipos de TypeScript generados

Genere un tipo de base de datos a partir de su esquema y obtenga columnas escritas, inserciones y argumentos de funciones.

IA

Vectores con pgvector

La extensión pgvector se envía con la imagen de la base de datos, para búsqueda de similitudes.

Inscribirse

GraphQL por proyecto

Active pg_graphql para un proyecto cuando desee una API GraphQL sobre su esquema.

Motor alternativo

MongoDB, si prefieres documentos

Elija MongoDB como motor de un proyecto. Luego, el aislamiento utiliza propietarios de documentos en lugar de seguridad a nivel de fila.

como funciona

De una tabla a una consulta escrita.

  1. 1

    Crear una tabla

    Utilice el editor de tablas de Studio o SQL simple.

  2. 2

    Agregar una política

    Active la seguridad a nivel de fila y describa quién puede ver qué filas.

  3. 3

    Generar tipos

    Ejecute aurabase-gen para obtener un tipo de base de datos para su cliente.

  4. 4

    Consulta

    Llame a aura.db.from(…) desde su aplicación, con la sesión del usuario.

API REST

¿Prefieres HTTP simple? Está todo aquí.

El SDK es una fina capa sobre estas rutas. Envíe la clave API de su proyecto con cada solicitud.

MétodoPunto finalDescripción
GET/v1/db/{table}Leer filas, con filtros, ordenamiento e incrustaciones.
POST/v1/db/{table}Inserte una o varias filas, o inserte.
PATCH/v1/db/{table}Actualizar filas.
DELETE/v1/db/{table}Eliminar filas.
POST/v1/db/rpc/{function}Llame a una función de PostgreSQL.
GET/v1/db/schemaEnumere las tablas y funciones del proyecto.
GET/v1/db/functionsEnumere las funciones definidas en el proyecto.
POST/v1/db/rawEjecute una declaración SQL. Reservado al rol de servicio.

Preguntas

Es bueno saberlo.

¿Es este PostgreSQL real?+
Sí. Los proyectos ejecutan PostgreSQL 18 con la extensión pgvector, por lo que su SQL, restricciones, activadores y funciones funcionan tal como están escritos.
¿Cómo mantengo a los usuarios alejados de los datos de los demás?+
Habilite la seguridad a nivel de fila en una tabla y escriba una política que compare una columna con auth.uid(). La base de datos lo aplica a cada solicitud realizada con el token de un usuario.
¿Puedo ejecutar SQL sin formato?+
Sí, con el rol de servicio, a través de aura.db.sql() o el editor SQL en Studio. No está disponible para usuarios anónimos o que hayan iniciado sesión, así que manténgalo en el servidor.
¿Obtengo tipos de TypeScript para mis tablas?+
Sí. Ejecute npx aurabase-gen para escribir un archivo Database.types.ts , luego pase su tipo de base de datos a createClient .
¿Cómo paginar los resultados?+
Utilice limit() y offset() . La paginación del cursor solo está disponible en proyectos MongoDB y en la ruta del motor nativo.
¿Qué cambia con MongoDB?+
No hay seguridad a nivel de fila. Las lecturas de los usuarios que han iniciado sesión se filtran según los documentos que poseen y los documentos creados con el rol de servicio no tienen propietario, por lo que los usuarios no pueden verlos.

¿Listo para almacenar datos?

Su base de datos está a un proyecto de distancia.

En cada proyecto se incluye una base de datos. No se requiere tarjeta de crédito.