home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / apps / database / ingres04.lzh / doc / quel / index.doc < prev    next >
Encoding:
Text File  |  1992-11-19  |  2.1 KB  |  58 lines
  1.  
  2.  
  3.  
  4.  
  5.      INDEX(QUEL)                  2/21/79                  INDEX(QUEL)
  6.  
  7.  
  8.  
  9.      NAME
  10.           index - create a secondary index on an existing relation.
  11.  
  12.      SYNOPSIS
  13.           _i_n_d_e_x _o_n relname _i_s indexname (domain_1 { ,domain_2})
  14.  
  15.      DESCRIPTION
  16.           _I_n_d_e_x is used to create secondary indices on existing  rela-
  17.           tions  in  order to make retrieval and update with secondary
  18.           keys more efficient.  The secondary key is constructed  from
  19.           relname  domains  1,  2,...,6  in the order given.  Only the
  20.           owner of a relation is allowed to create  secondary  indices
  21.           on that relation.
  22.  
  23.           In order to maintain the integrity of the index, users  will
  24.           NOT  be allowed to directly update secondary indices. Howev-
  25.           er, whenever a primary relation is  changed,  its  secondary
  26.           indices will be automatically updated by the system.  Secon-
  27.           dary indices may be modified to further increase the  access
  28.           efficiency  of the primary relation.  When an index is first
  29.           created, it is automatically modified  to  an  isam  storage
  30.           structure on all its domains.  If this structure is undesir-
  31.           able, the user may override the default  isam  structure  by
  32.           using  the  -_n  switch  (see ingres(unix)), or by entering a
  33.           _m_o_d_i_f_y command directly.
  34.  
  35.           If a _m_o_d_i_f_y or _d_e_s_t_r_o_y  command  is  used  on  _r_e_l_n_a_m_e,  all
  36.           secondary indices on _r_e_l_n_a_m_e are destroyed.
  37.  
  38.           Secondary indices on other indices, or on  system  relations
  39.           are forbidden.
  40.  
  41.      EXAMPLE
  42.           /* Create a secondary index called ``x'' on relation ``emp'' */
  43.              index on emp is x(mgr,sal)
  44.  
  45.      SEE ALSO
  46.           copy(quel), destroy(quel), modify(quel)
  47.  
  48.      BUGS
  49.           At most 6 domains may appear in the key.
  50.  
  51.           The _c_o_p_y command cannot be used  to  copy  into  a  relation
  52.           which has secondary indices.
  53.  
  54.           The default structure isam is a poor choice for an index un-
  55.           less the range of retrieval is small.
  56.  
  57.  
  58.