Collegare i programmi Python a MariaDB

Grazie alla com­bi­na­zio­ne di Python e MariaDB, è possibile collegare fa­cil­men­te i programmi a un database ed ela­bo­rar­ne le in­for­ma­zio­ni. L’uso combinato di Python e MariaDB si rivela par­ti­co­lar­men­te utile per le ap­pli­ca­zio­ni web, l’analisi dei dati e l’au­to­ma­zio­ne dei report.

Quali sono i requisiti?

Prima di poter collegare i programmi Python a MariaDB, è ne­ces­sa­rio che il sistema soddisfi i seguenti requisiti:

• In­stal­la­zio­ne di Python: è ne­ces­sa­rio che Python sia in­stal­la­to sul tuo sistema. As­si­cu­ra­ti di uti­liz­za­re una versione sup­por­ta­ta.
• Database MariaDB: è richiesto un database MariaDB fun­zio­nan­te. Puoi uti­liz­za­re un’in­stal­la­zio­ne locale di MariaDB o stabilire una con­nes­sio­ne a un database remoto.
• Dati di accesso al database: per con­net­ter­ti al database MariaDB hai bisogno di in­for­ma­zio­ni come il nome dell’host, la porta, il nome del database, il nome dell’utente e la password.
• Modulo Python: è richiesta l’in­stal­la­zio­ne del modulo Connector/Python per la con­nes­sio­ne con MariaDB.

Pre­pa­ra­zio­ne e in­stal­la­zio­ne

Se desideri uti­liz­za­re un server MariaDB, hai due opzioni: puoi in­stal­lar­lo di­ret­ta­men­te sul tuo computer oppure uti­liz­za­re la piat­ta­for­ma MariaDB nel cloud.

Metodo 1: in­stal­la­re il server MariaDB sull’hardware

Scaricare il pacchetto MariaDB e in­stal­lar­lo sul tuo hardware è piuttosto semplice. Procedi in questo modo:

Primo passaggio: ve­ri­fi­ca­re i requisiti di sistema

Controlla i requisiti per l’in­stal­la­zio­ne di MariaDB sul tuo sistema e as­si­cu­ra­ti che il tuo hardware soddisfi i requisiti minimi, come spazio di ar­chi­via­zio­ne e RAM suf­fi­cien­ti.

Secondo passaggio: scaricare MariaDB

Visita il sito ufficiale di MariaDB e seleziona il tipo di download de­si­de­ra­to in base al tuo sistema operativo (Windows, Linux o macOS). As­si­cu­ra­ti di se­le­zio­na­re la versione giusta per il tuo sistema.

Terzo passaggio: in­stal­la­re il pacchetto

Scarica il pacchetto corretto per il tuo sistema operativo e la tua ar­chi­tet­tu­ra (a 32 o 64 bit). Una volta com­ple­ta­to il download, esegui l’in­stal­la­zio­ne in base al tuo sistema operativo. Ad esempio, se desideri in­stal­la­re MariaDB su Ubuntu 20.04, inserisci il comando sudo apt install mariadb-server.

Quarto passaggio: con­fi­gu­ra­re il database

Dopo l’in­stal­la­zio­ne, devi con­fi­gu­ra­re il server MariaDB. In questo caso è ne­ces­sa­rio spe­ci­fi­ca­re i dati di accesso, le im­po­sta­zio­ni di sicurezza e altri parametri del database.

Quinto passaggio: avviare MariaDB

Ora occorre eseguire il servizio del server MariaDB. Su Windows, ciò avviene tramite il Service Manager. Su Linux e macOS, invece, è possibile farlo tramite la riga di comando im­met­ten­do sudo systemctl start mariadb oppure sudo service mariadb start.

Sesto passaggio: eseguire la con­fi­gu­ra­zio­ne iniziale

Dopo aver avviato MariaDB, con­fi­gu­ra­lo eseguendo il comando mysql_secure_installation. Questo ti aiuta a ef­fet­tua­re im­por­tan­ti im­po­sta­zio­ni di sicurezza come l’im­po­sta­zio­ne delle password e la rimozione degli account di prova.

Settimo passaggio: ve­ri­fi­ca­re l’accesso al database

Verifica se riesci a con­net­ter­ti al database. Accedi come utente root con mysql -u root -p. Inserisci la tua password ed esegui alcune semplici query SQL per ve­ri­fi­ca­re che il server funzioni cor­ret­ta­men­te.

Metodo 2: uti­liz­za­re MariaDB SkySQL

MariaDB SkySQL è una piat­ta­for­ma di database basata sul cloud che ti permette di eseguire database MariaDB in modo semplice ed ef­fi­cien­te nel cloud. La piat­ta­for­ma include MariaDB En­ter­pri­se Server e offre un’ampia gamma di vantaggi come la sca­la­bi­li­tà au­to­ma­ti­ca, l’alta di­spo­ni­bi­li­tà e le funzioni di sicurezza integrate.

Primo passaggio: re­gi­stra­zio­ne e login

Visita il sito ufficiale di MariaDB SkySQL e registra un account se non ne hai già uno. Effettua il login con le tue cre­den­zia­li.

Secondo passaggio: creazione di un nuovo servizio

Dopo aver ef­fet­tua­to il login, verrai rein­di­riz­za­to alla pagina iniziale di SkySQL. Fai clic su “Crea nuovo servizio” o su un pulsante simile per avviare un nuovo servizio di database. Seleziona il tipo di servizio de­si­de­ra­to. Puoi scegliere tra diverse piat­ta­for­me MariaDB, tra cui MariaDB En­ter­pri­se Server e altri servizi di database.

Terzo passaggio: con­fi­gu­ra­zio­ne del servizio

Per­so­na­liz­za la con­fi­gu­ra­zio­ne del servizio, se­le­zio­nan­do la versione di MariaDB, la capacità del database e altri parametri delle risorse. Puoi anche uti­liz­za­re le opzioni per l’alta di­spo­ni­bi­li­tà e la sca­la­bi­li­tà au­to­ma­ti­ca e spe­ci­fi­ca­re le im­po­sta­zio­ni di au­ten­ti­ca­zio­ne e sicurezza. Questo include la con­fi­gu­ra­zio­ne dei nomi utente e delle password nonché la gestione dei pemessi di accesso al database.

Quarto passaggio: con­nes­sio­ne al database

Dopo che il servizio è stato attivato, riceverai in­for­ma­zio­ni sul nome dell’host, la porta, il nome utente e la password. Utilizza queste in­for­ma­zio­ni per stabilire una con­nes­sio­ne al tuo database. Esegui alcune semplici query per ve­ri­fi­ca­re che il servizio funzioni.

Quinto passaggio: mo­ni­to­rag­gio e gestione del database

MariaDB SkySQL offre strumenti di mo­ni­to­rag­gio e analisi che ti per­met­to­no di mo­ni­to­ra­re le pre­sta­zio­ni del tuo database. Utilizza questi strumenti per as­si­cu­rar­ti che il tuo database funzioni in modo ottimale. Puoi gestire e scalare il tuo database in base alle tue esigenze regolando i parametri delle risorse o abi­li­tan­do funzioni ag­giun­ti­ve.

Con­nes­sio­ne al server MariaDB

Puoi uti­liz­za­re la libreria MariaDB per Python per con­net­ter­ti a un database MariaDB ed eseguire varie ope­ra­zio­ni sul database, come in­ter­ro­ga­re, inserire e ag­gior­na­re i dati. Installa la libreria uti­liz­zan­do il gestore di pacchetti pip:

pip3 install mariadb

Ora puoi col­le­gar­ti a MariaDB tramite Python.

Primo passaggio: stabilire una con­nes­sio­ne

Per prima cosa, devi importare la libreria e stabilire una con­nes­sio­ne al tuo database MariaDB. Per farlo, ti servono in­for­ma­zio­ni come il nome dell’host, la porta, il nome del database, il nome dell’utente e la password.

import mariadb
# Database connection details
db_config = {
    'user': 'your_username',
    'password': 'your_password',
    'host': 'your_hostname',
    'database': 'your_database',
    'port': 3306  # Standard port for MariaDB
}
# Establishing the connection
conn = mariadb.connect(**db_config)
# Create a cursor to execute queries
cursor = conn.cursor()

Il cursore è un oggetto che può essere uti­liz­za­to per eseguire ope­ra­zio­ni di database in un database re­la­zio­na­le come MariaDB. Tra queste vi sono, ad esempio, le query SQL e la modifica dei dati. In Python si riceve un cursore dopo aver stabilito una con­nes­sio­ne al database, che può essere ri­chia­ma­to tramite il metodo cursor().

Secondo passaggio: ri­chia­ma­re i dati

Ora uti­liz­zia­mo il cursore per eseguire le query SQL e re­cu­pe­ra­re i dati dal database.

# Define the SQL query
sql_query = "SELECT * FROM your_table"
# Execute the query
cursor.execute(sql_query)
# Fetch results
results = cursor.fetchall()
# Display data
for row in results:
    print(row)

Terzo passaggio: ag­giun­ge­re i dati

Per inserire dati in una tabella, definisci una query SQL-INSERT ed eseguila con il cursore.

# Define the SQL insert query
insert_query = "INSERT INTO your_table (column1, column2) VALUES (%s, %s)"
# Values to insert
values = ('value1', 'value2')
# Execute the insert query
cursor.execute(insert_query, values)
# Commit the transaction
conn.commit()

L’istru­zio­ne SQL INSERT specifica in quale tabella (your_table) e in quali colonne (column1 e column2) devono essere inseriti i dati. I se­gna­po­sto come %s rap­pre­sen­ta­no i valori da inserire. La tupla values contiene i valori cor­ri­spon­den­ti inseriti nel database. Il cursore esegue la query INSERT con i valori spe­ci­fi­ca­ti. Il metodo conn.commit() conferma quindi l’invio per garantire che le modifiche siano salvate in modo per­ma­nen­te nel database.

Quarto passaggio: in­ter­rom­pe­re la con­nes­sio­ne

Dopo aver com­ple­ta­to le ope­ra­zio­ni sul database, è ne­ces­sa­rio chiudere il cursore e in­ter­rom­pe­re la con­nes­sio­ne per liberare le risorse.

# Close cursor and connection
cursor.close()
conn.close()

Quinto passaggio: gestire gli errori

La gestione degli errori è im­por­tan­te in quanto consente di rilevare eventuali anomalie durante la creazione della con­nes­sio­ne o l’ese­cu­zio­ne delle query.

try:
        # Establish the connection
        conn = mariadb.connect(**db_config)
        # Create a cursor
        cursor = conn.cursor()
        # Execute the query
        cursor.execute(sql_query)
        # Fetch results
        results = cursor.fetchall()
        for row in results:
            print(row)
    except mariadb.Error as err:
        print(f"Error: {err}")
    finally:
        # Close cursor and connection
        if cursor:
            cursor.close()
        if conn:
            conn.close()

Puoi per­so­na­liz­za­re questa struttura in base alle tue spe­ci­fi­che esigenze di ap­pli­ca­zio­ne per im­ple­men­ta­re diverse ope­ra­zio­ni sul database.

Di seguito ri­por­tia­mo il codice completo:

import mariadb
# Database connection details
db_config = {
    'user': 'your_username',
    'password': 'your_password',
    'host': 'your_hostname',
    'database': 'your_database',
    'port': 3306  # Standard port for MariaDB
}
try:
    # Establishing the connection
    conn = mariadb.connect(**db_config)
    # Create a cursor to execute queries
    cursor = conn.cursor()
    # Define the SQL query
    sql_query = "SELECT * FROM your_table"
    # Execute the query
    cursor.execute(sql_query)
    # Fetch results
    results = cursor.fetchall()
    # Display data
    for row in results:
        print(row)
    # Define the SQL insert query
    insert_query = "INSERT INTO your_table (column1, column2) VALUES (%s, %s)"
    # Values to insert
    values = ('value1', 'value2')
    # Execute the insert query
    cursor.execute(insert_query, values)
    # Commit the transaction
    conn.commit()
except mariadb.Error as err:
    print(f"Error: {err}")
finally:
    # Close cursor and connection
    if cursor:
        cursor.close()
    if conn:
        conn.close()