{"title":"Escrevendo sua primeira aplicação Django, parte 2","version":"2.2","locale":"pt-br","docname":"intro/tutorial02","url":"/pt-br/2.2/intro/tutorial02/","canonical":"https://djangodocs.dev/pt-br/2.2/intro/tutorial02/","summary":"Este tutorial inicia onde Tutorial 1 termina. Iremos configurar um banco de dados, criar seu primeiro modelo, e ter uma rápida introdução ao admin site do…","html":"

Escrevendo sua primeira aplicação Django, parte 2Link para este cabeçalho#

\n

Este tutorial inicia onde Tutorial 1 termina. Iremos configurar um banco de dados, criar seu primeiro modelo, e ter uma rápida introdução ao admin site do Django automaticamente gerado.

\n
\n

Configuração do banco de dadosLink para este cabeçalho#

\n

Agora, abra o mysite/settings.py. Ele é um módulo normal do Python com variáveis de módulo representando as configurações do Django.

\n

Por padrão, a configuração usa o SQLite. Se você é novo com banco de dados, ou se estiver somente interessado em experimentar o Django, esta á maneira mais simples. SQLite está incluso no Python, de modo que você não precisa instalar nada a mais para ter o banco de dados. Contudo, quando iniciar seu primeiro projeto real, talvez queira usar um banco de dados mais escalável como o PostgreSQL, para evitar problemas com a troca do banco de dados no caminho.

\n

Se você quiser usar outro banco de dados, instale o de acordo database bindings e altere os seguinte parâmetros no item DATABASES 'default' de acordo com o seu banco de dados.

\n\n

Caso não use o SQLite como banco de dados, configurações adicionais como USER, PASSWORD, e HOST deverão ser adicionadas. Para mais detalhes, veja a referência na documentação para DATABASES.

\n\n

Enquanto estiver editando mysite/settings.py, mude TIME_ZONE para o seu fuso horário.

\n

Também observe a configuração do\nINSTALLED_APPS na parte superior do arquivo. Ela possui os nomes de todas as aplicações Django ativas para essa instância do Django. Aplicações podem ser usadas em múltiplos projetos, e você pode empacotá-las e distribuí-las para uso por outros em seus projetos.

\n

Por padrão, o INSTALLED_APPS contém as seguintes aplicações, que vêm com o Django:

\n\n

Estas aplicações são incluídas por padrão como uma conveniência para o caso comum.

\n

Algumas dessas aplicações fazem uso de pelo menos uma tabela no banco de dados, assim sendo, nós precisamos criar as tabelas no banco de dados antes que possamos\nutilizá-las. Para isso rode o seguinte comando:

\n

Linux / macOS

Shell
$ python manage.py migrate\n
\n

Windows

Windows
...\\> py manage.py migrate\n
\n

O comando migrate verifica a configuração em INSTALLED_APPS e cria qualquer tabela do banco de dados necessária de acordo com as configurações do banco de dados no seu arquivo mysite/settings.py e as migrações que venham com a app (cobriremos isso mais tarde). É mostrado uma mensagem para cada migração que foi aplicada. Se lhe interessar, execute cliente de linha de comando para seu banco de dados e dgite \\dt (PostgreSQL), SHOW TABLES; (MySQL), .schema (SQLite), ou SELECT TABLE_NAME FROM USER_TABLES; (Oracle) para mostrar as tabelas mostradas pelo Django.

\n\n
\n
\n

Criando modelosLink para este cabeçalho#

\n

Agora vamos definir seus modelos – essencialmente, o layout do banco de dados, com metadados adicionais.

\n\n

Em nossa simples aplicação de enquete, nós iremos criar dois modelos: Question e Choice. Uma Question tem uma pergunta e uma data de publicação. Uma Choice tem dois campos: o texto da escolha e um totalizador de votos. Cada Choice é associada a uma Question.

\n

Esses conceitos são representados por simples classes Python. Edite o arquivo polls/models.py de modo que fique assim:

\n
polls/models.py
\n
Python
from django.db import models\n\n\nclass Question(models.Model):\n    question_text = models.CharField(max_length=200)\n    pub_date = models.DateTimeField('date published')\n\n\nclass Choice(models.Model):\n    question = models.ForeignKey(Question, on_delete=models.CASCADE)\n    choice_text = models.CharField(max_length=200)\n    votes = models.IntegerField(default=0)\n
\n

O código é auto-explicativo. Cada model é representado por uma classe derivada da classe django.db.models.Model. Cada model possui um número de atributos de classe, as quais por sua vez representam campos de banco de dados no model.

\n

Cada campo é representado por uma instância de uma classe Field – e.g., CharField para campos do tipo caractere e DateTimeField para\ndata/hora. Isto diz ao Django qual tipo de dado cada campo contém.

\n

O nome de cada instância Field (e.g. question_text ou pub_date) é o nome do campo, em formato amigável para a máquina. Você irá usar este valor no seu código Python, e seu banco de dados irá usá-lo como nome de coluna.

\n

Você pode usar um argumento opcional na primeira posição de um Field para designar um nome legível por seres humanos o qual será usado em uma série de partes introspectivas do Django, e também servirá como documentação. Se esse argumento não for fornecido, o Django utilizará o nome legível pela máquina. Neste exemplo nós definimos um nome legível por humanos apenas para Question.pub_date. Para todos os outros campos neste model, o nome legível pela máquina será utilizado como nome legível por humanos.

\n

Algumas classes de Field possuem elementos obrigatórios. O CharField, por exemplo, requer que você informe a ele um max_length que é usado não apenas no esquema do banco de dados, mas na validação, como nós veremos em breve.

\n

Um Field pode ter varios argumentos opcionais; neste caso, nos definimos default o valor de votes para 0.

\n

Finalmente, note que uma relação foi criada, usando ForeignKey. Isso dia ao Django que cada Choice está relacionada a uma única Question. O Django suporta todos os relacionamentos comuns de um banco de dados: muitos-para-um, muitos-para-muitos e um-para-um

\n
\n
\n

Ativando modelosLink para este cabeçalho#

\n

Aquela pequena parte do model fornece ao Django muita informação. Com ela o Django é capaz de:

\n\n

Mas primeiro nós precisamos dizer ao nosso projeto que a aplicação polls está instalada.

\n\n

Para incluir a aplicação no nosso projeto, precisamos adicionar a referência à classe de configuração da aplicação na definição do INSTALLED_APPS . A classe PollsConfig``está no arquivo  :file:`polls/apps.py`, então seu caminha pontuado é ``'polls.apps.PollsConfig'. Edite o arquivo mysite/settings.py e adicione aquele caminho com notação de ponto a definição do INSTALLED_APPS. Ficará parecido como aqui:

\n
mysite/settings.py
\n
Python
INSTALLED_APPS = [\n    'polls.apps.PollsConfig',\n    'django.contrib.admin',\n    'django.contrib.auth',\n    'django.contrib.contenttypes',\n    'django.contrib.sessions',\n    'django.contrib.messages',\n    'django.contrib.staticfiles',\n]\n
\n

Agora o Django sabe que deve incluir a aplicação polls. Vamos rodar outro comando:

\n

Linux / macOS

Shell
$ python manage.py makemigrations polls\n
\n

Windows

Windows
...\\> py manage.py makemigrations polls\n
\n

Você deverá ver algo similar ao seguinte:

\n
Text
Migrations for 'polls':\n  polls/migrations/0001_initial.py:\n    - Create model Choice\n    - Create model Question\n    - Add field question to choice\n
\n

Ao executar makemigrations, você está dizendo Django que você fez algumas mudanças em seus modelos (neste caso, você fez novas modificações) e que você gostaria que as alterações sejam armazenadas como uma migração.

\n

As migrações são como o Django armazena as alterações nos seus modelos (e, portanto, seu esquema de banco de dados) - eles são apenas arquivos no disco. Você pode ler a migração para o novo modelo, se quiser; é o arquivo polls/migrations/0001_initial.py. Não se preocupe, você não precisa lê-los cada vez Django cria um, mas eles são projetados para ser editável no caso de você queira ajustar manualmente como Django muda as coisas.

\n

Existe um comando que vai rodar as migrações para você e gerenciar o esquema do banco de dados automaticamente - que é chamado migrate, e nós vamos chegar a ele em um momento - mas primeiro vamos ver qual SQL está migração vai rodar. O comando sqlmigrate recebe o nome da migração e o seu SQL.

\n

Linux / macOS

Shell
$ python manage.py sqlmigrate polls 0001\n
\n

Windows

Windows
...\\> py manage.py sqlmigrate polls 0001\n
\n

Você deve ver algo semelhante ao seguinte (reformatamos para facilitar a leitura):

\n
SQL
BEGIN;\n--\n-- Create model Choice\n--\nCREATE TABLE "polls_choice" (\n    "id" serial NOT NULL PRIMARY KEY,\n    "choice_text" varchar(200) NOT NULL,\n    "votes" integer NOT NULL\n);\n--\n-- Create model Question\n--\nCREATE TABLE "polls_question" (\n    "id" serial NOT NULL PRIMARY KEY,\n    "question_text" varchar(200) NOT NULL,\n    "pub_date" timestamp with time zone NOT NULL\n);\n--\n-- Add field question to choice\n--\nALTER TABLE "polls_choice" ADD COLUMN "question_id" integer NOT NULL;\nALTER TABLE "polls_choice" ALTER COLUMN "question_id" DROP DEFAULT;\nCREATE INDEX "polls_choice_7aa0f6ee" ON "polls_choice" ("question_id");\nALTER TABLE "polls_choice"\n  ADD CONSTRAINT "polls_choice_question_id_246c99a640fbbd72_fk_polls_question_id"\n    FOREIGN KEY ("question_id")\n    REFERENCES "polls_question" ("id")\n    DEFERRABLE INITIALLY DEFERRED;\n\nCOMMIT;\n
\n

Note o seguinte:

\n\n

Se você tiver interesse, você pode rodar python manage.py check; Ele checa por problemas no seu projeto sem criar migrations ou tocar seu banco de dados.

\n

Agora rode o migrate novamente para criar essas tabelas dos modelos no seu banco de dados:

\n

Linux / macOS

Shell
$ python manage.py migrate\nOperations to perform:\n  Apply all migrations: admin, auth, contenttypes, polls, sessions\nRunning migrations:\n  Rendering model states... DONE\n  Applying polls.0001_initial... OK\n
\n

Windows

Windows
...\\> py manage.py migrate\nOperations to perform:\n  Apply all migrations: admin, auth, contenttypes, polls, sessions\nRunning migrations:\n  Rendering model states... DONE\n  Applying polls.0001_initial... OK\n
\n

O comando migrate pega todas as migrações que ainda não foram aplicadas (Django rastreia quais foram aplicadas usando uma tabela especial em seu banco de dados chamada django_migrations) e aplica elas contra seu banco de dados - essencialmente, sincronizando as alterações feitas aos seus modelos com o esquema no banco de dados.

\n

Migrações são muito poderosas e permitem que você altere seus modelos ao longo do tempo, à medida que desenvolve o seu projeto, sem a necessidade de remover o seu banco de dados ou tabelas e criar de novo - ele é especializado em atualizar seu banco de dados ao vivo, sem perda de dados. Nós vamos cobri-los com mais profundidade em uma parte posterior do tutorial, mas para agora, lembre-se deste guia de três passos para fazer mudanças nos seus modelos:

\n\n

The reason that there are separate commands to make and apply migrations is\nbecause you’ll commit migrations to your version control system and ship them\nwith your app; they not only make your development easier, they’re also\nusable by other developers and in production.

\n

Leia a documentação do django-admin para informações completas sobre o que o utilitário manage.py pode fazer.

\n
\n
\n

Brincando com a APILink para este cabeçalho#

\n

Agora vamos dar uma passada no shell interativo do Python e brincar um pouco com a API livre que o Django dá a você. Para invocar o shell do Python, use esse comando:

\n

Linux / macOS

Shell
$ python manage.py shell\n
\n

Windows

Windows
...\\> py manage.py shell\n
\n

Nós usaremos isso em vez de simplesmente digitar “python”, porque o manage.py configura a variável de ambiente DJANGO_SETTINGS_MODULE, O que da ao Django o caminho de importação Python do arquivo mysite/settings.py.

\n

Assim que você estiver no shell, explore a API de banco de dados:

\n
Code
>>> from polls.models import Choice, Question  # Import the model classes we just wrote.\n\n# No questions are in the system yet.\n>>> Question.objects.all()\n<QuerySet []>\n\n# Create a new Question.\n# Support for time zones is enabled in the default settings file, so\n# Django expects a datetime with tzinfo for pub_date. Use timezone.now()\n# instead of datetime.datetime.now() and it will do the right thing.\n>>> from django.utils import timezone\n>>> q = Question(question_text="What's new?", pub_date=timezone.now())\n\n# Save the object into the database. You have to call save() explicitly.\n>>> q.save()\n\n# Now it has an ID.\n>>> q.id\n1\n\n# Access model field values via Python attributes.\n>>> q.question_text\n"What's new?"\n>>> q.pub_date\ndatetime.datetime(2012, 2, 26, 13, 0, 0, 775217, tzinfo=<UTC>)\n\n# Change values by changing the attributes, then calling save().\n>>> q.question_text = "What's up?"\n>>> q.save()\n\n# objects.all() displays all the questions in the database.\n>>> Question.objects.all()\n<QuerySet [<Question: Question object (1)>]>\n
\n

Wait a minute. <Question: Question object (1)> isn’t a helpful\nrepresentation of this object. Let’s fix that by editing the Question model\n(in the polls/models.py file) and adding a\n__str__() method to both Question and\nChoice:

\n
polls/models.py
\n
Python
from django.db import models\n\nclass Question(models.Model):\n    # ...\n    def __str__(self):\n        return self.question_text\n\nclass Choice(models.Model):\n    # ...\n    def __str__(self):\n        return self.choice_text\n
\n

É importante adicionar métodos __str__() aos seus models, não apenas para sua própria conveniência quando estiver lidando com o prompt interativo, mas também porque representações de objetos são usadas por todo projeto gerado automaticamente pelo Django.

\n

Vamos também adicionar um método personalizado a este modelo:

\n
polls/models.py
\n
Python
import datetime\n\nfrom django.db import models\nfrom django.utils import timezone\n\n\nclass Question(models.Model):\n    # ...\n    def was_published_recently(self):\n        return self.pub_date >= timezone.now() - datetime.timedelta(days=1)\n
\n

Note a adição de import datetime e from django.utils import timezone, para referenciar o módulo padrão do Python datetime e o modulo Django utilitário de fuso horário django.utils.timezone, respectivamente. Se você não é familiar com o gerenciamento de fuso horário no Python, você pode aprender mais no documentação de suporte a fuso horários.

\n

Salve essas mudanças e vamos iniciar uma nova sessão do shell interativo do Python rodando python manage.py shell novamente:

\n
Code
>>> from polls.models import Choice, Question\n\n# Make sure our __str__() addition worked.\n>>> Question.objects.all()\n<QuerySet [<Question: What's up?>]>\n\n# Django provides a rich database lookup API that's entirely driven by\n# keyword arguments.\n>>> Question.objects.filter(id=1)\n<QuerySet [<Question: What's up?>]>\n>>> Question.objects.filter(question_text__startswith='What')\n<QuerySet [<Question: What's up?>]>\n\n# Get the question that was published this year.\n>>> from django.utils import timezone\n>>> current_year = timezone.now().year\n>>> Question.objects.get(pub_date__year=current_year)\n<Question: What's up?>\n\n# Request an ID that doesn't exist, this will raise an exception.\n>>> Question.objects.get(id=2)\nTraceback (most recent call last):\n    ...\nDoesNotExist: Question matching query does not exist.\n\n# Lookup by a primary key is the most common case, so Django provides a\n# shortcut for primary-key exact lookups.\n# The following is identical to Question.objects.get(id=1).\n>>> Question.objects.get(pk=1)\n<Question: What's up?>\n\n# Make sure our custom method worked.\n>>> q = Question.objects.get(pk=1)\n>>> q.was_published_recently()\nTrue\n\n# Give the Question a couple of Choices. The create call constructs a new\n# Choice object, does the INSERT statement, adds the choice to the set\n# of available choices and returns the new Choice object. Django creates\n# a set to hold the "other side" of a ForeignKey relation\n# (e.g. a question's choice) which can be accessed via the API.\n>>> q = Question.objects.get(pk=1)\n\n# Display any choices from the related object set -- none so far.\n>>> q.choice_set.all()\n<QuerySet []>\n\n# Create three choices.\n>>> q.choice_set.create(choice_text='Not much', votes=0)\n<Choice: Not much>\n>>> q.choice_set.create(choice_text='The sky', votes=0)\n<Choice: The sky>\n>>> c = q.choice_set.create(choice_text='Just hacking again', votes=0)\n\n# Choice objects have API access to their related Question objects.\n>>> c.question\n<Question: What's up?>\n\n# And vice versa: Question objects get access to Choice objects.\n>>> q.choice_set.all()\n<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>\n>>> q.choice_set.count()\n3\n\n# The API automatically follows relationships as far as you need.\n# Use double underscores to separate relationships.\n# This works as many levels deep as you want; there's no limit.\n# Find all Choices for any question whose pub_date is in this year\n# (reusing the 'current_year' variable we created above).\n>>> Choice.objects.filter(question__pub_date__year=current_year)\n<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>\n\n# Let's delete one of the choices. Use delete() for that.\n>>> c = q.choice_set.filter(choice_text__startswith='Just hacking')\n>>> c.delete()\n
\n

Para mais informações sobre relacionamento de modelos, veja Acessando objetos relacionados. Para mais informação em como usar sublinhados duplos para pesquisa usando campos da API, veja Pesquisa com campos. Para um detalhamento completo da API de banco de dados, veja nossa referência à API de Banco de Dados.

\n
\n
\n

Escrevendo sua primeira aplicação Django, parte 7Link para este cabeçalho#

\n\n
\n

Criando um usuário administradorLink para este cabeçalho#

\n

Primeiro temos que criar um usuário que possa acessar o site de administração. Rode o seguinte comando:

\n

Linux / macOS

Shell
$ python manage.py createsuperuser\n
\n

Windows

Windows
...\\> py manage.py createsuperuser\n
\n

Digite seu nome de usuário desejado e pressione enter.

\n
Text
Username: admin\n
\n

Em seguida, será requisitado seu endereço de e-mail desejado:

\n
Text
Email address: admin@example.com\n
\n

O último passo é digitar sua senha. Você será solicitado que digite sua senha duas vezes, a segunda vez como uma confirmação da primeira.

\n
Text
Password: **********\nPassword (again): *********\nSuperuser created successfully.\n
\n
\n
\n

Inicie o servidor de desenvolvimentoLink para este cabeçalho#

\n

O site de administração vem ativado por padrão. Vamos iniciar o servidor de desenvolvimento e explora-lo.

\n

Se o servidor não estiver sendo executado, inicie-o da seguinte forma:

\n

Linux / macOS

Shell
$ python manage.py runserver\n
\n

Windows

Windows
...\\> py manage.py runserver\n
\n

Agora, abra o navegador de internet e vá para “/admin/” no seu domínio local – ex:, http://127.0.0.1:8000/admin/. Você deverá ver a tela de acesso:

\n\"Django\n

Desde que translation está habilitado por padrão, a tela de login talvez seja mostrada em sua própria língua, dependendo das configurações do seu browser a se o Django tem tradução para esta língua.

\n
\n
\n

Entre no site de administraçãoLink para este cabeçalho#

\n

Agora, tente acessar o sistema com a conta de super usuário que criou no passo anterior. Você deverá ver a página inicial do site de administração do Django:

\n\"Django\n

Você deverá ver alguns outros tipos de conteúdos editáveis, incluindo grupos e usuários. Estas funcionalidades são fornecidas por mod:django.contrib.auth, o framework de autenticação fornecido pelo Django.

\n
\n
\n

Torne a aplicação de enquetes editável no site de administraçãoLink para este cabeçalho#

\n

Mas onde está nossa aplicação de enquete? Ela não está visível na página principal do site de administração.

\n

Apenas uma coisa a ser feita: Nós temos que dizer para o site de administração que os objetos Question possuem uma interface de administração. Para fazer isto, crie um arquivo chamado polls/admin.py, e edite para que se pareça com isto:

\n
polls/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import Question\n\nadmin.site.register(Question)\n
\n
\n
\n

Explore a funcionalidade de administração de graçaLink para este cabeçalho#

\n

Agora que nós registramos Question, o Django sabe que ela deve ser exibida na página principal do site de administração:

\n\"Django\n

Clique em “Questions”. Agora cocê está na página “change list” para “questions”. Essa página mostra todas as “questions” em seu banco de dados e lhe deixa escolher uma para alterar. Lá está a pergunta “What’s up?” que criamos anteriormente.

\n\"Polls\n

Clique na enquete “What’s up?” para editá-la:

\n\"Editing\n

Coisas para observar aqui:

\n\n

A parte inferior da página fornece uma série de opções:

\n\n

Se o valor do “Date published” não bate com hora que a questão foi criada em Tutorial 1, provavelmente quer dizer que foi esquecido de configurar o correto valor da configuração do TIME_ZONE. Altere isso, e recarregue a página e verifique se o calor correto aparece.

\n

Altere a “Data de publicação” clicando nos atalhos “Hoje” e “Agora”. Em seguida, clique em “Salvar e continuar editando.” Então clique em “Histórico” no canto superior direito. Você verá uma página exibindo todas as alterações feitas neste objeto pelo site de administração do Django, com a hora e o nome de usuário da pessoa que fez a alteração:

\n\"History\n

Quando estiver confortável com a “API” dos modelos e estiver familiarizado com o “admin site”, leia part 3 of this tutorial para aprender sobre como adicionar mais “views”para nossa app “polls”.

\n
\n
","rootId":"writing-your-first-django-app-part-2","toc":[{"title":"Configuração do banco de dados","anchor":"database-setup","children":[]},{"title":"Criando modelos","anchor":"creating-models","children":[]},{"title":"Ativando modelos","anchor":"activating-models","children":[]},{"title":"Brincando com a API","anchor":"playing-with-the-api","children":[]},{"title":"Escrevendo sua primeira aplicação Django, parte 7","anchor":"introducing-the-django-admin","children":[{"title":"Criando um usuário administrador","anchor":"creating-an-admin-user","children":[]},{"title":"Inicie o servidor de desenvolvimento","anchor":"start-the-development-server","children":[]},{"title":"Entre no site de administração","anchor":"enter-the-admin-site","children":[]},{"title":"Torne a aplicação de enquetes editável no site de administração","anchor":"make-the-poll-app-modifiable-in-the-admin","children":[]},{"title":"Explore a funcionalidade de administração de graça","anchor":"explore-the-free-admin-functionality","children":[]}]}],"breadcrumbs":[{"docname":"intro/index","title":"Introdução","url":"/pt-br/2.2/intro/"}],"prev":{"docname":"intro/tutorial01","title":"Escrevendo seu primeiro app Django, parte 1","url":"/pt-br/2.2/intro/tutorial01/"},"next":{"docname":"intro/tutorial03","title":"Escrevendo sua primeira app Django, parte 3","url":"/pt-br/2.2/intro/tutorial03/"},"formats":{"html":"/pt-br/2.2/intro/tutorial02/","markdown":"/pt-br/2.2/intro/tutorial02.md","json":"/pt-br/2.2/intro/tutorial02.json"},"source":"https://github.com/django/django/blob/stable/2.2.x/docs/intro/tutorial02.txt","official":"https://docs.djangoproject.com/pt-br/2.2/intro/tutorial02/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}