O NestJS integra-se perfeitamente com bancos de dados via ORMs — mais comumente TypeORM (integração oficial @nestjs/typeorm) e Prisma (uma ORM moderna e type-safe usada via um serviço customizado). Ambos se encaixam na estrutura módulo/provider/DI do NestJS.
({
: [
.({
: ,
: process..,
: [],
: ,
}),
.([]),
],
})
{}
// 2. define an entity (maps to a table)
@Entity()
export class User {
@PrimaryGeneratedColumn() id: number;
@Column() name: string;
@Column({ unique: true }) email: string;
}
// 3. inject the repository into a service
@Injectable()
export class UsersService {
constructor(
@InjectRepository(User) private usersRepo: Repository<User>,
) {}
findAll() { return this.usersRepo.find(); }
findOne(id: number) { return this.usersRepo.findOneBy({ id }); }
create(data: Partial<User>) { return this.usersRepo.save(data); }
}
O TypeORM usa classes @Entity (mapeadas para tabelas) e Repositorys injetáveis para queries — encaixando-se naturalmente no modelo de DI do NestJS via @InjectRepository.
// 1. a PrismaService wraps the Prisma client (and manages connection lifecycle)
@Injectable()
export class PrismaService extends PrismaClient implements OnModuleInit {
async onModuleInit() { await this.$connect(); } // connect on startup
}
// 2. inject it and use the type-safe client
@Injectable()
export class UsersService {
constructor(private prisma: PrismaService) {}
findAll() { return this.prisma.user.findMany(); }
findOne(id: number) { return this.prisma.user.findUnique({ where: { id } }); }
create(data) { return this.prisma.user.create({ data }); }
}
O Prisma gera um cliente totalmente type-safe a partir de um arquivo de schema; você o envolve em um PrismaService injetável e o usa em seus serviços.
⚠️ NEVER use `synchronize: true` (TypeORM) in production — it auto-alters your schema
and can DROP data. Use MIGRATIONS (version-controlled schema changes) instead.
Prisma: prisma migrate dev/deploy manages schema changes via migration files.
TypeORM → repository/active-record patterns, decorators, mature, official Nest integration
Prisma → schema-first, excellent type safety, great DX, growing popularity
A integração com banco de dados é essencial — quase todo back-end persiste dados, e entender como conectar um banco de dados ao NestJS da forma idiomática é conhecimento prático fundamental.
Ambas as ORMs principais se encaixam na arquitetura do NestJS de forma limpa: TypeORM via o módulo oficial @nestjs/typeorm (configurando conexões, definindo classes @Entity, injetando Repositorys através de DI) e Prisma via um PrismaService injetável envolvido (oferecendo excelente type safety).
Saber como configurar a conexão, definir modelos e injetar a camada de acesso a dados em serviços — mantendo a lógica de banco de dados em serviços, separada dos controllers — é fundamental para construir aplicações NestJS reais.
Criticamente, entender o princípio migrations-sobre-synchronize (nunca fazer auto-sync do schema em produção, onde pode destruir dados, mas usar migrations controladas por versão) é uma prática importante de segurança em produção.
Este é material do dia a dia e imprescindível, já que a persistência de dados é central para o desenvolvimento back-end e a integração da ORM é como aplicações NestJS realmente armazenam e recuperam seus dados.