1 package SQL::Translator::Parser::SQLite;
3 # -------------------------------------------------------------------
4 # $Id: SQLite.pm,v 1.2 2003-10-04 01:16:39 kycl4rk Exp $
5 # -------------------------------------------------------------------
6 # Copyright (C) 2003 Ken Y. Clark <kclark@cpan.org>,
7 # darren chamberlain <darren@cpan.org>,
8 # Chris Mungall <cjm@fruitfly.org>
10 # This program is free software; you can redistribute it and/or
11 # modify it under the terms of the GNU General Public License as
12 # published by the Free Software Foundation; version 2.
14 # This program is distributed in the hope that it will be useful, but
15 # WITHOUT ANY WARRANTY; without even the implied warranty of
16 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 # General Public License for more details.
19 # You should have received a copy of the GNU General Public License
20 # along with this program; if not, write to the Free Software
21 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
23 # -------------------------------------------------------------------
27 SQL::Translator::Parser::SQLite - parser for SQLite
32 use SQL::Translator::Parser::SQLite;
34 my $translator = SQL::Translator->new;
35 $translator->parser("SQL::Translator::Parser::SQLite");
39 This is a grammar for parsing CREATE statements for SQLite as
42 http://www.sqlite.org/lang.html
47 CREATE [TEMP | TEMPORARY] [UNIQUE] INDEX index-name
48 ON [database-name .] table-name ( column-name [, column-name]* )
49 [ ON CONFLICT conflict-algorithm ]
57 CREATE [TEMP | TEMPORARY] TABLE table-name (
58 column-def [, column-def]*
63 CREATE [TEMP | TEMPORARY] TABLE table-name AS select-statement
66 name [type] [[CONSTRAINT name] column-constraint]*
71 typename ( number , number )
74 NOT NULL [ conflict-clause ] |
75 PRIMARY KEY [sort-order] [ conflict-clause ] |
76 UNIQUE [ conflict-clause ] |
77 CHECK ( expr ) [ conflict-clause ] |
81 PRIMARY KEY ( name [, name]* ) [ conflict-clause ]|
82 UNIQUE ( name [, name]* ) [ conflict-clause ] |
83 CHECK ( expr ) [ conflict-clause ]
86 ON CONFLICT conflict-algorithm
91 CREATE [TEMP | TEMPORARY] TRIGGER trigger-name [ BEFORE | AFTER ]
92 database-event ON [database-name .] table-name
96 CREATE [TEMP | TEMPORARY] TRIGGER trigger-name INSTEAD OF
97 database-event ON [database-name .] view-name
104 UPDATE OF column-list
107 [ FOR EACH ROW | FOR EACH STATEMENT ] [ WHEN expression ]
109 trigger-step ; [ trigger-step ; ]*
113 update-statement | insert-statement |
114 delete-statement | select-statemen
119 CREATE [TEMP | TEMPORARY] VIEW view-name AS select-statement
124 ON CONFLICT conflict-algorithm
126 conflict-algorithm ::=
127 ROLLBACK | ABORT | FAIL | IGNORE | REPLACE
132 expr binary-op expr |
137 table-name . column-name |
138 database-name . table-name . column-name |
140 function-name ( expr-list | * ) |
144 expr [NOT] BETWEEN expr AND expr |
145 expr [NOT] IN ( value-list ) |
146 expr [NOT] IN ( select-statement ) |
147 ( select-statement ) |
148 CASE [expr] ( WHEN expr THEN expr )+ [ELSE expr] END
151 LIKE | GLOB | NOT LIKE | NOT GLOB
156 use vars qw[ $DEBUG $VERSION $GRAMMAR @EXPORT_OK ];
157 $VERSION = sprintf "%d.%02d", q$Revision: 1.2 $ =~ /(\d+)\.(\d+)/;
158 $DEBUG = 0 unless defined $DEBUG;
161 use Parse::RecDescent;
163 use base qw(Exporter);
165 @EXPORT_OK = qw(parse);
167 # Enable warnings within the Parse::RecDescent module.
168 $::RD_ERRORS = 1; # Make sure the parser dies when it encounters an error
169 $::RD_WARN = 1; # Enable warnings. This will warn on unused rules &c.
170 $::RD_HINT = 1; # Give out hints to help fix problems.
175 my ( %tables, $table_order, @table_comments, @views, @triggers );
179 # The "eofile" rule makes the parser fail if any "statement" rule
180 # fails. Otherwise, the first successful match by a "statement"
181 # won't cause the failure needed to know that the parse, as a whole,
184 startrule : statement(s) eofile {
188 triggers => \@triggers,
194 statement : begin_transaction
200 begin_transaction : /begin transaction/i SEMICOLON
202 commit : /commit/i SEMICOLON
204 comment : /^\s*(?:#|-{2}).*\n/
206 my $comment = $item[1];
207 $comment =~ s/^\s*(#|-{2})\s*//;
208 $comment =~ s/\s*$//;
212 comment : /\/\*/ /[^\*]+/ /\*\//
214 my $comment = $item[2];
215 $comment =~ s/^\s*|\s*$//g;
222 create : CREATE TEMPORARY(?) UNIQUE(?) INDEX WORD ON table_name parens_field_list conflict_clause(?) SEMICOLON
224 my $db_name = $item[7]->{'db_name'} || '';
225 my $table_name = $item[7]->{'name'};
230 on_conflict => $item[9][0],
231 is_temporary => $item[2][0] ? 1 : 0,
234 my $is_unique = $item[3][0];
237 $index->{'type'} = 'unique';
238 push @{ $tables{ $table_name }{'constraints'} }, $index;
241 push @{ $tables{ $table_name }{'indices'} }, $index;
248 create : CREATE TEMPORARY(?) TABLE table_name '(' definition(s /,/) ')' SEMICOLON
250 my $db_name = $item[4]->{'db_name'} || '';
251 my $table_name = $item[4]->{'name'};
253 $tables{ $table_name }{'name'} = $table_name;
254 $tables{ $table_name }{'is_temporary'} = $item[2][0] ? 1 : 0;
255 $tables{ $table_name }{'order'} = ++$table_order;
257 for my $def ( @{ $item[6] } ) {
258 if ( $def->{'supertype'} eq 'column' ) {
259 push @{ $tables{ $table_name }{'fields'} }, $def;
261 elsif ( $def->{'supertype'} eq 'constraint' ) {
262 push @{ $tables{ $table_name }{'constraints'} }, $def;
267 definition : constraint_def | column_def
269 column_def: NAME type(?) column_constraint(s?)
272 supertype => 'column',
274 data_type => $item[2][0]->{'type'},
275 size => $item[2][0]->{'size'},
281 constraints => $item[3],
284 for my $c ( @{ $item[3] } ) {
285 if ( $c->{'type'} eq 'not_null' ) {
286 $column->{'is_nullable'} = 0;
288 elsif ( $c->{'type'} eq 'primary_key' ) {
289 $column->{'is_primary_key'} = 1;
291 elsif ( $c->{'type'} eq 'unique' ) {
292 $column->{'is_unique'} = 1;
294 elsif ( $c->{'type'} eq 'check' ) {
295 $column->{'check'} = $c->{'expression'};
297 elsif ( $c->{'type'} eq 'default' ) {
298 $column->{'default'} = $c->{'value'};
305 type : WORD parens_value_list(?)
313 column_constraint : NOT_NULL conflict_clause(?)
320 PRIMARY_KEY sort_order(?) conflict_clause(?)
323 type => 'primary_key',
324 sort_order => $item[2][0],
325 on_conflict => $item[2][0],
329 UNIQUE conflict_clause(?)
333 on_conflict => $item[2][0],
337 CHECK_C '(' expr ')' conflict_clause(?)
341 expression => $item[3],
342 on_conflict => $item[5][0],
354 constraint_def : PRIMARY_KEY parens_field_list conflict_clause(?)
357 supertype => 'constraint',
358 type => 'primary_key',
360 on_conflict => $item[3][0],
364 UNIQUE parens_field_list conflict_clause(?)
367 supertype => 'constraint',
370 on_conflict => $item[3][0],
374 CHECK_C '(' expr ')' conflict_clause(?)
377 supertype => 'constraint',
379 expression => $item[3],
380 on_conflict => $item[5][0],
384 table_name : qualified_name
386 qualified_name : NAME
387 { $return = { name => $item[1] } }
389 qualified_name : /(\w+)\.(\w+)/
390 { $return = { db_name => $1, name => $2 } }
394 conflict_clause : /on conflict/i conflict_algorigthm
396 conflict_algorigthm : /(rollback|abort|fail|ignore|replace)/i
398 parens_field_list : '(' column_list ')'
401 column_list : field_name(s /,/)
403 parens_value_list : '(' VALUE(s /,/) ')'
408 sort_order : /(ASC|DESC)/i
413 create : CREATE TEMPORARY(?) TRIGGER NAME before_or_after(?) database_event ON table_name trigger_action
415 my $table_name = $item[8]->{'name'};
418 is_temporary => $item[2][0] ? 1 : 0,
421 db_event => $item[6],
426 create : CREATE TEMPORARY(?) TRIGGER NAME instead_of database_event ON view_name trigger_action
428 my $table_name = $item[8]->{'name'};
431 is_temporary => $item[2][0] ? 1 : 0,
434 db_event => $item[6],
439 database_event : /(delete|insert|update)/i
441 database_event : /update of/i column_list
443 trigger_action : for_each(?) when(?) BEGIN_C trigger_step(s) END_C
446 for_each => $item[1][0],
452 for_each : /FOR EACH ROW/i | /FOR EACH STATEMENT/i
454 when : WHEN expr { $item[2] }
456 trigger_step : /(select|delete|insert|update)/i /[^;]+/ SEMICOLON
458 $return = join( ' ', $item[1], $item[2] )
461 before_or_after : /(before|after)/i { $return = lc $1 }
463 instead_of : /instead of/i
465 view_name : qualified_name
470 create : CREATE TEMPORARY(?) VIEW view_name AS select_statement
473 name => $item[4]->{'name'},
475 is_temporary => $item[2][0] ? 1 : 0,
479 select_statement : SELECT /[^;]+/ SEMICOLON
481 $return = join( ' ', $item[1], $item[2] );
493 TEMPORARY : /temp(orary)?/i { 1 }
499 NOT_NULL : /not null/i
501 PRIMARY_KEY : /primary key/i
521 UNIQUE : /unique/i { 1 }
525 NAME : /'?(\w+)'?/ { $return = $1 }
527 VALUE : /[-+]?\.?\d+(?:[eE]\d+)?/
531 # remove leading/trailing quotes
533 $val =~ s/^['"]|['"]$//g;
541 # -------------------------------------------------------------------
543 my ( $translator, $data ) = @_;
544 my $parser = Parse::RecDescent->new($GRAMMAR);
546 local $::RD_TRACE = $translator->trace ? 1 : undef;
547 local $DEBUG = $translator->debug;
549 unless (defined $parser) {
550 return $translator->error("Error instantiating Parse::RecDescent ".
551 "instance: Bad grammer");
554 my $result = $parser->startrule($data);
555 return $translator->error( "Parse failed." ) unless defined $result;
556 warn Dumper( $result ) if $DEBUG;
558 my $schema = $translator->schema;
560 $result->{ $a }->{'order'} <=> $result->{ $b }->{'order'}
561 } keys %{ $result->{'tables'} };
563 for my $table_name ( @tables ) {
564 my $tdata = $result->{'tables'}{ $table_name };
565 my $table = $schema->add_table(
566 name => $tdata->{'name'},
567 ) or die $schema->error;
569 $table->comments( $tdata->{'comments'} );
571 for my $fdata ( @{ $tdata->{'fields'} } ) {
572 my $field = $table->add_field(
573 name => $fdata->{'name'},
574 data_type => $fdata->{'data_type'},
575 size => $fdata->{'size'},
576 default_value => $fdata->{'default'},
577 is_auto_increment => $fdata->{'is_auto_inc'},
578 is_nullable => $fdata->{'is_nullable'},
579 comments => $fdata->{'comments'},
580 ) or die $table->error;
582 $table->primary_key( $field->name ) if $fdata->{'is_primary_key'};
584 for my $cdata ( @{ $fdata->{'constraints'} } ) {
585 next unless $cdata->{'type'} eq 'foreign_key';
586 $cdata->{'fields'} ||= [ $field->name ];
587 push @{ $tdata->{'constraints'} }, $cdata;
591 for my $idata ( @{ $tdata->{'indices'} || [] } ) {
592 my $index = $table->add_index(
593 name => $idata->{'name'},
594 type => uc $idata->{'type'},
595 fields => $idata->{'fields'},
596 ) or die $table->error;
599 for my $cdata ( @{ $tdata->{'constraints'} || [] } ) {
600 my $constraint = $table->add_constraint(
601 name => $cdata->{'name'},
602 type => $cdata->{'type'},
603 fields => $cdata->{'fields'},
604 reference_table => $cdata->{'reference_table'},
605 reference_fields => $cdata->{'reference_fields'},
606 match_type => $cdata->{'match_type'} || '',
607 on_delete => $cdata->{'on_delete_do'},
608 on_update => $cdata->{'on_update_do'},
609 ) or die $table->error;
613 for my $def ( @{ $result->{'views'} || [] } ) {
614 my $view = $schema->add_view(
615 name => $def->{'name'},
616 sql => $def->{'sql'},
620 for my $def ( @{ $result->{'triggers'} || [] } ) {
621 my $view = $schema->add_trigger(
622 name => $def->{'name'},
623 perform_action_when => $def->{'when'},
624 database_event => $def->{'db_event'},
625 action => $def->{'action'},
634 # -------------------------------------------------------------------
635 # All wholsome food is caught without a net or a trap.
637 # -------------------------------------------------------------------
643 Ken Y. Clark E<lt>kclark@cpan.orgE<gt>.
647 perl(1), Parse::RecDescent, SQL::Translator::Schema.