1 # ----------------------------------------------------------
3 # ----------------------------------------------------------
5 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
6 *** INCOMPATIBLE CHANGES:
7 * SQLT no longer supports setting separate conflicting values for the now
8 deprecated 'quote_table_names' and 'quote_field_names'. Instead their values
9 are proxied to the new 'quote_identifiers'. If 'quote_identifiers' is
10 supplied, the legacy settings are ignored (with a warning). If nothing is
11 specified the default is TRUE as before. If only one is specified - default
12 to its value for everything, and if both are specified with a conflicting
13 value an exception is thrown.
14 * Partial quoting support has been added in SQLite. It is currently disabled by
15 default, you need to request is explicitly with quote_identifiers => 1. In a
16 future version of SQL::Translator *THIS DEFAULT BEHAVIOR WILL CHANGE*.
17 If you do NOT WANT quoting, set quote_identifiers to a false value to
18 protect yourself from changes in a future release.
19 * Bump the default MySQL parser version to MySQL 4.0
20 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
21 * script/sqlt-graph now accepts a --trace option
22 * Fixes to SQLite foreign keys production (patch from Johan Viklund)
23 closes RT#16412, RT#44769
24 * ON DELETE/UPDATE actions for SQLite (patch from Lukas Thiemeier)
25 closes RT#70734, RT#71283, RT#70378
26 * Fix data preservation on SQLite diffs involving adding/dropping columns
27 * Support for triggers in PostgreSQL producer and parser
28 * Correct Data Type in SQLT::Parser::DBI::PostgreSQL (patch from Andrew Pam)
29 * Fix index issue in SQLT::Parser::DBI::PostgreSQL
30 * Add column and table comments in SQLT::Parser::DBI::PostgreSQL(patch from Andrew Pam)
31 * Stop the DBI parser from disconnecting externally supplied DBI handles (RT#35868)
32 * Fixed alter_drop_constraint for foreign keys and applying multiple changes
33 via alter_field to a column in Postgres Producer
34 * Added a working mechanism for naming foreign keys in the PostgreSQL producer
35 * Fix PostgreSQL ignoring default values with specified data type
36 * Fix PostgreSQL parser support for (N)::int defaults (patch by Tina Müller)
37 * Fix possible name duplication in SQLlite producer
38 * Oracle does not accept ON DELETE/UPDATE RESTRICT (though it is the actual default)
39 fix by not adding the ON DELETE/UPDATE clause at all
40 * Changed dependency on Digest::SHA1 to the core-bundled Digest::SHA (RT#67989)
41 * Support for double quoted and bit strings as default values in MySQL parser
42 * Improved VIEW support in MySQL parser
43 * Proper handling of CURRENT_TIMESTAMP default values in MySQL parser (RT#65844)
44 * Check in MySQL parser to avoid trying to parse a table defined twice in the same
45 file as indices (and probably other things) get messed up
46 * Workaround for some MySQL quirks on primary key definitions
47 * Fix dropping primary keys in MySQL diffs (RT#62250, patch from Nick Bertrand)
48 * MySQL producer does not attempt to write out non-existent unique constraint names
49 * MySQL parser correctly differentiates between signed and unsigned integer column
51 * Replace Class::Accessor::Fast dependency with already-included Moo
52 * Entire codebase is now free of tabs and trailing whitespace
53 * Spellfixes (RT#68912)
54 * Fix Diagram Producer POD (RT#71397, RT#71398)
55 * Fix Diagram Producer to use correct binmode on output (RT#71399)
56 * Fix ignored option to script/sqlt-diagram (RT#5992)
57 * Fix t/17sqlfxml-producer.t failures due to whitespace differences introduced by
58 environment config snippets (RT#70786)
59 * Fix assembly of Table objects with numbered columns being added out of order
60 (RT#74771) (based on patch from Jonathan Otsuka)
61 * Fix syntax error in SQL::Translator::Producer::Latex (RT#74953)
62 * Deprecate SQL::Translator::Schema::Graph and the as_graph() schema method
63 * Bump minimum supported perl version to 5.8.1 (mostly due to Moo)
65 # ----------------------------------------------------------
67 # ----------------------------------------------------------
69 * Add "if exists" to drop view statements in Pg.
71 # ----------------------------------------------------------
73 # ----------------------------------------------------------
75 * Fix MySQL producer to properly quote all table names on output (patch from geistteufel)
77 # ----------------------------------------------------------
79 # ----------------------------------------------------------
81 * Correctly create and parse FK constraints in SQLite
82 * Correct postgis geography type insertion and linebreak fix for multiple geometry/geography columns
83 * made PostgreSQL producer consistent with other producers in terms of
84 quoting and allowing functions in constraints and indices
85 * Add distinction of autoinc and regular primary keys to the GraphViz producer
86 * Fix odd invocation of Test::More::pass() in t/36-filters.t (RT#64728)
87 * Quote everything in SQL Server
88 * Turn off constraints before dropping tables in SQL Server
89 * Make true unique constraints if needed in SQL Server
90 * Fixed Producer::PostgresSQL to output array type after type size,
91 i.e. varchar(64)[] rather than varchar[](64)
93 # ----------------------------------------------------------
95 # ----------------------------------------------------------
97 * Fix POD typo in SQL/Translator/Schema/Trigger.pm
98 * Add explicit Scalar::Util to the deplist for really old perls
99 * Add support for PostGIS Geometry and Geography data types in the Pg producer
100 * Some minor fixes to squash warnings on new perls
101 * Support a custom_type_name hint when creating enum types in PostgreSQL
102 * Fix sqlt options/pod mismatch (RT#58318)
103 * Oracle Producer multicolumn constraint support
104 * Add support for triggers in the MySQL producer
105 * Fix unstable order of View's in MySQL parser
107 # ----------------------------------------------------------
109 # ----------------------------------------------------------
110 * Fix Producer::Oracle varchar2 without size def (ORA-00906: missing right
112 * Fix Producer::Oracle translate float and double to float instead of number
113 * Fix Producer::Oracle generation of too long unique constraint names
114 * Fix Producer::SQLite when generating VIEWs with add_drop_table => 1
115 * Fix Producer::MySQL not quoting index names when requested (RT#56173)
116 * Fix Producer::MySQL wrapping extra ()s around VIEW SELECT-ors (RT#56419)
117 * Fix Field::default_value to behave like a real accessor (allow undef as
118 an unsetting argument)
119 * Fix Mysql/Pg/SQLite/MSSQL producers to properly *not* quote numeric default
121 * Producer::Oracle tests now use Test::Differences
122 * Prettify output of SQLite producer (less bogus newlines)
123 * Augment SQLite and Pg producers to accept a perl-formatted (%d.%03d%03d)
124 and regular no-leading-zero (X.X.X) *_version producer args
126 # ----------------------------------------------------------
128 # ----------------------------------------------------------
129 * Fix Parser::DBI::Oracle reading too many tables (RT#49413)
130 * Fix Parser::MySQL tripping up on PRIMARY KEY ... USING (currently value is ignored) (RT#50468)
131 * Fix runaway debug trace (RT#52276)
132 * Fix Parser::PostgreSQL choking on commit; statements in DDL (#RT52277)
133 * Producer::Oracle now respects quote_field|table_names, and
134 no longer does name munging of reserved table names
135 * Producer::Oracle now correctly outputs databse-unique index names
137 # ----------------------------------------------------------
139 # ----------------------------------------------------------
140 * Fix PG producer numeric precision regression (RT#49301)
141 * Add DB2 producer numeric/decimal precision output
142 * Fix Oracle producer creating numeric precision statements that the test case expects (no whitespace)
143 * Add Oracle producer creating drop view statements like PG producer does
144 * Fix SQL::Translator::Diff to use producer_args instead of producer_options
146 # ----------------------------------------------------------
148 # ----------------------------------------------------------
149 * Pg parser fixes to deal properly with MATCH <type>
150 * Pg parser fixes to parse timestamp attributes correctly
151 * Fix broken default detection in script/sqlt (RT#27438)
152 * Fix dependency issues with LibXML and TT
154 # ----------------------------------------------------------
156 # ----------------------------------------------------------
157 * Depend on fixed Parse::RecDescent
158 * Added skip-tables and skip-tables-like options to Diagram
160 # ----------------------------------------------------------
162 # ----------------------------------------------------------
163 * Removed last use of Readonly
164 * Adjusted YAML dependency
166 # ----------------------------------------------------------
168 # ----------------------------------------------------------
169 * Re-add version numbers to files, else cpan's "upgrade" gets very confused
170 * Replaced code using Readonly, since most of the rest uses constant, and thats already a dep
171 * Moved YAML and XML::LibXML back to recommends, the tests for both now skip if not installed
172 * Bumped to 0.11000 to supercede 0.10 which has incorrect numbering scheme
174 # ----------------------------------------------------------
176 # ----------------------------------------------------------
177 * Resolved the following RT bugs (thanks to everyone for reporting!):
178 25791 does not recognize PostgreSQL ON_ERROR_STOP
179 29265 sqlt-diagram: --natural-join needs Graph::Directed
180 37814 SQLite translator failing to parse schema
181 42548 Producer::PostgreSQL incorrectly inserts the size in
182 'time(stamp)? with(out) time zone' fields
183 43173 SQL::Translator::Parser without versionnumber - will install
186 47026 META.yml is not packaged due to MANIFEST.SKIP (easyfix)
187 32130 Move from XML::XPath to XML::LibXML::XPathContext
189 13915 missing optional prerequisite cause make test to fail
190 8847 Diagram.pm: BINMODE missing in printing of graphic file.
191 21065 GraphViz producer fails on tables named 'node'
192 35448 Producer::PostgreSQL types without size
193 22026 sqlt-diagram uses -f arg twice
194 47897 [PATCH] Fix uninitialized value within @_ in (uc|lc)
195 47668 Mysql Parser doesn't recognize key types
196 46448 sqlt-graph errors out on MySQL DDL with btree keys
197 47176 Add Foreign Key support to Parser::DBI::PostgreSQL.pm
198 48025 MySQL Producer: Case inconsistency between elements in
199 @no_length_attr and $data_type
200 48569 sqlt-diagram fails to load SQLite schema
201 48596 SQL::Translator::Diff::schema_diff should produce a list in
203 44907 SQL::Translator::Producer::PostgreSQL produce() in list context
204 should return a list of statements
206 # ----------------------------------------------------------
208 # ----------------------------------------------------------
209 * Fixed Pg parser - caching the compiled P::RD schema is a *very*
211 * Fix MSSQL handling of ON UPDATE/DELETE RESTRICT
212 * Delay MSSQL FK constraint deployment until after all CREATE TABLE
214 * Coerce other engine's bytea/blob/clob datatypes to VarBinary
216 # ----------------------------------------------------------
218 # ----------------------------------------------------------
219 * Multiple test and dependency adhustments to make smokers happy
220 * Fix YAML producer wrt extra attribute
221 * Added support for "time(stamp) (p) with time zone" for Pg producer (mo)
223 # ----------------------------------------------------------
225 # ----------------------------------------------------------
226 * Add parser support for MySQL default values with a single quote
227 * Properly quote absolute table names in the MySQL producer
228 * Added CREATE VIEW subrules for mysql parser (wreis)
229 * Many fixes to code and tests for trigger's "database_events"
230 * Added semi-colon for (DROP|CREATE) TYPE statements in the Pg producer (wreis)
231 * ALTER TABLE/ALTER COLUMN/DROP DEFAULT support in Pg producer (mo)
232 * XML parser support for multi-event triggers
233 * SQLite producer support for multi-event triggers
234 * XML parser switched from XML::XPath to XML::LibXML
235 * Pg producer ALTER TABLE/COLUMN and DROP DEFAULT support
236 * MySQL producer skips length attribute for columns which do not support that
237 attribute. Currently following column types are added to that list:
238 date time timestamp datetime year
239 * Switch to Module::Install (mandates minimum perl 5.005)
240 * Major cleanup of GraphViz proucer
241 * Massive amount of fixes to SQLite/Pg/Mysql/MSSQL parsers/producers
242 Fix most of the problems uncovered by the roundtrip test framework
244 - Rewind exhausted globs before attempting a read
245 - Do not add xml comment header if no_comments is set
246 - table/field counts are held per schema object, not globally
247 - no more variable table and column names in SQLite and MSSQL
248 - VIEW support for Pg parser, also some cleanups
249 - The way we generate Pg create view statements was not standards compliant
250 (per RhodiumToad in #postgresql)
251 - Disable MSSQL view/procedure production - they never worked in the first place
252 - SQLite/MSSQL improvements:
253 - Support parsing of all DROP clauses
254 - Support parsing of field-level comments
255 - When producing do not append table names to constraint/index names
257 # ----------------------------------------------------------
259 # ----------------------------------------------------------
260 * Add support for temporary tables in Pg (nachos)
261 * Create Trigger support for SQLite
262 * GraphViz producer improvements
264 # ----------------------------------------------------------
266 # ----------------------------------------------------------
267 <BORKED RELEASE DELETED OFF CPAN>
269 # ----------------------------------------------------------
271 # ----------------------------------------------------------
272 * parsing MySQL CURRENT_TIMESTAMP as scalar ref so it can be produced without
274 * Add ignore_opts parser arg (to ignore table options) in Parser::MySQL (jgoulah)
275 * Skip tests for buggy Spreadsheet::ParseExcel versions (rbo)
276 * Add support for skip tables parser arg in Parser::DBI::MySQL (jgoulah)
277 * Changed behaviour of ::Producer::Oracle when returning an array of statements
278 to make it compatible to DBI->do()
279 * Fixed a few bugs in ::Producer::Oracle
280 * Applied patch from jgoulah to support mysql's MERGE option
281 * Applied patch from rbo to add support of multiple database events on a trigger
282 * Applied patch from lukes to allow drop if exists in sqlite producer, with
284 * Applied patch from rjbs with minor changes, now we support scalar refs in
286 * Fixed SQLite producer to end index statements in newlines, in scalar context
287 * Decreed that all list context statements shall not end in ; or ;\n
288 * Fixed SQLite, Diff and MySQL producers to agree with Decree.
289 * Added support for CREATE VIEW + tests in the Pg producer (wreis)
290 * Added support for CREATE VIEW + tests in the sqlite producer (groditi)
291 * Added proper argument parsing and documentation to MySQL Parser and
293 * Using DROP VIEW instead of OR REPLACE clause in the Pg producer, as replace
294 only allows replacement with identical set of columns (wreis)
295 * Added support for DROP VIEW and fixed CREATE VIEW statement in the sqlite
297 * Removed source_db and target_db accessors from Diff (throwback to old version,
298 only output_db is used)
301 * Support for longer varchar fields in MySQL
303 # ----------------------------------------------------------
305 # ----------------------------------------------------------
306 * Added support for CREATE VIEW + tests in the mysql producer (groditi)
307 * Added support for SET fields in the mysql producer + test (groditi)
308 * Added support for proper booleans in the mysql producer, when a mysql version
309 of at least 4.x is supplied
310 * Added support for proper enums under pg (as of 8.3), with pg version check,
311 and deferrable constraints
312 * Added support to truncate long constraint and index names in the mysql
313 producer, because of a change to DBIx::Class to produce such long names in
316 # ----------------------------------------------------------
318 # ----------------------------------------------------------
320 * Fix Pg produces idea of which field types need a size param (wreis)
321 * Add support for COLLATE table option to MySQL parser
322 * Allow DEFAULT CHARACTER SET without '=' (as produced by mysqldump)
324 # -----------------------------------------------------------
325 # 0.0899_02 2008-01-29
326 # ----------------------------------------------------------
328 * Major refactoring of SQL::Translator::Diff again:
329 * Diff is no longer one huge monolithic function.
330 * Added more tests for diff
331 * When producing diffs for MySQL you will (by default) get single alter
333 * SQLite can also do remove columns (by creating a temp table as shown in
334 http://sqlite.org/faq.html#q11
335 * Columns can be renamed if the new schema is from a form that can have metadata
336 (which is pretty much anything but an SQL file.) It does this by looking at
337 renamed_from in the $field->extra
338 * Updated Oracle and Postgres producers
341 # -----------------------------------------------------------
342 # 0.0899_01 2007-10-21
343 # ----------------------------------------------------------
345 * SQL::Translator::Diff now uses the ::Producer modules to create diffs
346 This *will* break back-compatibility
347 Use sqlt-diff-old for the previous one, and fix producers!
349 # -----------------------------------------------------------
351 # ----------------------------------------------------------
353 * Patched to ignore all TT versions >= 2.15 until TT is fixed :(
355 # -----------------------------------------------------------
357 # -----------------------------------------------------------
359 * Patched 18ttschema-producer.t and 33tt-table-producter.t to skip on TT 2.15,
362 # -----------------------------------------------------------
364 # -----------------------------------------------------------
366 * Patched MySQL producer to name constraints sanely, thanks Ash
367 * Added patch to Producer::DB2 to avoid dependency issues with foreign keys
368 * Added patch to remove single quotes for numeric default values in Producer::DB2
369 * Fixed Parser::SQLite to require a semicolon after a create trigger statement
370 * Added patch from avinash to add CASCADE to pg table drops
372 # -----------------------------------------------------------
374 # -----------------------------------------------------------
376 * Added patch to use default values for Pg timestamp fields
378 # -----------------------------------------------------------
380 # -----------------------------------------------------------
382 * Added patch from Ash to separate DROP statements in mysql producer in
384 * Fixed up SQLites usage of no-comments
386 # -----------------------------------------------------------
388 # -----------------------------------------------------------
390 * Made Trigger check that a give table exists in on_table - castaway
391 * Split some producers (DB2, MySQL, SQLite, PostgreSQL) into sub methods (others
392 to follow) - castaway
393 * Add alter_* methods to some Producers and docs to Producer.pm (for use by Diff
395 * Made changes to allow producers to return a list of statements - castaway
396 * Split sqlt-diff into script and module - castaway
397 * Added quote_table_names and quote_field_names patch (omega, zamolxes) - castaway
398 * Added DB2 Producer - castaway
399 * Added mysql_character_set for 4.1+ -mda
400 * New filters, Names and Globals. -mda
401 * Added the initial work on a template based Dia UML producer. -mda
403 # -----------------------------------------------------------
405 # -----------------------------------------------------------
406 * YAML parser supports extra attributes on tables.
408 * All schema objects now support the extra attribute, so can
409 have arbitary name/value data attached to them.
411 * Refactoring: Added SQL::Translator::Schema::Object - base
412 class for all Schema objects.
414 * Changes to MySQL Parser (Dave Howorth)
415 - ignore INSERT statements
416 - permit ALTER TABLE ADD FOREIGN KEY
417 - allow trailing comma on last field in CREATE statements
418 - collect the database name
421 - Can pass extra variables using tt_vars producer arg.
422 - Can pass extra config using tt_conf producer arg.
423 - Variables and config can be passed on the command line
424 with --tt-var and --tt-conf options to sqlt.
426 * Added schema filters.
429 - Added 'mysql_table_type' extra attribute on tables.
430 - Works out InnoDB tables from constraints.
431 - mysql_charset and mysql_collate extra attributes for tables and fiels.
434 # -----------------------------------------------------------
436 # -----------------------------------------------------------
437 * Added SQL::Translator::Manual
439 * Installation process now uses Module::Build
441 * Added new "Dumper" producer
443 * Changed the native SQL Fairy XML format to a fixed mapping.
444 *NB:* You should convert your existing XML schema. See the
445 SQL::Translator::Parser::XML::SQLFairy docs.
447 * Added producers: TT::Base and TT::Table.
449 # -----------------------------------------------------------
451 # -----------------------------------------------------------
452 * Added "COMMENT ON *" syntax to PostgreSQL parser
454 * Some fixes to Oracle parser as reported by Gail Binkley
456 * Added support in PostgreSQL parser for all "ALTER TABLE" statements
458 * Now distributing sqlt-diff script as it's pretty usable
460 * Added new options to sqlt-graph and GraphViz producer (Dave Cash)
462 # -----------------------------------------------------------
464 # -----------------------------------------------------------
466 * Increased version of Constants module to 1.41 to avoid a problem
467 where 0.02 has 1.4 of that file and 0.03 had 1.06 which confused
470 * Hard-coded all the PREREQ_PM modules in Makefile.PL (rather than
471 setting them dynamically) so that automated tests would pass
473 # -----------------------------------------------------------
475 # -----------------------------------------------------------
477 * Added parsers: XML::SQLFairy, Sybase, SQLite, DBI-MySQL,
478 DBI-PostgreSQL, DBI-SQLite, DBI-Sybase, Storable, YAML
480 * Added producers: XML::SQLFairy, TTSchema, Storable, YAML
482 * HTML producer now uses stylesheets to allow easy customization of colors
484 * Many bug fixes to most every module
486 * Added "sqlt-dumper" script to help create a script for dumping
487 a database a la "mysqldump"
489 * Reversed the arrowheads on the graphical producers to show the
490 relationships in a more standard way
492 * Changes all included script names to start with "sqlt"
494 * Added capturing and printing most embedded table and field comments
496 # -----------------------------------------------------------
498 # -----------------------------------------------------------
500 * Added parsers for Excel and Oracle
502 * Removed Sybase parser because it didn't actually work
504 * Added ClassDBI, Diagram, GraphViz, HTML, POD, SQLite, Sybase producers
506 * Added Schema classes to represent schema as objects
508 * Removed "Raw" producer in favor of the Schema classes
510 * Removed "Validator" class as the Schema classes validate themselves
512 * Improved all existing parsers and producers, expanding them to
513 handle foreign keys much better, produce better output, etc.
515 * Added sqlt-diagram.pl and sqlt-graphviz.pl as CLI frontends to the
518 * Added sql_translator.cgi as a web-form frontend to graphical producers
520 * Expanded test suite
522 # -----------------------------------------------------------
524 # -----------------------------------------------------------
526 * Added parsers: XML::SQLFairy, Sybase, SQLite, DBI-MySQL,
527 DBI-PostgreSQL, DBI-SQLite, DBI-Sybase, Storable, YAML
529 * Added producers: XML::SQLFairy, TTSchema, Storable, YAML
531 * HTML producer now uses stylesheets to allow easy customization of colors
533 * Many bug fixes to most every module
535 * Added "sqlt-dumper" script to help create a script for dumping
536 a database a la "mysqldump"
538 * Reversed the arrowheads on the graphical producers to show the
539 relationships in a more standard way
541 * Changes all included script names to start with "sqlt"
543 * Added capturing and printing most embedded table and field comments