pgsql-jp.github.io/jpug-doc/9.5.4/html/app-createlang.html at master · pgsql-jp/pgsql-jp.github.io · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!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>createlang</title><link rel="stylesheet" type="text/css" href="stylesheet.css" /><link rev="made" href="pgsql-docs@postgresql.org" /><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><link rel="home" href="index.html" title="PostgreSQL 9.5.4文書" /><link rel="up" href="reference-client.html" title="PostgreSQLクライアントアプリケーション" /><link rel="prev" href="app-createdb.html" title="createdb" /><link rel="next" href="app-createuser.html" title="createuser" /><link rel="copyright" href="legalnotice.html" title="法的告知" /><meta name="viewport" content="width=device-width,initial-scale=1.0" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><td width="20%" align="left" colspan="2"></td><th width="60%" align="center"><a accesskey="h" href="index.html">PostgreSQL 9.5.4文書</a></th><td width="20%" align="right"><div class="actions"><a class="issue" href="https://github.com/pgsql-jp/jpug-doc/issues/new?title=version 9.5.4 app-createlang.html">誤訳等の報告</a></div></td></tr><tr><td width="10%" align="left" valign="top"><a accesskey="p" href="app-createdb.html">前へ</a> </td><td width="10%" align="left" valign="top"><a accesskey="u" href="reference-client.html">上へ</a></td><td width="60%" align="center"><span class="application">createlang</span></td><td width="20%" align="right" valign="top"> <a accesskey="n" href="app-createuser.html">次へ</a></td></tr></table><hr /></div><div class="refentry" id="app-createlang"><div class="titlepage"></div><a id="idp106318128" class="indexterm"></a><div class="refnamediv"><h2>名前</h2><p>createlang<span class="original">
  &lt;refpurpose&gt;install a &lt;productname&gt;PostgreSQL&lt;/productname&gt; procedural language&lt;/refpurpose&gt;
</span> — <span class="productname">PostgreSQL</span>の手続き言語をインストールする</p></div><div class="refsynopsisdiv"><h2>概要</h2><div class="cmdsynopsis"><p id="idp106322400"><code class="command">createlang</code> [<em class="replaceable"><code>connection-option</code></em>...]  <em class="replaceable"><code>langname</code></em>  [<em class="replaceable"><code>dbname</code></em>]</p></div><div class="cmdsynopsis"><p id="idp106326144"><code class="command">createlang</code> [<em class="replaceable"><code>connection-option</code></em>...]   <code class="option">--list</code>  |   <code class="option">-l</code>   [<em class="replaceable"><code>dbname</code></em>]</p></div></div><div class="refsect1" id="idp106331488"><h2>説明</h2><span class="original">
  &lt;title&gt;Description&lt;/title&gt;
</span><p><span class="original">
   &lt;application&gt;createlang&lt;/application&gt; is a utility for adding a
   procedural language to a &lt;productname&gt;PostgreSQL&lt;/productname&gt; database.
</span><span class="application">createlang</span>は、<span class="productname">PostgreSQL</span>データベースに手続き言語を追加するためのユーティリティです。
  </p><p><span class="original">
   &lt;application&gt;createlang&lt;/application&gt; is just a wrapper around the
   &lt;xref linkend="sql-createextension"&gt; SQL command.
</span><span class="application">createlang</span>は単なるSQLコマンド<a class="xref" href="sql-createlanguage.html" title="CREATE LANGUAGE"><span class="refentrytitle">CREATE LANGUAGE</span></a>のラッパです。
  </p><div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">注意</h3><p><span class="original">
    &lt;application&gt;createlang&lt;/application&gt; is deprecated and may be removed
    in a future &lt;productname&gt;PostgreSQL&lt;/productname&gt; release.  Direct use
    of the &lt;command&gt;CREATE EXTENSION&lt;/&gt; command is recommended instead.
</span><span class="application">createlang</span>は廃止予定であり、将来の<span class="productname">PostgreSQL</span>リリースで削除される可能性があります。
代わりに<code class="command">CREATE EXTENSION</code>コマンドを直接使用することを推奨します。
   </p></div></div><div class="refsect1" id="idp106338672"><h2>オプション</h2><span class="original">
  &lt;title&gt;Options&lt;/title&gt;
</span><p><span class="original">
    &lt;application&gt;createlang&lt;/application&gt; accepts the following command-line arguments:
</span>    <span class="application">createlang</span>では、下記のコマンドライン引数を指定できます。

    </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="replaceable"><code>langname</code></em></span></dt><dd><p><span class="original">
        Specifies the name of the procedural language to be
        installed.  (This name is lower-cased.)
</span>インストールする手続きプログラミング言語の名前を指定します。
（この名前は小文字です。）
       </p></dd><dt><span class="term"><code class="option">[<span class="optional">-d</span>] <em class="replaceable"><code>dbname</code></em></code><br /></span><span class="term"><code class="option">[<span class="optional">--dbname=</span>]<em class="replaceable"><code>dbname</code></em></code></span></dt><dd><p><span class="original">
        Specifies the database to which the language should be added.
        The default is to use the database with the same name as the
        current system user.
</span>言語を追加するデータベースを指定します。
デフォルトでは、現在のシステムユーザ名と同じ名前のデータベースが使用されます。
       </p></dd><dt><span class="term"><code class="option">-e</code><br /></span><span class="term"><code class="option">--echo</code></span></dt><dd><p><span class="original">
        Display SQL commands as they are executed.
</span>実行されるSQLコマンドを表示します。
       </p></dd><dt><span class="term"><code class="option">-l</code><br /></span><span class="term"><code class="option">--list</code></span></dt><dd><p><span class="original">
        Show a list of already installed languages in the target database.
</span>対象データベース内に既にインストールされている言語の一覧を表示します。
       </p></dd><dt><span class="term"><code class="option">-V</code><br /></span><span class="term"><code class="option">--version</code></span></dt><dd><p><span class="original">
       Print the &lt;application&gt;createlang&lt;/application&gt; version and exit.
</span><span class="application">createlang</span>のバージョンを表示し、終了します。
       </p></dd><dt><span class="term"><code class="option">-?</code><br /></span><span class="term"><code class="option">--help</code></span></dt><dd><p><span class="original">
      Show help about &lt;application&gt;createlang&lt;/application&gt; command line
      arguments, and exit.
</span><span class="application">createlang</span>のコマンドライン引数の使用方法を表示し、終了します。
      </p></dd></dl></div><p>
   </p><p><span class="original">
    &lt;application&gt;createlang&lt;/application&gt; also accepts
    the following command-line arguments for connection parameters:
</span><span class="application">createlang</span>は、以下のコマンドライン引数も接続パラメータとして受け付けます。

    </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h <em class="replaceable"><code>host</code></em></code><br /></span><span class="term"><code class="option">--host=<em class="replaceable"><code>host</code></em></code></span></dt><dd><p><span class="original">
        Specifies the host name of the machine on which the
        server
        is running.  If the value begins with a slash, it is used
        as the directory for the Unix domain socket.
</span>サーバが稼働しているマシンのホスト名を指定します。
この値がスラッシュから始まる場合、Unixドメインソケット用のディレクトリとして使用されます。
       </p></dd><dt><span class="term"><code class="option">-p <em class="replaceable"><code>port</code></em></code><br /></span><span class="term"><code class="option">--port=<em class="replaceable"><code>port</code></em></code></span></dt><dd><p><span class="original">
        Specifies the TCP port or local Unix domain socket file
        extension on which the server
        is listening for connections.
</span>サーバが接続を監視するTCPポートもしくはUnixドメインソケットファイルの拡張子を指定します。
       </p></dd><dt><span class="term"><code class="option">-U <em class="replaceable"><code>username</code></em></code><br /></span><span class="term"><code class="option">--username=<em class="replaceable"><code>username</code></em></code></span></dt><dd><p><span class="original">
        User name to connect as.
</span>接続するためのユーザ名を指定します。
       </p></dd><dt><span class="term"><code class="option">-w</code><br /></span><span class="term"><code class="option">--no-password</code></span></dt><dd><p><span class="original">
        Never issue a password prompt.  If the server requires
        password authentication and a password is not available by
        other means such as a &lt;filename&gt;.pgpass&lt;/filename&gt; file, the
        connection attempt will fail.  This option can be useful in
        batch jobs and scripts where no user is present to enter a
        password.
</span>パスワードの入力を促しません。
サーバがパスワード認証を必要とし、かつ、<code class="filename">.pgpass</code>ファイルなどの他の方法が利用できない場合、接続試行は失敗します。
バッチジョブやスクリプトなどパスワードを入力するユーザが存在しない場合にこのオプションは有用かもしれません。
       </p></dd><dt><span class="term"><code class="option">-W</code><br /></span><span class="term"><code class="option">--password</code></span></dt><dd><p><span class="original">
        Force &lt;application&gt;createlang&lt;/application&gt; to prompt for a
        password before connecting to a database.
</span>データベースに接続する前に、<span class="application">createlang</span>は強制的にパスワード入力を促します。
       </p><p><span class="original">
        This option is never essential, since
        &lt;application&gt;createlang&lt;/application&gt; will automatically prompt
        for a password if the server demands password authentication.
        However, &lt;application&gt;createlang&lt;/application&gt; will waste a
        connection attempt finding out that the server wants a password.
        In some cases it is worth typing &lt;option&gt;-W&lt;/&gt; to avoid the extra
        connection attempt.
</span>サーバがパスワード認証を要求する場合<span class="application">createlang</span>は自動的にパスワード入力を促しますので、これが重要になることはありません。
しかし、<span class="application">createlang</span>は、サーバにパスワードが必要かどうかを判断するための接続試行を無駄に行います。
こうした余計な接続試行を防ぐために<code class="option">-W</code>の入力が有意となる場合もあります。
       </p></dd></dl></div><p>
   </p></div><div class="refsect1" id="idp106371888"><h2>環境</h2><span class="original">
  &lt;title&gt;Environment&lt;/title&gt;
</span><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="envar">PGDATABASE</code><br /></span><span class="term"><code class="envar">PGHOST</code><br /></span><span class="term"><code class="envar">PGPORT</code><br /></span><span class="term"><code class="envar">PGUSER</code></span></dt><dd><p><span class="original">
      Default connection parameters
</span>デフォルトの接続パラメータです。
     </p></dd></dl></div><p><span class="original">
   This utility, like most other &lt;productname&gt;PostgreSQL&lt;/&gt; utilities,
   also uses the environment variables supported by &lt;application&gt;libpq&lt;/&gt;
   (see &lt;xref linkend="libpq-envars"&gt;).
</span>また、このユーティリティは、他のほとんどの<span class="productname">PostgreSQL</span>ユーティリティと同様、<span class="application">libpq</span>でサポートされる環境変数を使用します（<a class="xref" href="libpq-envars.html" title="31.14. 環境変数">31.14. 環境変数</a>を参照してください）。
  </p></div><div class="refsect1" id="idp106377888"><h2>診断</h2><span class="original">
  &lt;title&gt;Diagnostics&lt;/title&gt;
</span><p><span class="original">
    Most error messages are self-explanatory. If not, run
    &lt;application&gt;createlang&lt;/application&gt; with the &lt;option&gt;&amp;#055;&amp;#055;echo&lt;/option&gt;
    option and see the respective &lt;acronym&gt;SQL&lt;/acronym&gt; command
    for details.  Also, any default connection settings and environment
    variables used by the &lt;application&gt;libpq&lt;/application&gt; front-end
    library will apply.
</span>ほとんどのエラーメッセージは、読めば理解できるものとなっています。
エラーメッセージを見ても問題が解決しない場合は、<span class="application">createlang</span>を<code class="option">--echo</code>オプションを付けて実行し、詳細については、対応する<acronym class="acronym">SQL</acronym>コマンドを参照してください。
<span class="application">libpq</span>フロントエンドライブラリで使用されるデフォルトの接続設定と環境変数も適用されます。
   </p></div><div class="refsect1" id="idp106381968"><h2>注釈</h2><span class="original">
  &lt;title&gt;Notes&lt;/title&gt;
</span><p><span class="original">
   Use &lt;xref linkend="app-droplang"&gt; to remove a language.
</span>言語を削除するには <a class="xref" href="app-droplang.html" title="droplang"><span class="refentrytitle"><span class="application">droplang</span></span></a>を使用してください。
  </p></div><div class="refsect1" id="idp106383760"><h2>例</h2><span class="original">
  &lt;title&gt;Examples&lt;/title&gt;
</span><p><span class="original">
    To install the language &lt;literal&gt;pltcl&lt;/literal&gt; into the database
    &lt;literal&gt;template1&lt;/literal&gt;:
</span><code class="literal">pltcl</code>言語を<code class="literal">template1</code>データベースにインストールします。
</p><pre class="screen"><code class="prompt">$ </code><strong class="userinput"><code>createlang pltcl template1</code></strong></pre><p><span class="original">
    Note that installing the language into &lt;literal&gt;template1&lt;/literal&gt;
    will cause it to be automatically installed into subsequently-created
    databases as well.
</span>
言語を<code class="literal">template1</code>にインストールすると、それより後で作成されるデータベースにも自動的にインストールされることに注意してください。
   </p></div><div class="refsect1" id="idp106389072"><h2>関連項目</h2><span class="original">
  &lt;title&gt;See Also&lt;/title&gt;
</span><span class="simplelist"><a class="xref" href="app-droplang.html" title="droplang"><span class="refentrytitle"><span class="application">droplang</span></span></a>, <a class="xref" href="sql-createextension.html" title="CREATE EXTENSION"><span class="refentrytitle">CREATE EXTENSION</span></a>, <a class="xref" href="sql-createlanguage.html" title="CREATE LANGUAGE"><span class="refentrytitle">CREATE LANGUAGE</span></a></span></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="app-createdb.html">前へ</a> </td><td width="20%" align="center"><a accesskey="u" href="reference-client.html">上へ</a></td><td width="40%" align="right"> <a accesskey="n" href="app-createuser.html">次へ</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="application">createdb</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">ホーム</a></td><td width="40%" align="right" valign="top"> <span class="application">createuser</span></td></tr></table></div></body></html>