より多くのSQL、より少ないコード、PostgreSQLを使用

Postgres v9.5以降、「競合」が原因で挿入が失敗した場合にどうなるかを指定できます。競合は、一意のインデックス（主キーを含む）または制約（CREATE CONSTRAINTを使用して以前に作成されたもの）の違反である可能性があります。

この機能は、アプリケーションロジックの挿入または更新を単一のSQLステートメントに単純化するために使用できます。たとえば、テーブル kv キーを使用 および値 列の場合、以下のステートメントは新しい行を挿入するか（テーブルにkey ='host'の行がない場合）、値を更新します（テーブルにkey ='host'の行がある場合）：

CREATE TABLE kv (key TEXT PRIMARY KEY, value TEXT);

INSERT INTO kv (key, value)
VALUES ('host', '10.0.10.1')
    ON CONFLICT (key) DO UPDATE SET value=EXCLUDED.value;

列keyに注意してください テーブルの単一列の主キーであり、競合句として指定されます。複数の列を持つ主キーがある場合は、代わりにここで主キーインデックスの名前を指定してください。

部分インデックスや制約の指定などの高度な例については、Postgresのドキュメントを参照してください。

挿入..戻る

INSERTステートメントはreturnすることもできます SELECTステートメントのように1つ以上の行。関数によって生成された値、 current_timestampなどのキーワードを返すことができます およびシリアル / sequence/identity列。

たとえば、自動生成されたID列と、行の作成のタイムスタンプを保持する列を持つテーブルは次のとおりです。

db=> CREATE TABLE t1 (id int GENERATED BY DEFAULT AS IDENTITY,
db(>                  at timestamptz DEFAULT CURRENT_TIMESTAMP,
db(>                  foo text);

INSERT .. RETURNINGステートメントを使用して、列 fooの値のみを指定できます。 、Postgresが idに対して生成した値を返すようにします およびat 列：

db=> INSERT INTO t1 (foo) VALUES ('first'), ('second') RETURNING id, at, foo;
 id |                at                |  foo
----+----------------------------------+--------
  1 | 2022-01-14 11:52:09.816787+01:00 | first
  2 | 2022-01-14 11:52:09.816787+01:00 | second
(2 rows)

INSERT 0 2

アプリケーションコードから、SELECTステートメントの実行と値の読み込みに使用するのと同じパターン/ APIを使用します（ executeQuery（）など）。 JDBCまたはdb.Query（） Goで）。

別の例を次に示します。これには自動生成されたUUIDがあります：

CREATE TABLE t2 (id uuid PRIMARY KEY, foo text);

INSERT INTO t2 (id, foo) VALUES (gen_random_uuid(), ?) RETURNING id;

INSERTと同様に、UPDATEおよびDELETEステートメントにもPostgresのRETURNING句を含めることができます。 RETURNING句はPostgresの拡張機能であり、SQL標準の一部ではありません。

stmt = conn.prepareStatement("SELECT key, value FROM kv WHERE key IN (?, ?)");
stmt.setString(1, key[0]);
stmt.setString(2, key[1]);

SELECT key, value FROM kv WHERE key = ANY(?)

stmt = conn.prepareStatement("SELECT key, value FROM kv WHERE key = ANY(?)");
a = conn.createArrayOf("STRING", keys);
stmt.setArray(1, a);

WITH items AS (
       DELETE FROM todos_2021
        WHERE NOT done
    RETURNING *
)
INSERT INTO todos_2021 SELECT * FROM items;

SELECT invoice_num, COALESCE(shipping_address, '')
  FROM invoices
 WHERE EXTRACT(month FROM raised_on) = 1    AND
       EXTRACT(year  FROM raised_on) = 2022

SELECT invoice_num, COALESCE(shipping_address, '* NOT SPECIFIED *') ...

SELECT invoice_num, COALESCE(billing_address, shipping_address, '* NO ADDRESS GIVEN *') ...

-- map NOT-SPECIFIED to an empty string
SELECT invoice_num,
       CASE shipping_address
	     WHEN 'NOT-SPECIFIED' THEN ''
		 ELSE shipping_address
		 END
FROM   invoices;

-- same result, different syntax
SELECT invoice_num,
       CASE
	     WHEN shipping_address = 'NOT-SPECIFIED' THEN ''
		 ELSE shipping_address
		 END
FROM   invoices;

SELECT invoice_num,
       CASE
	     WHEN shipping_address IS NULL THEN 'NOT SHIPPING'
	     WHEN billing_address = shipping_address THEN 'SHIPPING TO PAYER'
		 ELSE 'SHIPPING TO ' || shipping_address
		 END
FROM   invoices;

SELECT id, name, address, FALSE AS is_deleted 
  FROM users
 WHERE email = ?

UNION

SELECT id, name, address, TRUE AS is_deleted
  FROM deleted_users
 WHERE email = ?

   SELECT C.id, P.at
     FROM customers C LEFT OUTER JOIN purchases P ON P.customer_id = C.id
 ORDER BY C.id ASC, P.at ASC;

   SELECT DISTINCT ON (C.id) C.id, P.at
     FROM customers C LEFT OUTER JOIN purchases P ON P.customer_id = C.id
 ORDER BY C.id ASC, P.at ASC;

SELECT last_name, first_name,
       CASE country_code
	     WHEN 'US' THEN substr(phone, 2, 3)
		 ELSE 'NON-US'
		 END
FROM   customers;

SELECT last_name, first_name,
       CASE country_code
	     WHEN 'US' THEN substr(phone, 2, 3)
		 ELSE 'NON-US'
		 END
FROM   customers
ORDER  BY
       CASE country_code
	     WHEN 'US' THEN substr(phone, 2, 3)
		 ELSE 'NON-US'
		 END ASC;

SELECT last_name, first_name,
       CASE country_code
	     WHEN 'US' THEN substr(phone, 2, 3)
		 ELSE 'NON-US'
		 END
FROM   customers
ORDER  BY 3 ASC;