CREATE TABLE name (column type constraints, ...) tworzy tabelę. Każda kolumna dostaje nazwę i typ danych, a potem opcjonalne ograniczenia, takie jak PRIMARY KEY, NOT NULL, DEFAULT, UNIQUE albo CHECK.
Kolumna id numeruje się sama, plan przyjmuje 'free', gdy wstawienie ją pomija, a created_at zapisuje czas wstawienia. Strona o typach danych wymienia popularne typy kolumn.
Ograniczenia kolumn
| Ograniczenie | Działanie |
|---|---|
PRIMARY KEY | Unikalny i niepusty; jeden na tabelę |
NOT NULL | Kolumna musi mieć wartość |
DEFAULT expr | Wartość użyta, gdy wstawienie pomija kolumnę |
UNIQUE | Żadne dwa wiersze nie mają tej samej wartości (kilka NULL jest dozwolonych) |
CHECK (expr) | Odrzuca wiersze, dla których wyrażenie jest fałszywe |
REFERENCES t (col) | Klucz obcy do innej tabeli |
Od PostgreSQL 15 UNIQUE NULLS NOT DISTINCT traktuje NULL jako równe, więc tylko jeden wiersz może mieć NULL w tej kolumnie.
Reguły obejmujące kilka kolumn
Ograniczenie na więcej niż jednej kolumnie stoi w osobnej linii po kolumnach. Nadanie mu nazwy przez CONSTRAINT name sprawia, że komunikaty błędów są czytelne, a później możesz je usunąć po nazwie.
Zapytanie wypisuje trzy ograniczenia. Te bez nazwy dostały nazwy wygenerowane, bookings_guests_check i bookings_pkey.
Utworzenie tabeli tylko wtedy, gdy nie istnieje
IF NOT EXISTS zamienia drugie CREATE TABLE w komunikat zamiast błędu. Sprawdza tylko nazwę. Jeśli tabela logs już istnieje z innymi kolumnami, nic się nie zmienia.
Tabela z zapytania albo z innej tabeli
CREATE TABLE ... AS tworzy tabelę z wyniku SELECT, z jego kolumnami i typami. LIKE kopiuje definicję innej tabeli bez jej wierszy, a INCLUDING ALL przenosi wartości domyślne, ograniczenia, identity i indeksy.
big_orders ma jeden wiersz. orders_archive ma kolumny i ograniczenia orders, ale żadnych wierszy.
Kolumny generowane
Kolumna generowana jest obliczana z innych kolumn tego samego wiersza i wstawienia nie mogą jej zapisać. W PostgreSQL 17 musi być STORED: wartość jest liczona przy zapisie i zapisywana na dysku.
Sumy wynoszą 13.5 i 20.
Tabele tymczasowe i unlogged
CREATE TEMP TABLE tworzy tabelę widoczną tylko dla bieżącej sesji i usuwaną po jej zakończeniu. Nadaje się do wyników pośrednich w długim skrypcie. CREATE UNLOGGED TABLE pomija dziennik zapisu z wyprzedzeniem (WAL), więc zapisy są szybsze. Po awarii tabela jest czyszczona i nie trafia na repliki, więc używaj jej tylko do danych, które możesz odtworzyć.
CREATE TEMP TABLE import_batch (line text);
CREATE UNLOGGED TABLE page_views_staging (path text, seen_at timestamptz);
Żeby zmienić istniejącą tabelę, użyj ALTER TABLE. Wszystkie opcje opisuje dokumentacja CREATE TABLE.
Najczęściej zadawane pytania
Czy nazwy tabel w PostgreSQL rozróżniają wielkość liter?
Nazwy bez cudzysłowu są zamieniane na małe litery, więc CREATE TABLE Users tworzy users. Nazwa w cudzysłowie, taka jak "Users", zachowuje wielkość liter i potem trzeba ją ujmować w cudzysłów w każdym zapytaniu. Dlatego normą są nazwy snake_case pisane małymi literami.
Jak zobaczyć strukturę tabeli w PostgreSQL?
W psql \d table_name pokazuje kolumny, typy, wartości domyślne, indeksy i ograniczenia. Z poziomu SQL odpytaj information_schema.columns WHERE table_name = 'table_name'.
Jak skopiować tabelę w PostgreSQL?
CREATE TABLE copy AS TABLE original; kopiuje kolumny i wiersze, ale bez ograniczeń i indeksów. CREATE TABLE copy (LIKE original INCLUDING ALL); kopiuje strukturę z wartościami domyślnymi, ograniczeniami i indeksami, ale bez wierszy.
Jak usunąć tabelę w PostgreSQL?
DROP TABLE table_name; usuwa tabelę razem z danymi. DROP TABLE IF EXISTS table_name; pomija błąd, gdy tabela nie istnieje, a CASCADE usuwa też zależne od niej widoki i klucze obce.