mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Adjust hints and docs to suggest CREATE EXTENSION not CREATE LANGUAGE.

Browse Source 
The core PLs have been extension-ified for seven years now, and we can
reasonably hope that all out-of-core PLs have been too.  So adjust a few
places that were still recommending CREATE LANGUAGE as the user-level
way to install a PL.

Discussion: https://postgr.es/m/CA+TgmoaJTUDMSuSCg4k08Dv8vhbrJq9nP3ZfPbmysVz_616qxw@mail.gmail.com
This commit is contained in:
Tom Lane 2018-04-27 13:42:03 -04:00
parent 76ece16974
commit 2e83e6bd74
3 changed files with 5 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/src/sgml/ref/create_transform.sgml
View File

@ -157,7 +157,7 @@ CREATE [ OR REPLACE ] TRANSFORM FOR <replaceable>type_name</replaceable> LANGUAG
<programlisting> <programlisting>
CREATE TYPE hstore ...; CREATE TYPE hstore ...;
CREATE LANGUAGE plpythonu ...; CREATE EXTENSION plpythonu;
</programlisting> </programlisting>
Then create the necessary functions: Then create the necessary functions:
<programlisting> <programlisting>
@ -176,7 +176,7 @@ CREATE TRANSFORM FOR hstore LANGUAGE plpythonu (
TO SQL WITH FUNCTION plpython_to_hstore(internal) TO SQL WITH FUNCTION plpython_to_hstore(internal)
); );
</programlisting> </programlisting>
In practice, these commands would be wrapped up in extensions. In practice, these commands would be wrapped up in an extension.
</para> </para>
<para> <para>

2
doc/src/sgml/ref/do.sgml
View File

@ -81,7 +81,7 @@ DO [ LANGUAGE <replaceable class="parameter">lang_name</replaceable> ] <replacea
<para> <para>
The procedural language to be used must already have been installed The procedural language to be used must already have been installed
into the current database by means of <command>CREATE LANGUAGE</command>. into the current database by means of <command>CREATE EXTENSION</command>.
<literal>plpgsql</literal> is installed by default, but other languages are not. <literal>plpgsql</literal> is installed by default, but other languages are not.
</para> </para>

4
src/backend/commands/functioncmds.c
View File

@ -934,7 +934,7 @@ CreateFunction(ParseState *pstate, CreateFunctionStmt *stmt)
(errcode(ERRCODE_UNDEFINED_OBJECT), (errcode(ERRCODE_UNDEFINED_OBJECT),
errmsg("language \"%s\" does not exist", language), errmsg("language \"%s\" does not exist", language),
(PLTemplateExists(language) ? (PLTemplateExists(language) ?
errhint("Use CREATE LANGUAGE to load the language into the database.") : 0))); errhint("Use CREATE EXTENSION to load the language into the database.") : 0)));
languageOid = HeapTupleGetOid(languageTuple); languageOid = HeapTupleGetOid(languageTuple);
languageStruct = (Form_pg_language) GETSTRUCT(languageTuple); languageStruct = (Form_pg_language) GETSTRUCT(languageTuple);
@ -2136,7 +2136,7 @@ ExecuteDoStmt(DoStmt *stmt, bool atomic)
(errcode(ERRCODE_UNDEFINED_OBJECT), (errcode(ERRCODE_UNDEFINED_OBJECT),
errmsg("language \"%s\" does not exist", language), errmsg("language \"%s\" does not exist", language),
(PLTemplateExists(language) ? (PLTemplateExists(language) ?
errhint("Use CREATE LANGUAGE to load the language into the database.") : 0))); errhint("Use CREATE EXTENSION to load the language into the database.") : 0)));
codeblock->langOid = HeapTupleGetOid(languageTuple); codeblock->langOid = HeapTupleGetOid(languageTuple);
languageStruct = (Form_pg_language) GETSTRUCT(languageTuple); languageStruct = (Form_pg_language) GETSTRUCT(languageTuple);