cStatementCaractereObrigatório
Instrução SQL adequada ao SGBD e contexto autorizados.
GUIA PRÁTICOEm revisão
TCSqlExec e execução de comandos SQL
TCSqlExec(cStatement) -> nStatusExecuta uma instrução SQL na conexão DBAccess corrente.
Visão geral
TCSqlExec retorna status numérico negativo na falha; não o interprete como número de linhas alteradas. A instrução depende do SGBD. O TDN alerta que SQL direto não atualiza campos de controle DBAccess. O exemplo comunitário usa UPDATE em produto e campo customizado; aqui analisamos o padrão sem reproduzir uma alteração em cadastro. O bloco abaixo apenas prepara execução e não é invocado. A consulta SQL e o tratamento de erro devem ser definidos pelo proprietário da conexão e da transação. (Fontes: refs. 1–2.)
Sintaxe
TCSqlExec(cStatement) -> nStatusParâmetros
Retorno
Numérico; negativo indica falha.
Exemplo comentado
#Include "Protheus.ch"
User Function Ed688()
// Nao invocar com SQL externo: definir instrucao em laboratorio isolado.
Local bExecutar := {|cInstrucao| TCSqlExec(cInstrucao)}
ConOut(ValType(bExecutar))
Return NilResultado esperado
Cria bloco B, sem executar SQL. Ao integrar, conferir status < 0 e obter TCSQLError no contexto da falha. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Uma instrução por chamada; não usar SQL concatenado com entrada externa nem contornar regras de negócio do ERP.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.