Preparação e execução de uma instrução SQL
Uma prepared statement, ou instrução preparada, é um comando SQL preparado para execução posterior. Ela pode receber parâmetros, que reservam posições para os valores fornecidos a cada execução. Assim, a aplicação reutiliza a estrutura da consulta com entradas diferentes.
No PostgreSQL, o comando PREPARE analisa e reescreve a instrução. O comando EXECUTE fornece os valores necessários e solicita o planejamento e a execução. Essa divisão evita repetir parte do trabalho de análise.
Consultar produtos pelo identificador
O exemplo didático abaixo exige uma tabela produtos com as colunas id e nome. O identificador deve ser compatível com o tipo inteiro:
PREPARE buscar_produto (integer) AS SELECT nome FROM produtos WHERE id = $1;
EXECUTE buscar_produto(42);EXECUTE buscar_produto(73);O $1 representa o primeiro parâmetro. As duas execuções reutilizam essa instrução para buscar os nomes associados aos identificadores 42 e 73, respectivamente. Cada consulta retorna as linhas correspondentes ou um resultado vazio caso não haja correspondência.
Na aplicação, você deve usar a interface de parâmetros do driver para enviar os valores separadamente do texto SQL. Concatenar entradas externas ao comando antes de prepará-lo mantém a possibilidade de alterar sua sintaxe.
Duração na sessão e escolha do plano
A instrução preparada pertence à sessão PostgreSQL que a criou. Um pool de conexões administra várias sessões, portanto você precisa conferir como o driver prepara e reutiliza as instruções em cada uma.
O banco pode escolher um plano genérico, reutilizado entre execuções, ou um plano personalizado para os parâmetros recebidos. A preparação reduz trabalho repetido de análise, mas o ganho total depende da consulta e precisa ser medido.
Dúvidas frequentes
Perguntas frequentes sobre prepared statements
- A instrução preparada sobrevive ao encerramento da sessão?
- No PostgreSQL, ela existe na sessão que a criou. Uma nova sessão precisa preparar sua própria instrução antes de executá-la.
- Um parâmetro pode substituir o nome de uma tabela?
- Os parâmetros representam valores nas posições aceitas pelo SQL. O nome de uma tabela faz parte da estrutura do comando e não pode ser substituído por um parâmetro de valor.
- Preparar uma consulta garante um plano fixo ou menor tempo de execução?
- No PostgreSQL, o banco pode usar um plano genérico ou um plano personalizado para os valores recebidos. O efeito sobre o tempo de execução precisa ser medido na consulta utilizada.
Para continuar
Recursos relacionados
Documentação
PostgreSQL: preparação e execução de instruções
A referência do PostgreSQL descreve PREPARE, os parâmetros posicionais e a escolha entre planos genéricos e personalizados.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
O Desenvolvimento Colaborativo oferece orientação ao vivo para revisar consultas parametrizadas e investigar seu desempenho.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao desenvolver consultas com agentes, você precisa revisar a separação entre o texto SQL e os valores fornecidos pela aplicação.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.