sql::translator::parser::xml::sqlfairy(3pm) [debian man page]

SQL::Translator::Parser::XML::SQLFairy(3pm)		User Contributed Perl Documentation	       SQL::Translator::Parser::XML::SQLFairy(3pm)

NAME

       SQL::Translator::Parser::XML::SQLFairy - parser for SQL::Translator's XML.

SYNOPSIS

	 use SQL::Translator;

	 my $translator = SQL::Translator->new( show_warnings  => 1 );

	 my $out = $obj->translate(
	     from     => 'XML-SQLFairy',
	     to       => 'MySQL',
	     filename => 'schema.xml',
	 ) or die $translator->error;

	 print $out;

DESCRIPTION

       This parser handles the flavor of XML used natively by the SQLFairy project (SQL::Translator).  The XML must be in the namespace
       "http://sqlfairy.sourceforge.net/sqlfairy.xml."	See SQL::Translator::Producer::XML::SQLFairy for details of this format.

       You do not need to specify every attribute of the Schema objects as any missing from the XML will be set to their default values. e.g. A
       field could be written using only;

	<sqlf:field name="email" data_type="varchar" size="255" />

       Instead of the full;

	<sqlf:field name="email" data_type="varchar" size="255" is_nullable="1"
	  is_auto_increment="0" is_primary_key="0" is_foreign_key="0" order="4">
	  <sqlf:comments></sqlf:comments>
	</sqlf:field>

       If you do not explicitly set the order of items using order attributes on the tags then the order the tags appear in the XML will be used.

   default_value
       Leave the attribute out all together to use the default in Schema::Field.  Use empty quotes or 'EMPTY_STRING' for a zero lenth string.
       'NULL' for an explicit null (currently sets default_value to undef in the Schema::Field obj).

	 <sqlf:field default_value="" />		<!-- Empty string -->
	 <sqlf:field default_value="EMPTY_STRING" />	<!-- Empty string -->
	 <sqlf:field default_value="NULL" />		<!-- NULL -->

   ARGS
       Doesn't take any extra parser args at the moment.

LEGACY FORMAT

       The previous version of the SQLFairy XML allowed the attributes of the the schema objects to be written as either xml attributes or as data
       elements, in any combination. While this allows for lots of flexibility in writing the XML the result is a great many possible XML formats,
       not so good for DTD writing, XPathing etc! So we have moved to a fixed version described in SQL::Translator::Producer::XML::SQLFairy.

       This version of the parser will still parse the old formats and emmit warnings when it sees them being used but they should be considered
       heavily depreciated.

       To convert your old format files simply pass them through the translator :)

	$ sqlt -f XML-SQLFairy -t XML-SQLFairy schema-old.xml > schema-new.xml

BUGS

       Ignores the order attribute for Constraints, Views, Indices, Views, Triggers and Procedures, using the tag order instead. (This is the
       order output by the SQLFairy XML producer).

SEE ALSO

       perl, SQL::Translator, SQL::Translator::Producer::XML::SQLFairy, SQL::Translator::Schema.

TODO

       o   Support options attribute.

       o   Test foreign keys are parsed ok.

       o   Control over defaulting.

AUTHOR

       Mark D. Addison <mark.addison@itn.co.uk>, Jonathan Yu <frequency@cpan.org>

perl v5.14.2							    2012-01-18			       SQL::Translator::Parser::XML::SQLFairy(3pm)

Check Out this Related Man Page

SQL::Translator::Parser::DBIx::Class(3pm)		User Contributed Perl Documentation		 SQL::Translator::Parser::DBIx::Class(3pm)

NAME

       SQL::Translator::Parser::DBIx::Class - Create a SQL::Translator schema from a DBIx::Class::Schema instance

SYNOPSIS

	## Via DBIx::Class
	use MyApp::Schema;
	my $schema = MyApp::Schema->connect("dbi:SQLite:something.db");
	$schema->create_ddl_dir();
	## or
	$schema->deploy();

	## Standalone
	use MyApp::Schema;
	use SQL::Translator;

	my $schema = MyApp::Schema->connect;
	my $trans  = SQL::Translator->new (
	     parser	 => 'SQL::Translator::Parser::DBIx::Class',
	     parser_args => {
		 package => $schema,
		 add_fk_index => 0,
		 sources => [qw/
		   Artist
		   CD
		 /],
	     },
	     producer	 => 'SQLite',
	    ) or die SQL::Translator->error;
	my $out = $trans->translate() or die $trans->error;

DESCRIPTION

       This class requires SQL::Translator installed to work.

       "SQL::Translator::Parser::DBIx::Class" reads a DBIx::Class schema, interrogates the columns, and stuffs it all in an $sqlt_schema object.

       Its primary use is in deploying database layouts described as a set of DBIx::Class classes, to a database. To do this, see "deploy" in
       DBIx::Class::Schema.

       This can also be achieved by having DBIx::Class export the schema as a set of SQL files ready for import into your database, or passed to
       other machines that need to have your application installed but don't have SQL::Translator installed. To do this see "create_ddl_dir" in
       DBIx::Class::Schema.

PARSER OPTIONS

   add_fk_index
       Create an index for each foreign key.  Enabled by default, as having indexed foreign key columns is normally the sensible thing to do.

   sources
       Arguments: @class_names

       Limit the amount of parsed sources by supplying an explicit list of source names.

SEE ALSO

       SQL::Translator, DBIx::Class::Schema

AUTHORS

       See "CONTRIBUTORS" in DBIx::Class.

LICENSE

       You may distribute this code under the same terms as Perl itself.

perl v5.14.2							    2011-05-10				 SQL::Translator::Parser::DBIx::Class(3pm)

Linux and UNIX Man Pages

sql::translator::parser::xml::sqlfairy(3pm) [debian man page]

Check Out this Related Man Page