Digite para filtrar os verbetes do Glossário.

    Banco de dados · Vibe Coding: Do Zero ao MVP

    O que é prepared statements?

    As prepared statements são instruções SQL preparadas para execução posterior. Elas podem receber valores por parâmetros e ser reutilizadas na mesma sessão.

    Também chamado de: instrução preparada, prepared statement

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano