説明

<command>DELETE</command> deletes rows that satisfy the <literal>WHERE</literal> clause from the specified table. If the <literal>WHERE</literal> clause is absent, the effect is to delete all rows in the table. The result is a valid, but empty table. DELETEは、指定したテーブルからWHERE句を満たす行を削除します。 WHERE句がない場合、指定したテーブルの全ての行を削除することになります。 この結果、そのテーブルは存在するが中身が空のテーブルになります。

There are two ways to delete rows in a table using information contained in other tables in the database: using sub-selects, or specifying additional tables in the <literal>USING</literal> clause. Which technique is more appropriate depends on the specific circumstances. データベース内のほかのテーブルに含まれる情報を用いてテーブル内の行を削除する方法には、副SELECTとUSING句で追加テーブルを指定する方法の2つがあります。 どちらの技法が適切かはその状況によります。

The optional <literal>RETURNING</literal> clause causes <command>DELETE</command> to compute and return value(s) based on each row actually deleted. Any expression using the table's columns, and/or columns of other tables mentioned in <literal>USING</literal>, can be computed. The syntax of the <literal>RETURNING</literal> list is identical to that of the output list of <command>SELECT</command>. RETURNING句を指定すると、DELETEは実際に削除された各行に基づいて計算された値を返すようになります。 そのテーブルの列、USINGで指定された他のテーブルの列、あるいは、その両方を使用した式を計算することができます。 RETURNINGリストの構文はSELECTの出力リストと同一です。

You must have the <literal>DELETE</literal> privilege on the table to delete from it, as well as the <literal>SELECT</literal> privilege for any table in the <literal>USING</literal> clause or whose values are read in the <replaceable class="parameter">condition</replaceable>. 削除を実行するには、そのテーブルのDELETE権限が必要です。 また、USING句内のテーブルに対するSELECT権限、および、conditionで使用する値を読み取るために、その値が含まれるテーブルに対するSELECT権限も必要です。

パラメータ

出力

On successful completion, a <command>DELETE</command> command returns a command tag of the form 正常に終了した場合、DELETEコマンドは以下の形式のコマンドタグを返します。

DELETE count

The <replaceable class="parameter">count</replaceable> is the number of rows deleted. Note that the number may be less than the number of rows that matched the <replaceable class="parameter">condition</replaceable> when deletes were suppressed by a <literal>BEFORE DELETE</literal> trigger. If <replaceable class="parameter">count</replaceable> is 0, no rows were deleted by the query (this is not considered an error). countは削除した行数です。 この数は、BEFORE DELETEトリガによって削除が抑止された場合、conditionに合致した行より少なくなる可能性があることに注意してください。 countが0の場合、問い合わせによって削除された行がなかったことを示します （これはエラーとはみなされません）。

If the <command>DELETE</command> command contains a <literal>RETURNING</literal> clause, the result will be similar to that of a <command>SELECT</command> statement containing the columns and values defined in the <literal>RETURNING</literal> list, computed over the row(s) deleted by the command. DELETEコマンドがRETURNING句を持つ場合、その結果は、RETURNINGリストで定義した列と値を持ち、そのコマンドで削除された行全体に対して計算を行うSELECT文の結果と似たものになるでしょう。

注釈

<productname>PostgreSQL</productname> lets you reference columns of other tables in the <literal>WHERE</literal> condition by specifying the other tables in the <literal>USING</literal> clause. For example, to delete all films produced by a given producer, one can do: PostgreSQLでは、USING句で他のテーブルを指定することで、WHERE条件内で他のテーブルを参照することができます。 例えば、指定したプロデューサが製作した全ての映画を削除する時は、次のようなコマンドを実行します。

DELETE FROM films USING producers
  WHERE producer_id = producers.id AND producers.name = 'foo';

What is essentially happening here is a join between <structname>films</structname> and <structname>producers</structname>, with all successfully joined <structname>films</structname> rows being marked for deletion. This syntax is not standard. A more standard way to do it is: ここでは、filmsとproducersとを結合して、films行に削除用の印を付けるという作業を行っています。 この構文は標準に従ったものではありません。 より標準的な方法は以下の通りです。

DELETE FROM films
  WHERE producer_id IN (SELECT id FROM producers WHERE name = 'foo');

In some cases the join style is easier to write or faster to execute than the sub-select style. 副SELECT形式より結合形式の方が書き易い、あるいは、実行が速くなることがあります。

例

Delete all films but musicals: ミュージカル以外の全ての映画を削除します。

DELETE FROM films WHERE kind <> 'Musical';

Clear the table <literal>films</literal>: filmsテーブルを空にします。

DELETE FROM films;

Delete completed tasks, returning full details of the deleted rows: 完了した作業（statusがDONE）を削除し、削除された行のすべての詳細を返します。

DELETE FROM tasks WHERE status = 'DONE' RETURNING *;

Delete the row of <structname>tasks</structname> on which the cursor <literal>c_tasks</literal> is currently positioned: tasksにおいてc_tasksカーソルが現在位置している行を削除します。

DELETE FROM tasks WHERE CURRENT OF c_tasks;

While there is no <literal>LIMIT</literal> clause for <command>DELETE</command>, it is possible to get a similar effect using the same method described in <link linkend="update-limit">the documentation of <command>UPDATE</command></link>: DELETEにはLIMIT句はありませんが、UPDATEの文書で説明したのと同じ方法で同様の効果を得ることができます。

WITH delete_batch AS (
  SELECT l.ctid FROM user_logs AS l
    WHERE l.status = 'archived'
    ORDER BY l.creation_date
    FOR UPDATE
    LIMIT 10000
)
DELETE FROM user_logs AS dl
  USING delete_batch AS del
  WHERE dl.ctid = del.ctid;

互換性

This command conforms to the <acronym>SQL</acronym> standard, except that the <literal>USING</literal> and <literal>RETURNING</literal> clauses are <productname>PostgreSQL</productname> extensions, as is the ability to use <literal>WITH</literal> with <command>DELETE</command>. このコマンドは標準SQLに準拠しています。 ただし、USING句とRETURNING句はPostgreSQLの拡張です。 DELETEでWITHが使用可能であることも同様に拡張です。

関連項目