Hai Sentito il Terremoto?

h1. Sorgenti SQL

I sorgenti della piattaforma lato DB si trovano nel progetto, nella directory @db/@

Si compongono di 4 differenti files:

* struct.sql

* function.add.sql

* function.edit.sql

* view.sql

h2. struct.sql

All'interno sono presenti tutte le definizioni delle tabelle e lo schema delle relazioni, in formato (testo) SQL.

Un +esempio+ di struttura di tabella:

<pre><code class="sql">

CREATE TABLE province(

        id              SMALLINT UNSIGNED NOT NULL AUTO_INCREMENT,

        id_region       SMALLINT UNSIGNED NOT NULL REFERENCES region(id),

        code            CHAR(2) UNIQUE NOT NULL,

        name            CHAR(50) UNIQUE NOT NULL,

        PRIMARY KEY(id)

);

</code></pre>

h2. function.add.sql e function.edit.sql

Definizione di tutte le *STORED FUNCTIONS* e *STORED PROCEDURES* utilizzate per _manipolare_ i dati.

Sono state utilizzate le *STORED FUNCTIONS* e *STORED PROCEDURES* per fornire un'interfaccia comune al sistema e aumentare il livello di sicurezza.

Le funzioni *DOVREBBERO* avere un prefisso comune per l'inserimento e modifica dei dati: *save_<entità>* ma, a causa di continue interruzioni durante l'evoluzione del software, molte funzioni ancora sono distinte in *new_<entità>* e *edit_<entità>*

Un +esempio+ di struttura di una *STORED FUNCTIONS*:

<pre><code class="sql">

delimiter //

DROP FUNCTION IF EXISTS save_communication//

CREATE FUNCTION save_communication(_id INTEGER UNSIGNED, _subject TEXT, _body TEXT, _to_id_event INTEGER UNSIGNED, _to_all_subscribers BOOLEAN, _send_after TINYINT)  RETURNS INT

BEGIN

        IF (_id IS NULL) THEN

                INSERT INTO communication (subject, body, to_id_event, to_all_subscribers, send_after)

                        VALUES (_subject, _body, _to_id_event, _to_all_subscribers, _send_after);

        ELSE

                UPDATE communication SET 

                        added = NOW(), subject = _subject, body = _body,

                        send_after = _send_after

                        WHERE id = _id;

        END IF;

        RETURN 0;

END //

delimiter ;

</code></pre>

h2. view.sql

Definizione di tutte le *VISTE* utilizzate nel sistema. 

Sono state utilizzate le *VISTE* per fornire un'interfaccia comune al sistema e aumentare il livello di sicurezza.

La viste sono, _solitamente_, identificate con il prefisso *list_<entità>* o *list_<entità_entità>*.

Un +esempio+ di struttura di una *VISTA*:

<pre><code class="sql">

CREATE OR REPLACE VIEW list_communication AS

        SELECT c.*,

                e.id_loc, e.ads_id_event, e.mag_pref_value, CAST(e.depth AS DECIMAL(5,1)) AS depth, e.zone_name, e.n_quests AS counter,

                lat_degree, lat_first, ROUND(lat_second) AS lat_second,

                lon_degree, lon_first, ROUND(lon_second) AS lon_second,

                e.event_date

                FROM communication AS c

                LEFT JOIN event AS e ON (c.to_id_event = e.id);

</code></pre>