Vamos criar nossa primeira função utilizando o PostgreSQL. Primeiramente, vamos abrir a documentação do PostgreSQL na seção de server programming, isto é, programação do lado do servidor. De início, temos um sumário com vários tópicos — estudaremos muitos deles.
Um dos capítulos chama-se "Query Language (SQL) functions", funções utilizando SQL. Como já conhecemos SQL, vamos acessá-la. No primeiro bloco de código de exemplo, encontramos uma sintaxe um tanto quanto diferente. Vamos copiá-la.
No menu lateral do pgAdmin, clicaremos com o botão direito sobre o banco de dados "alura" e selecionaremos "Query Tool...". Vamos colar o código e analisá-lo:
CREATE FUNCTION clean_emp() RETURNS void AS '
DELETE FROM emp
WHERE salary < 0;
' LANGUAGE SQL;
Para criar uma função, primeiramente informamos que estamos criando uma função com CREATE FUNCTION. Em seguida, damos um nome a ela. Vamos substituir o nome clean_emp() por primeira_funcao(), para ficar com um nome bem sugestivo:
CREATE FUNCTION primeira_funcao() RETURNS void AS '
DELETE FROM emp
WHERE salary < 0;
' LANGUAGE SQL;
Se você já tem familiaridade com programação e costuma seguir um padrão diferente para nomear funções, não tem problema. De costume, utiliza-se o snake case, separando palavras com um underline, mas você pode combinar o formato com a sua equipe.
Portanto, a sintaxe é CREATE FUNCTION para criar uma função, seguido do nome dessa função. Mais adiante, estudaremos os parênteses que aparecem após o nome. A seguir, informamos o que será retornado. "Void" é uma palavra especial que significa "nada", que nada será retornado. No nosso caso, queremos que ela devolva um número inteiro, então digitaremos "INTEGER":
CREATE FUNCTION primeira_funcao() RETURNS INTEGER AS '
DELETE FROM emp
WHERE salary < 0;
' LANGUAGE SQL;
O termo "AS" significa "como". Entre aspas (ou outro caractere que podemos definir), colocaremos o corpo da função, o que acontecerá nessa função. Depois da definição, informamos a linguagem em que ela será executada. Por ora, SQL.
Vamos alterar o corpo da função para que ela retorne um inteiro, utilizando o comando SELECT e uma conta matemática, por exemplo:
CREATE FUNCTION primeira_funcao() RETURNS INTEGER AS '
SELECT (5 - 3) * 2
' LANGUAGE SQL;
Para executar, podemos pressionar a tecla "F5" ou clicar no ícone de play no menu superior. Na parte inferior, teremos a mensagem de que a função foi criada com sucesso.
Existem várias maneiras de chamar uma função. Vamos tentar usar o seguinte comando:
SELECT * primeira_funcao();
Com o asterisco, estamos buscando tudo que a função retorna como se fosse uma tabela e chamando o nome da função. Porém, ao executar, temos um erro de sintaxe, então vamos tentar de outra maneira, sem o asterisco:
SELECT primeira_funcao();
Queremos buscar todos os itens, porém a função devolve um item só:
Mais adiante, entenderemos por que isso aconteceu. Por enquanto, descobrimos que, com o comando SELECT primeira_funcao(), buscamos a informação devolvida pela função.
Repare que o nome da coluna resultante é "primeira_funcao". Se fôssemos colocar em um relatório, seria melhor renomeá-la para algo mais simples, como "numero". Podemos renomeá-la como aprendemos anteriormente:
SELECT primeira_funcao() AS numero;
Quando temos uma função que retorna um valor, podemos tratar a chamada dessa função como um valor normal, como uma coluna de uma tabela. Por isso, conseguimos renomeá-la sem problemas.
Recapitulando: a estrutura para criarmos uma função em SQL é CREATE FUNCTION, o nome da função, o tipo de valor retornado, o expressão AS, o corpo da função entre aspas simples e a linguagem (no caso, SQL). Vale lembrar que o corpo é o que será executado quando chamarmos a função.
Para chamar a função, utilizamos o comando SELECT. Ele buscará o valor dessa função, que é o que ela retorna. Mais adiante, estudaremos mais sobre retornos também. Como o retorno se torna um valor, podemos definir ALIAS e até fazer JOIN com tabelas.