Saltar al contenido
Logotipo de Aurabase
aurabase

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.

Explicación8 min leerNivel intermedioRevisado el 15 abr 2026

Esta página fue traducida automáticamente. La versión en inglés es autorizada.

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).

Consejo

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.

flujo internotext
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;
Información

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 create copia 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.

queries.tstypescript
// 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)
Consejo

¿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
Información

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.

connect.shbash
# 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:

cadena de conexióntext
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 que sslmode=verify-full falla 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 denied a la clave anónima y a los usuarios que han iniciado sesión, mientras que la clave service_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 ejecuta NOTIFY 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 LOCAL dentro de una transacción y espere que las declaraciones preparadas con nombre, LISTEN y los bloqueos de aviso a nivel de sesión no sean confiables (Prisma: agregue pgbouncer=true a la URL).
  • Versión del cliente. pg_dump rechaza un servidor más nuevo que él: use un cliente PostgreSQL 18 (pg_dump --version).
Información

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#