Arquivo de Log (.journal)

A continuously-used database is always record changes, additions or deletions. Realizar backups ou cópias de segurança regularmente é importante mas lembre que não permite (em caso de problemas) restaurar os dados registrados depois do último backup. Para responder à essa necessidade, 4D oferece agora uma ferramenta específica: o arquivo de log. Este arquivo permite garantir a segurança permanente dos dados do banco de dados. Este ficheiro permite garantir a segurança permanente dos dados do banco de dados.

Além disso, 4D trabalha constantemente com dados cache em memória. Any changes made to the data of the database are stored temporarily in the cache before being written to the hard disk. Isso acelera a operação das aplicações; na verdade, acessar a memória é mais rápido que acessar o disco rígido. If an incident occurs in the database before the data stored in the cache could be written to the disk, you must include the current log file in order to restore the database entirely.

Finally, 4D has functions that analyze the contents of the log file, making it possible to rollback the operations carried out on the data of the database. Essa funções estão disponíveis no MSC: veja a página deAnálise de atividade e a página Rollback.

como o arquivo de histórico funciona

The log file generated by 4D contains a descrption of all operations performed on the data of journaled tables of the database, which are logged sequentially. Como padrão, todas as tabelas são registradas, ou seja, incluidas no arquivo de histórico, mas pode desmarcar as tabelas individuais usando a propriedade de tabela Incluir no arquivo de histórico.

As such, each operation performed by a user causes two simultaneous actions: the first one in the database (instruction is executed normally) and the second one in the log file (the description of the operation is recorded). O arquivo de historial se cria de forma independente, sem perturbar nem ralentar o trabalho do usuário. Um banco de dados só pode trabalhar com um ficheiro de registo de cada vez. O arquivo de historial registra os seguintes tipos de ações:

• Abertura e fechamento de arquivos de dados,
• Abertura e fechamento de processos (contextos),
• Adição de registros ou BLOBs,
• Modificação de registros,
• Eliminação de registros,
• Criar ou fechar as transações.

Para saber mais sobre essas ações, consulte a página Análise de atividades do CSM.

4D gerencia o arquivo de historial. Leva em consideração todas as operações que afetam o arquivo de dados por igual, independente das manipulações realizadas pelo usuário, métodos 4D, o motor SQL, os plug-ins, ou um navegador web ou uma aplicação móvel.

A instrução abaixo resume o funcionamento do arquivo de historial:

O arquivo de historial atual se guarda automaticamente com o arquivo de dados atual. Este mecanismo tem duas vantagens distintas:

• Evitar a saturação do volume de disco onde se armazena o arquivo de historial. Sem uma cópia de segurança, o arquivo de histórico ficaria cada vez maior com o uso, e acabaria utilizando todo o espaço disponível no disco. Para cada cópia de segurnça do arquivo de dados, 4D ou 4D Server fecha o arquivo de histórico atual e imediatamente inicia um novo arquivo vazio, evitando assim o riesco de saturação. A continuação, o arquivo de historial antigo se arquiva e, finalmente, se destrói em função do mecanismo de gestão dos conjuntos de cópias de seguriança.
• It keeps log files corresponding to backups in order to be able to parse or repair a database at a later point in time. The integration of a log file can only be done in the database to which it corresponds. Para poder integrar corretamente um arquivo de historial em uma cópia de segurança, é importante que as cópias de segurança e os arquivos de historial se arquivem simultaneamente.

Criar o arquivo de histórico

By default, any database created with 4D uses a log file (option set in the General page of the Preferences). O arquivo de histórico é chamado data.journal e está na pasta Data.

You can find out if your database uses a log file at any time: just check whether the Use Log option is selected on the Backup/Configuration page of the Database Settings. If you deselected this option, or if you use a database without a log file and wish to set up a backup strategy with a log file, you will have to create one.

Para criar um arquivo de histórico:

1. On the Backup/Configuration page of the Database Settings, check the Use Log option. O programa exibe um caixa de diálogo abrir/novo arquivo. Como padrão, o nome arquivo é chamado data.journal.

2. Mantém o nome padrão ou renomeia, e daí seleciona o local do arquivo. If you have at least two hard drives, it is recommended that you place the log file on a disk other than the one containing the database. Se o disco duro do banco de dados for perdido, você ainda poderá recuperar o arquivo de histórico.

3. Clique Salvar. O disco e o nome do arquivo de histórico aberto agora estão exibidos na área Usar histórico da caixa de diálogo. Pode clicar nessa área para exibir um menu pop-up contendo a rota de histórico no disco.

4. Validar a caixa de diálogo Propriedades da base de dados.

In order for you to be able to create a log file directly, the database must be in one of the following situations:

• O arquivo de dados está em branco,
• Acabou de efetuar uma cópia de segurança da base de dados e ainda não foram feitas quaisquer alterações aos dados.

In all other cases, when you validate the Database Settings dialog box, an alert dialog box will appear to inform you that it is necessary to perform a backup. Se clicar em Aceitar, a cópia de segurança começa imediatamente, e depois se ativa o arquivo de histórico. If you click Cancel, the request is saved but the creation of the log file is postponed and it will actually be created only after the next backup of the database. This precaution is indispensable because, in order to restore a database after any incidents, you will need a copy of the database into which the operations recorded in the log file will be integrated.

Without having to do anything else, all operations performed on the data are logged in this file and it will be used in the future when the database is opened.

Precisa criar outro arquivo de histórico se criar um novo arquivo de dados. Precisa estabelecer ou criar outro arquivo de shitórico se abrir outro arquivo de dados que não estiver linnkado a um arquivo de histórico (ou se o arquivo de histórico estiver faltando).

Parando um arquivo de log

If you would like to stop logging operations to the current log file, simply deselect the Use Log option on the Backup/Configuration page of the Database Settings.

4D então exibe uma mensagem de alerta para avisar que a ação evita de aproveitar as vantagens de segurança de ter um arquivo de histórico:

If you click Stop, the current log file is immediately closed (the Database Settings dialog box does not need to be validated afterwards).

Se quiser fechar o arquivo de histórico atual porque é muito grande, pode considerar realizar um backup de arquivo de dados, o que vai fazer com que também se crie uma cópia de segurança do arquivo de histórico

4D Server: O comando New log file fecha automaticamente o arquivo de histórico atual e começa um novo. Se por alguma razão o arquivo de histórico ficar indisponível durante uma sessão de trabalho, o erro 1274 é gerado e o servidor 4D não permimte que o usuários escrevam mais dados. Quando o arquivo de histórico estiver disponível novamente, é preciso fazer um backup.