Python: ligação de programas a bases de dados MariaDB

Com Python e MariaDB, pode conectar apli­ca­ções a uma base de dados de forma eficiente e processar in­for­ma­ções. A com­bi­na­ção de Python e MariaDB é es­pe­ci­al­mente útil para apli­ca­ções web, análise de dados e au­to­ma­ti­za­ção de re­la­tó­rios.

Quais são os re­qui­si­tos?

Antes de poder ligar programas Python ao MariaDB, deve cumprir os seguintes re­qui­si­tos:

• Ins­ta­la­ção do Python: cer­ti­fi­que-se de que o Python está instalado no seu sistema e que é uma versão com­pa­tí­vel.
• Base de dados MariaDB: necessita de uma base de dados MariaDB funcional. Pode utilizar uma ins­ta­la­ção local do MariaDB ou ligar-se a uma base de dados remota.
• Cre­den­ci­ais de acesso ao banco de dados: você precisa de in­for­ma­ções como o nome do host, a porta, o nome do banco de dados, o nome de uti­li­za­dor e a senha para se conectar ao banco de dados MariaDB.
• Módulo Python: deve ter o módulo Python/Connector instalado para se conectar ao MariaDB.

Pre­pa­ra­ção e ins­ta­la­ção

Existem duas formas de aceder a um servidor MariaDB. Pode instalar um servidor MariaDB no seu próprio com­pu­ta­dor ou servidor, ou utilizar a pla­ta­forma MariaDB na nuvem.

Opção 1. Instalar o servidor MariaDB no seu hardware

É bastante simples des­car­re­gar o pacote MariaDB e instalá-lo no seu com­pu­ta­dor. Aqui está um guia detalhado:

Passo 1. Verifique os re­qui­si­tos do sistema

Cer­ti­fi­que-se de que o seu hardware cumpre os re­qui­si­tos mínimos, como ter espaço su­fi­ci­ente em disco e memória RAM.

Passo 2. Des­car­re­gue o MariaDB

Visite o site oficial do MariaDB e faça o download da versão cor­res­pon­dente ao seu sistema operativo (Windows, Linux ou macOS).

Passo 3. Instale o pacote

Faça o download do pacote correto para o seu sistema operativo e ar­qui­te­tura (32 bits ou 64 bits). Após concluir o download, execute a ins­ta­la­ção de acordo com o seu sistema operativo. Por exemplo, se você for instalar o MariaDB no Ubuntu 20.04, terá que executar o comando sudo apt install mariadb-server.

Passo 4. Configure a base de dados

Após a ins­ta­la­ção, configure o servidor MariaDB es­pe­ci­fi­cando os dados de acesso, a con­fi­gu­ra­ção de segurança e outros pa­râ­me­tros da base de dados.

Passo 5. Inicie o MariaDB

Inicie o serviço do servidor MariaDB. No Windows, isso é feito através do Gestor de Serviços. No Linux e no macOS, funciona através da linha de comandos com sudo systemctl start mariadb ou sudo service mariadb start.

Passo 6. Realize a con­fi­gu­ra­ção inicial

Configure o MariaDB após iniciá-lo, exe­cu­tando o comando mysql_secure_installation. O comando ajuda a realizar con­fi­gu­ra­ções de segurança im­por­tan­tes, como definir senhas e eliminar contas de teste.

Passo 7. Teste o acesso à base de dados

Verifique se consegue ligar-se cor­re­ta­mente à base de dados. Inicie sessão como uti­li­za­dor root com mysql -u root -p. Introduza a sua palavra-passe e execute algumas consultas SQL simples para verificar se o servidor está a funcionar cor­re­ta­mente.

Opção 2. Utilizar MariaDB SkySQL

MariaDB SkySQL é uma pla­ta­forma de base de dados na nuvem que permite operar bases de dados MariaDB de forma simples e eficiente na nuvem. A pla­ta­forma inclui o MariaDB En­ter­prise Server e oferece várias vantagens, como es­ca­la­bi­li­dade au­to­má­tica, alta dis­po­ni­bi­li­dade e funções de segurança in­te­gra­das.

Passo 1. Registe-se e inicie sessão

Visite o site oficial do MariaDB SkySQL e registe-se para obter uma conta, caso ainda não tenha uma. Inicie sessão com as suas cre­den­ci­ais.

Passo 2. Crie um novo serviço

Após iniciar sessão, será re­di­re­ci­o­nado para a página inicial do SkySQL. Clique em «Criar novo serviço» ou num botão se­me­lhante para iniciar um novo serviço de base de dados. Selecione o tipo de serviço que deseja, podendo escolher entre di­fe­ren­tes pla­ta­for­mas MariaDB, como MariaDB En­ter­prise Server e outros serviços de base de dados.

Passo 3. Configure o serviço

Per­so­na­lize as con­fi­gu­ra­ções do serviço, incluindo a seleção da versão do MariaDB, a ca­pa­ci­dade do banco de dados e outros pa­râ­me­tros de recursos. Também pode utilizar as opções de alta dis­po­ni­bi­li­dade e es­ca­la­bi­li­dade au­to­má­tica. Es­pe­ci­fi­que as con­fi­gu­ra­ções de au­ten­ti­ca­ção e segurança, incluindo nomes de uti­li­za­dor e senhas, bem como a gestão das per­mis­sões de acesso ao banco de dados.

Passo 4. Ligue-se à base de dados

Após a ativação do serviço, receberá in­for­ma­ções sobre o nome do host, a porta, o nome de uti­li­za­dor e a palavra-passe. Utilize essas in­for­ma­ções para se ligar à sua base de dados. Execute algumas consultas simples para verificar se o serviço está a funcionar.

Passo 5. Mo­ni­to­rize e gere a base de dados

O MariaDB SkySQL oferece fer­ra­men­tas de mo­ni­to­ri­za­ção e análise que permitem su­per­vi­si­o­nar o de­sem­pe­nho da sua base de dados. Utilize essas fer­ra­men­tas para garantir que a sua base de dados funcione de forma ideal. Pode gerir e di­men­si­o­nar a sua base de dados de acordo com as suas ne­ces­si­da­des, ajustando os pa­râ­me­tros de recursos ou ativando funções adi­ci­o­nais.

Ligar ao servidor MariaDB

Utilize a bi­bli­o­teca MariaDB do Python para se conectar a um banco de dados MariaDB e realizar diversas operações com ele, como consultar, inserir ou atualizar dados. Instale a bi­bli­o­teca com o ge­ren­ci­a­dor de pacotes pip:

pip3 install mariadb

Agora pode ligar-se ao MariaDB a partir do Python.

Passo 1. Es­ta­be­leça a ligação

Primeiro, você precisa importar a bi­bli­o­teca e es­ta­be­le­cer uma conexão com o seu banco de dados MariaDB. Para isso, você precisa de in­for­ma­ções como o nome do host, a porta, o nome do banco de dados, o nome de uti­li­za­dor e a senha.

import mariadb
# Detalles de la conexión a la base de datos
db_config = {
    'user': 'your_username',
    'password': 'your_password',
    'host': 'your_hostname',
    'database': 'your_database',
    'port': 3306  # Puerto predeterminado para MariaDB
}
# Establecer la conexión
conn = mariadb.connect(**db_config)
# Crear un cursor para ejecutar consultas
cursor = conn.cursor()

O cursor é um objeto que pode ser utilizado para realizar operações em bases de dados re­la­ci­o­nais, como MariaDB. As operações incluem consultas SQL e edição de dados. Após es­ta­be­le­cer uma ligação com a base de dados, recebe-se um cursor em Python. A consulta é feita através da função cursor().

Passo 2. Consulte os dados

Em seguida, utilize o cursor para executar consultas SQL e recuperar dados da base de dados.

# Definir la consulta SQL
sql_query = "SELECT * FROM your_table"
# Ejecutar la consulta
cursor.execute(sql_query)
# Obtener resultados
results = cursor.fetchall()
# Mostrar datos
for row in results:
    print(row)

Passo 3. Introduza os dados

Para in­tro­du­zir dados numa tabela, defina uma consulta SQL INSERT e execute-a com o cursor.

# Definir la consulta SQL INSERT
insert_query = "INSERT INTO your_table (column1, column2) VALUES (%s, %s)"
# Valores a insertar
values = ('value1', 'value2')
# Ejecutar la consulta INSERT
cursor.execute(insert_query, values)
# Confirmar la transacción
conn.commit()

A instrução SQL INSERT es­pe­ci­fica em que tabela (your_table) e em que colunas (column1 e column2) pretende inserir os dados. Os mar­ca­do­res de posição, como %s, re­pre­sen­tam os valores a serem inseridos. A tupla values contém os valores cor­res­pon­den­tes que pretende in­tro­du­zir na base de dados. O cursor executa a instrução INSERT com os valores es­pe­ci­fi­ca­dos. Em seguida, a função conn.commit() confirma a transação para garantir que as al­te­ra­ções sejam guardadas per­ma­nen­te­mente na base de dados.

Passo 4. Encerre a ligação

Depois de concluir as suas operações com a base de dados, deve fechar o cursor e a ligação para libertar recursos.

# Cierra el cursor y la conexión
cursor.close()
conn.close()

Passo 5. Gerencie os erros

É im­por­tante incluir a gestão de erros para poder detetar possíveis exceções ao es­ta­be­le­cer a ligação ou executar as consultas.

try:
        # Establecer la conexión
        conn = mariadb.connect(**db_config)
        # Crear un cursor
        cursor = conn.cursor()
        # Ejecutar la consulta
        cursor.execute(sql_query)
        # Obtener resultados
        results = cursor.fetchall()
        for row in results:
            print(row)
    except mariadb.Error as err:
        print(f"Error: {err}")
    finally:
        # Cerrar cursor y conexión
        if cursor:
            cursor.close()
        if conn:
            conn.close()

Pode adaptar esta estrutura básica às suas ne­ces­si­da­des es­pe­cí­fi­cas para im­ple­men­tar várias operações de base de dados.

Aqui está o código completo:

import mariadb
# Detalles de la conexión a la base de datos
db_config = {
    'user': 'your_username',
    'password': 'your_password',
    'host': 'your_hostname',
    'database': 'your_database',
    'port': 3306  # Puerto predeterminado para MariaDB
}
try:
    # Establecer la conexión
    conn = mariadb.connect(**db_config)
    # Crear un cursor para ejecutar consultas
    cursor = conn.cursor()
    # Definir la consulta SQL
    sql_query = "SELECT * FROM your_table"
    # Ejecutar la consulta
    cursor.execute(sql_query)
    # Obtener los resultados
    results = cursor.fetchall()
    # Mostrar los datos
    for row in results:
        print(row)
    # Definir la consulta SQL INSERT
    insert_query = "INSERT INTO your_table (column1, column2) VALUES (%s, %s)"
    # Valores a insertar
    values = ('value1', 'value2')
    # Ejecutar la consulta INSERT
    cursor.execute(insert_query, values)
    # Confirmar la transacción
    conn.commit()
except mariadb.Error as err:
    print(f"Error: {err}")
finally:
    # Cerrar el cursor y la conexión
    if cursor:
        cursor.close()
    if conn:
        conn.close()