主キーは、各行を識別する列または列の組です。値は一意で NULL であってはならず、テーブルに 1 つしか持てません。PostgreSQL では、普通は identity 列でデータベースに値を生成させます: id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY。
id は 1 と 2 です。主キーを定義すると、users_pkey という名前の一意インデックスも作られます。
identity 列: ALWAYS と BY DEFAULT
identity 列は行に番号を振る SQL 標準の方法で、PostgreSQL 10 から使えます。形式は 2 つあります。
GENERATED ALWAYS AS IDENTITYは、INSERTで明示的に値を指定すると拒否します。ただしOVERRIDING SYSTEM VALUEを付けた INSERT は例外です。こちらが安全な選択です。GENERATED BY DEFAULT AS IDENTITYは、値を指定しなかったときだけ生成した値を使います。
BY DEFAULT で自分で id を挿入すると、シーケンスが追いつかず、次に生成される id が重複します。id を指定して行をインポートしたあとは、setval でシーケンスを最大値の先に進めてください。
setval の行がないと、最後の INSERT は id 1 を受け取り、重複キーのエラーで失敗します。この行があれば、新しい行は 4 になります。
SERIAL と identity の違い
serial (4 バイト) と bigserial (8 バイト) は本当の型ではありません。シーケンスを作り、列のデフォルト値をそのシーケンスの nextval() にする省略記法です。
列は nextval('legacy_id_seq'::regclass) をデフォルト値に持つ普通の integer です。INSERT が独自の id を書き込むのを防ぐものはなく、シーケンスには別に権限が必要です。identity 列はこの両方を解決するので、新しいテーブルでは identity 列を選んでください。serial は今でも動き、古いスキーマやチュートリアルでよく見かけます。
増えていくテーブルには bigint (または bigserial) を使ってください。integer のキーは約 21 億で尽きます。
UUID の主キー
gen_random_uuid() はランダムなバージョン 4 の UUID を返します。PostgreSQL 13 から組み込まれているので、拡張機能は不要です。
実行するたびに違う id が表示され、テキストではどれも 36 文字です。uuid 型は 16 バイトで保存するので、text ではなく uuid を使ってください。PostgreSQL 18 では uuidv7() が加わり、インデックスの順に挿入される時刻順の UUID を生成できます。PostgreSQL 17 では、アプリケーション側で生成してください。
複合主キー
キーは複数の列にまたがってもよく、CREATE TABLE の中で独立した行に書きます。各組み合わせが 1 回だけ現れる中間テーブルでは、これが自然なキーです。
重複した組 (1, 10) はスキップされるので、件数は 3 です。既存のテーブルにキーを追加するには ALTER TABLE t ADD PRIMARY KEY (col) を使います。ほかの変更は ALTER TABLE のページ で扱います。ほかのテーブルは 外部キー でこのキーを参照します。
よくある質問
PostgreSQL に AUTO_INCREMENT はありますか?
その名前ではありません。標準的な方法は identity 列 id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY で、PostgreSQL 10 から使えます。従来の serial 型と bigserial 型は、シーケンスとデフォルト値で同じことを実現します。
PostgreSQL の id のシーケンスに欠番ができるのはなぜですか?
シーケンスは、INSERT があとで失敗したりトランザクションがロールバックされたりしても値を払い出し、その値は二度と使われません。欠番は普通のことで害はないので、id が連番であることに頼らないでください。
PostgreSQL の主キーはインデックスを作りますか?
作ります。主キー (とすべての UNIQUE 制約) は一意の B-tree インデックスを自動で作ります。主キーのインデックス名は tablename_pkey です。
主キーには UUID と bigint のどちらを使うべきですか?
bigint の identity キーは小さく (16 バイトに対して 8 バイト)、インデックスの順に挿入されます。UUID はどこでも往復通信なしで生成でき、行数も外から推測されません。ランダムな UUID は挿入がインデックス全体に散らばるので、大きなテーブルではコストが高くなります。