home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / apps / database / ingres04.lzh / doc / ref.doc < prev   
Encoding:
Text File  |  1992-09-11  |  11.8 KB  |  313 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                  @@@@@  @   @  @@@@@  @@@@   @@@@@   @@@@
  21.                    @    @@  @  @      @   @  @      @
  22.                    @    @@  @  @      @   @  @      @
  23.                    @    @ @ @  @  @@  @@@@   @@@@    @@@
  24.                    @    @  @@  @   @  @ @    @          @
  25.                    @    @  @@  @   @  @  @   @          @
  26.                  @@@@@  @   @   @@@@  @   @  @@@@@  @@@@
  27.  
  28.  
  29.  
  30.                                  VERSION 8
  31.  
  32.                       R E F E R E N C E   M A N U A L
  33.  
  34.  
  35.                                   9/11/92
  36.  
  37.  
  38.                                     by
  39.  
  40.  
  41.                                 Joe Kalash
  42.                                 Lisa Rodgin
  43.                                Zelaine Fong
  44.                                 Jeff Anton
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.           This manual is a reference manual for the INGRES  data  base
  62.           system.   It  documents  the  use  of INGRES in a very terse
  63.           manner.  To learn how to use INGRES, refer to  the  document
  64.           called ``A Tutorial on INGRES''.
  65.  
  66.           The INGRES reference manual is subdivided into four parts:
  67.             Quel    describes the commands and features which are used
  68.                     inside of INGRES.
  69.             Unix    describes the INGRES programs which are executable
  70.                     as UNIX commands.
  71.             Files   describes some of  the  important  files  used  by
  72.                     INGRES.
  73.             Error   lists all  the  user  generatable  error  messages
  74.                     along  with  some elaboration as to what they mean
  75.                     or what we think they mean.
  76.  
  77.           Each entry in this manual has one or more of  the  following
  78.           sections:
  79.  
  80.           NAME section
  81.                This section repeats the name of the entry and gives an
  82.                indication of its purpose.
  83.  
  84.           SYNOPSIS section
  85.                This section indicates the form of the command  (state-
  86.                ment).  The conventions which are used are as follows:
  87.  
  88.                   Bold face names are used to indicate  reserved  key-
  89.                          words.
  90.                   Lower case words indicate generic types of  informa-
  91.                          tion  which must be supplied by the user; le-
  92.                          gal values for these names are  described  in
  93.                          the DESCRIPTION section.
  94.                   Square brakets ( [] )  indicate  that  the  enclosed
  95.                          item is optional.
  96.                   Braces ( {} ) indicate an optional item which may be
  97.                          repeated.  In some cases they indicate simple
  98.                          (non-repeated) grouping; the usage should  be
  99.                          clear from context.
  100.  
  101.                When these conventions are insufficient to fully speci-
  102.                fy the legal format of a command a more general form is
  103.                given and the allowable subsets are  specified  in  the
  104.                DESCRIPTION section.
  105.  
  106.           DESCRIPTION section
  107.                This section gives a detailed description of the  entry
  108.                with  references  to  the  generic  names  used  in the
  109.                SYNOPSIS section.
  110.  
  111.           EXAMPLE section
  112.                This section gives one or more examples of the  use  of
  113.                the  entry.   Most  of  these examples are based on the
  114.                following relations:
  115.                                emp(name,sal,mgr,bdate)
  116.                                          and
  117.                                 newemp(name,sal,age)
  118.                                         and
  119.                        parts(pnum, pname, color, weight, qoh)
  120.  
  121.           SEE ALSO section
  122.                This section gives the names of entries in  the  manual
  123.                which are closely related to the current entry or which
  124.                are referenced in the description of the current entry.
  125.  
  126.           BUGS section
  127.                This section indicates known bugs  or  deficiencies  in
  128.                the command.
  129.  
  130.           To start using INGRES you must be entered as an INGRES user;
  131.           this  is done by the INGRES administrator who will enter you
  132.           in the ``users'' file (see users(files)).   To  start  using
  133.           ingres  see  the  section  on  ingres(unix), quel(quel), and
  134.           monitor(quel).
  135.  
  136.  
  137.      ACKNOWLEDGEMENTS
  138.           We would like to acknowledge the people who have  worked  on
  139.           INGRES in the past:
  140.  
  141.                Eric Allman
  142.                Rick Birman
  143.                Bob Epstein
  144.                James Ford
  145.                Paula Hawthorn
  146.                Gerald Held
  147.                Peter Kreps
  148.                Marc Meyer
  149.                Jeff Ranstrom
  150.                Dan Ries
  151.                Peter Rubinstein
  152.                Polly Siegal
  153.                Mike Ubell
  154.                John Woodfill
  155.                Nick Whyte
  156.                Karel Youssefi
  157.                William Zook
  158.  
  159.  
  160.  
  161.                 TABLE OF CONTENTS
  162.  
  163.           APPEND(QUEL) - append tuples to a relation
  164.               _a_p_p_e_n_d [_t_o] relname (target_list) [_w_h_e_r_e qual]
  165.  
  166.           COPY(QUEL) - copy data into/from a relation from/into a UNIX
  167.               file.
  168.               _c_o_p_y relname (domname = format {, domname = format })
  169.                         direction "filename"
  170.  
  171.           CREATE(QUEL) - create a new relation
  172.               _c_r_e_a_t_e relname (domname_1 = format {, domname_2  =  format
  173.               })
  174.  
  175.           DEFINE(QUEL) - define subschema
  176.               _d_e_f_i_n_e _v_i_e_w name (target list) [ _w_h_e_r_e qual ]
  177.               _d_e_f_i_n_e _p_e_r_m_i_t oplist { _o_n | _o_f | _t_o } var [ (attlist)  ]
  178.                    _t_o  name [ _a_t term ] [ _f_r_o_m time _t_o time ] [ _o_n day
  179.                    _t_o day ] [ _w_h_e_r_e qual ]
  180.               _d_e_f_i_n_e _i_n_t_e_g_r_i_t_y _o_n var _i_s qual
  181.  
  182.           DELETE(QUEL) - delete tuples from a relation
  183.               _d_e_l_e_t_e tuple_variable [_w_h_e_r_e qual]
  184.  
  185.           DELIM(QUEL) - specify a name for a pattern of characters
  186.               _d_e_s_t_r_o_y _d_e_l_i_m groupname ( delimitor, pattern )
  187.               pattern = [ "[character list]" | "{character list}" ]*
  188.  
  189.           DESTROY(QUEL) - destroy existing relation(s)
  190.               _d_e_s_t_r_o_y relname { , relname }
  191.               _d_e_s_t_r_o_y [ _p_e_r_m_i_t | _i_n_t_e_g_r_i_t_y ] relname [ integer { , in-
  192.               teger } | _a_l_l ]
  193.               _d_e_s_t_r_o_y _d_e_l_i_m groupname
  194.  
  195.           HELP(QUEL) - get information about how to use INGRES,  about
  196.               relations in the database,
  197.               _h_e_l_p [ relname ] [ "section" ] {, relname}{, "section"}
  198.               _h_e_l_p _v_i_e_w relname {, relname}
  199.               _h_e_l_p _p_e_r_m_i_t relname {, relname}
  200.               _h_e_l_p _i_n_t_e_g_r_i_t_y relname {, relname}
  201.               _h_e_l_p _d_e_l_i_m [ groupname ] {, groupname}
  202.  
  203.           INDEX(QUEL) - create a secondary index on an existing  rela-
  204.               tion.
  205.               _i_n_d_e_x _o_n relname _i_s indexname (domain_1 { ,domain_2})
  206.  
  207.           INTEGRITY(QUEL) - define integrity constraints
  208.               _d_e_f_i_n_e _i_n_t_e_g_r_i_t_y _o_n var _i_s qual
  209.  
  210.           MACROS(QUEL) - terminal monitor macro facility
  211.  
  212.           MODIFY(QUEL) - convert the storage structure of a relation
  213.               _m_o_d_i_f_y relname _t_o storage-structure [ _o_n key1 [  :  _s_o_r_-
  214.                    _t_o_r_d_e_r ] [ { , key2 [ : _s_o_r_t_o_r_d_e_r ] } ] ] [ _w_h_e_r_e [
  215.                    _f_i_l_l_f_a_c_t_o_r = _n ] [ , _m_i_n_p_a_g_e_s = _n ] [ , _m_a_x_p_a_g_e_s  =
  216.                    _n ] [ , _l_i_d_n = _l_i_d_n_a_m_e ] [
  217.  
  218.           MONITOR(QUEL) - interactive terminal monitor
  219.  
  220.           ORDERED(QUEL) - storage structure type
  221.  
  222.           PERMIT(QUEL) - add permissions to a relation
  223.               _d_e_f_i_n_e _p_e_r_m_i_t oplist { _o_n | _o_f | _t_o } var [ (attlist) ]
  224.                    _t_o name [ _a_t term ] [ _f_r_o_m time _t_o time ]
  225.                    [ _o_n day _t_o day ] [ _w_h_e_r_e qual ]
  226.  
  227.           PRINT(QUEL) - print relation(s)
  228.               _p_r_i_n_t relname {, relname}
  229.  
  230.           QUEL(QUEL) - QUEry Language for INGRES
  231.  
  232.           RANGE(QUEL) - declare a variable to range over a relation
  233.               _r_a_n_g_e _o_f variable _i_s relname
  234.  
  235.           REPLACE(QUEL) - replace values of domains in a relation
  236.               _r_e_p_l_a_c_e tuple_variable (target_list) [_w_h_e_r_e qual]
  237.  
  238.           RETRIEVE(QUEL) - retrieve tuples from a relation
  239.               _r_e_t_r_i_e_v_e [[_i_n_t_o] relname] (target_list) [_w_h_e_r_e qual]
  240.               _r_e_t_r_i_e_v_e _u_n_i_q_u_e (target_list) [_w_h_e_r_e qual]
  241.  
  242.           SAVE(QUEL) - save a relation until a date.
  243.               _s_a_v_e relname _u_n_t_i_l month day year
  244.  
  245.           USE(QUEL) - specify a group of delimitors to be used
  246.               _u_s_e groupname
  247.               _u_n_u_s_e groupname
  248.  
  249.           VIEW(QUEL) - define a virtual relation
  250.               _d_e_f_i_n_e _v_i_e_w name (target-list) [ _w_h_e_r_e qual ]
  251.  
  252.           COPYDB(UNIX) - create batch files to copy out  a  data  base
  253.               and restore it.
  254.               _c_o_p_y_d_b [ -_u_n_a_m_e ] database full-path-name-of-directory [
  255.               relation ... ]
  256.  
  257.           CREATDB(UNIX) - create a data base
  258.               _c_r_e_a_t_d_b [ -_u_n_a_m_e ] [ -_e ] [ -_m ] [ +__c ] [ +__q ] dbname
  259.  
  260.           DESTROYDB(UNIX) - destroy an existing database
  261.               _d_e_s_t_r_o_y_d_b [ -_s ] [ -_m ] dbname
  262.  
  263.           EQUEL(UNIX) - Embedded QUEL interface to C
  264.               _e_q_u_e_l [ -_d ] [ -_f ] [ -_r ] file.q ...
  265.  
  266.           GEO-QUEL(UNIX) - GEO-QUEL data display system
  267.               _g_e_o_q_u_e_l [ -_s ] [ -_d ] [ -_a ] [ -_t_T ] [ -_t_n_T ] dbname
  268.  
  269.           HELPR(UNIX) - get information about a database.
  270.               _h_e_l_p_r [ -_u_n_a_m_e ] [ +__w ] database relation ...
  271.  
  272.           INGRES(UNIX) - INGRES relational data base management system
  273.               _i_n_g_r_e_s [ _f_l_a_g_s ] dbname [ process_table ]
  274.  
  275.           PRINTR(UNIX) - print relations
  276.               _p_r_i_n_t_r [ _f_l_a_g_s ] database relation ...
  277.  
  278.           PURGE(UNIX) - destroy all expired and temporary relations
  279.               _p_u_r_g_e [ -_f ] [ -_p ] [ -_a ] [ -_s ] [ +__w ] [ database  ...
  280.               ]
  281.  
  282.           RESTORE(UNIX) - recover from an INGRES or UNIX crash.
  283.               _r_e_s_t_o_r_e [ -_a ] [ -_s ] [ +__w ] [ database ... ]
  284.  
  285.           SYSMOD(UNIX) -  modify  system  relations  to  predetermined
  286.               storage structures.
  287.               _s_y_s_m_o_d [ -_s ] [ -_w ] dbname [ _r_e_l_a_t_i_o_n ] [ _a_t_t_r_i_b_u_t_e ] [
  288.               _i_n_d_e_x_e_s ] [ _t_r_e_e ] [ _p_r_o_t_e_c_t ] [ _i_n_t_e_g_r_i_t_i_e_s ]
  289.  
  290.           USERSETUP(UNIX) - setup users file
  291.               .../_b_i_n/_u_s_e_r_s_e_t_u_p [ flags [ pathname ] ]
  292.  
  293.           TTYTYPE(FILES) - GEO-QUEL terminal type database
  294.  
  295.           INTRODUCTION(ERROR) - Error messages introduction
  296.  
  297.           PARSER(ERROR) - Parser error message summary
  298.               Error numbers 2000 - 2999.
  299.  
  300.           QRYMOD(ERROR) - Query Modification error message summary
  301.               Error numbers 3000 - 3999.
  302.  
  303.           OVQP(ERROR) - One Variable  Query  Processor  error  message
  304.               summary
  305.               Error numbers 4000 - 4499.
  306.  
  307.           DECOMP(ERROR) - Decomposition error message summary
  308.               Error numbers 4500 - 4999.
  309.  
  310.           DBU(ERROR) - Data Base Utility error message summary
  311.               Error numbers 5000 - 5999
  312.  
  313.