• A Confluence está sendo executada atualmente com todos os plugins que não são do sistema desabilitados. Pode haver perda de algumas funcionalidades
TOTVSTEC

Árvore de páginas

Executa uma instrução de sintaxe SQL (Structured Query Language) diretamente no banco de dados em que está conectado.

Sintaxe

TCSQLExec( < cStatement > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cStatement

caractere

Indica a instrução que será executada no banco de dados.

X


Retorno

Nome

Tipo

Descrição

nStatus

numérico

Retorna o status da execução. Se menor que 0 indica que a instrução não foi executada com sucesso.

Observações

  • O parâmetro cStatement é extremamente dependente do SGBD (Sistema Gerenciador de Banco de Dados) e deve ser construída visando o banco de dados utilizado.
  • É aconselhável que o parâmetro cStatement execute uma única instrução por vez. Isto porque a solicitação de execução de mais de uma instrução no Statement está sujeito ao comportamento do SGBD.
  • Essa função, por submeter instruções SQL diretamente ao SGBD, podendo utilizar tabelas não criadas pelo TOTVS | DBAccess, não atualiza os campos de controle criados pelo TOTVS | DBAccess.

Exemplos

USER FUNCTION TEST()
  TCLink()
  
  TCDelFile("T1")
  
  DBCreate("T1", {{"FIELD_NAME", "C", 10, 0}, ;
                  {"FIELD_TYPE", "C", 10, 0}}, "TOPCONN")
  
  nStatus := TCSqlExec("insert into t1 (field_name, field_type) values ('name', 'type')")
  
  if (nStatus < 0)
    conout("TCSQLError() " + TCSQLError())
  endif
  
  TCUnlink()
RETURN

Veja também

  • Sem rótulos