Baoding-FenShuaJiang
/
Green_GoodERP18_FSJ_Standard
Watch 1
Star 0
Wiki 捐赠
gooderp18绿色标准版
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Tree: 0f75e31513
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '0f75e31513'
${ noResults }
Green_GoodERP18_FSJ_Standard/PostgreSQL/doc/postgresql/html/libpq-envars.html

139 lines
13KB
Raw Blame History 

  1. <?xml version="1.0" encoding="UTF-8" standalone="no"?>

  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>33.14. Environment Variables</title><link rel="stylesheet" type="text/css" href="stylesheet.css" /><link rev="made" href="pgsql-docs@lists.postgresql.org" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><link rel="prev" href="libpq-events.html" title="33.13. Event System" /><link rel="next" href="libpq-pgpass.html" title="33.15. The Password File" /></head><body><div xmlns="http://www.w3.org/TR/xhtml1/transitional" class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="5" align="center">33.14. Environment Variables</th></tr><tr><td width="10%" align="left"><a accesskey="p" href="libpq-events.html" title="33.13. Event System">Prev</a> </td><td width="10%" align="left"><a accesskey="u" href="libpq.html" title="Chapter 33. libpq - C Library">Up</a></td><th width="60%" align="center">Chapter 33. <span xmlns="http://www.w3.org/1999/xhtml" class="application">libpq</span> - C Library</th><td width="10%" align="right"><a accesskey="h" href="index.html" title="PostgreSQL 12.4 Documentation">Home</a></td><td width="10%" align="right"> <a accesskey="n" href="libpq-pgpass.html" title="33.15. The Password File">Next</a></td></tr></table><hr></hr></div><div class="sect1" id="LIBPQ-ENVARS"><div class="titlepage"><div><div><h2 class="title" style="clear: both">33.14. Environment Variables</h2></div></div></div><a id="id-1.7.3.21.2" class="indexterm"></a><p>

  3.    The following environment variables can be used to select default

  4.    connection parameter values, which will be used by

  5.    <code class="function">PQconnectdb</code>, <code class="function">PQsetdbLogin</code> and

  6.    <code class="function">PQsetdb</code> if no value is directly specified by the calling

  7.    code.  These are useful to avoid hard-coding database connection

  8.    information into simple client applications, for example.

  9. 

  10.    </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>

  11.       <a id="id-1.7.3.21.3.4.1.1.1" class="indexterm"></a>

  12.       <code class="envar">PGHOST</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-HOST">host</a> connection parameter.

  13.      </p></li><li class="listitem"><p>

  14.       <a id="id-1.7.3.21.3.4.2.1.1" class="indexterm"></a>

  15.       <code class="envar">PGHOSTADDR</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-HOSTADDR">hostaddr</a> connection parameter.

  16.       This can be set instead of or in addition to <code class="envar">PGHOST</code>

  17.       to avoid DNS lookup overhead.

  18.      </p></li><li class="listitem"><p>

  19.       <a id="id-1.7.3.21.3.4.3.1.1" class="indexterm"></a>

  20.       <code class="envar">PGPORT</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-PORT">port</a> connection parameter.

  21.      </p></li><li class="listitem"><p>

  22.       <a id="id-1.7.3.21.3.4.4.1.1" class="indexterm"></a>

  23.       <code class="envar">PGDATABASE</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-DBNAME">dbname</a> connection parameter.

  24.       </p></li><li class="listitem"><p>

  25.       <a id="id-1.7.3.21.3.4.5.1.1" class="indexterm"></a>

  26.       <code class="envar">PGUSER</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-USER">user</a> connection parameter.

  27.      </p></li><li class="listitem"><p>

  28.       <a id="id-1.7.3.21.3.4.6.1.1" class="indexterm"></a>

  29.       <code class="envar">PGPASSWORD</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-PASSWORD">password</a> connection parameter.

  30.       Use of this environment variable

  31.       is not recommended for security reasons, as some operating systems

  32.       allow non-root users to see process environment variables via

  33.       <span class="application">ps</span>; instead consider using a password file

  34.       (see <a class="xref" href="libpq-pgpass.html" title="33.15. The Password File">Section 33.15</a>).

  35.      </p></li><li class="listitem"><p>

  36.       <a id="id-1.7.3.21.3.4.7.1.1" class="indexterm"></a>

  37.       <code class="envar">PGPASSFILE</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-PASSFILE">passfile</a> connection parameter.

  38.      </p></li><li class="listitem"><p>

  39.       <a id="id-1.7.3.21.3.4.8.1.1" class="indexterm"></a>

  40.       <code class="envar">PGSERVICE</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-SERVICE">service</a> connection parameter.

  41.      </p></li><li class="listitem"><p>

  42.       <a id="id-1.7.3.21.3.4.9.1.1" class="indexterm"></a>

  43.       <code class="envar">PGSERVICEFILE</code> specifies the name of the per-user

  44.       connection service file.  If not set, it defaults

  45.       to <code class="filename">~/.pg_service.conf</code>

  46.       (see <a class="xref" href="libpq-pgservice.html" title="33.16. The Connection Service File">Section 33.16</a>).

  47.      </p></li><li class="listitem"><p>

  48.       <a id="id-1.7.3.21.3.4.10.1.1" class="indexterm"></a>

  49.       <code class="envar">PGOPTIONS</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-OPTIONS">options</a> connection parameter.

  50.      </p></li><li class="listitem"><p>

  51.       <a id="id-1.7.3.21.3.4.11.1.1" class="indexterm"></a>

  52.       <code class="envar">PGAPPNAME</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-APPLICATION-NAME">application_name</a> connection parameter.

  53.      </p></li><li class="listitem"><p>

  54.       <a id="id-1.7.3.21.3.4.12.1.1" class="indexterm"></a>

  55.       <code class="envar">PGSSLMODE</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-SSLMODE">sslmode</a> connection parameter.

  56.      </p></li><li class="listitem"><p>

  57.       <a id="id-1.7.3.21.3.4.13.1.1" class="indexterm"></a>

  58.       <code class="envar">PGREQUIRESSL</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-REQUIRESSL">requiressl</a> connection parameter.

  59.       This environment variable is deprecated in favor of the

  60.       <code class="envar">PGSSLMODE</code> variable; setting both variables suppresses the

  61.       effect of this one.

  62.      </p></li><li class="listitem"><p>

  63.       <a id="id-1.7.3.21.3.4.14.1.1" class="indexterm"></a>

  64.       <code class="envar">PGSSLCOMPRESSION</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-SSLCOMPRESSION">sslcompression</a> connection parameter.

  65.      </p></li><li class="listitem"><p>

  66.       <a id="id-1.7.3.21.3.4.15.1.1" class="indexterm"></a>

  67.       <code class="envar">PGSSLCERT</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-SSLCERT">sslcert</a> connection parameter.

  68.      </p></li><li class="listitem"><p>

  69.       <a id="id-1.7.3.21.3.4.16.1.1" class="indexterm"></a>

  70.       <code class="envar">PGSSLKEY</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-SSLKEY">sslkey</a> connection parameter.

  71.      </p></li><li class="listitem"><p>

  72.       <a id="id-1.7.3.21.3.4.17.1.1" class="indexterm"></a>

  73.       <code class="envar">PGSSLROOTCERT</code>  behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-SSLROOTCERT">sslrootcert</a> connection parameter.

  74.      </p></li><li class="listitem"><p>

  75.       <a id="id-1.7.3.21.3.4.18.1.1" class="indexterm"></a>

  76.       <code class="envar">PGSSLCRL</code>  behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-SSLCRL">sslcrl</a> connection parameter.

  77.      </p></li><li class="listitem"><p>

  78.       <a id="id-1.7.3.21.3.4.19.1.1" class="indexterm"></a>

  79.       <code class="envar">PGREQUIREPEER</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-REQUIREPEER">requirepeer</a> connection parameter.

  80.      </p></li><li class="listitem"><p>

  81.       <a id="id-1.7.3.21.3.4.20.1.1" class="indexterm"></a>

  82.       <code class="envar">PGGSSENCMODE</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-GSSENCMODE">gssencmode</a> connection parameter.

  83.      </p></li><li class="listitem"><p>

  84.       <a id="id-1.7.3.21.3.4.21.1.1" class="indexterm"></a>

  85.       <code class="envar">PGKRBSRVNAME</code>  behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-KRBSRVNAME">krbsrvname</a> connection parameter.

  86.      </p></li><li class="listitem"><p>

  87.       <a id="id-1.7.3.21.3.4.22.1.1" class="indexterm"></a>

  88.       <code class="envar">PGGSSLIB</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-GSSLIB">gsslib</a> connection parameter.

  89.      </p></li><li class="listitem"><p>

  90.       <a id="id-1.7.3.21.3.4.23.1.1" class="indexterm"></a>

  91.       <code class="envar">PGCONNECT_TIMEOUT</code>  behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-CONNECT-TIMEOUT">connect_timeout</a> connection parameter.

  92.      </p></li><li class="listitem"><p>

  93.       <a id="id-1.7.3.21.3.4.24.1.1" class="indexterm"></a>

  94.       <code class="envar">PGCLIENTENCODING</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-CLIENT-ENCODING">client_encoding</a> connection parameter.

  95.      </p></li><li class="listitem"><p>

  96.       <a id="id-1.7.3.21.3.4.25.1.1" class="indexterm"></a>

  97.       <code class="envar">PGTARGETSESSIONATTRS</code> behaves the same as the <a class="xref" href="libpq-connect.html#LIBPQ-CONNECT-TARGET-SESSION-ATTRS">target_session_attrs</a> connection parameter.

  98.      </p></li></ul></div><p>

  99.   </p><p>

  100.    The following environment variables can be used to specify default

  101.    behavior for each <span class="productname">PostgreSQL</span> session.  (See

  102.    also the <a class="xref" href="sql-alterrole.html" title="ALTER ROLE"><span class="refentrytitle">ALTER ROLE</span></a>

  103.    and <a class="xref" href="sql-alterdatabase.html" title="ALTER DATABASE"><span class="refentrytitle">ALTER DATABASE</span></a>

  104.    commands for ways to set default behavior on a per-user or per-database

  105.    basis.)

  106. 

  107.    </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>

  108.       <a id="id-1.7.3.21.4.4.1.1.1" class="indexterm"></a>

  109.       <code class="envar">PGDATESTYLE</code> sets the default style of date/time

  110.       representation.  (Equivalent to <code class="literal">SET datestyle TO

  111.       ...</code>.)

  112.      </p></li><li class="listitem"><p>

  113.       <a id="id-1.7.3.21.4.4.2.1.1" class="indexterm"></a>

  114.       <code class="envar">PGTZ</code> sets the default time zone.  (Equivalent to

  115.       <code class="literal">SET timezone TO ...</code>.)

  116.      </p></li><li class="listitem"><p>

  117.       <a id="id-1.7.3.21.4.4.3.1.1" class="indexterm"></a>

  118.       <code class="envar">PGGEQO</code> sets the default mode for the genetic query

  119.       optimizer.  (Equivalent to <code class="literal">SET geqo TO ...</code>.)

  120.      </p></li></ul></div><p>

  121. 

  122.    Refer to the <acronym class="acronym">SQL</acronym> command <a class="xref" href="sql-set.html" title="SET"><span class="refentrytitle">SET</span></a>

  123.    for information on correct values for these

  124.    environment variables.

  125.   </p><p>

  126.    The following environment variables determine internal behavior of

  127.    <span class="application">libpq</span>; they override compiled-in defaults.

  128. 

  129.    </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>

  130.       <a id="id-1.7.3.21.5.2.1.1.1" class="indexterm"></a>

  131.       <code class="envar">PGSYSCONFDIR</code> sets the directory containing the

  132.       <code class="filename">pg_service.conf</code> file and in a future version

  133.       possibly other system-wide configuration files.

  134.      </p></li><li class="listitem"><p>

  135.       <a id="id-1.7.3.21.5.2.2.1.1" class="indexterm"></a>

  136.       <code class="envar">PGLOCALEDIR</code> sets the directory containing the

  137.       <code class="literal">locale</code> files for message localization.

  138.      </p></li></ul></div><p>

  139.   </p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="libpq-events.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="libpq.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="libpq-pgpass.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">33.13. Event System </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 33.15. The Password File</td></tr></table></div></body></html>
上海开阖软件有限公司 沪ICP备12045867号-1