SQL::Translator::Producer::MySQL.3pm

Langue: en

Version: 2009-08-18 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

NAME

SQL::Translator::Producer::MySQL - MySQL-specific producer for SQL::Translator

SYNOPSIS

Use via SQL::Translator:
   use SQL::Translator;
 
   my $t = SQL::Translator->new( parser => '...', producer => 'MySQL', '...' );
   $t->translate;
 
 

DESCRIPTION

This module will produce text output of the schema suitable for MySQL. There are still some issues to be worked out with syntax differences between MySQL versions 3 and 4 (``SET foreign_key_checks,'' character sets for fields, etc.).

ARGUMENTS

This producer takes a single optional producer_arg "mysql_version", which provides the desired version for the target database. By default MySQL v3 is assumed, and statements pertaining to any features introduced in later versions (e.g. CREATE VIEW) are not produced.

Valid version specifiers for "mysql_version" are listed here

Table Types

Normally the tables will be created without any explicit table type given and so will use the MySQL default.

Any tables involved in foreign key constraints automatically get a table type of InnoDB, unless this is overridden by setting the "mysql_table_type" extra attribute explicitly on the table.

Extra attributes.

The producer recognises the following extra attributes on the Schema objects.
field.list
Set the list of allowed values for Enum fields.
field.binary, field.unsigned, field.zerofill
Set the MySQL field options of the same name.
field.renamed_from, table.renamed_from
Use when producing diffs to indicate that the current table/field has been renamed from the old name as given in the attribute value.
table.mysql_table_type
Set the type of the table e.g. 'InnoDB', 'MyISAM'. This will be automatically set for tables involved in foreign key constraints if it is not already set explicitly. See ``Table Types''.

Please note that the "ENGINE" option is the prefered method of specifying the MySQL storage engine to use, but this method still works for backwards compatability.

table.mysql_charset, table.mysql_collate
Set the tables default charater set and collation order.
field.mysql_charset, field.mysql_collate
Set the fields charater set and collation order.

SEE ALSO

SQL::Translator, http://www.mysql.com/.

AUTHORS

darren chamberlain <darren@cpan.org>, Ken Youens-Clark <kclark@cpan.org>.