Parte 3: Integrando com o banco de dados#

Na maioria das aplicações Web é necessário persistir algum tipo de dado. A forma mais utilizada para implementar persistência de dados em aplicações Web é através de banco de dados. Um banco de dados serve para que informações relevantes para a sua aplicação possam ser registradas e armazenadas de maneira segura, organizada e padronizada.

Existem diversos bancos de dados disponíveis no mercado (SQLite, PostgreSQL, MySQL, entre outros). O framework Django permite a integração da sua aplicação com qualquer um dos bancos citados acima. No entanto, neste handout vamos conectar a nossa aplicação com o SQLLite.

Abra o arquivo getit/settings.py. Procure o seguinte trecho de código:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

Neste dicionário está configurando o SQLite como o banco de dados da aplicação (será criado um banco de dados no arquivo db.sqlite3 dentro da pasta principal do seu projeto). Se você quiser utilizar outro banco de dados, basta instalar as bibliotecas necessárias (em geral disponíveis para ser instaladas via pip install) e modificar os itens desse dicionário. Se quiser saber mais, consulte a documentação do Django.

Já que estamos no arquivo de configuração, aproveite para procurar pela lista INSTALLED_APPS. Ela deve ser parecida com essa:

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
]

Na parte 2 comentamos que um projeto é composto por múltiplos apps, que são partes de um sistema. A lista INSTALLED_APPS define os nomes dos apps utilizados pelo seu projeto. Por exemplo, há um app que é responsável por gerenciar arquivos estáticos (imagens, css, javascript, etc.), outro responsável pela autenticação (usuário, senha, mudança de senha) e assim por diante.

Nós já criamos um app para o nosso projeto, o notes. Vamos adicioná-lo na lista de apps nas configurações.

Como vimos, o nosso projeto já tem diversos apps instalados. Vários desses apps utilizam o banco de dados para armazenar pelo menos uma tabela. Para que essas tabelas sejam criadas vamos utilizar o comando (no terminal):

python manage.py migrate

Criando seus próprios modelos#

Começamos esta parte do handout comentando que o Django já tem uma integração com o banco de dados. Para isso nós precisamos criar classes do Python para representar os nossos modelos, cujos dados serão armazenados em tabelas nos bancos de dados relacionais. Vamos criar o nosso primeiro modelo.

from django.db import models


class Note(models.Model):
    title = models.CharField(max_length=200)

Nós acabamos de executar o comando python manage.py migrate para criar as tabelas dos apps no banco de dados. Como o nosso app notes também está entre os INSTALLED_APPS, esse mesmo comando também vai criar a tabela do modelo Note.

Antes disso, precisamos pedir para o Django criar as migrações. Uma migração é a forma do Django armazenar modificações no banco de dados (criação de novas tabelas, por exemplo). Para isso, execute o comando

python manage.py makemigrations

Seguido por

python manage.py migrate

O primeiro comando criou o script de criação da tabela que armazenará as anotações. O segundo comando aplicou esse script, efetivamente criando a tabela no banco de dados.

Ok, nós criamos o banco de dados, mas como eu adiciono dados nele e vejo o que está armazenado? Boa pergunta! Siga para a parte 4!