4D v14.3

TRUNCATE TABLE

Página Inicial

 
4D v14.3
TRUNCATE TABLE

TRUNCATE TABLE 


 

TRUNCATE TABLE {( tabela )} 
Parâmetro Tipo   Descrição
tabela  Tabela in Tabela onde todos os registros serão apagados ou tabela padrão se esse parâmetro for omitido

O comando TRUNCATE TABLE [#descv]apaga rapidamente todos os registros de tabela. Depois de chamar o comando, não há uma seleção atual nem um registro atual.

O efeito deste comando é similar ao de uma sequência ALL RECORDS / DELETE SELECTION; entretanto, seu funcionamento difere nos seguintes pontos:

  • Não se chama o trigger
  • A integridade referencial dos dados não é controlada.
  • Nenhuma transação deve estar em curso no processo que executa TRUNCATE TABLE. Se este for o caso, o comando não faz nada e a variável sistema OK assume o valor 0
  • Se um ou mais registros estiverem bloqueados por outro processo, o comando falha: m erro é gerado e a variável sistema OK assume o valor 0. O conjunto sistema LockedSet não é criado.
  • Se tabela já estiver vazia, TRUNCATE TABLE não faz nada e a variável OK assume o valor 1.
  • Se tabela estiver em modo apenas leitura, TRUNCATE TABLE não faz nada e a variável OK assume o valor 0.
  • A variável OK assume o valor 0 ou 1 dependendo de se o comando falhou ou foi bem sucedido.
  • A operação é gravada no arquivo de histórico se houver.
O comando TRUNCATE TABLE deve portanto ser utilizado com cuidado, no entanto é muito efetivo em alguns casos, por exemplo, para apagar rapidamente dados temporários.

Nota: o conceito e funcionamento deste comando é similar ao do comando SQL TRUNCATE (TABELA).

Se o comando tiver sido executado corretamente, a variável sistema OK assume o valor 1. Do contrário, assume o valor 0.

 
PROPRIEDADES 

Produto: 4D
Tema: Seleção
Número 1051

Este comando modifica a variável sistema OKO comando altera o registro atualO comando altera a seleção atual

 
HISTÓRIA 

Modificado: 4D v11 SQL Release 3

 
VER TAMBÉM 

DELETE SELECTION

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)