Histórico da Página

...

Sintaxe

TCAlter ( <cNome>, <aEstruturaAntiga><aEstruturaAtual>, <aEstruturaNova>, [@nErro] ) --> lRet

...

Nome	Tipo	Descrição	Obrigatório	Referência
cNome	Caracter	Indica o nome da tabela que será alterada	X
aEstruturaAntigaaEstruturaAtual	Vetor	Indica o array que contém as informações dos campos atuais da tabela.	X
aEstruturaNova	Vetor	Indica o array que contém as informações com os campos que serão alterados na a nova estrutura desejada para a tabela..	X
nErro	Numérico	Caso ocorra algum erro na hora alteração da alteraçãoestrutura, o número do erro do DBAccess será colocado nessa retornado através desta variável		X

Retorno

lRet (lógico)

...

É responsabilidade do programador passar a estrutura antiga atual corretamente, caso . Caso seja passada uma estrutura errada será mostrada uma mensagem de erro; diferente da atual, pode haver perda de uma ou mais colunas da tabela.
A função determina internamente as ações a serem tomadas para adequar a estrutura atual para a nova estrutura informada, mantendo os dados na tabela. Nesta operação, dependendo do SGDB em questão, um ou mais índices existentes para a tabela podem ser apagados para que a operação seja completa.
Ao comparar as estruturas, são determinadas originalmente quatro ações para cada campo da estrutura:
Campo inserido ( existe na nova estrutura, mas não existe na estrutura atual)
Campo eliminado ( existe na estrutura atual, mas não existe na nova estrutura )
Campo mantido ( existe em ambas as estruturas, com os mesmos atributos – tipo e tamanhos )
Campo alterado ( existe em ambas as estruturas, porém com tipo ou tamanho diferentes )
Na mudança de atributos em alteração de campo, a única A unica conversão de tipo suportada é N (numérico) para C (caracter). Caso seja realizada uma conversão de tipo não suportada, todos os dados da tabela coluna em questão serão apagados;.

...

Exemplo

User Function ex_TCAlter()

...

Árvore de páginas