sql/5_0_0-to-5_0_1_upgrade.sql

   1 --
   2 --  Comment Meta Language Constructs:
   3 --
   4 --  #IfNotTable
   5 --    argument: table_name
   6 --    behavior: if the table_name does not exist,  the block will be executed
   7
   8 --  #IfTable
   9 --    argument: table_name
  10 --    behavior: if the table_name does exist, the block will be executed
  11
  12 --  #IfColumn
  13 --    arguments: table_name colname
  14 --    behavior:  if the table and column exist,  the block will be executed
  15
  16 --  #IfMissingColumn
  17 --    arguments: table_name colname
  18 --    behavior:  if the table exists but the column does not,  the block will be executed
  19
  20 --  #IfNotColumnType
  21 --    arguments: table_name colname value
  22 --    behavior:  If the table table_name does not have a column colname with a data type equal to value, then the block will be executed
  23
  24 --  #IfNotRow
  25 --    arguments: table_name colname value
  26 --    behavior:  If the table table_name does not have a row where colname = value, the block will be executed.
  27
  28 --  #IfNotRow2D
  29 --    arguments: table_name colname value colname2 value2
  30 --    behavior:  If the table table_name does not have a row where colname = value AND colname2 = value2, the block will be executed.
  31
  32 --  #IfNotRow3D
  33 --    arguments: table_name colname value colname2 value2 colname3 value3
  34 --    behavior:  If the table table_name does not have a row where colname = value AND colname2 = value2 AND colname3 = value3, the block will be executed.
  35
  36 --  #IfNotRow4D
  37 --    arguments: table_name colname value colname2 value2 colname3 value3 colname4 value4
  38 --    behavior:  If the table table_name does not have a row where colname = value AND colname2 = value2 AND colname3 = value3 AND colname4 = value4, the block will be executed.
  39
  40 --  #IfNotRow2Dx2
  41 --    desc:      This is a very specialized function to allow adding items to the list_options table to avoid both redundant option_id and title in each element.
  42 --    arguments: table_name colname value colname2 value2 colname3 value3
  43 --    behavior:  The block will be executed if both statements below are true:
  44 --               1) The table table_name does not have a row where colname = value AND colname2 = value2.
  45 --               2) The table table_name does not have a row where colname = value AND colname3 = value3.
  46
  47 --  #IfRow2D
  48 --    arguments: table_name colname value colname2 value2
  49 --    behavior:  If the table table_name does have a row where colname = value AND colname2 = value2, the block will be executed.
  50
  51 --  #IfRow3D
  52 --        arguments: table_name colname value colname2 value2 colname3 value3
  53 --        behavior:  If the table table_name does have a row where colname = value AND colname2 = value2 AND colname3 = value3, the block will be executed.
  54
  55 --  #IfIndex
  56 --    desc:      This function is most often used for dropping of indexes/keys.
  57 --    arguments: table_name colname
  58 --    behavior:  If the table and index exist the relevant statements are executed, otherwise not.
  59
  60 --  #IfNotIndex
  61 --    desc:      This function will allow adding of indexes/keys.
  62 --    arguments: table_name colname
  63 --    behavior:  If the index does not exist, it will be created
  64
  65 --  #EndIf
  66 --    all blocks are terminated with a #EndIf statement.
  67
  68 --  #IfNotListReaction
  69 --    Custom function for creating Reaction List
  70
  71 --  #IfNotListOccupation
  72 --    Custom function for creating Occupation List
  73
  74 --  #IfTextNullFixNeeded
  75 --    desc: convert all text fields without default null to have default null.
  76 --    arguments: none
  77
  78 --  #IfTableEngine
  79 --    desc:      Execute SQL if the table has been created with given engine specified.
  80 --    arguments: table_name engine
  81 --    behavior:  Use when engine conversion requires more than one ALTER TABLE
  82
  83 --  #IfInnoDBMigrationNeeded
  84 --    desc: find all MyISAM tables and convert them to InnoDB.
  85 --    arguments: none
  86 --    behavior: can take a long time.
  87