Ajude o site desativando o bloqueador de anúncio

ASSINE A NEWSLETTER

Cadastrando...
PIX uDesenv pix deposito

TCRefresh [AS]

Autor: Eurai Criado: 01/01/2016 Atualizado: 28/07/2021

Descrição

Atualiza as definições globais de uma tabela no cache de definições do DBAccess

 

Sintaxe

TCRefresh( )

 

Parâmetros


Par Nome Tipo Descrição Default Obg Ref
01
cTabela
Caracter
Indica o nome da tabela para atualizar o cache de definições do DBAccess
  X  

 

Retorno

Retorno Tipo Descrição

 

Exemplo

#INCLUDE "TOTVS.CH"


User Function TCRefresh()

TCRefresh( RetSQLName('SA1') )

Return( Nil )

Resultado
tcrefresh_-_resultado_01                                       

 

 

Informações adicionais

O DBAccess mantém um cache de definições de estruturas de tabelas em uso (estruturas de campos, índices e controle de numeração), para as tabelas abertas pelo sistema. Este cache é criado à medida que novas tabelas são abertas, e otimiza a abertura de tabelas da aplicação, uma vez que qualquer alteração estrutural na tabela ou suas definições é feita utilizando demais funções da RDD através do DBAccess, ele mesmo atualiza os caches internos de estruturas.Caso um programa realize instruções de alteração estruturas ou índices diretamente nas tabelas do banco, mediante a função TCSQLExec() ou procedurespor exemplo, e pode ser necessário solicitar ao DBAccess que ele atualize o cache global com as novas definições da tabela. Neste caso, utiliza-se a função TCRefresh().Internamente, a obtenção das definições de campos, índices e tratamentos adicionais de uma tabela de dados do DBAccess consiste em executar queriesmontadas dinamicamente para obter do banco de dados as definições das colunas e índices da tabela em questão, depois obter as definições complementares registradas na TOP_FIELD, atualizar o número do último registro físico (R_E_C_N_O_ ) da tabela em memória, para o controle de inserções. Ao executarmos a função TCRefresh(), informando o nome da tabela, o DBAccess vai recriar a definição estrutural desta tabela no cache de estruturas do DBAccess.A utilização desta função é para fins específicos, em aplicações onde isto realmente é necessário. Chamar a função TCRefresh() desnecessariamente em uma aplicação pode prejudicar a performance da mesm

 

 

 

 

 

Gostou? Compartilhe com seus amigos e deixe um comentário! 😎