debian man page for parse::dia::sql

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

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
       o   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.

       o   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.

       o   Preliminary support for Dia's database shapes is added.

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

       o   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
       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 <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:

       o   Project home

	   Documentation and public source code repository:

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

       o   RT: CPAN's request tracker

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

       o   AnnoCPAN: Annotated CPAN documentation

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

       o   CPAN Ratings

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

       o   Search CPAN

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

SEE ALSO
       o   <http://tedia2sql.tigris.org/>

       o   <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 managment 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.

perl v5.14.2							    2012-02-01						      Parse::Dia::SQL(3pm)