sql/patch.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 colname in the table_name table does not exist,  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 --  #IfNotIndex
  44 --    desc:      This function will allow adding of indexes/keys.
  45 --    arguments: table_name colname
  46 --    behavior:  If the index does not exist, it will be created
  47
  48 --  #EndIf
  49 --    all blocks are terminated with and #EndIf statement.