Configurazioni database¶
Genropy include un proprio mapper SQL che permette di operare in modo trasparente su diversi dei DBMS esistenti. Esistono infatti degli adapter per i diversi sistemi che permettono di accedere al database in lettura e scrittura utilizzando sempre le stesse API definite da Genropy.
Attualmente sono già stati implementati gli adapter per accedere a database
SQLite
postgreSQL
mySQL
msSQL
Ed altri potranno essere implementati in futuro.
In questa sezione vedremo quali componenti aggiuntivi occorre installare e quali configurazioni sono necessarie per far operare le vostre applicazioni Genropy sui i diversi DBMS.
Configurare il file instanceconfig¶
Innanzitutto occorre configurare opportunamente il file instanceconfig.xml
che troverete nella directory config
della vostra istanza di applicazione.
All’interno del tag db potete inserire i seguenti parametri
implementation
: ovvero il DBMS del database (postgres, sqlite, mysql, etc)dbname
: cioè il nome del databasehost
user
password
port
extensions
: se usate eventualmente estensionihardQueryLimit
: ammette un valore numerico di soglia di limit forzato per tutte le query eseguite dall’applicazione.
Se nel vostro ambiente di sviluppo usate sempre lo stesso DBMS e lavorate sempre con gli stessi parametri di connessione potete definire tutti questi attributi nel file instanceconfig/default.xml
contenuto nella directory delle MISSING LINK (handbooks/installation_guide/appendix/configuration) configurazioni di ambiente.
Per implementare PostgreSQL, ad esempio, sarà necessario modificare il file default.xml
come segue:
<packages/>
<db implementation="postgres" host="localhost" user="postgres" password="postgres" port='5432' />
<authentication>
Se definite questi parametri nel file di default, nel file instanceconfig
vostra applicazione dovrete solo indicare il nome del database con il parametro dbname
Installazioni aggiuntive¶
A seconda del DBMS scelto, sarà possibile effettuare la installazione di Genropy utilizzando un profilo particolare tra quelli possibili. In questo modo tutte le librerie e le dipendenze verranno installate automaticamente e non sarà quindi necessario installarle manualmente.
Per PostgreSQL¶
Per poter lavorare con il mapper SQL di Genropy su database PostgreSql è disponibile il profilo psql
che provvederà a installare automaticamente la libreria psycopg2.
Suggerimento
Se state lavorando in ambiente macOS suggeriamo come versione di PostgreSQL di utilizzare Postgres.app
Attenzione però al $PATH! In caso di problemi si faccia riferimento a questa Documentazione di PostgreSQL
Per MySQL¶
Per poter lavorare con il mapper SQL di Genropy su database PostgreSql è disponibile il profilo mysql
che provvederà a installare la libreria MySQL-python.