Comandos Básicos da CLI do Prisma

O Prisma é um ORM moderno para Node.js, projetado para facilitar o acesso ao banco de dados. Ele oferece uma CLI poderosa que permite gerenciar modelos, migrações e conexões ao banco de dados de forma eficiente. Neste post, vamos explorar os comandos básicos da CLI do Prisma para te ajudar a começar.

---

1. Inicializar o Prisma no Projeto

Para configurar o Prisma em seu projeto, use o comando:

npx prisma init

O que ele faz?

• Cria a pasta prisma/.
• Gera o arquivo schema.prisma, onde você define seus modelos e configurações de banco de dados.

---

2. Criar Migrações

Depois de configurar seus modelos no arquivo schema.prisma, você pode criar migrações com:

npx prisma migrate dev --name <nome-da-migracao>

Parâmetros:

• -name <nome-da-migracao>: Adicione um nome descritivo para a migração.

O que ele faz?

• Cria um arquivo de migração em prisma/migrations/.
• Aplica as alterações no banco de dados.

---

3. Sincronizar o Banco sem Migrações

Se você não deseja usar migrações, pode sincronizar o banco com o modelo:

npx prisma db push

O que ele faz?

• Atualiza o banco de dados com base no schema.prisma.
• Não cria histórico de alterações (ideal para protótipos).

---

4. Gerar Cliente Prisma

Para usar o Prisma no código, você precisa gerar o cliente:

npx prisma generate

O que ele faz?

• Gera a pasta node_modules/@prisma/client, que contém o cliente Prisma para ser usado no projeto.

Exemplo de uso no código:

import { PrismaClient } from '@prisma/client'
const prisma = new PrismaClient();

---

5. Verificar Conexão com o Banco

Para testar a conexão com o banco definido no schema.prisma:

npx prisma db pull

O que ele faz?

• Conecta ao banco de dados e atualiza o schema.prisma com as tabelas existentes.

---

6. Abrir o Prisma Studio

O Prisma Studio é uma interface gráfica para visualizar e editar dados diretamente:

npx prisma studio

O que ele faz?

• Abre uma interface no navegador para manipular registros no banco de dados.

---

7. Checar a Versão do Prisma

Para verificar a versão instalada da CLI do Prisma:

npx prisma -v

---

Resumo dos Comandos

Comando	Descrição
npx prisma init	Inicializa o Prisma no projeto.
npx prisma migrate dev	Cria e aplica migrações no banco.
npx prisma db push	Sincroniza o banco sem criar migrações.
npx prisma generate	Gera o cliente Prisma.
npx prisma db pull	Atualiza o schema.prisma com o banco.
npx prisma studio	Abre a interface gráfica do Prisma Studio.
npx prisma -v	Mostra a versão da CLI do Prisma.