Parse::Dia::SQL(3)

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.