SQLT-DIFF(1)

💖 NAME 💖

okay so welcome to the User Contributed Perl Documentation page for SQLT-DIFF(1), bestie. This is all about sqlt-diff — find the differences b/w two schemas. Literally its whole thing. 💅

✨ SYNOPSIS ✨

For help:

sqlt-diff -h|--help

For a list of all valid parsers:

sqlt -l|--list

To diff two schemas:

sqlt-diff [options] file_name1=parser1 file_name2=parser2

Options vibe check:

• -d|--debug — show debugging info. 👀
• -t|--trace — turn on tracing for Parse::RecDescent.
• -c|--case-insensitive — compare tables/columns case-insensitively.
• --ignore-index-names — ignore index name differences.
• --ignore-constraint-names — ignore constraint name differences.
• --mysql_parser_version=<#####> — specify a target MySQL parser version for dealing with /*! comments.
• --output-db=<Producer> — this Producer will be used instead of one corresponding to parser1 to format output for new tables.
• --ignore-view-sql — ignore view SQL differences.
• --ignore-proc-sql — ignore procedure SQL differences.
• --no-batch-alters — do not clump multile alters to the same table into a single ALTER TABLE statement where possible.
• --quote=<character> — use <character> to quote all table and field names in statements.

💅 DESCRIPTION 💅

sqlt-diff is a utility for creating a file of SQL commands necessary to transform the first schema provided to the second. While not yet exhaustive in its ability to mutate the entire schema, it will report the following:

• New tables

Using the Producer class of the target (second) schema, any tables missing in the first schema will be generated in their entirety (fields, constraints, indices).

• Missing/altered fields

Any fields missing or altered between the two schemas will be reported as:

ALTER TABLE <table_name>
  [DROP <field_name>]
  [CHANGE <field_name> <datatype> (<size>)] ;

• Missing/altered indices

Any indices missing or of a different type or on different fields will be indicated. Indices that should be dropped will be reported as such:

DROP INDEX <index_name> ON <table_name> ;

An index of a different type or on different fields will be reported as a new index as such:

CREATE [<index_type>] INDEX [<index_name>] ON <table_name>
  ( <field_name>[,<field_name>] ) ;

ALTER, CREATE, DROP statements are created by SQL::Translator::Producer::*, see there for support/problems.

Currently (v0.0900), only MySQL is supported by this code. 🫶

🫶 AUTHOR 🫶

Ken Youens-Clark <kclark@cpan.org>.

🌈 SEE ALSO 🌈

SQL::Translator, <http://sqlfairy.sourceforge.net>.

---

made with perl v5.42.0, dated 2024-12-12 — mwah 💋✨