← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/postgresql-9.1/oneiric-security

« back to all changes in this revision

Viewing changes to doc/src/sgml/man7/DISCARD.7

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2011-05-11 10:41:53 UTC
  • Revision ID: james.westby@ubuntu.com-20110511104153-psbh2o58553fv1m0
Tags: upstream-9.1~beta1
Import upstream version 9.1~beta1

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/src/sgml/man7/DISCARD.7
 
1
'\" t
 
2
.\"     Title: DISCARD
 
3
.\"    Author: The PostgreSQL Global Development Group
 
4
.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
 
5
.\"      Date: 2011-04-27
 
6
.\"    Manual: PostgreSQL 9.1beta1 Documentation
 
7
.\"    Source: PostgreSQL 9.1beta1
 
8
.\"  Language: English
 
9
.\"
 
10
.TH "DISCARD" "7" "2011-04-27" "PostgreSQL 9.1beta1" "PostgreSQL 9.1beta1 Documentation"
 
11
.\" -----------------------------------------------------------------
 
12
.\" * set default formatting
 
13
.\" -----------------------------------------------------------------
 
14
.\" disable hyphenation
 
15
.nh
 
16
.\" disable justification (adjust text to left margin only)
 
17
.ad l
 
18
.\" -----------------------------------------------------------------
 
19
.\" * MAIN CONTENT STARTS HERE *
 
20
.\" -----------------------------------------------------------------
 
21
.SH "NAME"
 
22
DISCARD \- discard session state
 
23
.\" DISCARD
 
24
.SH "SYNOPSIS"
 
25
.sp
 
26
.nf
 
27
DISCARD { ALL | PLANS | TEMPORARY | TEMP }
 
28
.fi
 
29
.SH "DESCRIPTION"
 
30
.PP
 
31
DISCARD
 
32
releases internal resources associated with a database session\&. These resources are normally released at the end of the session\&.
 
33
.PP
 
34
DISCARD TEMP
 
35
drops all temporary tables created in the current session\&.
 
36
DISCARD PLANS
 
37
releases all internally cached query plans\&.
 
38
DISCARD ALL
 
39
resets a session to its original state, discarding temporary resources and resetting session\-local configuration changes\&.
 
40
.SH "PARAMETERS"
 
41
.PP
 
42
TEMPORARY or TEMP
 
43
.RS 4
 
44
Drops all temporary tables created in the current session\&.
 
45
.RE
 
46
.PP
 
47
PLANS
 
48
.RS 4
 
49
Releases all cached query plans\&.
 
50
.RE
 
51
.PP
 
52
ALL
 
53
.RS 4
 
54
Releases all temporary resources associated with the current session and resets the session to its initial state\&. Currently, this has the same effect as executing the following sequence of statements:
 
55
.sp
 
56
.if n \{\
 
57
.RS 4
 
58
.\}
 
59
.nf
 
60
SET SESSION AUTHORIZATION DEFAULT;
 
61
RESET ALL;
 
62
DEALLOCATE ALL;
 
63
CLOSE ALL;
 
64
UNLISTEN *;
 
65
SELECT pg_advisory_unlock_all();
 
66
DISCARD PLANS;
 
67
DISCARD TEMP;
 
68
.fi
 
69
.if n \{\
 
70
.RE
 
71
.\}
 
72
.RE
 
73
.SH "NOTES"
 
74
.PP
 
75
DISCARD ALL
 
76
cannot be executed inside a transaction block\&.
 
77
.SH "COMPATIBILITY"
 
78
.PP
 
79
DISCARD
 
80
is a
 
81
PostgreSQL
 
82
extension\&.