Parse::Dia::SQL::Output::SQLite3(3pm)			User Contributed Perl Documentation		     Parse::Dia::SQL::Output::SQLite3(3pm)

NAME

       Parse::Dia::SQL::Output::SQLite3 - Create SQL for SQLite version 3.

SYNOPSIS

	   use Parse::Dia::SQL;
	   my $dia = Parse::Dia::SQL->new(file => 'foo.dia', db => 'sqlite3');
	   print $dia->get_sql();

DESCRIPTION

       This sub-class creates SQL for the SQLite database version 3.

   new
       The constructor.

       Object names in SQLite have no inherent limit. 60 has been arbitrarily chosen.

   _get_create_table_sql
       Generate create table statement for a single table using SQLite syntax:

       Includes class comments before the table definition.

       Includes autoupdate triggers based on the class comment.

       autoupdate triggers

       If the class comment includes a line like:

       <autoupdate:foo/>

       Then an 'after update' trigger is generated for this table which executes the statement foo for the updated row.

       Examples of use include tracking record modification dates ("<autoupdate:dtModified=datetime('now')/">) or deriving a value from another
       field ("<autoupdate:sSoundex=soundex(sName)/">)

   get_schema_drop
       Generate drop table statments for all tables using SQLite syntax:

	 drop table {foo} if exists

   get_view_drop
       Generate drop view statments for all tables using SQLite syntax:

	 drop view {foo} if exists

   _get_fk_drop
       Drop foreign key enforcement triggers using SQLite syntax:

	 drop trigger {foo} if exists

       The automatically generated foreign key enforcement triggers are:

       See "_get_create_association_sql" for more details.

       constraint_name_bi_tr
       constraint_name_bu_tr
       constraint_name_buparent_tr
       constraint_name_bdparent_tr

   _get_drop_index_sql
       drop index statement using SQLite syntax:

	 drop index {foo} if exists

   get_permissions_create
       SQLite doesn't support permissions, so supress this output.

   get_permissions_drop
       SQLite doesn't support permissions, so supress this output.

   _get_create_association_sql
       Create the foreign key enforcement triggers using SQLite syntax:

	 create trigger {fkname}[_bi_tr|_bu_tr|_bdparent_tr|_buparent_tr]

       Because SQLite doesn't natively enforce foreign key constraints (see <http://www.sqlite.org/omitted.html>), we use triggers to emulate this
       behaviour.

       The trigger names are the default contraint name (something like child_table_fk_child_fkcolumn) with suffixes described below.

       {constraint_name} is the name of the association, either specified or generated.
       {child_table} is the name of the dependent or child table.
       {child_fkcolumn} is the field in the dependent table that hold the foreign key.
       {parent_table} is the name of the parent table.
       {parent_key} is the key field of the parent table.

       Before insert - Dependent Table

       constraint_name_bi_tr

       Before insert on the child table require that the parent key exists.

	 create trigger {constraint_name}_bi_tr before insert on {child_table}
	   for each row
	     begin
	       select
		 raise(abort, 'insert on table {child_table} violates foreign key constraint {constraint_name}')
		 where new.{child_fkcolumn} is not null and (select {parent_key} from {parent_table} where {parent_key}=new.{child_fkcolumn}) is null;
	     end;

       Before update - Dependent Table

       constraint_name_bu_tr

       Before update on the child table require that the parent key exists.

	 create trigger {constraint_name}_bu_tr before update on {table_name}
	   for each row
	     begin
	       select raise(abort, 'update on table {child_table} violates foreign key constraint {constraint_name}')
	       where new.{child_fkcolumn} is not null and (select {parent_key} from {parent_table} where {parent_key}=new.{child_fkcolumn}) is null;
	     end;

       Before update - Parent Table

       constraint_name_buparent_tr

       Before update on the primary key of the parent table ensure that there are no dependent child records.  Note that cascading updates don't
       work.

	 create trigger {constraint_name}_buparent_tr before update on {parent_table}
	   for each row when new.{parent_key} <> old.{parent_key}
	     begin
	       select raise(abort, 'update on table {parent_table} violates foreign key constraint {constraint_name} on {child_table}')
	       where (select {child_fkcolumn} from {child_table} where {child_fkcolumn}=old.{parent_key}) is not null;
	     end;

       Before delete - Parent Table

       constraint_name_bdparent_tr

       The default behaviour can be modified through the contraint (in the multiplicity field) of the association.

       Default (On Delete Restrict)

       Before delete on the parent table ensure that there are no dependent child records.

	 create trigger {constraint_name}_bdparent_tr before delete on {parent_table}
	   for each row
	     begin
	       select raise(abort, 'delete on table {parent_table} violates foreign key constraint {constraint_name} on {child_table}')
	       where (select {child_fkcolumn} from {child_table} where {child_fkcolumn}=old.{parent_key}) is not null;
	     end;

       On Delete Cascade

       Before delete on the parent table delete all dependent child records.

	 create trigger {constraint_name}_bdparent_tr before delete on {parent_table}
	   for each row
	     begin
	       delete from {child_table} where {child_table}.{child_fkcolumn}=old.{parent_key};
	     end;

       On Delete Set Null

       Before delete on the parent table set the foreign key field(s) in all dependent child records to NULL.

	 create trigger {constraint_name}_bdparent_tr before delete on {parent_table}
	   for each row
	     begin
	       update {child_table} set {child_table}.{child_fkcolumn}=null where {child_table}.{child_fkcolumn}=old.{parent_key};
	     end;

TODO

       Things that might get added in future versions:

       Mandatory constraints

       The current foreign key triggers allow NULL in the child table. This might use a keyword in the multiplicity field (perhaps 'required') or
       could check the 'not null' state of the child fkcolumn.

       Views

       Views haven't been tested. They might already work, but who knows...

       Other stuff

       Bugs etc

perl v5.14.2							    2011-02-15				     Parse::Dia::SQL::Output::SQLite3(3pm)