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.
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¶
- •
- Support options attribute.
- •
- Test foreign keys are parsed ok.
- •
- Control over defaulting.
AUTHOR¶
Mark D. Addison <mark.addison@itn.co.uk>, Jonathan Yu
<frequency@cpan.org>