Como conectar Python e MariaDB

Com Python e MariaDB, você pode conectar apli­ca­ções de forma eficiente a um banco de dados e processar in­for­ma­ções. A com­bi­na­ção Python-MariaDB é par­ti­cu­lar­mente adequada para apli­ca­ções web, análises de dados e automação de re­la­tó­rios.

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

Antes de conectar programas Python ao MariaDB, os seguintes re­qui­si­tos devem ser atendidos:

• Ins­ta­la­ção do Python: você deve ter o Python instalado em seu sistema. Cer­ti­fi­que-se de usar uma versão com­pa­tí­vel.
• Banco de dados MariaDB: é ne­ces­sá­rio um banco de dados MariaDB funcional. Você pode usar uma ins­ta­la­ção local do MariaDB ou se conectar a um banco de dados remoto.
• Cre­den­ci­ais de acesso ao banco de dados: você precisará de in­for­ma­ções como o nome do host, porta, nome do banco de dados, nome de usuário e senha para se conectar ao MariaDB.
• Módulo Python: o módulo Connector/Python para conexão com o MariaDB deve estar instalado.

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

Existem duas maneiras de acessar um servidor MariaDB. Você pode instalar um servidor MariaDB em 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 hardware

É bastante simples baixar o pacote MariaDB e instalá-lo em seu próprio hardware. Aqui está um guia detalhado:

Passo 1: Verificar os re­qui­si­tos do sistema

Verifique os re­qui­si­tos para a ins­ta­la­ção do MariaDB em seu sistema. Cer­ti­fi­que-se de que o hardware atende aos re­qui­si­tos mínimos, como espaço de ar­ma­ze­na­mento e memória RAM su­fi­ci­en­tes.

Passo 2: Baixar o MariaDB

Visite o site oficial do MariaDB e escolha o tipo de download adequado com base no seu sistema ope­ra­ci­o­nal (Windows, Linux ou macOS). Cer­ti­fi­que-se de se­le­ci­o­nar a versão correta para o seu sistema.

Passo 3: Instalar o pacote

Baixe o pacote correto para o seu sistema ope­ra­ci­o­nal e ar­qui­te­tura (32 bits ou 64 bits). Após o download, execute a ins­ta­la­ção conforme o seu sistema ope­ra­ci­o­nal. Por exemplo, para instalar o MariaDB no Ubuntu 20.04, use o comando sudo apt install mariadb-server.

Passo 4: Con­fi­gu­ra­ção do banco de dados

Após a ins­ta­la­ção, configure o servidor MariaDB. Isso inclui definir cre­den­ci­ais de acesso, con­fi­gu­ra­ções de segurança e outros pa­râ­me­tros do banco de dados.

Passo 5: Iniciar o MariaDB

Inicie o serviço do servidor MariaDB. No Windows, isso é feito pelo Ge­ren­ci­a­dor de Serviços. No Linux e macOS, use a linha de comando com sudo systemctl start mariadb ou sudo service mariadb start.

Passo 6: Realizar a con­fi­gu­ra­ção inicial

Após iniciar, configure o MariaDB exe­cu­tando o comando mysql_secure_installation. Esse comando ajuda a definir con­fi­gu­ra­ções im­por­tan­tes de segurança, como definir senhas e remover contas de teste.

Passo 7: Testar o acesso ao banco de dados

Verifique se você pode se conectar ao banco de dados com sucesso. Faça login como usuário root com mysql -u root -p, insira sua senha e execute algumas consultas SQL simples para garantir que o servidor está fun­ci­o­nando cor­re­ta­mente.

Opção 2: Usar o MariaDB SkySQL

O MariaDB SkySQL é uma pla­ta­forma de banco de dados baseada na nuvem que permite operar bancos de dados MariaDB de maneira fácil e eficiente. A pla­ta­forma inclui o MariaDB En­ter­prise Server e oferece uma série de vantagens, como es­ca­la­bi­li­dade au­to­má­tica, alta dis­po­ni­bi­li­dade e recursos de segurança in­te­gra­dos.

Passo 1: Registrar e fazer login

Visite o site oficial do MariaDB SkySQL e crie uma conta, caso ainda não tenha uma. Faça login com suas cre­den­ci­ais.

Passo 2: Criar um novo serviço

Após o login, você será re­di­re­ci­o­nado para a página inicial do SkySQL. Clique em “Criar novo serviço” ou em um botão se­me­lhante para iniciar um novo serviço de banco de dados. Escolha o tipo de serviço desejado. Você pode escolher entre várias pla­ta­for­mas MariaDB, incluindo o MariaDB En­ter­prise Server e outros serviços de banco de dados.

Passo 3: Con­fi­gu­rar o serviço

Per­so­na­lize a con­fi­gu­ra­ção do serviço, incluindo a seleção da versão do MariaDB, ca­pa­ci­dade do banco de dados e outros pa­râ­me­tros. Você também pode apro­vei­tar as opções de alta dis­po­ni­bi­li­dade e es­ca­la­bi­li­dade au­to­má­tica. Defina as con­fi­gu­ra­ções de au­ten­ti­ca­ção e segurança, como nomes de usuário e senhas, além do ge­ren­ci­a­mento de direitos de acesso ao banco de dados.

Passo 4: Conectar-se ao banco de dados

Após o serviço ser pro­vi­si­o­nado, você receberá in­for­ma­ções sobre o host, a porta, o nome de usuário e a senha. Use essas in­for­ma­ções para se conectar ao seu banco de dados. Execute algumas consultas simples para verificar se o serviço está fun­ci­o­nando.

Passo 5: Monitorar e gerenciar o banco de dados

O MariaDB SkySQL oferece fer­ra­men­tas de mo­ni­to­ra­mento e análise que pos­si­bi­li­tam acom­pa­nhar o de­sem­pe­nho do seu banco de dados. Utilize essas fer­ra­men­tas para garantir que seu banco de dados está fun­ci­o­nando de maneira ideal. Você pode gerenciar e escalar seu banco de dados conforme ne­ces­sá­rio, ajustando os pa­râ­me­tros de de­sem­pe­nho ou ativando fun­ci­o­na­li­da­des adi­ci­o­nais.

Conexão com o servidor MariaDB

Com a bi­bli­o­teca mariadb para Python, você pode se conectar a um banco de dados MariaDB e realizar diversas operações de banco de dados, como consultas, inserções e atu­a­li­za­ções de dados. Instale a bi­bli­o­teca com o ge­ren­ci­a­dor de pacotes pip:

pip3 install mariadb

Agora, você pode se conectar ao MariaDB com Python.

Passo 1: Es­ta­be­le­cer conexão

Primeiro, você precisa importar a bi­bli­o­teca e conectar-se ao seu banco de dados MariaDB. Para isso, você precisará de in­for­ma­ções como o nome do host, a porta, o nome do banco de dados, o nome de usuário e a senha.

import mariadb
# Detalhes da conexão com o banco de dados
db_config = {
    'user': 'your_username',
    'password': 'your_password',
    'host': 'your_hostname',
    'database': 'your_database',
    'port': 3306  # Porta padrão para MariaDB
}
# Estabelecendo a conexão
conn = mariadb.connect(**db_config)
# Criar um cursor para executar consultas
cursor = conn.cursor()

O cursor é um objeto que permite realizar operações em um banco de dados re­la­ci­o­nal, como o MariaDB. Isso inclui, por exemplo, consultas SQL e a ma­ni­pu­la­ção de dados. Em Python, você obtém um cursor após es­ta­be­le­cer uma conexão com o banco de dados. Ele é chamado pelo método cursor().

Passo 2: Consultar dados

A seguir, usaremos o cursor para executar consultas SQL e recuperar dados do banco de dados.

# Definir a consulta SQL
sql_query = "SELECT * FROM your_table"
# Executar a consulta
cursor.execute(sql_query)
# Buscar resultados
results = cursor.fetchall()
# Exibir dados
for row in results:
    print(row)

Passo 3: Adicionar dados

Para inserir dados em uma tabela, defina uma consulta SQL INSERT e execute-a com o cursor.

# Definir a consulta SQL de inserção
insert_query = "INSERT INTO your_table (column1, column2) VALUES (%s, %s)"
# Valores a serem inseridos
values = ('value1', 'value2')
# Executar a consulta de inserção
cursor.execute(insert_query, values)
# Confirmar a transação
conn.commit()

A instrução SQL INSERT es­pe­ci­fica em qual tabela (your_table) e colunas (column1 e column2) os dados serão inseridos. Os pla­cehol­ders como %s re­pre­sen­tam os valores a serem inseridos. A tupla values armazena esses valores antes da inserção no banco de dados. O cursor executa a consulta INSERT com os valores for­ne­ci­dos. Em seguida, o método conn.commit() confirma a transação para garantir que as al­te­ra­ções sejam per­ma­nen­te­mente salvas no banco de dados.

Passo 4: Encerrar conexão

Após concluir suas operações no banco de dados, feche o cursor e a conexão para liberar recursos.

# Fechar cursor e conexão
cursor.close()
conn.close()

Passo 5: Tratar erros

É im­por­tante incluir o tra­ta­mento de erros para capturar possíveis exceções ao es­ta­be­le­cer a conexão ou executar consultas.

try:
    # Estabelecendo a conexão
    conn = mariadb.connect(**db_config)
    # Criar um cursor
    cursor = conn.cursor()
 # Executar a consulta
    cursor.execute(sql_query)
    # Buscar resultados
    results = cursor.fetchall()
    for row in results:
        print(row)
except mariadb.Error as err:
    print(f"Erro: {err}")
finally:
    # Fechar cursor e conexão
    if cursor:
        cursor.close()
    if conn:
        conn.close()

Você pode adaptar essa estrutura básica às ne­ces­si­da­des da sua aplicação para executar consultas, inserções, atu­a­li­za­ções e outras operações no banco de dados.

Aqui está o código completo:

import mariadb
# Detalhes da conexão com o banco de dados
db_config = {
    'user': 'your_username',
    'password': 'your_password',
    'host': 'your_hostname',
    'database': 'your_database',
    'port': 3306  # Porta padrão para MariaDB
}
try:
    # Estabelecendo a conexão
    conn = mariadb.connect(**db_config)
    # Criar um cursor para executar consultas
    cursor = conn.cursor()
    # Definir a consulta SQL
    sql_query = "SELECT * FROM your_table"
    # Executar a consulta
    cursor.execute(sql_query)
    # Buscar resultados
    results = cursor.fetchall()
    # Exibir dados
    for row in results:
        print(row)
    # Definir a consulta SQL de inserção
    insert_query = "INSERT INTO your_table (column1, column2) VALUES (%s, %s)"
    # Valores a serem inseridos
    values = ('value1', 'value2')
    # Executar a consulta de inserção
    cursor.execute(insert_query, values)
    # Confirmar a transação
    conn.commit()
except mariadb.Error as err:
    print(f"Erro: {err}")
finally:
    # Fechar cursor e conexão
    if cursor:
        cursor.close()
    if conn:
        conn.close()