10.5.2 INSERT - Adicionando Novos Agentes

Fala, comandante! Agora que você já domina o SELECT e sabe buscar dados com precisão cirúrgica, chegou a hora de começar a preencher seu QG com agentes. Um quartel vazio não cumpre missão, né?

Pra isso, apresento o nosso novo aliado: o poderoso INSERT INTO! Ele é o responsável por inserir novas linhas nas tabelas — ou seja, recrutar agentes para nossa força-tarefa.

---

🎯 Missão: Cadastrar um Novo Recruta

O comando INSERT INTO segue três passos básicos:

1. Escolha a tabela onde os dados vão entrar.

2. Liste as colunas que receberão os valores.

3. Forneça os valores, na ordem certinha.

🔍 Modelo Geral:

INSERT INTO nome_da_tabela (coluna1, coluna2, coluna3)
VALUES (valor1, valor2, valor3);

🧠 Como Funciona:

• INSERT INTO: Diz onde inserir.

• (coluna1, coluna2, ...): Lista as colunas-alvo.

• VALUES: Introduz os valores.

• (valor1, valor2, ...): Os dados que vão preencher as colunas.

• ;: Fim do comando. Missão concluída.

---

📏 Regras de Ouro do INSERT

1. Ordem é essencial: Os valores devem estar na mesma ordem das colunas.

2. Tipos de dados importam: Texto entre aspas ('texto'), números sem aspas, datas no formato 'YYYY-MM-DD'.

3. Colunas obrigatórias (NOT NULL) precisam de valor.

4. Chave Primária (PK):

   • Se for uuid com valor padrão ou serial, o Supabase gera sozinho.

   • Nesse caso, você não precisa (nem deve) passar id no INSERT.

5. Chave Estrangeira (FK):

   • Forneça um valor válido da outra tabela.

   • Exemplo: ao cadastrar um post, o usuario_id tem que ser real.

---

🧪 Exemplo 1: Cadastrando a Agente Ana

Tabela: usuarios Suponha que o Supabase gera o id automaticamente.

INSERT INTO usuarios (nome, email, data_nascimento, cidade)
VALUES ('Ana Lima', '[e-mail]', '2008-03-08', 'Salvador');

✅ Resultado: Uma nova linha com os dados da Ana é criada.

📌 Para verificar:

SELECT * FROM usuarios WHERE nome = 'Ana Lima';

---

🧪 Exemplo 2: A Missão da Ana (Adicionando um Post)

Vamos usar o id que encontramos da Ana e cadastrá-la como autora de um post:

INSERT INTO posts (texto_do_post, data_publicacao, usuario_id, numero_likes)
VALUES (
  'Cheguei na área! #SupabaseRocks',
  '2025-06-03 18:00:00',
  'b2c3d4e5-67ef-8901-2345-6789abcdef01',
  0
);

🧠 Aqui:

• texto_do_post: O que a Ana escreveu.

• data_publicacao: Quando foi postado.

• usuario_id: O id da Ana.

• numero_likes: Começando com zero curtidas.

---

🧑‍🤝‍🧑 Múltiplos Agentes em Missão

Dá pra inserir vários usuários de uma vez:

INSERT INTO usuarios (nome, email, data_nascimento, cidade)
VALUES
  ('Pedro Costa', '[e-mail]', '2006-09-12', 'Belo Horizonte'),
  ('Sofia Alves', '[e-mail]', '2007-01-30', 'Curitiba'),
  ('Lucas Martins', '[e-mail]', '2005-07-25', 'Recife');

📦 Resultado: Três novos recrutas de uma só vez!

---

🖥️ E Pela Interface Supabase?

Prefere o visual? Tudo bem!

1. Vá em Table Editor.

2. Clique na tabela desejada.

3. Aperte "Insert row".

4. Preencha os dados no formulário.

5. Clique em "Save".

Ideal pra inserir poucos dados manualmente. Mas aprender o INSERT INTO no SQL te dá muito mais autonomia — e controle de verdadeiros mestres!

---

🎉 Missão Cumprida! Agora você já domina o recrutamento no seu banco de dados. Com SELECT e INSERT, você lê e escreve dados.