Introduzione

Il progetto di picoSQL nasce col nome di picoGateway nel 1995 come driver ODBC per file COBOL. Consiste di una DLL scritta in C++ su sistema operativo Windows 3.1. All'inizio lo sforzo principale viene fatto per ottenere una buona compatiblità con i front-end esistenti (principalmente MS-Access, MS-Query e VisualBasic) e per vedere come normalizzata una base dati formata da files COBOL che normalizzata non lo è mai.

Il successo ottenuto consente di sviluppare ulteriormente il prodotto, raffinando l'ottimizzatore delle query e implementando un SQL abbastanza esteso, a esclusione del DDL (Data Description Language).

Viene in seguito realizzata una versione client/server, chiamata PicoDb, capace di girare su UNIX e di gestire file in formato proprio (picoIsam) oppure interfacciando direttamente il file manager del COBOL Microfocus.

Installazione

L'installazione è particolarmente semplice: se avete la distribuzione binaria, è sufficiente estrarre i file archiviati in una directory qualsiasi (\ per Windows NT/2000/XP) ed eseguire

startTestDb.sh (Unix/Linux)
startTestDb.bat (Windows)

per attivare il DB con un database di test già configurato.

N.B. su Windows NT/2000/XP viene attivato lo script setReg.js che inserisce alcune informazioni nel registry file. Fra tali informazioni è compresa la directory col DB di test che risulta corretta solo se si installa sotto \

A questo punto se si dispone di Java sul proprio computer, si può lanciare

iSQLViewerTest.sh (Unix/Linux)
iSQLViewerTest.bat (Windows)

per interrogare e amministrare il DB.
Se non dispone di Java si può usare il programma

picosql.sh (Unix/Linux)
picosql.bat (Windows)

che consente di inviare al DB delle query SQL da riga di comando.

• bin dove risiedono tutti i programmi eseguibili;
• lib dove risiedono le librerie (solo Unix/Linux);
• inc dove risiedono le gli header files per le compilazioni;
• java dove risiede il driver JDBC e le applicazioni scritte con linguaggio Java.
• doc dove risiede la documentazione.

PicoSQL consiste fondamentalmente in un programma, picosqld, da attivare tramite inetd (o xinetd) oppure picoserv. In tal modo diventa un servizio di rete legato a una porta, cioè a un numero intero compreso tra 1 e 65535; questo numero (per esempio 6789) deve essere sempre specificato sulla linea di comando di picosqld. Per esempio:

picosqld 6789

Per l'attivazione con inetd (o xinetd), si rimanda alla documentazione relativa. picoserv è un semplice programma che sostituisce inetd, principalmente per scopi di test o debugging: il suo uso è il seguente

picoserv [-f] <lineDiComando> <porta>

picoserv "picosqld 6789" 6789

Quando viene fatta una richiesta di connessione picoSQL legge un file di configurazione dove trova le informazioni necessarie. Questo file è un file in formato testo su Unix/Linux mentre su Windows è il registry file di sistema e deve essere modificato con il programma regedit.

• Unix/LunixViene ricercato il file

  $HOME/.picosql.ini

  oppure, in mancanza di questo,

  /etc/picosql.ini

  In questo file possono essere presenti pių sezioni, caratterizzate da un nome racchiuso tra parentesi quadre su una singola linea. Ciascuna sezione può contenere più attributi, caratterizzati da un nome (il nome attributo), un segno di uguale (=) e un valore che termina all'interruzione della linea di testo. Le linee che iniziano con il carattere punto e virgola (;) oppure diesis (#) vengono considerati commenti.
  Ciascuna sezione corrisponde a un database e comprende informazioni come utente, password e locazione del DB. Nell'esempio seguente sono dichiarati due database, il primo, chiamato picoSqlTest, accessibile a chiunque mentre il secondo, chiamato rubrica può essere acceduto solo fornendo l'appropriato nome utente e password.

   [picoSqlTest]
   DataDirectory=/home/test.db
   
   [rubrica]
   DataDirectory=/home/rubrica.db
   User=pico
   Password=soft
   PicoOdbcTrace=NO
   SuspensiveLock=YES
   ; for picosql client only
   server=localhost
   port=6789
   

• Windows NT/2000/XP Su Windows la configurazione viene letta dal registry file a partire dalla chiave:

  HKEY_CURRENT_USER\Software\PicoSoft\PicoSQL

  oppure, in mancanza di questa,

  HKEY_LOCAL_MACHINE\Software\PicoSoft\PicoSQL

  Ogni chiave in questa sezione può corrispondere a un database. Sotto la chiave corrispondente al database possono essere definite delle stringhe, ciascuna delle quali corrisponde a un attributo del database, come utente, password e locazione del DB. Nell'esempio seguente sono dichiarati due database, il primo, chiamato picoSqlTest, accessibile a chiunque mentre il secondo, chiamato rubrica può essere acceduto solo fornendo l'appropriato nome utente e password.

   [HKEY_CURRENT_USER\Software\PicoSoft\PicoSQL\picoSqlTest]
   DataDirectory=C:\home\test.db
  
   [HKEY_CURRENT_USER\Software\PicoSoft\PicoSQL\rubrica]
   DataDirectory=C:\home\rubrica.db
   User=pico
   Password=soft
   PicoOdbcTrace=NO
   SuspensiveLock=YES
   server=localhost
   port=6789