Objetivo

Com o objetivo de permitir alterar várias estruturas de tabelas necessárias no SGE, foi disponibilizada uma rotina especial que realiza a adequação estrutural do banco de dados.

Esta rotina pesquisa todas as tabelas do sistema que possuem os campos a serem alterados, apresenta ao usuário a relação encontrada e efetua automaticamente a alteração do tamanho dos campos selecionados. Como o volume de alterações é grande, a equipe técnica decidiu desenvolver uma rotina especifica para este momento somente ao invés de enviar inúmeras alterações via liveupdate.

Por se tratar de uma alteração estrutural diretamente na base de dados, é fundamental seguir rigorosamente as orientações abaixo.

Medidas de Segurança Obrigatórias

1. Realizar Backup Completo

Antes de iniciar o procedimento, execute um backup completo e validado da base de dados.

Importante: não execute a rotina sem possuir uma cópia de segurança recente e testada.

Em ambientes com grande volume de dados, recomenda-se também validar previamente o tempo necessário para uma eventual restauração do backup, garantindo que exista um plano de contingência adequado caso seja necessário retornar ao estado anterior.

2. Garantir Exclusividade de Uso

Durante a execução da rotina:

• Todos os usuários devem estar fora do sistema (SGE, WEB, COLETOR, etc...);
• Serviços de integração devem estar parados;
• Rotinas automáticas e agendamentos devem ser suspensos;
• Não devem existir processos de importação, faturamento, estoque ou geração de relatórios em execução;
• Não devem existir aplicações externas realizando consultas ou gravações diretamente na base de dados. 

Em bancos de dados de grande porte, qualquer atividade concorrente pode aumentar significativamente o tempo de processamento e o crescimento do log de transações. 

3. Executar Fora do Horário Comercial

Recomenda-se executar a rotina em período de baixa utilização do sistema, preferencialmente fora do horário de expediente.

Para bases com milhões de registros ou tabelas de grande volume, é altamente recomendável reservar uma janela de manutenção exclusiva para a execução da rotina, evitando impactos operacionais e reduzindo riscos de bloqueios ou lentidão.

4. Verificar Espaço em Disco

Certifique-se de que o servidor possui espaço suficiente para:

• Crescimento dos arquivos de dados;

• Crescimento do log de transações;

• Operações temporárias realizadas pelo banco de dados durante a alteração.

Atenção Especial ao Log de Transações

A alteração estrutural de campos pode gerar um crescimento significativo do log de transações, especialmente em bancos de dados com grande volume de registros.

Antes da execução, recomenda-se verificar:

• Espaço livre disponível nas unidades de armazenamento;
• Tamanho atual do arquivo de log;
• Configuração de crescimento automático (Auto Growth);
• Política de backup do log de transações, quando aplicável.

Em alguns cenários, o crescimento do log pode ser superior ao esperado e consumir rapidamente o espaço disponível em disco, ocasionando interrupção da operação ou indisponibilidade do banco de dados. 

Por este motivo, o monitoramento do espaço durante toda a execução é altamente recomendado.

Procedimento de Execução

Etapa 1 – Pesquisa das Tabelas

Ao acessar a rotina GEA022, clique no botão Pesquisar (item 1).

A rotina realizará uma varredura em toda a estrutura do banco de dados procurando tabelas que possuam campos a serem alterados.

Ao final da pesquisa será apresentada uma listagem contendo (item 2):

• Número da tabela;

• Descrição;

• Nome interno;

• Nome físico da tabela;

• Quantidade de registros.

No painel da direita (item 3) serão exibidos os campos encontrados, seu tipo, tamanho atual e indicação de índice.

Avaliação Prévia do Impacto

Antes de prosseguir para a alteração, recomenda-se analisar cuidadosamente a quantidade de tabelas encontradas e identificar aquelas que possuem maior volume de registros.

Em ambientes com bases pequenas ou médias, normalmente a alteração completa não apresenta dificuldades significativas.

Já em ambientes com grande volume de dados, esta análise é fundamental para definir a melhor estratégia de execução.

Etapa 2 – Seleção das Tabelas

Após a pesquisa, o usuário poderá:

• Marcar individualmente as tabelas desejadas;

• Utilizar o botão Marcar (item 1) para selecionar todas as tabelas encontradas;

• Utilizar o botão Desmarcar (item 2) caso seja necessário reiniciar a seleção.

Avaliação do Melhor Cenário de Execução

A escolha entre processamento total ou parcial deve considerar principalmente o volume de dados existente na base.

Cenário 1 – Seleção Total

Recomendado quando:

• O banco possui volume reduzido ou moderado de dados;
• Existe uma janela de manutenção adequada;
• Há espaço suficiente para crescimento dos arquivos e do log de transações;
• Deseja-se concluir toda a adequação em uma única execução.

Vantagens:

• Menor risco de esquecer tabelas relacionadas;
• Processo concluído em uma única etapa;
• Menor necessidade de planejamento adicional.

Cenário 2 – Seleção Parcial

Pode ser considerada quando:

• O banco possui grande volume de dados;
• Existem tabelas com milhões de registros;
• Há limitação de tempo para manutenção;
• Existe preocupação com crescimento excessivo do log de transações;
• O ambiente possui restrições de espaço em disco.

Vantagens:

• Permite dividir o processamento em etapas;
• Reduz o impacto operacional por execução;
• Facilita o controle do crescimento do log de transações;
• Possibilita monitoramento mais detalhado dos resultados.
• 
  

Importante: a execução parcial deve ser cuidadosamente planejada pela equipe técnica responsável. A não atualização de tabelas relacionadas pode gerar inconsistências temporárias ou exigir novas intervenções posteriores.

Na dúvida, recomenda-se avaliar previamente o ambiente junto à equipe de banco de dados antes de definir a estratégia.

Etapa 3 – Início da Alteração

Após conferir a seleção, clicar em Alterar Tabelas (item 1).

O sistema apresentará uma mensagem de confirmação informando que será realizada as alteraçõesnas tabelas selecionadas.

Antes de confirmar, revise novamente:

• Existência do backup;
• Ausência de usuários conectados;
• Ausência de integrações e processos ativos;
• Espaço disponível para crescimento dos arquivos de dados;
• Espaço disponível para crescimento do log de transações.

Somente após estas validações confirme a execução.

Etapa 4 – Processamento

Durante a execução será exibida uma janela de acompanhamento contendo:

• Quantidade de registros lidos;

• Quantidade de registros processados.

Considerações para Bases de Grande Volume

Dependendo da quantidade de tabelas selecionadas e do volume de registros armazenados, o processamento poderá variar de alguns minutos até várias horas.

Em bancos de dados de grande porte é esperado:

• Maior utilização de disco;
• Crescimento significativo do log de transações;
• Maior tempo de bloqueio das estruturas alteradas;
• Aumento temporário da utilização de recursos do servidor.

Por este motivo, recomenda-se monitorar continuamente:

• Espaço livre em disco;
• Crescimento do log de transações;
• Consumo de CPU e memória;
• Eventos e mensagens do banco de dados.

Atenção

Durante esta etapa:

• Não fechar a rotina;
• Não encerrar o sistema;
• Não reiniciar o servidor;
• Não interromper o banco de dados;
• Não cancelar o processo, salvo orientação expressa da equipe técnica.

A interrupção do processamento pode deixar a estrutura do banco inconsistente e exigir a restauração do backup.

Validações Após a Conclusão

Após o término da rotina recomendamos:

Cadastros

• Consultar itens existentes;

• Incluir um novo item com código superior a 16 posições;

• Alterar itens já cadastrados.

Movimentações

• Realizar testes de entrada e saída de estoque;

• Consultar saldos;

• Consultar lotes e séries, quando aplicável.

Integrações

• Validar integrações externas;

• Validar importações e exportações de dados;

• Validar força de vendas e aplicações WEB, caso existam.

Recomendações Técnicas Adicionais

Após a conclusão da alteração, recomenda-se:

• Monitorar os logs do banco nas primeiras horas de utilização;
• Avaliar o tamanho final do log de transações e executar os procedimentos de manutenção previstos para o ambiente;
• Monitorar desempenho e utilização de recursos nos dias subsequentes à alteração.

Em bancos de dados com grande volume de informações, estas atividades são especialmente importantes para restabelecer a melhor performance possível após a alteração estrutural.

Considerações Finais

A alteração do tamanho do campo Código do Item é uma modificação estrutural de grande impacto, pois afeta diversas tabelas e relacionamentos do sistema.

Em ambientes com grande volume de dados, o planejamento da execução torna-se ainda mais importante, principalmente em relação a:

• Tempo necessário para processamento;
• Espaço disponível em disco;
• Crescimento do log de transações;
• Definição entre execução total ou parcial;
• Disponibilidade de janela de manutenção adequada.

Por este motivo, a execução deve ocorrer em ambiente controlado, com backup validado, monitoramento constante e sem usuários conectados.

Seguindo as orientações acima, o procedimento ocorrerá de forma mais segura, reduzindo riscos operacionais e preservando a integridade dos dados.

O EXECUTÁVEL ENCONTRA-SE ANEXADO A ESTE ARTIGO E DEVE SER BAIXADO NO DIRETÓRIO WSGE\PROGRAMS E EXECUTADO DE LÁ.