FER003 — Manutenção do Banco de Dados
Fonte
- Form:
source/FER003/UFER003.pas - DataModule:
source/FER003/UdmFER003.pas
Objetivo
O módulo FER003 - Manutencao do Banco de Dados e a ferramenta centralizada de administracao e manutencao do banco de dados Firebird utilizado pelo sistema JunsoftERP. Este módulo disponibiliza ao administrador do sistema um conjunto abrangente de funcionalidades para garantir a saude, integridade e atualizacao da base de dados, incluindo execucao de scripts SQL, gerenciamento de indices, atualizacao estrutural do banco, operacoes de backup/restauracao e utilitarios de limpeza e validacao.
Este módulo e fundamental para o ciclo de vida do sistema, pois permite que atualizacoes estruturais sejam aplicadas de forma automatizada, comparando a base de dados do cliente com uma base de referencia (ATUALIZACAO.GDB). O processo de comparacao abrange roles, sequencias, funcoes UDF, dominios, excecoes, tabelas, indices, checks, chaves primarias, chaves estrangeiras, stored procedures, views e triggers, garantindo que a base do cliente esteja sempre alinhada com a versao mais recente do sistema.
Alem da atualizacao, o módulo oferece ferramentas essenciais de manutencao como sweep/limpeza de lixo do banco de dados, validacao e correcao de erros na base, e backup/restauracao com suporte a operacoes locais e remotas. Estas funcionalidades sao criticas para ambientes de producao onde a disponibilidade e integridade dos dados sao prioridades absolutas.
O acesso a este módulo deve ser restrito exclusivamente a administradores de sistema e profissionais de TI qualificados, pois operacoes incorretas podem comprometer a integridade do banco de dados e causar perda de dados.
Funcionalidades
- Execucao de Scripts (Aba "Execucao de Scripts")
- Manutencao de Indices (Aba "Manutencao de Indices")
- Manutencao do Banco (Aba "Manutencao Banco")
- Backup / Restauracao (Aba "Backup / Restauracao")
- Atualizacao do Banco (Aba "Atualizacao do Banco")
Perguntas Frequentes
Perguntas Gerais
P: Qual e a finalidade da tela FER003? R: A tela FER003 e uma ferramenta de administracao do banco de dados que oferece diversas funcionalidades: execucao de scripts SQL, atualizacao automatica da estrutura do banco de dados (comparacao de bases), gerenciamento de indices (estatisticas e ativacao), operacoes de backup e restauracao, e utilitarios de manutencao como limpeza (sweep), validacao e correcao de erros na base de dados.
P: Quais abas estao disponiveis na tela FER003? R: A tela possui cinco abas principais: Script (execucao de scripts SQL no formato JXP), Indice (gerenciamento de estatisticas e ativacao de indices), Atualizacao (comparacao e atualizacao automatica da estrutura do banco), Utilitarios (limpeza/sweep, validacao e correcao de erros) e Backup (operacoes de backup e restauracao do banco de dados).
P: Como executar um script SQL na tela FER003? R: Na aba Script, clique no botao Abrir para selecionar um arquivo no formato JXP. O caminho do arquivo sera exibido no campo correspondente. Em seguida, clique no botao Salvar (F6) para executar o script. O resultado da execucao sera exibido na area de log abaixo.
P: Como funciona a atualizacao automatica do banco de dados? R: Na aba Atualizacao, ao clicar em Salvar (F6), o sistema compara a estrutura do banco de dados atual com uma base de referencia (ATUALIZACAO.GDB). O processo atualiza automaticamente sequencias, dominios, tabelas, indices, chaves primarias e estrangeiras, procedimentos, views, triggers, listas de valores, módulos, mensagens e validates. Ao final, a versao do metadata e atualizada e um log detalhado e gerado.
P: Como funciona o gerenciamento de indices? R: A aba Indice possui duas sub-abas: Estatistica (para atualizar as estatisticas dos indices selecionados) e Inativos (para ativar indices que estao desativados). Em ambas, selecione os indices desejados usando a tecla Espaco ou clicando com o mouse, e em seguida clique em Salvar (F6) para processar.
P: Quais operacoes de backup estao disponiveis? R: A aba Backup oferece tres opcoes: Backup (cria uma copia de seguranca do banco de dados), Restauracao (restaura o banco a partir de um arquivo de backup) e Backup + Restauracao (executa ambas as operacoes em sequencia, criando uma nova base a partir da existente). E possivel configurar o IP do servidor, caminhos do banco, backup e base nova, alem de opcoes para execucao remota e paralelismo.
P: Quais utilitarios de manutencao estao disponiveis? R: A aba Utilitarios oferece: Verificar Limpeza (verifica se o banco possui lixo/registros obsoletos), Executar Limpeza (executa o sweep manual no banco), Ativar Limpeza Automatica (configura o sweep automatico com intervalo de 20000 registros), Desativar Limpeza Automatica (desabilita o sweep automatico), Validacao (verifica a integridade do banco de dados) e Correcao de Erros (tenta corrigir problemas encontrados na validacao).
Mensagens de Confirmacao
P: O que significa a mensagem "Deseja Realizar a Atualizacao do Banco?" R: Esta mensagem aparece ao clicar em Salvar (F6) na aba Atualizacao. Ela solicita confirmacao antes de iniciar o processo de comparacao e atualizacao automatica da estrutura do banco de dados. Este processo pode levar alguns minutos e, ao final, o sistema sera fechado automaticamente.
P: O que significa a mensagem "Deseja Executar o Script?" R: Esta mensagem aparece ao clicar em Salvar (F6) na aba Script. Ela solicita confirmacao antes de executar o arquivo de script SQL selecionado no banco de dados.
P: O que significa a mensagem "Deseja Atualizar a Estatistica dos Indices?" R: Esta mensagem aparece ao clicar em Salvar (F6) na sub-aba Estatistica da aba Indice. Ela solicita confirmacao antes de recalcular as estatisticas dos indices selecionados, operacao que pode melhorar a performance das consultas.
P: O que significa a mensagem "Deseja Ativar os Indices?" R: Esta mensagem aparece ao clicar em Salvar (F6) na sub-aba Inativos da aba Indice. Ela solicita confirmacao antes de reativar os indices selecionados que estao desativados.
Mensagens de Validacao e Erros
P: O que significa a mensagem "Nao foi possivel Executar o Script. Verifique!" (E-0000)? R: Esta mensagem aparece quando o arquivo de script informado no campo de arquivo nao foi encontrado no caminho especificado. Verifique se o caminho esta correto e se o arquivo no formato JXP existe no local indicado.
P: O que significa a mensagem "Nao foi Selecionado nenhum Indice. Verifique!" (E-0000)? R: Esta mensagem aparece ao tentar processar indices (atualizar estatisticas ou ativar) sem ter selecionado nenhum indice na grade. Selecione pelo menos um indice antes de executar a operacao.
P: O que significa a mensagem "Nao foi encontrado o aplicativo Jungfix.exe na pasta Utilitarios. Verifique!" (E-0000)? R: Esta mensagem aparece ao tentar executar operacoes de limpeza (sweep), validacao ou correcao de erros sem que o aplicativo utilitario Jungfix.exe esteja disponivel na pasta Utilitarios do sistema. Certifique-se de que o aplicativo esta instalado corretamente.
P: O que significa a mensagem "Nao foi encontrado o aplicativo Jungbak.exe na pasta Utilitarios. Verifique!" (E-0000)? R: Esta mensagem aparece ao tentar executar operacoes de backup ou restauracao sem que o aplicativo utilitario Jungbak.exe esteja disponivel na pasta Utilitarios do sistema. Certifique-se de que o aplicativo esta instalado corretamente.
P: O que significa a mensagem "E obrigatorio informar o IP ou Nome do Servidor." (E-0000)? R: Esta mensagem aparece na aba Backup quando o campo Servidor esta vazio. Informe o endereco IP ou o nome do servidor onde o banco de dados esta localizado.
P: O que significa a mensagem "E obrigatorio informar o Nome e Endereco do Banco de Dados." (E-0000)? R: Esta mensagem aparece na aba Backup quando a opcao selecionada requer o caminho do banco de dados (Backup ou Backup + Restauracao) e o campo Banco esta vazio. Informe o caminho completo do arquivo de banco de dados.
P: O que significa a mensagem "E obrigatorio informar o Nome e Endereco do Backup." (E-0000)? R: Esta mensagem aparece na aba Backup quando a opcao selecionada requer o caminho do arquivo de backup (Backup ou Restauracao) e o campo Backup esta vazio. Informe o caminho completo do arquivo de backup.
P: O que significa a mensagem "E obrigatorio informar o Nome e Endereco da Base Nova." (E-0000)? R: Esta mensagem aparece na aba Backup quando a opcao selecionada requer o caminho da nova base de dados (Restauracao ou Backup + Restauracao) e o campo Base Nova esta vazio. Informe o caminho completo para o novo arquivo de banco de dados.
P: O que significa a mensagem "E obrigatorio selecionar uma das opcoes." (E-0000)? R: Esta mensagem aparece na aba Backup quando nenhuma das opcoes de operacao (Backup, Restauracao ou Backup + Restauracao) foi selecionada. Selecione uma das opcoes antes de executar.
P: O que significa a mensagem "Script Executado com Erros. Verifique o Log!"? R: Esta mensagem aparece quando o script SQL foi executado, porem ocorreram erros durante a execucao. Os detalhes dos erros serao exibidos na area de log na tela. Analise o log para identificar e corrigir os problemas.
P: O que significa a mensagem "Comparacao de Base Executada com Erros."? R: Esta mensagem aparece apos a atualizacao automatica do banco quando foram encontrados erros durante a comparacao das bases. O total de erros sera informado e um arquivo de log (LogAtualizacao.txt) sera gerado para analise detalhada dos problemas.
Mensagens Informativas
P: O que significa a mensagem "Script Executado com Sucesso."? R: Esta mensagem confirma que o script SQL foi executado sem erros. O arquivo de script sera automaticamente excluido apos a execucao bem-sucedida.
P: O que significa a mensagem "Comparacao de Base Executada com Sucesso."? R: Esta mensagem confirma que a atualizacao automatica da estrutura do banco de dados foi concluida sem erros. O sistema sera fechado automaticamente apos a conclusao.
P: O que significa a mensagem "Indices Processados com Sucesso"? R: Esta mensagem confirma que a operacao de atualizacao de estatisticas dos indices selecionados foi concluida com sucesso.
P: O que significa a mensagem "Instrucao Processada com Sucesso"? R: Esta mensagem confirma que a operacao de ativacao dos indices selecionados foi concluida com sucesso.
P: O que significa a mensagem "Sistema sera Fechado apos Validacao e Correcao de Erros da Base."? R: Esta mensagem aparece ao fechar a tela FER003 apos ter executado uma operacao de Validacao ou Correcao de Erros. Como essas operacoes desconectam o banco de dados, o sistema precisa ser encerrado completamente. Reinicie o sistema apos a conclusao da operacao.
Mensagens exibidas
Levantadas de source/FER003/ pela camada 0 (commit 96fc51e236).
Mais 18 mensagens com texto literal no código: FER003.
Tabelas de Escrita (INSERT/UPDATE/DELETE)
| Tabela | Operacoes |
|---|---|
| ACESSO | INSERT |
| EMPRESA | DELETE, INSERT, UPDATE |
| PARMSISTEMA | UPDATE |
Tabelas de Leitura (SELECT)
| Tabela | Operacoes |
|---|---|
| COLISTAVALOR | SELECT |
| COMPARACAOVALIDATE | SELECT |
| ETAPASPRODUCAOPNEU | SELECT |
| LISTAVALOR | SELECT |
| MENSAGEM | SELECT |
| MENSAGEMNFE | SELECT |
| MODULO | SELECT |
| USUARIOEMPRESA | SELECT |
| VALIDATE | SELECT |
Procedures Chamadas
| Procedure |
|---|
| ATUALIZA_COLISTAVALOR |
| ATUALIZA_LISTAVALOR |
| ATUALIZA_MENSAGEM |
| ATUALIZA_VALIDATE |
Dependencias Aferentes (quem alimenta esta tela)
Telas que escrevem em tabelas lidas por esta tela.
| Tela | Título | Tabelas em Comum |
|---|---|---|
| ADM002 | Cadastro de Empresas | EMPRESA, USUARIOEMPRESA |
| ADM004 | Acessos de Usuários a Módulos | ACESSO, EMPRESA |
| ADM013 | Duplicação | ACESSO, USUARIOEMPRESA |
| CEQ002 | Consulta Ordens de Produção | EMPRESA, PARMSISTEMA |
| FER007 | Cadastro de Listas de Valor | COLISTAVALOR, LISTAVALOR |
Junsoft | Junsoft | PARMSISTEMA, USUARIOEMPRESA |
| MPD052 | Controle de Obra / Romaneio | EMPRESA, LISTAVALOR |
| MPD053 | Ordem de serviço - Ótica | EMPRESA, LISTAVALOR |
| MPD058 | MPD058 | EMPRESA, LISTAVALOR |
| MRC049 | Faturamento Automático de Ordem de Carregamento | EMPRESA, LISTAVALOR |
| TFA067 | Contratos e Licenças de Software | EMPRESA, PARMSISTEMA |
| ADM001 | Cadastro de Usuários | USUARIOEMPRESA |
| ADM003 | Cadastro de Módulos Personalizados | MODULO |
| ADM008 | Impressoras | EMPRESA |
| ADM010 | Configurações do Sistema | PARMSISTEMA |
| CCO001 | Consulta de Cotações | EMPRESA |
| CEQ001 | Saldo em Estoque | EMPRESA |
| CEQ003 | Custo Ordem Produção | EMPRESA |
| CEQ004 | Sugestão de Produção | EMPRESA |
| CEQ005 | Movimentos Estoque | EMPRESA |
| CEQ006 | CEQ006 | EMPRESA |
| CEQ007 | CEQ007 | EMPRESA |
| CEQ008 | CEQ008 | EMPRESA |
| CEQ012 | CEQ012 | EMPRESA |
| CEQ013 | CEQ013 | EMPRESA |
| CEQ015 | CEQ015 | EMPRESA |
| CEQ016 | CEQ016 | EMPRESA |
| CEQ017 | CEQ017 | EMPRESA |
| CFA001 | Formação de Preço de Venda | EMPRESA |
| CFA002 | Custo Total sobre Produção | EMPRESA |
| +423 telas |
Dependencias Eferentes (quem consome dados desta tela)
Telas que leem tabelas escritas por esta tela.
| Tela | Título | Tabelas em Comum |
|---|---|---|
Junsoft | Junsoft | ACESSO, EMPRESA, PARMSISTEMA |
| MNF001 | Recebimento de Notas Fiscais de Compra | ACESSO, EMPRESA, PARMSISTEMA |
| MNF008 | Emissão Nota Fiscal de Venda - Obras | ACESSO, EMPRESA, PARMSISTEMA |
| RFC032 | Razão Financeiro | ACESSO, EMPRESA, PARMSISTEMA |
| TOF007 | Cadastro de Peças | ACESSO, EMPRESA, PARMSISTEMA |
| TPO001 | Produtos | ACESSO, EMPRESA, PARMSISTEMA |
| ADM002 | Cadastro de Empresas | EMPRESA, PARMSISTEMA |
| ADM004 | Acessos de Usuários a Módulos | ACESSO, EMPRESA |
| ADM005 | Atalhos de Módulos por Usuário | ACESSO, EMPRESA |
| ADM010 | Configurações do Sistema | EMPRESA, PARMSISTEMA |
| ADM013 | Duplicação | ACESSO, EMPRESA |
| ADM023 | Configurações Gerais - Portal | EMPRESA, PARMSISTEMA |
| ADM024 | Parâmetros de Usuário - Portal | EMPRESA, PARMSISTEMA |
| CCB001 | Consulta de Lançamentos | EMPRESA, PARMSISTEMA |
| CCB002 | Balancete em Tela | EMPRESA, PARMSISTEMA |
| CCB003 | Razão em Tela | EMPRESA, PARMSISTEMA |
| CCB004 | DRE em Tela | EMPRESA, PARMSISTEMA |
| CEQ002 | Consulta Ordens de Produção | EMPRESA, PARMSISTEMA |
| CNF001 | Consulta de Notas Fiscais | ACESSO, EMPRESA |
| CNF008 | Demonstrativo de Margens sobre Vendas | EMPRESA, PARMSISTEMA |
| CPD001 | Consulta de Pedidos | ACESSO, EMPRESA |
JunsoftAPIBoletos | JunsoftAPIBoletos | EMPRESA, PARMSISTEMA |
JunsoftIntegracao | JunsoftIntegracao | EMPRESA, PARMSISTEMA |
JunsoftNFSe2 | JunsoftNFSe2 | EMPRESA, PARMSISTEMA |
LET045 | LET045 | EMPRESA, PARMSISTEMA |
LNF600 | LNF600 | EMPRESA, PARMSISTEMA |
| MCB001 | Parâmetros Contábeis | EMPRESA, PARMSISTEMA |
| MFA013 | Parâmetros NFSE | EMPRESA, PARMSISTEMA |
| MFC036 | Liberação de Contas a Pagar | ACESSO, EMPRESA |
| MNF002 | Emissão de Nota Fiscal de Venda | EMPRESA, PARMSISTEMA |
| +1145 telas |