Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
Uma stored procedure é um bloco nomeado de SQL que é executado no servidor. Você a chama uma vez e ela executa quantas instruções estiverem dentro dela. O código fica no banco de dados, não na sua aplicação.

Criando uma Stored Procedure

O MySQL usa DELIMITER para mudar o terminador de instrução, de modo que o ; dentro do corpo da procedure não encerre a instrução CREATE PROCEDURE antes da hora.
Chame-a com CALL:
Descarte-a:
Veja sua definição:

Parâmetros

As procedures suportam três modos de parâmetro:
Chame-a com uma variável definida pelo usuário para os parâmetros OUT:

Variáveis Locais

Declare variáveis locais com DECLARE no início do bloco BEGIN...END, antes de qualquer outra instrução:

Fluxo de Controle

As procedures do MySQL suportam as construções padrão de fluxo de controle:

Tratamento de Erros

Use DECLARE ... HANDLER para capturar erros:
EXIT HANDLER interrompe a procedure quando a condição é disparada. CONTINUE HANDLER deixa a procedure continuar em execução. RESIGNAL relança o erro para o chamador. Lance seus próprios erros com SIGNAL:
45000 é o SQLSTATE para “exceção definida pelo usuário não tratada”.

Cursores

Os cursores iteram sobre um conjunto de resultados linha por linha dentro de uma procedure. Use-os quando você não consegue expressar a lógica como uma operação de conjunto.
O handler NOT FOUND define v_done como TRUE quando o cursor fica sem linhas. Sempre feche os cursores antes de a procedure terminar.

Stored Procedures vs Funções

Use uma função quando precisar incorporar a lógica em uma expressão SQL. Use uma procedure para todo o resto — processos de várias etapas, lógica condicional, efeitos colaterais.

Quando Usar Stored Procedures

As stored procedures fazem sentido quando:
  • Impõem regras de negócio que devem valer independentemente de qual aplicação ou usuário executa a consulta
  • Reduzem idas e vindas em operações de várias etapas (jobs em lote complexos, migrações de dados)
  • Concedem aos usuários acesso a operações específicas sem expor as tabelas subjacentes (GRANT EXECUTE ON PROCEDURE)
Elas atrapalham quando:
  • A lógica muda com frequência — as implantações exigem ALTER PROCEDURE ou DROP/recriação
  • A depuração é necessária — não há depurador, apenas logging baseado em SIGNAL
  • A portabilidade importa — a sintaxe de stored procedures é específica do MySQL

Perguntas Frequentes

Uma stored procedure pode retornar um conjunto de resultados?

Sim. Qualquer SELECT dentro de uma procedure que não usa INTO envia um conjunto de resultados ao chamador:
Várias instruções SELECT dentro de uma procedure enviam vários conjuntos de resultados. A maioria dos clientes lida com isso, mas alguns ORMs não.

Como vejo todas as stored procedures de um banco de dados?

Solução de Problemas

VillageSQL: Tipos Personalizados de Extensão em Stored Procedures

Os tipos personalizados de extensão do VillageSQL (por exemplo, COMPLEX, UUID, TVECTOR) podem ser usados como tipos de parâmetro de stored procedure e como tipos de variável em DECLARE. Instale a extensão primeiro e depois referencie seus tipos na definição da procedure:
UNINSTALL EXTENSION vai falhar enquanto qualquer stored procedure usar os tipos personalizados daquela extensão. Descarte ou altere a procedure antes de desinstalar a extensão. Consulte Desinstalando Extensões para mais detalhes.

Veja também