DS & II

Capítulo 15 - O Arquivo X de Dados

Leitura de 5 min

🚀 Capítulo 15: O Arquivo X de Dados (Tema: Arquivo X)

NOTE

Este capítulo utiliza a temática de Arquivo X para explicar o uso de Bancos de Dados com o GORM em Go. Guarde as informações da sua API em arquivos permanentes!

1. 🎯 Objetivo da Aula

Compreender o conceito de um ORM (Object-Relational Mapping), conhecer a biblioteca GORM do Go e aprender como conectar a API a um banco de dados e fazer operações básicas (CRUD).

2. 🏢 O Cenário Prático (Seu Desafio)

Na famosa série de suspense Arquivo X, os agentes do FBI Mulder e Scully investigam casos misteriosos e paranormais. Todas as pistas, depoimentos de testemunhas e fotos de discos voadores que eles coletam são guardados em pastas físicas dentro de grandes arquivos de metal na delegacia. Para resolver um caso novo, eles precisam ir até o arquivo, buscar a pasta certa, ler os dados e, às vezes, atualizar a pasta com novas pistas.

No mundo das APIs reais, nós não podemos guardar as informações apenas na memória RAM do computador (em variáveis). Se o servidor reiniciar, tudo some! Nós precisamos guardar os dados em um Banco de Dados!

  • E para não precisarmos escrever comandos complexos e gigantescos de linguagem SQL na mão, o Go possui uma ferramenta incrível chamada GORM (um ORM).
  • O GORM é o arquivista perfeito: ele pega as nossas Structs do Go e as transforma automaticamente em tabelas no banco de dados! Seu desafio é arquivar os dados!

🧠 Fundamentos: A Teoria Traduzida

🗄️ 1. O que é um ORM?

Significa Object-Relational Mapping (Mapeamento Objeto-Relacional). É uma biblioteca que serve de ponte entre o mundo do Go (onde usamos Structs) e o mundo do Banco de Dados (onde usamos tabelas e SQL).

🏆 2. Apresentando o GORM:

O GORM é o ORM mais famoso e utilizado na comunidade Go. Ele faz coisas incríveis por nós:

  1. Auto-Migração: Ele lê a sua Struct em Go e cria a tabela no banco de dados sozinho, sem você precisar digitar nenhum comando SQL!
  2. Operações Simples: Em vez de digitar SELECT * FROM produtos WHERE id = 1, você digita apenas db.First(&produto, 1). O GORM traduz tudo para nós!
graph LR
    A[Struct Go] -->|GORM| B[(Banco de Dados)]
    B -->|GORM| A

📥 3. Como instalar o GORM:

Você precisa instalar o coração do GORM e o “driver” do banco de dados que você vai usar (neste exemplo, usaremos o SQLite, que salva tudo em um arquivo simples no seu computador):

go get -u gorm.io/gorm
go get -u gorm.io/driver/sqlite

4. 📖 Exemplo Guiado: Criando a Tabela do Arquivo X

Veja como é simples conectar e salvar um dado no banco usando GORM:

package main
 
import (
    "gorm.io/driver/sqlite"
    "gorm.io/gorm"
)
 
// O GORM usa essa struct para criar a tabela!
type Caso struct {
    gorm.Model        // Adiciona campos automáticos como ID e Data de criação
    Titulo    string
    Descricao string
}
 
func main() {
    // 1. Conecta ao banco de dados (cria o arquivo arquivo_x.db)
    db, _ := gorm.Open(sqlite.Open("arquivo_x.db"), &gorm.Config{})
 
    // 2. Cria a tabela "casos" automaticamente!
    db.AutoMigrate(&Caso{})
 
    // 3. Cria e salva um novo caso no banco de dados
    novoCaso := Caso{Titulo: "O ET de Varginha", Descricao: "Luzes estranhas no céu."}
    db.Create(&novoCaso)
}

5. 🛠️ Prática Obrigatória 1: O papel do ORM

Com base no texto:

  1. Qual é a principal facilidade que uma ferramenta de ORM (como o GORM) traz para o programador de Go quando ele precisa mexer com banco de dados?

6. 🛠️ Prática Obrigatória 2: Auto-Migração

  1. O que faz o comando db.AutoMigrate(&Caso{}) no exemplo acima? O que acontece no banco de dados quando essa linha é executada?

7. 📤 Instruções de Entrega (GitHub Desktop + Microsoft Teams)

  1. Faça o Commit: No GitHub Desktop, digite a mensagem (ex: Finaliza Capítulo 15 Go_ArquivoX) e clique em Commit to main.
  2. Envie para a Nuvem (Push): Clique em Push origin.

8. 📂 Estrutura de Pastas

spec_backend_com_golang_e_gin/
├── capitulos/
│   └── capitulo_15_arquivo_x.md

💡 Checkpoint de Lógica

O comando gorm.Model que colocamos dentro da Struct adiciona automaticamente quatro campos muito importantes: ID (chave primária), CreatedAt (data de criação), UpdatedAt (data de atualização) e DeletedAt (data de exclusão)!

10. 🔥 Desafio de Fixação

Pesquise como fazer uma busca por um registro específico usando o GORM (Dica: procure pelo método db.Where).

🔑 Gabarito de Código/Fórmulas

Gabarito da Prática 1:

  1. Ele evita que o programador precise escrever código SQL na mão. O ORM permite que o programador manipule o banco de dados usando apenas as Structs e funções nativas do Go, tornando o desenvolvimento muito mais rápido e menos propenso a erros de digitação de comandos SQL! Gabarito da Prática 2:
  2. Ele lê a estrutura da Struct Caso e cria automaticamente a tabela física no banco de dados com as colunas certas (ID, Titulo, Descricao). Se a tabela já existir, ele apenas atualiza ela se você tiver adicionado campos novos!

← Capitulo Anterior | Proximo Capitulo →

Visão de gráfico

Backlinks