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 database
  • host
  • user
  • password
  • port
  • extensions : se usate eventualmente estensioni
  • hardQueryLimit: 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 configurazioni di ambiente .

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à necessario installare delle librerie Python aggiuntive.

Per PostgreSQL

Per poter lavorare con il mapper SQL di Genropy su database PostgreSql è necessario installare la libreria psycopg2 usando l'istruzione.

pip install psycopg2-binary

Hint

Se state lavorando in ambiente OSX suggeriamo come versione di PostgreSQL di utilizzare Postgres.app

Per MySQL

Per poter lavorare con il mapper SQL di Genropy su database MySqyl è necessario installare la libreria MySQL-python usando l'istruzione.

pip install MySQL-python