Python, uma linguagem de programação interpretada, de alto nível e de propósito geral, vem crescendo em popularidade nos últimos anos. Lançado pela primeira vez em 1991, o Python está agora em sua terceira versão principal.
Os desenvolvedores têm afinidade com a linguagem por vários motivos, incluindo seu alto nível de legibilidade e uma infinidade de recursos que permitem concluir tarefas complexas com relativa facilidade. De acordo com a Stack Overflow Developer Survey de 2019, o Python se posicionou entre as cinco principais linguagens de programação mais populares e é a segunda linguagem mais amada (atrás do Rust) entre os desenvolvedores.
Apresentando o Connector/Python
MariaDB tem o prazer de anunciar a disponibilidade imediata do MariaDB Connector/Python beta! O Connector/Python permite que programas Python acessem bancos de dados MariaDB usando uma API compatível com a Python DB API 2.0 (PEP-249). Para otimizar o desempenho, o novo conector é escrito em C e aproveita a biblioteca cliente MariaDB Connector/C para comunicação cliente-servidor.
Por que um novo cliente? Embora existam clientes existentes que podem ser usados para se comunicar com o MariaDB, a motivação por trás da criação do MariaDB Python Connector é fornecer um cliente leve e muito rápido que suporte todos os recursos do MariaDB além do que o MySQL oferece.
Primeiros passos
Para começar a usar o Connector/Python, você deve atender aos seguintes pré-requisitos:
- Instale o Python 3 (a versão mínima suportada é 3.6)
- Acessar uma instância MariaDB 10.x
- Instale o MariaDB Connector/C versão 3.1.5 ou mais recente
Depois de atender aos pré-requisitos, você estará pronto para instalar o conector usando:
$ pip3 install --pre mariadb
Com o Connector/Python instalado, agora você pode usá-lo em seu código Python. Comece criando um novo arquivo Python chamado “example.py” em um local de sua escolha.
Abra o arquivo e adicione o seguinte à primeira linha para habilitar o uso do conector:
importar mariadb
Adicione os valores de configuração para a instância do banco de dados MariaDB à qual você deseja se conectar.
config ={ 'host':'localhost', 'user':'root', 'password':'secret',} Você poderá usar essa configuração para se conectar ao MariaDB usando
mariadb.connect :conn =mariadb.connect(**config)
Para executar consultas, você precisa de um cursor baseado na conexão:
cur =conn.cursor()
E você pode fechar a conexão quando terminar:
conn.close()
Para reunir tudo, o script a seguir se conecta a um banco de dados local e executa algumas consultas. Consulte nossa documentação para obter mais informações sobre consultas.
import sysimport mariadbconfig ={ 'host':'localhost', 'user':'root', 'password':'secret',} try:conn =mariadb.connect(**config, database='test' )exceto mariadb.Error as err:print(err, file=sys.stderr) sys.exit(1)cur =conn.cursor()cur.execute("SHOW TABLES")for (tbl,) in cur.fetchall( ):# pré-busca todos os dados para liberar o cursor print("\n===", tbl, "===\n") cur.execute(f"SELECT * FROM `{tbl}`") print ([x[0] para x em cur.description]) # imprime nomes de campos (como uma lista) para linha em cur:# usando um iterador minimiza a memória usada print(row) # imprime cada linha nesta tabela (cada uma como a tuple)cur.execute("INSERT INTO sample VALUES (?, ?, ?)", (1, "Uma 'string' com aspas simples.", '2020-01-01'))conn.close()
Salve as alterações, abra uma janela de terminal, navegue até o local de “example.py” e execute:
$ python3 exemplo.py
O que vem a seguir
Como esta versão do MariaDB Connector/Python é beta, não recomendamos usá-lo em produção.
O Connector/Python está em desenvolvimento ativo e antecipamos o lançamento de atualizações em breve, portanto, fique atento! Se você tiver dúvidas, encontrar problemas ou quiser contribuir para o desenvolvimento do Connector/Python, você pode encontrar o código-fonte no GitHub. A documentação do MariaDB Connector/Python está disponível em MariaDB Enterprise Documentation.
