SQL::Translator::ParseUserMContributeSQL::Translator::Parser::XML::SQLFairy(3)NAMESQL::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
· 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>
perl v5.14.2201SQL::Translator::Parser::XML::SQLFairy(3)