Tempo de leitura: 1 minuto
A função PLSQuery em ADVPL executa queries/instruções SQL no banco de dados. Ela é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL.
Sintaxe:
PLSQuery(cSQL,cAlias)
Parâmetro(s):
Nenhum
Retorno:
Nil
Exemplo da função PLSQuery em ADVPL:
//Bibliotecas
#Include "Protheus.ch"
#INCLUDE "TBICONN.CH"
#INCLUDE "topconn.ch"
#include "TOTVS.CH"
#include 'rwmake.ch'
/*/{Protheus.doc} fPLSQury
Exemplo da função PLSQuery em ADVPL
@type function
@author Adilio Costa
@since 07/10/2025
@version 1.0
@?Inscreva-se no Blog ProtheusAdvpl:
https://www.protheusadvpl.com.br
@?Inscreva-se no Canal ProtheusAdvpl:
https://www.youtube.com/protheusadvpl
@?Siga-nos no Instagram:
https://www.instagram.com/protheusadvpl
@?Conheça os Cursos e Formações do ProtheusAdvpl:
https://cursos-e-formacoes-protheusadvpl.gr-site.com/
@Participe de nossas comunidades no WhatsApp:
-Comunidade Protheus Backoffice:https://chat.whatsapp.com/KMUIAjwZ6EZ6eAHsLkPTyb
-Comunidade Protheus-RH:https://chat.whatsapp.com/L5dUyAna6xU4ylG5DUgfOW
-Comunidade Protheus-Programação:https://chat.whatsapp.com/LsD6z0apdqKHlOz67bcaEn
-Comunidade Protheus-Framework:https://chat.whatsapp.com/BzUFpjaSnTC3vtsfa77jmG
|Se esse conteúdo foi útil pra você nos ajude divulgando
ele e nossas redes sociais!!|
/*/
User Function fPLSQury()
Local aArea := GetArea()
Local cQry := ""
Local cNum := "366635"
PREPARE ENVIRONMENT EMPRESA "01" FILIAL "01" MODULO "COM"
cQry := " SELECT * FROM "+RetSQLName("SC1")+" SC1 (NOLOCK) WHERE C1_NUM = '"+Alltrim(cNum)+"' AND D_E_L_E_T_ = '' AND C1_FILIAL = '"+xFILIAL("SC1")+"' "
//Executa a consulta SQL
PLSQuery(cQry, "QRYSC1")
QRYSC1->(DBGoTop())
While QRYSC1->(!EOF())
FWAlertInfo("Registro encontrado: "+QRYSC1->C1_NUM+" - "+QRYSC1->C1_PRODUTO,"Função PLSQuery")
QRYSC1->(DBSkip())
EndDo
//Restaura a área
RestArea(aArea)
Return

É isso aí, finalizamos aqui mais um post no Blog ProtheusAdvpl. Caso tenha ficado alguma dúvida deixe seu comentário ou nos envie um e-mail para adiliocosta@protheusadvpl.com.br, até um próximo post, grande abraço e fica com Deus.
Link(s) de referência(s):