4D v16.3Compact data file |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v16.3
Compact data file
|
Compact data file ( endEstrutura ; endDados {; pastaArquivo {; opçao {; metodo}}} ) -> Resultado | ||||||||
Parâmetro | Tipo | Descrição | ||||||
endEstrutura | Texto |
![]() |
Endereço de acesso ao arquivo de estrutura | |||||
endDados | Texto |
![]() |
Endereço de acesso ao arquivo de dados | |||||
pastaArquivo | Texto |
![]() |
Endereço de acesso a pasta onde será colocado o arquivo de dados original | |||||
opçao | Inteiro longo |
![]() |
Opções de compactação | |||||
metodo | Texto |
![]() |
Nome do método 4D de retrochamada | |||||
Resultado | Texto |
![]() |
Endereço de acesso completo à pasta que contém o arquivo de dados original | |||||
O comando Compact data file [# descv] compacta o arquivo de dados designado pelo parâmetro endereçoDados associado com o arquivo de estrutura endereçoEstrutura. [#/ descv] Para mais informações sobre compactação, consulte o manual de Design.
Para assegurar a continuidade da operação do banco de dados, os novos dados de arquivos compactados automaticamente substituem o arquivo original. Por razões de segurança, o arquivo original não é modificado e é movido para uma pasta especial chamada "Replaced files (compacting) AAAA-MM-DD HH-MM-SS", onde AAAA-MM-DD HH-MM-SS representa a data e hora do backup. Por exemplo: "Replaced files (compacting) 2007/09/27 15-20-35"
O comando retorna o caminho completo da pasta realmente criado para armazenar os dados do arquivo original. Este comando só pode ser executado a partir de 4D (modo local) ou 4D Server (stored procedure). Os arquivo de dados a ser compactado deve corresponder à estrutura do arquivo designado pela endereçoEstrutura. Além disso, o arquivo de dados não deve ser aberto quando o comando é executado, caso contrário um erro é gerado.
Se ocorrer um erro durante o processo de compactação, os arquivos originais são mantidos em sua posição inicial. Se um arquivo de índice (arquivo .4DIndx ) é associado com o arquivo de dados, ele também é compactado. Tal como acontece com os dados, o arquivo original está salvo e a nova versão compactada substitui a anterior.
Constante | Tipo | Valor | Comentário |
Compact address table | Inteiro longo | 131072 | Forçar a reescrever os registros de endereço tabela (compactação lenta). Se você apenas passar esta opção, 4D ativa automaticamente a opção "Atualizar Registros '. Note que neste caso, os números de registro são reescritos. |
Create process | Inteiro longo | 32768 | Quando se passa esta opção, a compactação será assincrônica e deverá administrar os resultados utilizando o método de retrochamada (ver a continuação). 4D não mostrará a barra de progresso (é possível fazer isso através do método de retrochamada). A variável sistema OK toma o valor 1 se o processo for lançado corretamente e 0 em todos os outros casos. Quando não se passa esta opção, a variável OK toma o valor 1 se a compactação se realiza corretamente, do contrário 0. |
Do not create log file | Inteiro longo | 16384 | Geralmente, esse comando cria um arquivo de histórico em formato XML (veja o final da descrição do comando). Você pode cancelar esta operação a partir desta opção. |
Timestamp log file name | Inteiro longo | 262144 | Quando esta opção for passada, o nome do arquivo de histórico gerado conterá a data e a hora de sua criação; como resulado, não substituirá nenhum arquivo de histórico gerado anteriormente. Como padrão, se esta opção não for passada, os nomes de arquivo de histórico não terão uma timestamp e cada novo arquivo gerado vai substituir o anterior. |
Update records | Inteiro longo | 65536 | Força a reescrita de todos os registros após a atual definição de campos na estrutura. |
Por padrão, o comando Compact data file cria um arquivo de log no formato XML (se você não tiver passado a opção Do not create log file, consulte o parâmetro opções). Seu nome é baseado no arquivo de dados e é colocado próximo a esse arquivo. Por exemplo, para um arquivo de dados chamado "data.4dd", o arquivo de log será nomeado "data_compact_log.xml"
O exemplo a seguir (Windows) efetua a compactação de um arquivo de dados:
$arquivoEstrutura:=Structure file
$arquivoDados:="C:\Bancos\Faturas\Janeiro\Faturas.4dd"
$arquivoOrig:="C:\Bancos\Faturas\Arquivos\Janeiro\"
$pastaArqu:=Compact data file($arquivoEstrutura;$arquivoDados;$arquivoOrig)
Se a operação de compactação foi realizada corretamente, a variável sistema OK recebe o valor 1, caso contrário, recebe o valor 0.
Se um arquivo de histórico for gerado, seu nome de caminho completo é retornado na variável de sistema Document.
Produto: 4D
Tema: Ambiente 4D
Número
937
Criado por: 4D v11 SQL
Modificado: 4D v13
Modificado: 4D v15 R3
Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)