sql/4_2_0-to-4_2_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 --  #IfMissingColumn
  13 --    arguments: table_name colname
  14 --    behavior:  if the table exists but the column does not,  the block will be executed
  15
  16 --  #IfNotColumnType
  17 --    arguments: table_name colname value
  18 --    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
  19
  20 --  #IfNotRow
  21 --    arguments: table_name colname value
  22 --    behavior:  If the table table_name does not have a row where colname = value, the block will be executed.
  23
  24 --  #IfNotRow2D
  25 --    arguments: table_name colname value colname2 value2
  26 --    behavior:  If the table table_name does not have a row where colname = value AND colname2 = value2, the block will be executed.
  27
  28 --  #IfNotRow3D
  29 --    arguments: table_name colname value colname2 value2 colname3 value3
  30 --    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.
  31
  32 --  #IfNotRow4D
  33 --    arguments: table_name colname value colname2 value2 colname3 value3 colname4 value4
  34 --    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.
  35
  36 --  #IfNotRow2Dx2
  37 --    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.
  38 --    arguments: table_name colname value colname2 value2 colname3 value3
  39 --    behavior:  The block will be executed if both statements below are true:
  40 --               1) The table table_name does not have a row where colname = value AND colname2 = value2.
  41 --               2) The table table_name does not have a row where colname = value AND colname3 = value3.
  42
  43 --  #IfRow2D
  44 --    arguments: table_name colname value colname2 value2
  45 --    behavior:  If the table table_name does have a row where colname = value AND colname2 = value2, the block will be executed.
  46
  47 --  #IfRow3D
  48 --        arguments: table_name colname value colname2 value2 colname3 value3
  49 --        behavior:  If the table table_name does have a row where colname = value AND colname2 = value2 AND colname3 = value3, the block will be executed.
  50
  51 --  #IfIndex
  52 --    desc:      This function is most often used for dropping of indexes/keys.
  53 --    arguments: table_name colname
  54 --    behavior:  If the table and index exist the relevant statements are executed, otherwise not.
  55
  56 --  #IfNotIndex
  57 --    desc:      This function will allow adding of indexes/keys.
  58 --    arguments: table_name colname
  59 --    behavior:  If the index does not exist, it will be created
  60
  61 --  #EndIf
  62 --    all blocks are terminated with a #EndIf statement.
  63