Consultando o Banco de Dados com Sequelize no Node.js

Vamos aprender a realizar operações básicas com dados usando o exemplo de modelo do último tema:

const Sequelize = require("sequelize");
const sequelize = new Sequelize({
    dialect: "sqlite",
    storage: "programicio.db",
    define: {
        timestamps: false
    }
});

const User = sequelize.define("user", {
  id: {
    type: Sequelize.INTEGER,
    autoIncrement: true,
    primaryKey: true,
    allowNull: false
  },
  name: {
    type: Sequelize.STRING,
    allowNull: false
  },
  age: {
    type: Sequelize.INTEGER,
    allowNull: false
  }
});

Adicionando Dados

Para adicionar dados ao banco, utiliza-se o método create() do modelo, ao qual se passa o objeto a ser inserido:

User.create({
  name: "Tom",
  age: 35
}).then(res => {
  console.log(res);
}).catch(err => console.log(err));

Como podemos observar, as propriedades do objeto passado ao método create correspondem às propriedades do modelo User, com exceção do atributo id, que é gerado pelo banco de dados.

Após a operação de inserção, podemos acessar o objeto adicionado, incluindo seu id gerado pelo banco de dados:

User.create({
  name: "Bob",
  age: 31
}).then(res => {
  const user = {id: res.id, name: res.name, age: res.age};
  console.log(user);
}).catch(err => console.log(err));

Obtendo Dados

Para obter todos os dados, utiliza-se o método findAll():

User.findAll({raw: true}).then(users => {
  console.log(users);
}).catch(err => console.log(err));

Neste exemplo, o método recebe um objeto opcional {raw: true}, que permite obter diretamente os dados do banco no formato de objetos sem metadados adicionais. Por exemplo, a saída no console pode ser a seguinte:

[ 
  { id: 1, name: 'Tom', age: 35 },
  { id: 2, name: 'Bob', age: 31 } 
]

Filtro Simples

Para aplicar filtros em consultas (assim como em operações de atualização e remoção), usa-se o operador where, que especifica o critério de filtro. Por exemplo, vamos selecionar todos os usuários do banco cujo nome seja "Tom":

User.findAll({where: {name: "Tom"}, raw: true})
.then(users => {
  console.log(users);
}).catch(err => console.log(err));

A saída no console será:

Obtendo um Único Objeto

Frequentemente, precisamos obter apenas um objeto do banco de dados. Nesse caso, podemos usar métodos como findByPk() (obtém o objeto pela chave primária) e findOne() (obtém um objeto que corresponde a um critério específico). Por exemplo, vamos buscar o usuário com id=2:

User.findByPk(2)
.then(user => {
    if(!user) return; // se o usuário não for encontrado
    console.log(user.name);
}).catch(err => console.log(err));

Ou podemos buscar um usuário com o nome "Tom":

User.findOne({where: {name: "Tom"}})
.then(user => {
    if(!user) return;
    console.log(user.name, user.age);
}).catch(err => console.log(err));

Atualizando Dados

Para atualizar dados, utiliza-se o método update(), ao qual se passa um objeto com os novos valores e um objeto critério para seleção dos objetos a serem atualizados:

User.update({ age: 36 }, {
  where: {
    name: "Bob"
  }
}).then((res) => {
  console.log(res);
});

Neste caso, o primeiro objeto indica que todos os objetos selecionados terão o campo age atualizado para o valor 36. O segundo objeto especifica o critério de seleção: somente os objetos com name="Bob" serão atualizados.

Removendo Dados

Para remover dados, utiliza-se o método destroy(), ao qual se passa um objeto critério para seleção dos objetos a serem deletados:

User.destroy({
  where: {
    name: "Bob"
  }
}).then((res) => {
  console.log(res);
});

Neste exemplo, serão removidos os objetos cujo name seja "Bob".