Ir para o conteúdo
Aura Logo
aurabase

Visualizar bancos de dados por solicitação pull

Uma ramificação é uma cópia de um projeto com sua própria URL e chaves de API. Crie um por solicitação pull no CI, aponte a visualização para ele e deixe-o expirar ou exclua-o na mesclagem.

Guia prático5 min lidoNível intermediárioRevisado em 12 de nov. de 2026

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

Uma solicitação pull = um banco de dados#

aura branch create clona um projeto PostgreSQL (esquema, políticas de segurança em nível de linha, funções, gatilhos, visualizações e linhas) em um novo projeto com seu próprio URL e chaves de API. Uma solicitação pull pode executar sua migração lá e os revisores podem testar o resultado, sem qualquer contenção no projeto de origem. A lista completa do que é ou não clonado e os limites estão nas ramificações do banco de dados branches de banco de dados.

Informações

Uma ramificação é uma cópia feita quando você a cria, em tempo proporcional aos dados (14 segundos para 333 MB na pilha de teste local). Não é um clone de cópia na gravação e não segue a fonte posteriormente.

Em CI#

Não há ação GitHub para instalar: a CLI faz o trabalho. Autentique-se com um token de acesso pessoal (aura login --token), crie a ramificação do projeto que você testa e mantenha o que a visualização precisa. Salve cada snippet como um script do seu pipeline:

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

As chaves são impressas apenas uma vez, quando o branch é criado: armazene-as no trabalho (ou como segredos da implantação de visualização) naquele momento. Para executar as migrações da solicitação pull na ramificação, vincule a pasta a ela e pressione: aura link --project-id <branch id> então aura db push.

Os comandos aura branch foram executados em uma pilha local; aura login --token é o login das receitas de CI na implantação implantação. O fluxo de trabalho GitHub ou GitLab em torno deles é seu para escrever.

O que o ramo contém#

A ramificação possui as linhas da origem (adicione --no-data apenas para o esquema), incluindo quaisquer dados pessoais que contenham: não há anonimato. Crie a ramificação a partir de um projeto de teste, não de produção, se a visualização não precisar ver dados reais. Usuários de autenticação, objetos de armazenamento, funções de borda e segredos não são clonados; propague-os em sua configuração de visualização.

TTL e cotas#

Uma filial vive 72 horas por padrão, até 30 dias (--ttl). As ramificações expiradas são excluídas automaticamente, assim como uma ramificação cuja criação falha. Uma ramificação não conta no limite do seu projeto; conta no limite de filiais ativas do seu plano (1 no Grátis, 10 no Pro, 25 no Team), consulte limites. Passado o limite, aura branch create falha com BRANCH_LIMIT_REACHED: exclua uma ramificação ou aguarde seu TTL.

Para ir mais longe#