← Back to branch summary

~ubuntu-branches/debian/sid/postgresql-9.3/sid

« back to all changes in this revision

Viewing changes to doc/src/sgml/html/sql-execute.html

  • Committer: Package Import Robot
  • Author(s): Martin Pitt
  • Date: 2013-05-08 05:39:52 UTC
  • Revision ID: package-import@ubuntu.com-20130508053952-1j7uilp7mjtrvq8q
Tags: upstream-9.3~beta1
Import upstream version 9.3~beta1

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/src/sgml/html/sql-execute.html
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 
2
<HTML
 
3
><HEAD
 
4
><TITLE
 
5
>EXECUTE</TITLE
 
6
><META
 
7
NAME="GENERATOR"
 
8
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
 
9
REV="MADE"
 
10
HREF="mailto:pgsql-docs@postgresql.org"><LINK
 
11
REL="HOME"
 
12
TITLE="PostgreSQL 9.3beta1 Documentation"
 
13
HREF="index.html"><LINK
 
14
REL="UP"
 
15
TITLE="SQL Commands"
 
16
HREF="sql-commands.html"><LINK
 
17
REL="PREVIOUS"
 
18
TITLE="END"
 
19
HREF="sql-end.html"><LINK
 
20
REL="NEXT"
 
21
TITLE="EXPLAIN"
 
22
HREF="sql-explain.html"><LINK
 
23
REL="STYLESHEET"
 
24
TYPE="text/css"
 
25
HREF="stylesheet.css"><META
 
26
HTTP-EQUIV="Content-Type"
 
27
CONTENT="text/html; charset=ISO-8859-1"><META
 
28
NAME="creation"
 
29
CONTENT="2013-05-06T21:00:50"></HEAD
 
30
><BODY
 
31
CLASS="REFENTRY"
 
32
><DIV
 
33
CLASS="NAVHEADER"
 
34
><TABLE
 
35
SUMMARY="Header navigation table"
 
36
WIDTH="100%"
 
37
BORDER="0"
 
38
CELLPADDING="0"
 
39
CELLSPACING="0"
 
40
><TR
 
41
><TH
 
42
COLSPAN="5"
 
43
ALIGN="center"
 
44
VALIGN="bottom"
 
45
><A
 
46
HREF="index.html"
 
47
>PostgreSQL 9.3beta1 Documentation</A
 
48
></TH
 
49
></TR
 
50
><TR
 
51
><TD
 
52
WIDTH="10%"
 
53
ALIGN="left"
 
54
VALIGN="top"
 
55
><A
 
56
TITLE="END"
 
57
HREF="sql-end.html"
 
58
ACCESSKEY="P"
 
59
>Prev</A
 
60
></TD
 
61
><TD
 
62
WIDTH="10%"
 
63
ALIGN="left"
 
64
VALIGN="top"
 
65
><A
 
66
HREF="sql-commands.html"
 
67
ACCESSKEY="U"
 
68
>Up</A
 
69
></TD
 
70
><TD
 
71
WIDTH="60%"
 
72
ALIGN="center"
 
73
VALIGN="bottom"
 
74
></TD
 
75
><TD
 
76
WIDTH="20%"
 
77
ALIGN="right"
 
78
VALIGN="top"
 
79
><A
 
80
TITLE="EXPLAIN"
 
81
HREF="sql-explain.html"
 
82
ACCESSKEY="N"
 
83
>Next</A
 
84
></TD
 
85
></TR
 
86
></TABLE
 
87
><HR
 
88
ALIGN="LEFT"
 
89
WIDTH="100%"></DIV
 
90
><H1
 
91
><A
 
92
NAME="SQL-EXECUTE"
 
93
></A
 
94
>EXECUTE</H1
 
95
><DIV
 
96
CLASS="REFNAMEDIV"
 
97
><A
 
98
NAME="AEN77275"
 
99
></A
 
100
><H2
 
101
>Name</H2
 
102
>EXECUTE&nbsp;--&nbsp;execute a prepared statement</DIV
 
103
><DIV
 
104
CLASS="REFSYNOPSISDIV"
 
105
><A
 
106
NAME="AEN77283"
 
107
></A
 
108
><H2
 
109
>Synopsis</H2
 
110
><PRE
 
111
CLASS="SYNOPSIS"
 
112
>EXECUTE <TT
 
113
CLASS="REPLACEABLE"
 
114
><I
 
115
>name</I
 
116
></TT
 
117
> [ ( <TT
 
118
CLASS="REPLACEABLE"
 
119
><I
 
120
>parameter</I
 
121
></TT
 
122
> [, ...] ) ]</PRE
 
123
></DIV
 
124
><DIV
 
125
CLASS="REFSECT1"
 
126
><A
 
127
NAME="AEN77287"
 
128
></A
 
129
><H2
 
130
>Description</H2
 
131
><P
 
132
>   <TT
 
133
CLASS="COMMAND"
 
134
>EXECUTE</TT
 
135
> is used to execute a previously prepared
 
136
   statement. Since prepared statements only exist for the duration of a
 
137
   session, the prepared statement must have been created by a
 
138
   <TT
 
139
CLASS="COMMAND"
 
140
>PREPARE</TT
 
141
> statement executed earlier in the
 
142
   current session.
 
143
  </P
 
144
><P
 
145
>   If the <TT
 
146
CLASS="COMMAND"
 
147
>PREPARE</TT
 
148
> statement that created the statement
 
149
   specified some parameters, a compatible set of parameters must be
 
150
   passed to the <TT
 
151
CLASS="COMMAND"
 
152
>EXECUTE</TT
 
153
> statement, or else an
 
154
   error is raised. Note that (unlike functions) prepared statements are
 
155
   not overloaded based on the type or number of their parameters; the
 
156
   name of a prepared statement must be unique within a database session.
 
157
  </P
 
158
><P
 
159
>   For more information on the creation and usage of prepared statements,
 
160
   see <A
 
161
HREF="sql-prepare.html"
 
162
>PREPARE</A
 
163
>.
 
164
  </P
 
165
></DIV
 
166
><DIV
 
167
CLASS="REFSECT1"
 
168
><A
 
169
NAME="AEN77297"
 
170
></A
 
171
><H2
 
172
>Parameters</H2
 
173
><P
 
174
></P
 
175
><DIV
 
176
CLASS="VARIABLELIST"
 
177
><DL
 
178
><DT
 
179
><TT
 
180
CLASS="REPLACEABLE"
 
181
><I
 
182
>name</I
 
183
></TT
 
184
></DT
 
185
><DD
 
186
><P
 
187
>      The name of the prepared statement to execute.
 
188
     </P
 
189
></DD
 
190
><DT
 
191
><TT
 
192
CLASS="REPLACEABLE"
 
193
><I
 
194
>parameter</I
 
195
></TT
 
196
></DT
 
197
><DD
 
198
><P
 
199
>      The actual value of a parameter to the prepared statement.  This
 
200
      must be an expression yielding a value that is compatible with
 
201
      the data type of this parameter, as was determined when the
 
202
      prepared statement was created.
 
203
     </P
 
204
></DD
 
205
></DL
 
206
></DIV
 
207
></DIV
 
208
><DIV
 
209
CLASS="REFSECT1"
 
210
><A
 
211
NAME="AEN77310"
 
212
></A
 
213
><H2
 
214
>Outputs</H2
 
215
><P
 
216
>   The command tag returned by <TT
 
217
CLASS="COMMAND"
 
218
>EXECUTE</TT
 
219
>
 
220
   is that of the prepared statement, and not <TT
 
221
CLASS="LITERAL"
 
222
>EXECUTE</TT
 
223
>.
 
224
  </P
 
225
></DIV
 
226
><DIV
 
227
CLASS="REFSECT1"
 
228
><A
 
229
NAME="AEN77315"
 
230
></A
 
231
><H2
 
232
>Examples</H2
 
233
><P
 
234
>    Examples are given in the <A
 
235
HREF="sql-prepare.html#SQL-PREPARE-EXAMPLES"
 
236
><I
 
237
>Examples</I
 
238
></A
 
239
> section of the <A
 
240
HREF="sql-prepare.html"
 
241
>PREPARE</A
 
242
> documentation.
 
243
   </P
 
244
></DIV
 
245
><DIV
 
246
CLASS="REFSECT1"
 
247
><A
 
248
NAME="AEN77320"
 
249
></A
 
250
><H2
 
251
>Compatibility</H2
 
252
><P
 
253
>   The SQL standard includes an <TT
 
254
CLASS="COMMAND"
 
255
>EXECUTE</TT
 
256
> statement,
 
257
   but it is only for use in embedded SQL.  This version of the
 
258
   <TT
 
259
CLASS="COMMAND"
 
260
>EXECUTE</TT
 
261
> statement also uses a somewhat different
 
262
   syntax.
 
263
  </P
 
264
></DIV
 
265
><DIV
 
266
CLASS="REFSECT1"
 
267
><A
 
268
NAME="AEN77325"
 
269
></A
 
270
><H2
 
271
>See Also</H2
 
272
><A
 
273
HREF="sql-deallocate.html"
 
274
>DEALLOCATE</A
 
275
>, <A
 
276
HREF="sql-prepare.html"
 
277
>PREPARE</A
 
278
></DIV
 
279
><DIV
 
280
CLASS="NAVFOOTER"
 
281
><HR
 
282
ALIGN="LEFT"
 
283
WIDTH="100%"><TABLE
 
284
SUMMARY="Footer navigation table"
 
285
WIDTH="100%"
 
286
BORDER="0"
 
287
CELLPADDING="0"
 
288
CELLSPACING="0"
 
289
><TR
 
290
><TD
 
291
WIDTH="33%"
 
292
ALIGN="left"
 
293
VALIGN="top"
 
294
><A
 
295
HREF="sql-end.html"
 
296
ACCESSKEY="P"
 
297
>Prev</A
 
298
></TD
 
299
><TD
 
300
WIDTH="34%"
 
301
ALIGN="center"
 
302
VALIGN="top"
 
303
><A
 
304
HREF="index.html"
 
305
ACCESSKEY="H"
 
306
>Home</A
 
307
></TD
 
308
><TD
 
309
WIDTH="33%"
 
310
ALIGN="right"
 
311
VALIGN="top"
 
312
><A
 
313
HREF="sql-explain.html"
 
314
ACCESSKEY="N"
 
315
>Next</A
 
316
></TD
 
317
></TR
 
318
><TR
 
319
><TD
 
320
WIDTH="33%"
 
321
ALIGN="left"
 
322
VALIGN="top"
 
323
>END</TD
 
324
><TD
 
325
WIDTH="34%"
 
326
ALIGN="center"
 
327
VALIGN="top"
 
328
><A
 
329
HREF="sql-commands.html"
 
330
ACCESSKEY="U"
 
331
>Up</A
 
332
></TD
 
333
><TD
 
334
WIDTH="33%"
 
335
ALIGN="right"
 
336
VALIGN="top"
 
337
>EXPLAIN</TD
 
338
></TR
 
339
></TABLE
 
340
></DIV
 
341
></BODY
 
342
></HTML
 
343
>
 
 
b'\\ No newline at end of file'