fetch.l
上传用户:blenddy
上传日期:2007-01-07
资源大小:6495k
文件大小:2k
源码类别:

数据库系统

开发平台:

Unix_Linux

  1. ." This is -*-nroff-*-
  2. ." XXX standard disclaimer belongs here....
  3. ." $Header: /usr/local/cvsroot/pgsql/src/man/Attic/fetch.l,v 1.7 1998/06/24 13:21:26 momjian Exp $
  4. .TH FETCH SQL 01/23/93 PostgreSQL PostgreSQL
  5. .SH NAME
  6. fetch - fetch instance(s) from a cursor
  7. .SH SYNOPSIS
  8. .nf
  9. fBfetchfR [ (fBforwardfR | fBbackwardfR) ] [ ( number | fBallfR) ] [fBinfR cursor_name]
  10. .fi
  11. .SH DESCRIPTION
  12. .BR Fetch
  13. allows a user to retrieve instances from a cursor named
  14. .IR cursor_name.
  15. The number of instances retrieved is specified by
  16. .IR number .
  17. If the number of instances remaining in the cursor is less than
  18. .IR number ,
  19. then only those available are fetched.  Substituting the keyword
  20. .IR all
  21. in place of a number will cause all remaining instances in the cursor 
  22. to be retrieved.  Instances may be fetched in both
  23. .IR forward
  24. and
  25. .IR backward
  26. directions.  The default direction is
  27. .IR forward .
  28. .PP
  29. Updating data in a cursor is not supported by Postgres, because mapping
  30. cursor updates back to base classes is impossible in general as with
  31. view updates.  Consequently, users must issue explicit replace
  32. commands to update data.
  33. .PP
  34. Cursors may only be used inside of transaction blocks marked by 
  35. .IR begin(l)
  36. and
  37. .IR commit(l)
  38. because the data that they store spans multiple user queries.
  39. .SH EXAMPLE
  40. .nf
  41. --
  42. --set up and use a cursor 
  43. --
  44. begin work;
  45. declare mycursor cursor for 
  46.     select * from pg-user;
  47. --
  48. --Fetch all the instances available in the cursor FOO
  49. --
  50. fetch all in FOO;
  51. --
  52. --Fetch 5 instances backward in the cursor FOO
  53. --
  54. fetch backward 5 in FOO;
  55. --
  56. --close
  57. --
  58. close foo;
  59. commit;
  60. .fi
  61. .SH "SEE ALSO"
  62. begin(l),
  63. commit(l),
  64. close(l),
  65. move(l),
  66. select(l).