Árvore de páginas
Ir para o final dos metadados
Ir para o início dos metadados

Executa uma sentença de sintaxe SQL (Structured Query Language).

Sintaxe

TCSqlExec( < cStatement > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cStatement

caractere

Indica a string que contém a sentença que será informada à função e 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 sentença não foi executada com sucesso.

Observações

A sentença <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 (Sistema Gerenciador de Banco de Dados)

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