CREATE TABLE name (column type constraints, ...) でテーブルを作ります。各列には名前とデータ型を付け、必要に応じて PRIMARY KEY、NOT NULL、DEFAULT、UNIQUE、CHECK などの制約を加えます。
id 列は自動で採番されます。INSERT で plan を省略すると 'free' が入り、created_at には挿入した時刻が記録されます。よく使う列の型は データ型のページ にまとめています。
列の制約
| 制約 | 効果 |
|---|---|
PRIMARY KEY | 一意で NULL 不可。テーブルに 1 つ |
NOT NULL | 列に値が必須 |
DEFAULT expr | INSERT で列を省略したときに使う値 |
UNIQUE | 同じ値を持つ行を許さない (NULL は複数可) |
CHECK (expr) | 式が false になる行を拒否する |
REFERENCES t (col) | 別のテーブルへの外部キー |
PostgreSQL 15 からは、UNIQUE NULLS NOT DISTINCT を使うと NULL 同士を等しいとみなすので、その列が NULL の行は 1 行しか入れられません。
複数の列にまたがるルール
複数の列に対する制約は、列の定義のあとに独立した行として書きます。CONSTRAINT name で名前を付けると、エラーメッセージが読みやすくなり、あとで名前を指定して削除できます。
クエリは 3 つの制約を表示します。名前を付けなかった制約には、bookings_guests_check と bookings_pkey という名前が自動で付きます。
テーブルがない場合だけ作る
IF NOT EXISTS を付けると、2 回目の CREATE TABLE はエラーではなく通知になります。確認するのは名前だけです。logs という名前のテーブルが別の列構成ですでにあっても、何も変わりません。
クエリや別のテーブルからテーブルを作る
CREATE TABLE ... AS は SELECT の結果からテーブルを作り、結果の列と型をそのまま使います。LIKE は別のテーブルの定義を行なしでコピーし、INCLUDING ALL を付けるとデフォルト値、制約、identity、インデックスも一緒にコピーします。
big_orders には 1 行あります。orders_archive は orders の列と制約を持ち、行はありません。
生成列
生成列は同じ行のほかの列から計算される列で、INSERT で値を書き込むことはできません。PostgreSQL 17 では STORED にする必要があり、値は書き込み時に計算されてディスクに保存されます。
合計は 13.5 と 20 です。
一時テーブルと UNLOGGED テーブル
CREATE TEMP TABLE は現在のセッションからしか見えないテーブルを作り、セッションが終わると削除されます。長いスクリプトの中間結果を置くのに向いています。CREATE UNLOGGED TABLE は先行書き込みログ (WAL) を使わないので、書き込みが速くなります。ただしクラッシュ後は空になり、レプリカにもコピーされないので、作り直せるデータにだけ使ってください。
CREATE TEMP TABLE import_batch (line text);
CREATE UNLOGGED TABLE page_views_staging (path text, seen_at timestamptz);
作成済みのテーブルを変更するには ALTER TABLE を使います。すべてのオプションは CREATE TABLE のリファレンス に載っています。
よくある質問
PostgreSQL のテーブル名は大文字と小文字を区別しますか?
引用符で囲まない名前は小文字に変換されるので、CREATE TABLE Users は users を作ります。"Users" のように引用符で囲んだ名前は大文字小文字がそのまま残り、以後すべてのクエリで引用符が必要になります。そのため小文字のスネークケースが一般的です。
PostgreSQL でテーブルの構造を確認するには?
psql では \d table_name で列、型、デフォルト値、インデックス、制約が表示されます。SQL からは information_schema.columns WHERE table_name = 'table_name' を検索します。
PostgreSQL でテーブルをコピーするには?
CREATE TABLE copy AS TABLE original; は列と行をコピーしますが、制約とインデックスはコピーしません。CREATE TABLE copy (LIKE original INCLUDING ALL); はデフォルト値、制約、インデックスを含む構造をコピーし、行はコピーしません。
PostgreSQL でテーブルを削除するには?
DROP TABLE table_name; でテーブルとデータを削除します。DROP TABLE IF EXISTS table_name; はテーブルがなくてもエラーになりません。CASCADE を付けると、そのテーブルに依存するビューと外部キーも削除します。