Permissões necessárias

Use o ID do projeto do banco como project-id e conceda somente o scope da ação:

owner tem acesso completo na sessão de usuário. assistant, member e API Keys da organização precisam do grant específico. A operação de consultar aplicações vinculadas usa atualmente database.password.rotate no contrato da API.

Acessando as Configurações

1. No menu lateral, clique em Projetos
2. Localize e clique no nome do projeto de banco de dados desejado
3. Na página do projeto, clique no botão "Editar" no canto superior direito

Configurações Disponíveis

Nome do Projeto

O nome do projeto pode ser alterado a qualquer momento.

Regras:

• Mínimo: 6 caracteres
• Máximo: 32 caracteres
• Apenas letras minúsculas, números e hífens

Nota: A alteração do nome não afeta o endereço de conexão, que usa o ID do projeto.

Descrição do Projeto

A descrição do projeto pode ser alterada a qualquer momento.

Características:

• Campo opcional para descrever o propósito do projeto
• Ajuda a identificar e organizar seus projetos
• Pode incluir informações como ambiente, cliente, ou finalidade

Senha do Banco de Dados

Você pode renovar a senha do usuário app a qualquer momento. Você não escolhe a nova senha: a Zenifra gera uma senha completamente nova.

Como alterar:

1. Na seção de senha, solicite a geração de uma nova senha
2. Confirme a ação
3. Copie a nova senha exibida e guarde-a em local seguro; ela é mostrada uma única vez

Atenção: O banco de dados pode ficar indisponível durante o processo.

Importante: As aplicações vinculadas não são atualizadas automaticamente. O console lista essas aplicações; atualize manualmente a variável de conexão (por exemplo, DATABASE_URL) em cada uma.

Versão do MariaDB

A versão do MariaDB pode ser atualizada.

Versões disponíveis:

• MariaDB 10
• MariaDB 11

O console oferece apenas versões mais novas que a atual.

Como atualizar:

1. Selecione a nova versão desejada
2. Clique em Salvar

Atenção: A atualização de versão pode causar alguns minutos de indisponibilidade. Recomendamos realizar a alteração em horários de baixo acesso.

Importante: Não é possível fazer downgrade da versão do MariaDB. Exporte os dados com mariadb-dump/mysqldump antes do upgrade e teste a aplicação com a nova versão.

String de Conexão

A string de conexão é gerada automaticamente e pode ser consultada a qualquer momento, com a senha mascarada.

Formato:

mariadb://app:<senha>@mariadb-<id-do-projeto>.managed.zenifra.com:<porta>/app?ssl=true

A conexão exige TLS e aponta para a instância primária.

Para copiar: Clique no botão de copiar ao lado da string de conexão.

Dica: Use esta string na variável DATABASE_URL da sua aplicação HTTP para conectar ao banco de dados.

Acesso público

Por padrão, o host e a porta da string de conexão aceitam conexões de qualquer lugar, sempre com TLS. Se o banco só atende aplicações da sua organização, você pode desligar o acesso público e usar apenas as conexões privadas entre aplicações.

Como desligar:

1. Crie as conexões privadas das aplicações que usam o banco e troque a variável de conexão delas pelo endereço interno <projeto>.<id-da-organização>.zenifra.local:3306, com TLS, como descrito em Conexão TLS com bancos de dados
2. Na edição do projeto, localize o card Acesso público
3. Desligue o acesso público e confirme a ação
4. Na página do banco, o card de conexão passa a mostrar o aviso Acesso público desligado

Como religar:

1. No card Acesso público, ligue o acesso público e confirme
2. O banco volta a aceitar conexões no mesmo host e na mesma porta; a string de conexão externa continua igual

Atenção: com o acesso público desligado, ferramentas de administração, scripts locais e aplicações fora da Zenifra deixam de conseguir conectar ao MariaDB. As conexões privadas entre aplicações continuam funcionando, e a troca de senha continua disponível.

Nota: o banco precisa estar em execução, e a alteração não é aceita enquanto outra operação estiver em andamento no projeto.

Réplicas (MariaDB)

O MariaDB na Zenifra utiliza uma configuração fixa de 3 instâncias:

• 1 instância primária: Recebe as conexões de escrita e leitura
• 2 réplicas: Mantêm cópia dos dados e podem assumir em caso de falha da primária

Nota: Diferente do PostgreSQL, no MariaDB a quantidade de réplicas é fixa (3 instâncias) e não pode ser alterada.

Failover Automático

O MariaDB conta com failover automático:

• Se a instância primária falhar, uma das réplicas pode ser promovida automaticamente
• A conexão continua usando o mesmo host e a mesma porta
• Conexões abertas podem ser encerradas durante a troca; configure sua aplicação para reconectar automaticamente

Armazenamento

O armazenamento do banco de dados pode ser ajustado.

Limites:

• Mínimo: 1 GB
• Máximo: 250 GB

Impacto:

• Para projetos por hora: o armazenamento pode ser aumentado
• Para contratos mensais/anuais: o armazenamento é definido na contratação e não pode ser alterado durante o contrato

Plano

No pagamento por hora, você pode trocar o plano do banco na edição do projeto. Em contratos mensais ou anuais, o plano não pode ser alterado durante o contrato. A mudança pode causar indisponibilidade temporária.

Renovação automática

Em contratos mensais e anuais, a edição do projeto permite ativar ou desativar a renovação automática do contrato. Somente o owner da organização pode alterar essa opção.

Atenção: Não é possível reduzir o armazenamento. O aumento pode causar alguns minutos de indisponibilidade.

Ações do Projeto

Parar o Projeto

Ao parar o projeto:

• O banco de dados é interrompido
• As réplicas são desligadas
• O projeto não pode ser acessado
• Para projetos por hora, a cobrança do plano é interrompida, mas os custos do armazenamento continuam.

Quando usar:

• Quando não precisa do banco temporariamente
• Para economia em projetos por hora

Iniciar o Projeto

Para iniciar um projeto que está parado:

• O banco de dados é iniciado novamente
• As réplicas são inicializadas
• O projeto volta a ser acessível
• Para projetos por hora, a cobrança é retomada

Deletar o Projeto

A deleção é permanente e irreversível.

O que acontece:

• Todas as réplicas são removidas
• Todos os dados são apagados

Atenção: A Zenifra não mantém backup do banco. Exporte os dados com mariadb-dump/mysqldump antes de deletar. Esta ação não pode ser desfeita.

Próximos Passos

• Criar um Banco de Dados MariaDB
• Métricas e Insights do MariaDB
• Configurações de Pagamento

FAQ

Posso alterar a senha do banco de dados?

Sim. A qualquer momento através das configurações do projeto; a Zenifra gera a nova senha e a exibe uma única vez. Lembre-se de atualizar a variável de conexão nas aplicações que usam o banco.

A alteração de configurações causa downtime?

Depende da alteração:

• Senha: Pode causar indisponibilidade durante o processo
• Versão do MariaDB: Pode causar alguns minutos de indisponibilidade
• Réplicas: Configuração fixa (não alterável)
• Armazenamento: Pode causar alguns minutos de indisponibilidade
• Plano: Pode causar indisponibilidade temporária

Posso restaurar um banco de dados deletado?

Não. A deleção é permanente e não há backup pela plataforma. Os dados não podem ser recuperados. Exporte os dados antes de deletar.

O que acontece se a instância primária falhar?

O MariaDB conta com failover automático:

• Uma das réplicas é promovida a primária
• A conexão continua usando o mesmo host e a mesma porta
• Conexões abertas podem ser encerradas durante a troca; configure sua aplicação para reconectar automaticamente

Como fazer backup do meu banco de dados?

A Zenifra não oferece hoje backup automático nem restauração pelo console. Faça exportações periódicas com mariadb-dump/mysqldump, guarde as cópias fora do projeto e teste a restauração.

Posso conectar aplicações externas ao banco?

Sim, enquanto o acesso público estiver ligado, que é o padrão. Use a string de conexão fornecida nas configurações; a conexão exige TLS. Projetos de banco de dados não oferecem whitelist ou blacklist. Se nenhum cliente fora da Zenifra precisa do banco, desligue o acesso público e conecte suas aplicações pelas conexões privadas.

Posso alterar o número de réplicas do MariaDB?

Não. O MariaDB na Zenifra utiliza uma configuração fixa de 3 instâncias (1 primária + 2 réplicas). Esta configuração não pode ser alterada.