home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / apps / database / postgres / postgre2.z / postgre2 / ref / postquel / purge < prev    next >
Encoding:
Text File  |  1992-08-27  |  1.1 KB  |  49 lines
  1. .\" XXX standard disclaimer belongs here....
  2. .SP PURGE COMMANDS 6/14/90
  3. .XA 2 Purge
  4. .uh NAME
  5. .lp
  6. purge \*- discard historical data
  7. .uh SYNOPSIS
  8. .lp
  9. .(l
  10. \fBpurge\fR classname [ \fBbefore\fR abstime ] [ \fBafter\fR reltime ]
  11. .)l
  12. .uh DESCRIPTION
  13. .lp
  14. .b Purge
  15. allows a user to specify the historical retention properties of a class.
  16. The date specified is an absolute time such as 
  17. Jan 1 1987, and
  18. \*(PP will discard tuples whose validity expired before the indicated time.
  19. .b Purge 
  20. with no
  21. .i before
  22. clause is equivalent to
  23. .q "purge before now."
  24. Until specified with a purge command,
  25. instance preservation defaults to
  26. .q "forever."
  27. .lp
  28. The user may purge a class at any time as long
  29. as the purge date never decreases.
  30. \*(PP will enforce this restriction, silently.
  31. .uh EXAMPLE
  32. .lp
  33. .nf
  34. .ft C
  35. /* Always discard data in the EMP class */
  36. /* prior to January 1, 1989             */
  37.  
  38. purge EMP before "Jan 1 1989"
  39.  
  40. /* Retain only the current data in EMP */
  41.  
  42. purge EMP
  43. .ft
  44. .uh BUGS
  45. .lp
  46. Error messages are quite unhelpful.  A complaint about "inconsistent times"
  47. followed by several nine-digit numbers indicates an attempt to "back up"
  48. a purge date on a relation.
  49.