Usina BRGuía AdvPL
Ingresar
← Todos los temas
GUíA PRáCTICAEn revisión

TCSqlExec y ejecución de instrucciones SQL

TCSqlExec(cStatement) -> nStatus

Ejecuta instrucción SQL en conexión DBAccess actual.

TCSqlExec y ejecución de instrucciones SQLAdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

TCSqlExec retorna estado numérico negativo en fallo; no interprete como filas afectadas. SQL depende del SGBD. TDN advierte que SQL directo no actualiza campos de control DBAccess. El ejemplo comunitario actualiza campo customizado de producto; analizamos patrón sin reproducir modificación. El bloque no invocado solo prepara ejecución. Propietarios de conexión/transacción deben definir SQL y errores. (Fuentes: refs. 1–2.)

02 · SINTAXIS

Sintaxis

TCSqlExec(cStatement) -> nStatus

Parámetros

cStatement
CarácterObligatorio

Instrucción SQL para SGBD/contexto autorizados.

Retorno

Numérico; negativo indica fallo.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function Ed688()
    // No invocar con SQL externo: definir instrucción en laboratorio aislado.
    Local bEjecutar := {|cInstruccion| TCSqlExec(cInstruccion)}
    ConOut(ValType(bEjecutar))
Return Nil
Resultado esperado

Crea bloque B sin ejecutar SQL. Al integrar compruebe estado < 0 y obtenga TCSQLError en contexto del fallo. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS
  • Use una instrucción por llamada; no concatene entrada externa ni eluda reglas ERP.
  • En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS
  1. TOTVS. TCSQLExec. Retorno e campos de controle. Consulta el 2026-10-28.
  2. Atilio. dan-atilio/AdvPL. Maratona de Exemplos/Exemplo_482_Funcoes_TCSQLExec_e_TCSQLError.prw. Arquivo completo consultado; adaptação editorial. Consulta el 2026-10-28.
Estado
En revisión
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha