Configuração de Banco de Dados SQLite com Python Flask

Beginner

This tutorial is from open-source community. Access the source code

Introdução

Neste laboratório, aprenderemos como definir e acessar um banco de dados SQLite usando o framework Python Flask. Configuraremos um banco de dados SQLite, estabeleceremos uma conexão com ele, criaremos tabelas e inicializaremos o banco de dados.

Nota: Você precisa criar o arquivo de código você mesmo e executá-lo no ambiente. Você pode visualizar o status do serviço Flask na Web 5000.

Configurando o Banco de Dados

Primeiramente, precisamos configurar um banco de dados SQLite para armazenar usuários e posts. SQLite é uma escolha conveniente, pois não requer um servidor de banco de dados separado e é embutido no Python.

Em nossa aplicação Flask, criaremos uma conexão com o banco de dados SQLite. Essa conexão é tipicamente atrelada à requisição em aplicações web, e é fechada após o trabalho ser finalizado.

A conexão é estabelecida usando a função sqlite3.connect e usamos o objeto especial do Flask g para armazenar e reutilizar a conexão.

Crie um novo arquivo Python db.py e adicione o seguinte código:

## flaskr/db.py

import sqlite3
from flask import current_app, g

def get_db():
    ## Check if 'db' is not in 'g'
    if 'db' not in g:
        ## Establish a connection to the database
        g.db = sqlite3.connect(
            current_app.config['DATABASE'],
            detect_types=sqlite3.PARSE_DECLTYPES
        )
        ## Return rows that behave like dicts
        g.db.row_factory = sqlite3.Row

    return g.db

def close_db(e=None):
    ## Pop 'db' from 'g' and close the connection if it exists
    db = g.pop('db', None)

    if db is not None:
        db.close()

Criando Tabelas

No SQLite, os dados são armazenados em tabelas e colunas. Precisamos criá-las antes de podermos armazenar e recuperar dados. Nossa aplicação armazenará usuários na tabela user e posts na tabela post.

Crie um novo arquivo SQL schema.sql e adicione o seguinte código:

## flaskr/schema.sql

DROP TABLE IF EXISTS user;
DROP TABLE IF EXISTS post;

CREATE TABLE user (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  username TEXT UNIQUE NOT NULL,
  password TEXT NOT NULL
);

CREATE TABLE post (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  author_id INTEGER NOT NULL,
  created TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
  title TEXT NOT NULL,
  body TEXT NOT NULL,
  FOREIGN KEY (author_id) REFERENCES user (id)
);

Inicializando o Banco de Dados

Em seguida, adicionaremos funções Python que executarão os comandos SQL para criar as tabelas. Adicione as seguintes funções ao arquivo db.py:

## flaskr/db.py

def init_db():
    db = get_db()

    with current_app.open_resource('schema.sql') as f:
        db.executescript(f.read().decode('utf8'))

@click.command('init-db')
def init_db_command():
    """Clear the existing data and create new tables."""
    init_db()
    click.echo('Initialized the database.')

Registrando com a Aplicação

As funções close_db e init_db_command precisam ser registradas com a instância da aplicação para serem usadas pela aplicação. Como estamos usando uma função factory (fábrica), escreveremos uma função que recebe uma aplicação e faz o registro.

Adicione a seguinte função ao arquivo db.py:

## flaskr/db.py

def init_app(app):
    app.teardown_appcontext(close_db)
    app.cli.add_command(init_db_command)

Em seguida, importe e chame esta função da factory. Adicione o seguinte código ao arquivo __init__.py:

## flaskr/__init__.py

def create_app():
    app = ...
    ## existing code omitted

    from . import db
    db.init_app(app)

    return app

Inicializando o Arquivo do Banco de Dados

Agora que init-db foi registrado com a aplicação, ele pode ser chamado usando o comando flask.

Execute o comando init-db:

flask --app flaskr init-db
Initialized the database.

Resumo

Neste laboratório, aprendemos como definir e acessar um banco de dados SQLite usando o framework Python Flask. Criamos uma conexão com o banco de dados, criamos tabelas e inicializamos o banco de dados. Isso é fundamental para qualquer aplicação web que precise armazenar e recuperar dados de um banco de dados.