説明

<command>DROP PROCEDURE</command> removes the definition of one or more existing procedures. To execute this command the user must be the owner of the procedure(s). The argument types to the procedure(s) usually must be specified, since several different procedures can exist with the same name and different argument lists. DROP PROCEDUREは1つ以上の既存のプロシージャ定義を削除します。 このコマンドを実行できるのは、そのプロシージャの所有者のみです。 プロシージャの引数の型は通常必ず指定しなければなりません。 異なる引数を持つ同じ名前のプロシージャが複数存在する可能性があるからです。

パラメータ

注釈

If there is only one procedure of the given name, the argument list can be omitted. Omit the parentheses too in this case. 指定した名前のプロシージャが1つしかない場合は、引数リストを省略できます。 この場合は括弧も省略してください。

In <productname>PostgreSQL</productname>, it's sufficient to list the input (including <literal>INOUT</literal>) arguments, because no two routines of the same name are allowed to share the same input-argument list. Moreover, the <command>DROP</command> command will not actually check that you wrote the types of <literal>OUT</literal> arguments correctly; so any arguments that are explicitly marked <literal>OUT</literal> are just noise. But writing them is recommendable for consistency with the corresponding <command>CREATE</command> command. PostgreSQLでは、入力引数（INOUTを含む）を列挙すれば十分です。 これは同じ名前のルーチンが同じ入力引数リストを共有することは許可されていないためです。 さらにDROPコマンドはOUT引数の型を正しく書いたかどうかを実際にはチェックしません。 したがって、明示的にOUTと記された引数は単なるノイズにすぎません。 しかし、対応するCREATEコマンドとの一貫性を保つために、これらを書いておくことをお勧めします。

For compatibility with the SQL standard, it is also allowed to write all the argument data types (including those of <literal>OUT</literal> arguments) without any <replaceable class="parameter">argmode</replaceable> markers. When this is done, the types of the procedure's <literal>OUT</literal> argument(s) <emphasis>will</emphasis> be verified against the command. This provision creates an ambiguity, in that when the argument list contains no <replaceable class="parameter">argmode</replaceable> markers, it's unclear which rule is intended. The <command>DROP</command> command will attempt the lookup both ways, and will throw an error if two different procedures are found. To avoid the risk of such ambiguity, it's recommendable to write <literal>IN</literal> markers explicitly rather than letting them be defaulted, thus forcing the traditional <productname>PostgreSQL</productname> interpretation to be used. SQL標準との互換性のため、argmode印を付けずに、すべての引数のデータ型（OUT引数のデータ型を含む）を書くこともできます。 これが行なわれると、プロシージャのOUT引数の型はコマンドに対して検証されるようになるでしょう。 この規定は、引数リストにargmode印が含まれていない場合、どの規則を意図しているのかが不明確であるという曖昧さを生じさせます。 DROPコマンドは両方の方法で検索を試み、2つの異なるプロシージャが見つかった場合エラーを生じます。 このような曖昧さのリスクを避けるために、IN印をデフォルトにするのではなく明示的に記述して、従来のPostgreSQL解釈を強制的に使用することをお勧めします。

The lookup rules just explained are also used by other commands that act on existing procedures, such as <command>ALTER PROCEDURE</command> and <command>COMMENT ON PROCEDURE</command>. ここで説明した検索規則は、ALTER PROCEDUREやCOMMENT ON PROCEDUREなど、既存のプロシージャーに作用する他のコマンドでも使用されます。

例

If there is only one procedure <literal>do_db_maintenance</literal>, this command is sufficient to drop it: do_db_maintenanceプロシージャが1つしかない場合、次のコマンドで削除できます。

DROP PROCEDURE do_db_maintenance;

Given this procedure definition: 下記のプロシージャ定義が与えられた時、

CREATE PROCEDURE do_db_maintenance(IN target_schema text, OUT results text) ...

any one of these commands would work to drop it: 下記のコマンドのいずれかを使用すれば、プロシージャを削除することができます。

DROP PROCEDURE do_db_maintenance(IN target_schema text, OUT results text);
DROP PROCEDURE do_db_maintenance(IN text, OUT text);
DROP PROCEDURE do_db_maintenance(IN text);
DROP PROCEDURE do_db_maintenance(text);
DROP PROCEDURE do_db_maintenance(text, text);  -- potentially ambiguous

However, the last example would be ambiguous if there is also, say, しかし、最後の例は、例えば下記もあると曖昧になります。

CREATE PROCEDURE do_db_maintenance(IN target_schema text, IN options text) ...

互換性

This command conforms to the SQL standard, with these <productname>PostgreSQL</productname> extensions: このコマンドはSQL標準に準拠しますが、以下のPostgreSQLの拡張があります。

関連項目