Tutorial de CRUD com Node.js, Sequelize e PostgreSQL

No tutorial de hoje vou lhe ensinar a como construir um CRUD utilizando Node.js e PostgreSQL, mas diferentes do tutorial anterior com este banco de dados, neste eu vou mostrar como fazer isso com o ORM Sequelize.

Não sabe o que é um ORM? O que é o Sequelize? Ou até sabe mas não faz a mínima ideia de como usar?

Então este tutorial é pra você.

Atenção: este é um tutorial para quem já conhece Node.js e PostgreSQL. Se você não conhece estas duas tecnologias, comece por algo mais introdutório.

Se preferir, assista ao vídeo abaixo, que possui o mesmo conteúdo, independente do banco de dados.

ORM

Quando estamos construindo aplicações com bancos de dados, independente da linguagem, existem muitas, mas muitas atividades repetitivas mesmo entre sistemas completamente diferentes. Uma delas é a escrita dos comandos e consultas SQL para fazer inserções, atualizações, etc nas tabelas do seu banco e a outra é o mapeamento das entidades e relacionamentos em objetos ou módulos da sua aplicação.

Mapear tabelas para código é um padrão muito comum independente de linguagem ou framework pois te permite programar mais próximo da regra de negócio da empresa, reduz a carga cognitiva de ficar chaveando mentalmente entre as diferentes camadas da aplicação e lhe dá muita produtividade, uma vez que, depois do mapeamento feito, atividades triviais, porém trabalhosas, como ficar escrevendo os mesmos SQLs de sempre se tornam apenas simples chamadas de funções ou métodos.

Ainda assim, fazer este mapeamento na mão também é extremamente penoso e coloca uma curva inicial de trabalho grande em novos projetos. Aí que entram os ORMs ou Object-Relational Mappers.

Um ORM é um framework que lhe permite fazer este mapeamento de forma automática, como o Entity Framework da Microsoft, ou de forma manual, mas extremamente simplificada, como o Hibernate da RedHat, sendo este segundo tipo o mais popular porque muitas vezes a mágica dos geradores automáticos de mapeamento criam código com baixa qualidade e/ou possuem funcionalidades mais limitadas.

Por exemplo, se você tem uma tabela de clientes, você pode ter uma classe ou módulo clientes na sua aplicação e ao invés de escrever um INSERT para salvar um novo cliente na base, você usaria uma função ou método save/add ou equivalente. Assim, você estará manipulando o banco SQL sem precisar escrever SQL de fato, usando apenas a sua linguagem de programação favorita.

Outra coisa bacana de trabalhar com ORMs é que muitas vezes eles atuam com mais de um banco, facilitando portar o seu código para diferentes mecanismos de persistência ou até em cenários de persistência poliglota.

Em Node.js, o ORM mais popular é o Sequelize.

Sequelize

O Sequelize, segundo o site oficial, é um ORM para Node.js baseado em Promises, para os bancos PostgreSQL, MySQL, MariaDB, SQLite e MS SQL Server. Então se você não usa PostgreSQL mas usa qualquer um desses outros bancos aí, deve conseguir adaptar este tutorial para sua realidade.

Entre suas principais características estão o suporte a transações sólidas (ACID), relacionamentos, eager e lazy loading (carregamento adiantado ou tardio), replicação de leitura e muito mais.

Mas antes de começarmos a “brincar” com o Sequelize, você vai precisar de um banco PostgreSQL criado e com uma tabela modelada. Se você nunca programou com Node e Postgre antes, vou deixar abaixo um vídeo ensinando a instalação do ambiente.

Quando estiver com o ambiente pronto, pode criar o banco e tabela para nossa aplicação. No meu caso, eu tenho um banco chamado crud, recomendo que tenha um com um nome à sua escolha, mas não se preocupe em criar tabelas, o Sequelize vai cuidar disso pra gente.

Depois, crie uma aplicação Node.js na sua máquina com npm init e instale as dependências do Sequelize e do pg no seu package.json.

npm install sequelize pg

1	npm install sequelize pg

Agora crie um arquivo db.js na raiz do seu projeto para fazermos a primeira conexão com o banco de dados.

const Sequelize = require('sequelize');
const sequelize = new Sequelize('postgres://postgres@localhost:5432/crud', {dialect: 'postgres'});

module.exports = sequelize;

const Sequelize = require('sequelize');

const sequelize = new Sequelize('postgres://postgres@localhost:5432/crud', {dialect: 'postgres'});

module.exports = sequelize;

O código é bem direto, ele carrega a dependência do Sequelize, inicializa um novo objeto usando o construtor dele que espera a connection string e um objeto com opções para a conexão (dialeto do banco neste caso).

Não precisamos nos preocupar em explicitamente criar uma conexão aqui. Internamente o Sequelize vai gerenciar isso pra gente usando o conceito de connection pool, onde ele vai abrir e fechar diversas conexões conforme a necessidade, priorizando performance.

Model

O próximo passo é criar nosso model/modelo, um módulo que vai conter as informações do nosso mapeamento objeto-relacional, ou seja, o código JavaScript que vai representar uma tabela do banco de dados.

Note que esta tabela nem vai existir ainda, ela será criada pelo Sequelize quando necessário.

Crie um arquivo produto.js para inserir o código de definição do nosso modelo de produto, como abaixo. A recomendação é um nome no singular pois representa o schema para um produto, que usaremos várias vezes. O próprio Sequelize depois vai pluralizar este nome (funciona melhor com nomes em Inglês, então não se surpreenda se aparecer algum plural estranho).

const Sequelize = require('sequelize');
const database = require('./db');

const Produto = database.define('produto', {
    id: {
        type: Sequelize.INTEGER,
        autoIncrement: true,
        allowNull: false,
        primaryKey: true
    },
    nome: {
        type: Sequelize.STRING,
        allowNull: false
    },
    preco: {
        type: Sequelize.DOUBLE
    },
    descricao: Sequelize.STRING
})

module.exports = Produto;

const Sequelize = require('sequelize');

const database = require('./db');

const Produto = database.define('produto', {

id: {

type: Sequelize.INTEGER,

autoIncrement: true,

allowNull: false,

primaryKey: true

nome: {

type: Sequelize.STRING,

allowNull: false

preco: {

type: Sequelize.DOUBLE

descricao: Sequelize.STRING

})

module.exports = Produto;

O que o código acima faz é carregar a dependência do Sequelize para que possamos usar algumas constantes dele. Depois carrega a dependência do nosso banco de dados, que configuramos anteriormente.

Com essa dependência do banco de dados, vamos usar a function define para criar o schema da nossa tabela, sendo o primeiro parâmetro o nome que a mesma vai possuir. Resista à tentação de usar nomes diferentes, recomendo que modelo e tabela possuam o mesmo nome.

O segundo parâmetro é a definição do schema em si, onde temos campos e propriedades, bem autoexplicativas. Para o tipo de cada coluna/propriedade, usamos as constantes existentes no Sequelize (INTEGER, DOUBLE, etc), além dos modificadores como autoIncrement, allowNull, primaryKey, etc.

No fim, apenas exportamos este model, para que possamos utilizá-lo na nossa aplicação de fato.

Aplicação

O próximo passo é utilizar estes módulos que criamos de fato na nossa aplicação.

Como mencionei antes, o Sequelize vai fazer a gestão não apenas das conexões com o banco, como a criação das tabelas necessárias, se elas ainda não existirem.

Então em nosso index.js, a primeira coisa que vamos fazer é um sync do Sequelize com nosso banco de dados, para que as tabelas sejam mapeadas corretamente.

//index.js
(async () => {
    const database = require('./db');
    const Produto = require('./produto');

    try {
        const resultado = await database.sync();
        console.log(resultado);
    } catch (error) {
        console.log(error);
    }
})();

//index.js

(async () => {

const database = require('./db');

const Produto = require('./produto');

try {

const resultado = await database.sync();

console.log(resultado);

} catch (error) {

console.log(error);

}

})();

Aqui eu criei uma IIFE que será disparada assim que o index.js for chamado. Ela é necessária para que possamos usar async await neste módulo, funcionalidades mais modernas do JavaScript. Internamente ao IIFE o código não tem nada demais, eu carrego a dependência do nosso banco de dados e chamo a função sync, imprimindo no console o resultado ou o erro.

Essa função sync irá verificar se o seu model está batendo com o seu banco de dados. As tabelas que estiverem faltando, ele cria para você, quando necessário.

Quando você executar este index.js, vai ver como resultado um monte de código explicando o sync realizado. A menos que dê um erro, não tem nada demais aqui.

Create

Agora vamos iniciar nosso CRUD com o C de Create.

O Sequelize fornece algumas funções de inserção de dados, sendo a mais direta delas a create, que cria imediatamente o registro na tabela com o objeto passado por parâmetro (o código abaixo deve estar logo depois do sync).

const resultadoCreate = await Produto.create({
    nome: 'mouse',
    preco: 10,
    descricao: 'Um mouse USB bonitão'
})
console.log(resultadoCreate);

const resultadoCreate = await Produto.create({

nome: 'mouse',

preco: 10,

descricao: 'Um mouse USB bonitão'

})

console.log(resultadoCreate);

Ao rodar a aplicação agora você vai notar que no console vão aparecer sim algumas informações relevantes desta vez, como por exemplo o SQL que foi utilizado para criar a tabela (porque ela não existia) bem como o SQL do INSERT que foi gerado automaticamente para você.

Aí que está uma das vantagens de usar um ORM!

Note que além de pluralizar o nome da tabela ao criá-la, o Sequelize também adicionou campos de timestamp para data de criação de data de atualização, que ele mesmo vai gerenciar, automaticamente.

E esse foi mais um brinde de usar Sequelize! 😀

Se você olhar no seu banco de dados, verá que lá está uma tabela de produtos com este registro que acabamos de inserir.

E com isso fechamos o CREATE!

Read

Agora vamos fazer o R do CRUD, de Read/Retrieve!

Ele é ainda mais simples do que o Create, basta usarmos a função findAll disponibilizada pelo nosso objeto Produto, que teremos um array de produtos à nossa disposição.

const produtos = await Produto.findAll();
console.log(produtos);

1 2	const produtos = await Produto.findAll(); console.log(produtos);

Esta função findAll permite que a gente passe um objeto de opções por parâmetro para restringir os resultados da nossa consulta também, como mencionado na documentação oficial.

Outra opção, é usar a função findByPk para trazer apenas um produto baseado na chave-primária da tabela, ou seja, nosso id, como abaixo.

const produto = await Produto.findByPk(1);
console.log(produto)

1 2	const produto = await Produto.findByPk(1); console.log(produto)

E com isso, encerramos o R de Read/Retrieve!

Update

O próximo passo é atualizarmos um item da nossa tabela, o U do CRUD: Update!

Para atualizarmos um item, primeiro precisamos retorná-lo do banco de dados usando alguma função de find do Sequelize. No passo anterior, usamos a findByPk para retornar o produto com ID 1. Vamos escrever o nosso código de update imediatamente abaixo.

const produto = await Produto.findByPk(1);
//console.log(produto);
produto.nome = "Mouse Top";

const resultadoSave = await produto.save();
console.log(resultadoSave);

const produto = await Produto.findByPk(1);

//console.log(produto);

produto.nome = "Mouse Top";

const resultadoSave = await produto.save();

console.log(resultadoSave);

Note que alterei apenas o nome do produto retornado pelo findByPk e depois chamei uma função save que vai justamente montar e executar o Update considerando apenas os novos valores do objeto produto.

Como resultado, apenas imprimo no console e você verá o UPDATE construído, bem como se olhar na base de dados, verá a linha da tabela atualizada.

Com isso, fechamos nosso update!

Delete

E por fim, vamos ao D do CRUD, de DELETE!

Assim como para salvar e retornar dados existem diversas formas de fazer, para o Delete não é diferente. Você pode usar Produto.destroy e passar um where por parâmetro, ou então retornar um produto e usar a função destroy do próprio objeto retornado, você decide.

//assim
Produto.destroy({ where: { id: 1 }});

//ou assim
const produto = await Produto.findByPk(1);
produto.destroy();

//assim

Produto.destroy({ where: { id: 1 }});

//ou assim

const produto = await Produto.findByPk(1);

produto.destroy();

A esta altura, o trecho de código acima é bem autoexplicativo e ambos os trechos fazem exatamente a mesma coisa, embora o primeiro seja mais performático.

D do CRUD? Check!

E com isso finalizamos este tutorial em que você aprendeu como fazer um CRUD bem simples usando Node.js, Sequelize e PostgreSQL.

Tenho certeza que juntando com outros conhecimentos de Node.js vai lhe permitir construir aplicações de verdade.

Um abraço e até a próxima!

Quer aprender a construir aplicações profissionais usando Node.js, Sequelize, banco SQL e muito mais? Clica no banner abaixo e conheça meu curso!