MariaDB Connector/Python Beta nu beschikbaar

Python, een geïnterpreteerde programmeertaal op hoog niveau voor algemene doeleinden, is de afgelopen jaren steeds populairder geworden. Python werd voor het eerst uitgebracht in 1991 en is nu in zijn derde grote versie.

Ontwikkelaars hebben affiniteit met de taal om verschillende redenen, waaronder de hoge leesbaarheid en een overvloed aan functies waarmee complexe taken relatief gemakkelijk kunnen worden uitgevoerd. Volgens de Stack Overflow Developer Survey voor 2019 heeft Python zichzelf gepositioneerd in de top vijf van meest populaire programmeertalen en is het de tweede meest geliefde taal (na Rust) onder ontwikkelaars.

Introductie van Connector/Python

MariaDB is verheugd de onmiddellijke beschikbaarheid van MariaDB Connector/Python beta aan te kondigen! Connector/Python stelt Python-programma's in staat toegang te krijgen tot MariaDB-databases met behulp van een API die compatibel is met de Python DB API 2.0 (PEP-249). Om de prestaties te optimaliseren, is de nieuwe connector geschreven in C en maakt gebruik van de MariaDB Connector/C-clientbibliotheek voor client-servercommunicatie.

Waarom een nieuwe klant? Hoewel er bestaande clients zijn die kunnen worden gebruikt om met MariaDB te communiceren, is de motivatie achter het maken van de MariaDB Python Connector om een lichtgewicht, zeer snelle client te bieden die alle MariaDB-functies ondersteunt die verder gaan dan wat MySQL biedt.

Aan de slag

Om Connector/Python te gaan gebruiken, moet u aan de volgende vereisten voldoen:

Installeer Python 3 (minimaal ondersteunde versie is 3.6)
Toegang tot een MariaDB 10.x-instantie
Installeer MariaDB Connector/C versie 3.1.5 of nieuwer

Zodra u aan de vereisten heeft voldaan, bent u klaar om de connector te installeren met:

$ pip3 install --pre mariadb

Met Connector/Python geïnstalleerd, kunt u het nu gebruiken binnen uw Python-code. Ga aan de slag door een nieuw Python-bestand met de naam "example.py" te maken op een locatie naar keuze.

Open het bestand en voeg het volgende toe aan de eerste regel om het gebruik van de connector in te schakelen:

import mariadb

Voeg de configuratiewaarden toe voor de MariaDB-database-instantie waarmee u verbinding wilt maken.

config = {
    'host': 'localhost',
    'user': 'root',
    'password': 'secret',
}

U kunt die configuratie gebruiken om verbinding te maken met MariaDB met behulp van mariadb.connect :

conn = mariadb.connect(**config)

Om query's uit te voeren, hebt u een cursor nodig op basis van de verbinding:

 cur = conn.cursor()

En je kunt de verbinding verbreken als je klaar bent:

conn.close()

Om alles bij elkaar te brengen, maakt het volgende script verbinding met een lokale database en voert het een paar query's uit. Zie onze documentatie voor meer informatie over vragen.

import sys
import mariadb

config = {
    'host': 'localhost',
    'user': 'root',
    'password': 'secret',
}
 
try:
    conn = mariadb.connect(**config, database='test')
except mariadb.Error as err:
    print(err, file=sys.stderr)
    sys.exit(1)

cur = conn.cursor()

cur.execute("SHOW TABLES")
for (tbl,) in cur.fetchall(): # pre-fetch all data to free up the cursor
    print("\n===", tbl, "===\n")
    cur.execute(f"SELECT * FROM `{tbl}`")
    print([x[0] for x in cur.description]) # print field names (as a list)
    for row in cur: # using an iterator minimizes the memory used
        print(row) # print every row in this table (each as a tuple)

cur.execute("INSERT INTO sample VALUES (?, ?, ?)",
    (1, "A 'string' with single quotes.", '2020-01-01'))

conn.close()

Sla de wijzigingen op, open een terminalvenster, navigeer naar de locatie van "example.py" en voer het volgende uit:

$ python3 example.py

Wat nu

Aangezien deze release van MariaDB Connector/Python een bètaversie is, raden we aan deze niet in productie te gebruiken.

Connector/Python is in actieve ontwikkeling en we verwachten binnenkort updates uit te brengen, dus houd ons in de gaten! Als je vragen hebt, problemen tegenkomt, of een bijdrage wilt leveren aan de ontwikkeling van Connector/Python, kun je de broncode vinden op GitHub. Documentatie voor MariaDB Connector/Python is beschikbaar in MariaDB Enterprise Documentation.