Menu

PostgreSQL CREATE TABLE: składnia i przykłady

CREATE TABLE określa kolumny, typy i ograniczenia tabeli. Omawia klucze identity, NOT NULL, DEFAULT, UNIQUE, CHECK, IF NOT EXISTS, CREATE TABLE AS i LIKE.

Na tej stronie są działające edytory: edytuj, uruchamiaj i od razu zobacz wynik.

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

OgraniczenieDziałanie
PRIMARY KEYUnikalny i niepusty; jeden na tabelę
NOT NULLKolumna musi mieć wartość
DEFAULT exprWartość 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.

Ilustracja języków programowania w Coddy

Ucz się programowania z Coddy

Zacznij