Base de datos
PostgreSQL 18, una base de datos dedicada por proyecto en el clúster de su organización, esquemas aislados, tipos TypeScript generados automáticamente, RLS nativo. Sin bifurcaciones ni reescritura de proxies: sus extensiones, activadores y PL/pgSQL funcionan tal cual.
Postgres 18, sin abstracción#
El servicio aura-db expone un CRUD genérico encima de un PostgreSQL 18: cada proyecto tiene su propia base de datos, alojada en el clúster PostgreSQL de su organización (un clúster completamente dedicado a un único proyecto en la oferta empresarial). Cada llamada al SDK se traduce a SQL nativo a través de una capa delgada que respeta el RLS policies inyectado en la sesión.
También puede omitir el SDK y apuntar psql, Prisma, Drizzle, Kysely, Metabase o pg_dump a su base de datos: protocolo de conexión estándar PostgreSQL, TLS, una función que solo puede llegar a la base de datos de su proyecto. Consulte Conexión directa a continuación. (Una implementación que no publica el puerto PostgreSQL lo dice en Studio › Configuración › Conexión: use el SDK, la API REST, el editor SQL o la CLI, aura db raw).
Un pg_dump le brinda su base de datos completa (esquema, datos, extensiones, políticas). Sin bloqueos, migración saliente trivial.
El SDK llama a PostgREST, que llama a Postgres#
Debajo del capó, el SDK serializa sus llamadas .from().select()… en una solicitud HTTP a aura-db que delega a un sidecar PostgREST. PostgREST se traduce a SQL y abre una conexión agrupada a través de PgBouncer con el search_path del proyecto inyectado.
SDK → HTTPS GET /v1/db/sensors?select=id,name
Gateway → aura-db Session verification & routing
aura-db → PgBouncer → PostgreSQL 18
# Conexión con el proyecto search_path
SET LOCAL search_path = project_a7f3_, public;
SET LOCAL request.jwt.claims = '{ "sub": "u_9k2", "tenant": "t_4c" }';
SELECT id, name, temperature FROM sensors WHERE active = true LIMIT 50;
Las políticas RLS tienen acceso a auth.uid(), auth.role(), auth.tenant(). Estos ayudantes leen request.jwt.claims inyectado por la puerta de enlace, imposible de manipular en el lado del cliente.
Seis habilidades nativas#
- Esquema por proyecto. Partición aplicada por PostgreSQL: sin columna Tenten_id, una función de conexión por proyecto, los derechos nunca se abrieron a PUBLIC.
- Migraciones versionadas. SQL versionado, reversión atómica, tiempo de inactividad cero. Los tipos TypeScript se regeneran con cada migración.
- Codegen TypeScript y Rust. Generación automática de tipos para tablas, vistas, enumeraciones y funciones RPC desde su esquema en vivo.
- Nativo RLS. Políticas declarativas comprobables. El SDK inyecta el inquilino de reclamo en cada conexión.
- Extensiones permitidas. 14 extensiones que instala la plataforma cuando se crea un proyecto:
pgvector,pgcrypto,uuid-ossp,pg_trgm,pg_graphql,pg_stat_statements,citext,hstore,ltree,unaccent,btree_gin,btree_gist,fuzzystrmatch,intarray. - Ramas de la base de datos.
aura branch createcopia un proyecto (esquema, políticas, funciones, activadores, vistas y filas) en un nuevo proyecto con su propia URL y claves, que se elimina automáticamente después de su tiempo de vida. Una copia realizada en el momento de la creación, no una réplica en vivo.
CRUD completo, mecanografiado#
Las cuatro operaciones básicas comparten la misma superficie .from(table). Los tipos devueltos se infieren de su esquema: abra su IDE, el autocompletado funciona en columnas, uniones y devoluciones.
// Enumere los últimos 50 sensores activos
const { data, error } = await aura
.from('sensors')
.select('id, name, temperature, location!inner(city)')
.eq('active', true)
.order('captured_at', { ascending: false })
.limit(50)
¿Necesita SQL más complejo? Cree una función Postgres y llámela mediante aura.rpc('function_name', args). Las funciones se benefician de las mismas políticas RLS que las tablas.
14 extensiones incluidas en la lista permitida listas#
14 extensiones incluidas en la lista permitida, listas para cada nuevo proyecto
La plataforma los instala cuando se crea el proyecto (una función del proyecto no puede ejecutar CREATE EXTENSION por sí sola, por lo que no hay que olvidar ningún paso de activación). Enumere lo que está instalado con aura db extensions list o Studio › Base de datos › Extensiones; aura db extensions enable <name> y POST /v1/db/{project_id}/schema/extensions vuelven a aplicar uno permitido.
- pgvector (
vector) - pg_graphql (se instala cuando habilita GraphQL)
- pg_stat_statements
- pgcripto
- uuid-ossp
- pg_trgm
- citexto
- hstore
- árbol
- sin acento
- btree_gin
- btree_gist
- partido difuso
- intraray
postgis, pg_cron, timescaledb, pgmq y pg_partman no están incluidos en la imagen administrada estándar. Para cargas de trabajo programadas, active una función perimetral en una programación cron en Cron. Un proyecto creado antes de este cambio tiene solo las cinco extensiones históricas (vector, pgcrypto, uuid-ossp, pg_trgm, pg_graphql) hasta que la plataforma ejecute su siguiente actualización de esquema; no puede agregar los demás usted mismo, porque sólo el operador de la base de datos puede instalarlos.
Conéctese directamente: psql, Prisma, Drizzle, pg_dump#
Cada proyecto tiene su propia función de inicio de sesión PostgreSQL (proj_xxxxxxxx) y un host con el formato <project-slug>.db.<your-domain> en el puerto 5432. La contraseña se emite a pedido y se muestra una vez: la plataforma no la mantiene clara, por lo que una contraseña perdida se reemplaza y nunca se recupera.
# Host, puerto, base de datos y rol del proyecto vinculado (sin contraseña)
aura db connection
# Emita una contraseña e imprima la cadena de conexión completa (revoca la contraseña anterior)
aura db connection --new-password
# Abra psql en él (psql solicita la contraseña)
aura connect
aura db connection --new-password imprime una cadena que puedes pegar en cualquier lugar:
postgresql://proj_ef13db60:<password>@my-app-ab12cd34.db.example.com:5432/project_694efb7f_...?sslmode=require
La misma tarjeta existe en Studio › Configuración › Conexión › Base de datos (Generar contraseña / Restablecer contraseña).
- Se requiere TLS. El punto final rechaza conexiones de texto sin formato (
sslmode=require). En una pila k3d local, el certificado está autofirmado (*.db.localhost), por lo quesslmode=verify-fullfalla allí por diseño; La producción utiliza un certificado emitido para*.db.<your-domain>. - Confinado a su proyecto. El enrutador selecciona su base de datos a partir del nombre de la función y la fuerza: solicitar otro nombre de base de datos aún llega al suyo y se rechaza la presentación de su función en el host de otro proyecto. Su rol no es el de superusuario y no pasa por alto RLS; para ejecutar una migración como propietario de la tabla, use
BEGIN; SET LOCAL ROLE tenant_<project-uuid>_admin; …; COMMIT;. - Las tablas que crea aquí son privadas para la plataforma. La seguridad de nivel de fila no se puede activar automáticamente para una tabla creada a través de esta conexión (que necesita un superusuario PostgreSQL, que un proyecto administrado nunca expone), por lo que las claves públicas no obtienen privilegios sobre ella: la API REST responde
permission denieda la clave anónima y a los usuarios que han iniciado sesión, mientras que la claveservice_role, Studio y su propio rol la leen y escriben. Para exponerlo al SDK, habilite RLS, otorgue y luego agregue una política (consulte Seguridad a nivel de fila):ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT ON posts TO aura_anon; CREATE POLICY …. PostgREST aprende sobre la nueva tabla cuando ejecutaNOTIFY pgrst, 'reload schema'. Las tablas creadas a través de esta conexión antes de que existiera esta regla se cierran la próxima vez que emita una contraseña (aura db connection --new-password), a menos que ya tengan RLS habilitado. - Agrupador de transacciones. Las conexiones pasan por PgBouncer en modo de transacción. El estado de la sesión no se transfiere de una transacción a la siguiente: use
SET LOCALdentro de una transacción y espere que las declaraciones preparadas con nombre,LISTENy los bloqueos de aviso a nivel de sesión no sean confiables (Prisma: agreguepgbouncer=truea la URL). - Versión del cliente.
pg_dumprechaza un servidor más nuevo que él: use un cliente PostgreSQL 18 (pg_dump --version).
El acceso directo depende de la implementación que publica el puerto PostgreSQL. Está activado para la pila k3d local y para implementaciones cuyos valores de Helm lo habilitan (ingress.tcp.enabled detrás de ingress-nginx o pgproxy.nodePort); Studio y aura db connection le avisan cuando no es así.
para ir más lejos#
- Seguridad a nivel de fila
Políticas nativas, pruebas, patrones multiinquilino.
- Convenciones
Esquemas de nombres, columnas, políticas, ayudantes RLS.
- Ramas de base de datos
Una copia de un proyecto para cada solicitud de extracción, eliminada por su TTL.
- Arquitectura
Cómo encaja aura-db en los 8 servicios.
- API DESCANSO
Superficie HTTP sin formato para base de datos, autenticación y almacenamiento.
- Supabase Migración
pg_dump + RLS reasignación, 1 hora para un proyecto promedio.