NAME¶

Parse::Dia::SQL - Convert Dia class diagrams into SQL.

SYNOPSIS¶

    use Parse::Dia::SQL;
    my $dia = Parse::Dia::SQL->new(
      file => 't/data/TestERD.dia',
      db   => 'db2'
    );
    print $dia->get_sql();
    # or command-line version
    perl parsediasql --file t/data/TestERD.dia --db db2

DESCRIPTION¶

Dia is a diagram creation program for Linux, Unix and Windows released under the GNU General Public License. Parse::Dia::SQL converts Dia class diagrams into SQL. Parse::Dia::SQL is the parser that interprets the .dia file(s) into an internal datastructure. Parse::Dia::SQL::Output (or one of its sub classes) can take the datastructure and generate the SQL statements it represents.

MODELLING HOWTO¶

See <http://tedia2sql.tigris.org/usingtedia2sql.html>

Modelling differences from tedia2sql¶

•

Index options are supported. Text is taken from the comments field of the operation, i.e. the index. A database specific default value is used if the comments field is left blank. Consult the Output sub class' constructor.

•

Type mapping is supported. A type mapping is a user-defined column name replacement. Unlike tedia2sql the type mapping is non-recursive. Consult "t/data/typemap.dia" for an example.

•

Preliminary support for Dia's database shapes is added.

•

Table comments are used as table postfix options. This means per-table options (e.g. partitioning options) are supported on a per-database level.

•

backticks notation is supported for MySQL-InnoDB.

DIA VERSIONS¶

Parse::Dia::SQL has been tested with Dia versions 0.93 - 0.97. Parse::Dia::SQL uses the XML "version" tag information in the .dia input file to determine how each XML construct is formatted. Future versions of Dia may change the internal format, and XML "version" tag is used to detect such changes.

DATABASE SUPPORT¶

The following databases are supported:

DB2

Informix

Ingres

Oracle

Postgres

Sas

SQLite3

SQLite3fk (with foreign key support)

Sybase

MySQL InnoDB

MySQL MyISAM

Adding support for additional databases means to create a subclass of Parse::Dia::SQL::Output. Patches are welcome.

AUTHOR¶

Parse::Dia::SQL is based on tedia2sql by Tim Ellis and others. See the AUTHORS file for details. Modified by Andreas Faafeng, "<aff at cpan.org>" for release on CPAN.

BUGS¶

Please report any bugs or feature requests to "bug-parse-dia-sql at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Parse-Dia-SQL>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT¶

You can find documentation for this module with the perldoc command.

    perldoc Parse::Dia::SQL

You can also look for information at:

•

Project home

Documentation and public source code repository:

<http://tedia2sql.tigris.org/>

•

RT: CPAN's request tracker

<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Parse-Dia-SQL>

•

AnnoCPAN: Annotated CPAN documentation

<http://annocpan.org/dist/Parse-Dia-SQL>

•

CPAN Ratings

<http://cpanratings.perl.org/d/Parse-Dia-SQL>

•

Search CPAN

<http://search.cpan.org/dist/Parse-Dia-SQL>

SEE ALSO¶

•

<http://tedia2sql.tigris.org/>

•

<http://live.gnome.org/Dia>

ACKNOWLEDGEMENTS¶

See the AUTHORS file.

LICENSE¶

This program is released under the GNU General Public License.

TERMINOLOGY¶

By database we mean relational database management system (RDBMS).

METHODS¶

new()

The constructor. Mandatory arguments:

  file  - The .dia file to parse
  db    - The target database type
    

Dies if target database is unknown or unsupported.

get_sql()

Return sql for given db. Calls underlying methods that performs parsing and sql generation.