I386LINUX/util/I386LINUX/doc/postgresql/html/sql-set.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >SET</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
   9 REV="MADE"
  10 HREF="mailto:pgsql-docs@postgresql.org"><LINK
  11 REL="HOME"
  12 TITLE="PostgreSQL 7.4.1 Documentation"
  13 HREF="index.html"><LINK
  14 REL="UP"
  15 TITLE="SQL Commands"
  16 HREF="sql-commands.html"><LINK
  17 REL="PREVIOUS"
  18 TITLE="SELECT INTO"
  19 HREF="sql-selectinto.html"><LINK
  20 REL="NEXT"
  21 TITLE="SET CONSTRAINTS"
  22 HREF="sql-set-constraints.html"><LINK
  23 REL="STYLESHEET"
  24 TYPE="text/css"
  25 HREF="stylesheet.css"><META
  26 NAME="creation"
  27 CONTENT="2003-12-22T03:48:47"></HEAD
  28 ><BODY
  29 CLASS="REFENTRY"
  30 ><DIV
  31 CLASS="NAVHEADER"
  32 ><TABLE
  33 SUMMARY="Header navigation table"
  34 WIDTH="100%"
  35 BORDER="0"
  36 CELLPADDING="0"
  37 CELLSPACING="0"
  38 ><TR
  39 ><TH
  40 COLSPAN="5"
  41 ALIGN="center"
  42 VALIGN="bottom"
  43 >PostgreSQL 7.4.1 Documentation</TH
  44 ></TR
  45 ><TR
  46 ><TD
  47 WIDTH="10%"
  48 ALIGN="left"
  49 VALIGN="top"
  50 ><A
  51 HREF="sql-selectinto.html"
  52 ACCESSKEY="P"
  53 >Prev</A
  54 ></TD
  55 ><TD
  56 WIDTH="10%"
  57 ALIGN="left"
  58 VALIGN="top"
  59 ><A
  60 HREF="sql-selectinto.html"
  61 >Fast Backward</A
  62 ></TD
  63 ><TD
  64 WIDTH="60%"
  65 ALIGN="center"
  66 VALIGN="bottom"
  67 ></TD
  68 ><TD
  69 WIDTH="10%"
  70 ALIGN="right"
  71 VALIGN="top"
  72 ><A
  73 HREF="sql-set-constraints.html"
  74 >Fast Forward</A
  75 ></TD
  76 ><TD
  77 WIDTH="10%"
  78 ALIGN="right"
  79 VALIGN="top"
  80 ><A
  81 HREF="sql-set-constraints.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-SET"
  93 ></A
  94 >SET</H1
  95 ><DIV
  96 CLASS="REFNAMEDIV"
  97 ><A
  98 NAME="AEN42311"
  99 ></A
 100 ><H2
 101 >Name</H2
 102 >SET&nbsp;--&nbsp;change a run-time parameter</DIV
 103 ><A
 104 NAME="AEN42314"
 105 ></A
 106 ><DIV
 107 CLASS="REFSYNOPSISDIV"
 108 ><A
 109 NAME="AEN42316"
 110 ></A
 111 ><H2
 112 >Synopsis</H2
 113 ><PRE
 114 CLASS="SYNOPSIS"
 115 >SET [ SESSION | LOCAL ] <VAR
 116 CLASS="REPLACEABLE"
 117 >name</VAR
 118 > { TO | = } { <VAR
 119 CLASS="REPLACEABLE"
 120 >value</VAR
 121 > | '<VAR
 122 CLASS="REPLACEABLE"
 123 >value</VAR
 124 >' | DEFAULT }
 125 SET [ SESSION | LOCAL ] TIME ZONE { <VAR
 126 CLASS="REPLACEABLE"
 127 >timezone</VAR
 128 > | LOCAL | DEFAULT }</PRE
 129 ></DIV
 130 ><DIV
 131 CLASS="REFSECT1"
 132 ><A
 133 NAME="AEN42322"
 134 ></A
 135 ><H2
 136 >Description</H2
 137 ><P
 138 >   The <TT
 139 CLASS="COMMAND"
 140 >SET</TT
 141 > command changes run-time configuration
 142    parameters.  Many of the run-time parameters listed in
 143    <A
 144 HREF="runtime-config.html"
 145 >Section 16.4</A
 146 > can be changed on-the-fly with
 147    <TT
 148 CLASS="COMMAND"
 149 >SET</TT
 150 >.
 151    (But some require superuser privileges to change, and others cannot
 152    be changed after server or session start.)
 153    <TT
 154 CLASS="COMMAND"
 155 >SET</TT
 156 > only affects the value used by the current
 157    session.
 158   </P
 159 ><P
 160 >   If <TT
 161 CLASS="COMMAND"
 162 >SET</TT
 163 > or <TT
 164 CLASS="COMMAND"
 165 >SET SESSION</TT
 166 > is issued
 167    within a transaction that is later aborted, the effects of the
 168    <TT
 169 CLASS="COMMAND"
 170 >SET</TT
 171 > command disappear when the transaction is rolled
 172    back.  (This behavior represents a change from
 173    <SPAN
 174 CLASS="PRODUCTNAME"
 175 >PostgreSQL</SPAN
 176 > versions prior to 7.3, where
 177    the effects of <TT
 178 CLASS="COMMAND"
 179 >SET</TT
 180 > would not roll back after a later
 181    error.)  Once the surrounding transaction is committed, the effects
 182    will persist until the end of the session, unless overridden by another
 183    <TT
 184 CLASS="COMMAND"
 185 >SET</TT
 186 >.
 187   </P
 188 ><P
 189 >   The effects of <TT
 190 CLASS="COMMAND"
 191 >SET LOCAL</TT
 192 > last only till the end of
 193    the current transaction, whether committed or not.  A special case is
 194    <TT
 195 CLASS="COMMAND"
 196 >SET</TT
 197 > followed by <TT
 198 CLASS="COMMAND"
 199 >SET LOCAL</TT
 200 > within
 201    a single transaction: the <TT
 202 CLASS="COMMAND"
 203 >SET LOCAL</TT
 204 > value will be
 205    seen until the end of the transaction, but afterwards (if the transaction
 206    is committed) the <TT
 207 CLASS="COMMAND"
 208 >SET</TT
 209 > value will take effect.
 210   </P
 211 ></DIV
 212 ><DIV
 213 CLASS="REFSECT1"
 214 ><A
 215 NAME="AEN42342"
 216 ></A
 217 ><H2
 218 >Parameters</H2
 219 ><P
 220 ></P
 221 ><DIV
 222 CLASS="VARIABLELIST"
 223 ><DL
 224 ><DT
 225 ><TT
 226 CLASS="LITERAL"
 227 >SESSION</TT
 228 ></DT
 229 ><DD
 230 ><P
 231 >      Specifies that the command takes effect for the current session.
 232       (This is the default if neither <TT
 233 CLASS="LITERAL"
 234 >SESSION</TT
 235 > nor
 236       <TT
 237 CLASS="LITERAL"
 238 >LOCAL</TT
 239 > appears.)
 240      </P
 241 ></DD
 242 ><DT
 243 ><TT
 244 CLASS="LITERAL"
 245 >LOCAL</TT
 246 ></DT
 247 ><DD
 248 ><P
 249 >      Specifies that the command takes effect for only the current
 250       transaction.  After <TT
 251 CLASS="COMMAND"
 252 >COMMIT</TT
 253 > or <TT
 254 CLASS="COMMAND"
 255 >ROLLBACK</TT
 256 >,
 257       the session-level setting takes effect again.  Note that
 258       <TT
 259 CLASS="COMMAND"
 260 >SET LOCAL</TT
 261 > will appear to have no effect if it is
 262       executed outside a <TT
 263 CLASS="COMMAND"
 264 >BEGIN</TT
 265 > block, since the
 266       transaction will end immediately.
 267      </P
 268 ></DD
 269 ><DT
 270 ><VAR
 271 CLASS="REPLACEABLE"
 272 >name</VAR
 273 ></DT
 274 ><DD
 275 ><P
 276 >      Name of a settable run-time parameter.  Available parameters are
 277       documented in <A
 278 HREF="runtime-config.html"
 279 >Section 16.4</A
 280 > and below.
 281      </P
 282 ></DD
 283 ><DT
 284 ><VAR
 285 CLASS="REPLACEABLE"
 286 >value</VAR
 287 ></DT
 288 ><DD
 289 ><P
 290 >      New value of parameter.  Values can be specified as string
 291       constants, identifiers, numbers, or comma-separated lists of
 292       these.  <TT
 293 CLASS="LITERAL"
 294 >DEFAULT</TT
 295 > can be used to specify
 296       resetting the parameter to its default value.
 297      </P
 298 ></DD
 299 ></DL
 300 ></DIV
 301 ><P
 302 >   Besides the configuration parameters documented in <A
 303 HREF="runtime-config.html"
 304 >Section 16.4</A
 305 >, there are a few that can only be
 306    adjusted using the <TT
 307 CLASS="COMMAND"
 308 >SET</TT
 309 > command or that have a
 310    special syntax:
 311
 312    <P
 313 ></P
 314 ></P><DIV
 315 CLASS="VARIABLELIST"
 316 ><DL
 317 ><DT
 318 ><TT
 319 CLASS="LITERAL"
 320 >NAMES</TT
 321 ></DT
 322 ><DD
 323 ><P
 324 >       <TT
 325 CLASS="LITERAL"
 326 >SET NAMES <VAR
 327 CLASS="REPLACEABLE"
 328 >value</VAR
 329 ></TT
 330 > is an alias for
 331        <TT
 332 CLASS="LITERAL"
 333 >SET client_encoding TO <VAR
 334 CLASS="REPLACEABLE"
 335 >value</VAR
 336 ></TT
 337 >.
 338       </P
 339 ></DD
 340 ><DT
 341 ><TT
 342 CLASS="LITERAL"
 343 >SEED</TT
 344 ></DT
 345 ><DD
 346 ><P
 347 >       Sets the internal seed for the random number generator (the
 348        function <CODE
 349 CLASS="FUNCTION"
 350 >random</CODE
 351 >).  Allowed values are
 352        floating-point numbers between 0 and 1, which are then
 353        multiplied by 2<SUP
 354 >31</SUP
 355 >-1.
 356       </P
 357 ><P
 358 >       The seed can also be set by invoking the function
 359        <CODE
 360 CLASS="FUNCTION"
 361 >setseed</CODE
 362 >:
 363 </P><PRE
 364 CLASS="PROGRAMLISTING"
 365 >SELECT setseed(<VAR
 366 CLASS="REPLACEABLE"
 367 >value</VAR
 368 >);</PRE
 369 ><P>
 370       </P
 371 ></DD
 372 ><DT
 373 ><TT
 374 CLASS="LITERAL"
 375 >TIME ZONE</TT
 376 ></DT
 377 ><DD
 378 ><P
 379 >       <TT
 380 CLASS="LITERAL"
 381 >SET TIME ZONE <VAR
 382 CLASS="REPLACEABLE"
 383 >value</VAR
 384 ></TT
 385 > is an alias
 386        for <TT
 387 CLASS="LITERAL"
 388 >SET timezone TO <VAR
 389 CLASS="REPLACEABLE"
 390 >value</VAR
 391 ></TT
 392 >.  The
 393        syntax <TT
 394 CLASS="LITERAL"
 395 >SET TIME ZONE</TT
 396 > allows special syntax
 397        for the time zone specification.  Here are examples of valid
 398        values (but note some are accepted only on some platforms):
 399
 400        <P
 401 ></P
 402 ></P><DIV
 403 CLASS="VARIABLELIST"
 404 ><DL
 405 ><DT
 406 ><TT
 407 CLASS="LITERAL"
 408 >'PST8PDT'</TT
 409 ></DT
 410 ><DD
 411 ><P
 412 >           The time zone for Berkeley, California.
 413           </P
 414 ></DD
 415 ><DT
 416 ><TT
 417 CLASS="LITERAL"
 418 >'Portugal'</TT
 419 ></DT
 420 ><DD
 421 ><P
 422 >           The time zone for Portugal.
 423           </P
 424 ></DD
 425 ><DT
 426 ><TT
 427 CLASS="LITERAL"
 428 >'Europe/Rome'</TT
 429 ></DT
 430 ><DD
 431 ><P
 432 >           The time zone for Italy.
 433           </P
 434 ></DD
 435 ><DT
 436 ><TT
 437 CLASS="LITERAL"
 438 >-7</TT
 439 ></DT
 440 ><DD
 441 ><P
 442 >           The time zone 7 hours west from UTC (equivalent
 443            to PDT).  Positive values are east from UTC.
 444           </P
 445 ></DD
 446 ><DT
 447 ><TT
 448 CLASS="LITERAL"
 449 >INTERVAL '-08:00' HOUR TO MINUTE</TT
 450 ></DT
 451 ><DD
 452 ><P
 453 >           The time zone 8 hours west from UTC (equivalent
 454            to PST).
 455           </P
 456 ></DD
 457 ><DT
 458 ><TT
 459 CLASS="LITERAL"
 460 >LOCAL</TT
 461 ><BR><TT
 462 CLASS="LITERAL"
 463 >DEFAULT</TT
 464 ></DT
 465 ><DD
 466 ><P
 467 >           Set the time zone to your local time zone (the one that
 468            the server's operating system defaults to).
 469           </P
 470 ></DD
 471 ></DL
 472 ></DIV
 473 ><P>
 474
 475        See <A
 476 HREF="datatype-datetime.html"
 477 >Section 8.5</A
 478 > for more information
 479        about time zones.
 480       </P
 481 ></DD
 482 ></DL
 483 ></DIV
 484 ><P>
 485   </P
 486 ></DIV
 487 ><DIV
 488 CLASS="REFSECT1"
 489 ><A
 490 NAME="AEN42441"
 491 ></A
 492 ><H2
 493 >Notes</H2
 494 ><P
 495 >   The function <CODE
 496 CLASS="FUNCTION"
 497 >set_config</CODE
 498 > provides equivalent
 499    functionality. See <A
 500 HREF="functions-misc.html"
 501 >Section 9.13</A
 502 >.
 503   </P
 504 ></DIV
 505 ><DIV
 506 CLASS="REFSECT1"
 507 ><A
 508 NAME="AEN42446"
 509 ></A
 510 ><H2
 511 >Examples</H2
 512 ><P
 513 >   Set the schema search path:
 514 </P><PRE
 515 CLASS="PROGRAMLISTING"
 516 >SET search_path TO my_schema, public;</PRE
 517 ><P>
 518   </P
 519 ><P
 520 >   Set the style of date to traditional
 521    <SPAN
 522 CLASS="PRODUCTNAME"
 523 >POSTGRES</SPAN
 524 > with <SPAN
 525 CLASS="QUOTE"
 526 >"day before month"</SPAN
 527 >
 528    input convention:
 529 </P><PRE
 530 CLASS="SCREEN"
 531 >SET datestyle TO postgres, dmy;</PRE
 532 ><P>
 533   </P
 534 ><P
 535 >   Set the time zone for Berkeley, California, using quotes to
 536    preserve the uppercase spelling of the time zone name:
 537 </P><PRE
 538 CLASS="SCREEN"
 539 >SET TIME ZONE 'PST8PDT';
 540 SELECT current_timestamp AS today;
 541
 542              today
 543 -------------------------------
 544  2003-04-29 15:02:01.218622-07</PRE
 545 ><P>
 546   </P
 547 ></DIV
 548 ><DIV
 549 CLASS="REFSECT1"
 550 ><A
 551 NAME="AEN42456"
 552 ></A
 553 ><H2
 554 >Compatibility</H2
 555 ><P
 556 >   <TT
 557 CLASS="LITERAL"
 558 >SET TIME ZONE</TT
 559 > extends syntax defined in the SQL
 560    standard.  The standard allows only numeric time zone offsets while
 561    <SPAN
 562 CLASS="PRODUCTNAME"
 563 >PostgreSQL</SPAN
 564 > allows more flexible
 565    time-zone specifications.  All other <TT
 566 CLASS="LITERAL"
 567 >SET</TT
 568 >
 569    features are <SPAN
 570 CLASS="PRODUCTNAME"
 571 >PostgreSQL</SPAN
 572 > extensions.
 573   </P
 574 ></DIV
 575 ><DIV
 576 CLASS="REFSECT1"
 577 ><A
 578 NAME="AEN42463"
 579 ></A
 580 ><H2
 581 >See Also</H2
 582 ><A
 583 HREF="sql-reset.html"
 584 ><I
 585 >RESET</I
 586 ></A
 587 >, <A
 588 HREF="sql-show.html"
 589 ><I
 590 >SHOW</I
 591 ></A
 592 ></DIV
 593 ><DIV
 594 CLASS="NAVFOOTER"
 595 ><HR
 596 ALIGN="LEFT"
 597 WIDTH="100%"><TABLE
 598 SUMMARY="Footer navigation table"
 599 WIDTH="100%"
 600 BORDER="0"
 601 CELLPADDING="0"
 602 CELLSPACING="0"
 603 ><TR
 604 ><TD
 605 WIDTH="33%"
 606 ALIGN="left"
 607 VALIGN="top"
 608 ><A
 609 HREF="sql-selectinto.html"
 610 ACCESSKEY="P"
 611 >Prev</A
 612 ></TD
 613 ><TD
 614 WIDTH="34%"
 615 ALIGN="center"
 616 VALIGN="top"
 617 ><A
 618 HREF="index.html"
 619 ACCESSKEY="H"
 620 >Home</A
 621 ></TD
 622 ><TD
 623 WIDTH="33%"
 624 ALIGN="right"
 625 VALIGN="top"
 626 ><A
 627 HREF="sql-set-constraints.html"
 628 ACCESSKEY="N"
 629 >Next</A
 630 ></TD
 631 ></TR
 632 ><TR
 633 ><TD
 634 WIDTH="33%"
 635 ALIGN="left"
 636 VALIGN="top"
 637 >SELECT INTO</TD
 638 ><TD
 639 WIDTH="34%"
 640 ALIGN="center"
 641 VALIGN="top"
 642 ><A
 643 HREF="sql-commands.html"
 644 ACCESSKEY="U"
 645 >Up</A
 646 ></TD
 647 ><TD
 648 WIDTH="33%"
 649 ALIGN="right"
 650 VALIGN="top"
 651 >SET CONSTRAINTS</TD
 652 ></TR
 653 ></TABLE
 654 ></DIV
 655 ></BODY
 656 ></HTML
 657 >