Saltar al contenido
Logotipo de Aurabase
aurabase

Vista previa de bases de datos por solicitud de extracción

Una rama es una copia de un proyecto con su propia URL y claves API. Cree uno por solicitud de extracción en CI, apunte la vista previa hacia él y déjelo caducar o elimínelo al fusionarlo.

Guía práctica5 min leerNivel intermedioRevisado el 12 nov 2026

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

Una solicitud de extracción = una base de datos#

aura branch create clona un proyecto PostgreSQL (esquema, políticas de seguridad a nivel de fila, funciones, activadores, vistas y filas) en un nuevo proyecto con su propia URL y claves API. Una solicitud de extracción puede ejecutar su migración allí y los revisores pueden probar el resultado, sin ninguna disputa sobre el proyecto de origen. La lista completa de lo que se clona y lo que no, y los límites, se encuentran en las ramas de la base de datos ramas de base de datos.

Información

Una rama es una copia realizada cuando la creas, en un tiempo proporcional a los datos (14 segundos para 333 MB en la pila de prueba local). No es un clon de copia sobre escritura y no sigue la fuente posteriormente.

En CI#

No hay ninguna acción GitHub para instalar: la CLI hace el trabajo. Autentíquese con un token de acceso personal (aura login --token), luego cree la rama del proyecto que prueba y conserve lo que necesita la vista previa. Guarde cada fragmento como un script de su canalización:

open-preview.shbash
aura login --token "$AURA_PAT"
aura branch create "pr-$PR_NUMBER" --from "$AURA_PROJECT_ID" --ttl 3d --json > branch.json
# Branch.json: id, slug, url, anon_key, service_role_key, expires_at
close-preview.shbash
aura login --token "$AURA_PAT"
aura branch delete "pr-$PR_NUMBER" --from "$AURA_PROJECT_ID" --force

Las claves se imprimen solo una vez, cuando se crea la rama: guárdelas en el trabajo (o como secretos de la implementación de vista previa) en ese momento. Para ejecutar las migraciones de la solicitud de extracción en la rama, vincule la carpeta y presione: aura link --project-id <branch id> y luego aura db push.

Los comandos aura branch se ejecutaron en una pila local; aura login --token es el inicio de sesión de las recetas de CI en la implementación despliegue. El flujo de trabajo GitHub o GitLab que los rodea es suyo.

Que contiene la rama#

La rama tiene las filas de la fuente (agregue --no-data solo para el esquema), incluidos los datos personales que contienen: no hay anonimización. Cree la rama desde un proyecto provisional, no desde producción, si la vista previa no debe ver datos reales. Los usuarios de autenticación, los objetos de almacenamiento, las funciones perimetrales y los secretos no se clonan; siémbrelos en su configuración de vista previa.

TTL y cuotas#

Una sucursal vive 72 horas de forma predeterminada, hasta 30 días (--ttl). Las ramas caducadas se eliminan automáticamente, al igual que las ramas cuya creación falla. Una sucursal no cuenta para el límite de tu proyecto; cuenta contra el límite de ramas activas de su plan (1 en Gratis, 10 en Pro, 25 en Equipo), consulte los límites de límites. Más allá del límite, aura branch create falla con BRANCH_LIMIT_REACHED: elimina una rama o espera su TTL.

para ir más lejos#