Skip to main content

​
Visão geral

O VillageSQL segue políticas claras de versionamento e compatibilidade para ajudar você a tomar decisões bem fundamentadas sobre implantação e atualizações.

​
Versionamento do VillageSQL

O VillageSQL usa o Versionamento Semântico (SemVer) para comunicar a natureza e o impacto das mudanças em cada lançamento.

​
Formato da versão

As versões seguem o formato: MAJOR.MINOR.PATCH

​
Regras de incremento de versão

  • Versão MAJOR (por exemplo, 1.0.0 → 2.0.0): mudanças incompatíveis que podem exigir modificações no código ou migrações de banco de dados
  • Versão MINOR (por exemplo, 0.1.0 → 0.2.0): novos recursos e funcionalidades adicionados de forma compatível com versões anteriores
  • Versão PATCH (por exemplo, 0.0.1 → 0.0.2): correções de bugs e pequenas melhorias compatíveis com versões anteriores
O VillageSQL está atualmente em desenvolvimento pré-1.0 (versão 0.x.x). Durante essa fase, as interfaces de API e de extensões podem mudar com mais frequência à medida que estabilizamos a plataforma.

​
Builds de desenvolvimento

Versões com um sufixo de pré-lançamento (por exemplo, 0.0.5-dev) são builds de desenvolvimento. Por padrão, o servidor bloqueia atualizações a partir de um banco de dados inicializado com um build de desenvolvimento. Os builds de desenvolvimento não são testados quanto à compatibilidade de atualização e podem incluir mudanças incompatíveis de esquema ou de protocol. Para permitir isso, inicie o servidor com --villagesql-allow-unsafe-dev-upgrade:
Sem a flag, o servidor sai com um erro se detectar um banco de dados de versão de desenvolvimento:
Com a flag, o servidor registra um aviso e prossegue:
O servidor sai com um erro se a flag for especificada, mas a versão atual não for um build de desenvolvimento:
Ou se nenhuma atualização de esquema estiver sendo realizada:

​
Compatibilidade de extensões

As extensões do VillageSQL são específicas de cada versão. Uma extensão compilada para uma versão do VillageSQL pode não funcionar com outra versão. Ao atualizar o VillageSQL:
  1. Verifique a compatibilidade da extensão com a nova versão
  2. Atualize ou recompile as extensões conforme necessário
  3. Teste as extensões em um ambiente de desenvolvimento antes da implantação em produção
Consulte o Guia de Atualização para procedimentos detalhados de atualização.