postgresql/doc/src/sgml/ref/drop_language.sgml

178 lines
3.9 KiB
Plaintext
Raw Normal View History

<REFENTRY ID="SQL-DROPLANGUAGE">
<REFMETA>
<REFENTRYTITLE>
DROP LANGUAGE
</REFENTRYTITLE>
<REFMISCINFO>SQL - Language Statements</REFMISCINFO>
</REFMETA>
<REFNAMEDIV>
<REFNAME>
DROP LANGUAGE
</REFNAME>
<REFPURPOSE>
Removes a user-defined procedural language
</REFPURPOSE>
<REFSYNOPSISDIV>
<REFSYNOPSISDIVINFO>
<DATE>1998-04-15</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
1998-09-22 17:48:03 +02:00
DROP PROCEDURAL LANGUAGE '<REPLACEABLE CLASS="PARAMETER">langname</REPLACEABLE>'
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-DROPLANGUAGE-1">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
</REFSECT2INFO>
<TITLE>
Inputs
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
1998-09-22 17:48:03 +02:00
<REPLACEABLE CLASS="PARAMETER">langname</REPLACEABLE>
</TERM>
<LISTITEM>
<PARA>
The name of an existing language.
</PARA>
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</REFSECT2>
<REFSECT2 ID="R2-SQL-DROPLANGUAGE-2">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
</REFSECT2INFO>
<TITLE>
Outputs
</TITLE>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<ReturnValue>DROP</ReturnValue>
</TERM>
<LISTITEM>
<PARA>
This message is returned if the language is successfully dropped.
</PARA>
</LISTITEM>
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>
ERROR: Language "<replaceable class="parameter">langname</replaceable>" doesn't exist</ReturnValue>
</TERM>
<LISTITEM>
<PARA>
This message occurs if the language
"<replaceable class="parameter">langname</replaceable>" is
not found.
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
<REFSECT1 ID="R1-SQL-DROPLANGUAGE-1">
<REFSECT1INFO>
<DATE>1998-04-15</DATE>
</REFSECT1INFO>
<TITLE>
Description
</TITLE>
<PARA>
<command>DROP PROCEDURAL LANGUAGE</command> will remove the definition
1998-09-22 17:48:03 +02:00
of the previously registered procedural language having the name
'<replaceable class="parameter">langname</replaceable>'.
</PARA>
<REFSECT2 ID="R2-SQL-DROPLANGUAGE-3">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
</REFSECT2INFO>
<TITLE>
Notes
</TITLE>
<PARA>
The <command>DROP PROCEDURAL LANGUAGE</command> statement is
1998-09-22 17:48:03 +02:00
a <productname>Postgres</productname> language extension.
</PARA>
<PARA>
1998-09-22 17:48:03 +02:00
Refer to <command>CREATE PROCEDURAL LANGUAGE</command>
for information on how to create procedural languages.
</PARA>
</refsect2>
<REFSECT2 ID="R2-SQL-DROPLANGUAGE-4">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
</REFSECT2INFO>
<TITLE>
Bugs
</TITLE>
<PARA>
No checks are made if functions or trigger procedures registered
in this language still exist. To re-enable them without having
to drop and recreate all the functions, the pg_proc's prolang
attribute of the functions must be adjusted to the new object
ID of the recreated pg_language entry for the PL.
</PARA>
</REFSECT2>
</refsect1>
<REFSECT1 ID="R1-SQL-DROPLANGUAGE-2">
<TITLE>
Usage
</TITLE>
<PARA>
This command removes the PL/Sample language:
</PARA>
<ProgramListing>
1998-09-22 17:48:03 +02:00
DROP PROCEDURAL LANGUAGE 'plsample'
</ProgramListing>
</REFSECT1>
<REFSECT1 ID="R1-SQL-DROPLANGUAGE-3">
<TITLE>
Compatibility
</TITLE>
<PARA>
</PARA>
<REFSECT2 ID="R2-SQL-DROPLANGUAGE-5">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
</REFSECT2INFO>
<TITLE>
SQL92
</TITLE>
<PARA>
1998-09-22 17:48:03 +02:00
There is no <command>DROP PROCEDURAL LANGUAGE</command> in
<acronym>SQL92</acronym>.
</PARA>
</refsect2>
</refsect1>
</REFENTRY>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:"/usr/lib/sgml/catalog"
sgml-local-ecat-files:nil
End:
-->