Como Alterar Configurações do MariaDB

Permissões necessárias

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

Ação	Scope mínimo
Visualizar o projeto	`project.read` em `project:<project-id>`
Alterar nome	`project.name.update` em `project:<project-id>`
Alterar descrição	`project.description.update` em `project:<project-id>`
Alterar senha	`database.password.rotate` em `database:<project-id>`
Alterar versão	`database.version.update` em `database:<project-id>`
Visualizar conexão	`database.connection.read` em `database:<project-id>`

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

No menu lateral, clique em Projetos
Localize e clique no nome do projeto de banco de dados desejado
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:

Na seção de senha, solicite a geração de uma nova senha
Confirme a ação
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:

Selecione a nova versão desejada
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.

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.

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

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?