Tworzysz tabelę użytkowników i nie chcesz ręcznie wymyślać identyfikatora przy każdym zapisie? Automatycznie nadawany klucz główny zwykle rozwiązuje ten problem, ale składnia zależy od bazy, a kolejnych numerów nie należy traktować jak numerów dokumentów bez luk.

Automatyczne ID upraszcza zapis, ale jego składnia i zachowanie zależą od silnika
- MySQL: kolumna otrzymuje atrybut
AUTO_INCREMENT. - PostgreSQL: nową tabelę najczęściej definiuje się z kolumną
GENERATED ... AS IDENTITY. - SQL Server: używa właściwości
IDENTITY(seed, increment). - SQLite: zwykle wystarcza
INTEGER PRIMARY KEY; słowoAUTOINCREMENTzapobiega ponownemu użyciu usuniętego ID. - Luki są normalne: automatyczny licznik nie gwarantuje kolejnych numerów bez przerw.
Składnia zależy od bazy, nie od samego SQL
Wspólna jest intencja: baza generuje wartość identyfikatora, gdy dodajesz wiersz. Różni się zapis deklaracji kolumny, dlatego kod z AUTO_INCREMENT nie zadziała w SQL Server ani PostgreSQL.
Przykład tworzy tabelę users z automatycznym kluczem i polem nazwy. W PostgreSQL użyto wariantu GENERATED BY DEFAULT, który pozwala podać własne ID, jeśli jawnie dodasz je do instrukcji INSERT.
| Silnik | Przykładowa definicja | Na co zwrócić uwagę |
|---|---|---|
| MySQL | id INT NOT NULL AUTO_INCREMENT PRIMARY KEY | AUTO_INCREMENT to składnia MySQL. |
| PostgreSQL | id INTEGER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY | ALWAYS mocniej blokuje przypadkowe podanie własnej wartości. |
| SQL Server | id INT IDENTITY(1,1) PRIMARY KEY | Pierwsza liczba określa wartość początkową, druga krok. |
| SQLite | id INTEGER PRIMARY KEY | Sam typ INTEGER wraz z kluczem głównym wystarcza do generowania ID. |
W PostgreSQL starsze przykłady często pokazują SERIAL. Nadal można je spotkać w istniejących projektach, ale do nowych tabel czytelniejszy jest standardowy zapis kolumny tożsamości. Szczegóły wariantów opisuje dokumentacja PostgreSQL o kolumnach identity.
Wybierz typ ID z myślą o wzroście tabeli
INT zajmuje mniej miejsca niż BIGINT, ale ma niższy limit dodatnich wartości. Dla małej, wewnętrznej tabeli zwykły typ całkowity może wystarczyć; przy tabelach intensywnie zapisujących zdarzenia bezpieczniejszy zapas daje typ 64-bitowy.
W PostgreSQL INTEGER mieści wartości do 2 147 483 647, a BIGINT do 9 223 372 036 854 775 807. To limit zakresu typu, nie prognoza liczby rekordów: usuwanie wierszy nie cofa licznika. Informacje o typach i starszym zapisie SERIAL podaje dokumentacja PostgreSQL dotycząca typów liczbowych.
Uważam, że dla nowych tabel aplikacyjnych najlepiej jawnie dobierać typ do przewidywanego tempa przyrostu danych, zamiast mechanicznie kopiować INT z pierwszego przykładu. Zmiana zbyt małego typu po wdrożeniu bywa znacznie bardziej kłopotliwa niż świadomy zapas od początku.
Pomiń kolumnę ID przy zwykłym INSERT
Po skonfigurowaniu licznika nie obliczaj ręcznie MAX(id) + 1. Przy dwóch zapisach wykonywanych równocześnie oba żądania mogą odczytać tę samą największą wartość i spróbować użyć identycznego identyfikatora.
INSERT INTO users (name)
VALUES ('Ala Nowak');
Kolumnę id pomijasz, a baza przydziela wartość. Jeśli aplikacja potrzebuje jej natychmiast, pobierz identyfikator mechanizmem właściwym dla używanego silnika i sterownika. W PostgreSQL można użyć RETURNING id; w MySQL dostępna jest funkcja LAST_INSERT_ID(). Dokumentacja MySQL o AUTO_INCREMENT opisuje również pobranie ostatniej wygenerowanej wartości.
Wyjątkiem jest import danych, podczas którego trzeba zachować istniejące identyfikatory. Po takim imporcie sprawdź, czy licznik będzie nadawał wartości wyższe niż już zapisane; szczegóły ustawiania i synchronizacji zależą od konkretnej bazy.
Luki w numeracji nie oznaczają błędnych rekordów
Jeśli po ID 41 pojawia się 43, nie zakładaj od razu, że ktoś usunął rekord 42. Wartość mogła zostać pobrana przez transakcję, która później się wycofała, albo przydzielona nieudanemu zapisowi. W PostgreSQL sekwencja nie cofa pobranej wartości po rollbacku, a SQL Server również nie obiecuje numeracji bez przerw.
To obala częste założenie, że automatyczne ID tworzy ciągłą numerację. Służy do jednoznacznego wskazywania wierszy, nie do rozliczania kolejnych pozycji ani ustalania, który zapis wydarzył się pierwszy. Różnicę dobrze opisują dokumentacje funkcji sekwencji PostgreSQL i właściwości IDENTITY w SQL Server.
| Sytuacja | Prawdopodobna przyczyna | Co zrobić |
|---|---|---|
| Po usunięciu wiersza numer nie wraca | Licznik nie jest narzędziem do ponownego wykorzystania identyfikatorów. | Pozostaw lukę; nie zmieniaj ręcznie ID pozostałych rekordów. |
| Po błędzie INSERT następny numer jest wyższy | Silnik mógł zużyć wartość przed odrzuceniem zapisu. | Sprawdź przyczynę błędu, a lukę potraktuj jako normalną. |
| W imporcie dostajesz błąd duplikatu klucza | Wstawiane ID koliduje z istniejącym wierszem albo licznik jest niesynchronizowany z danymi. | Zweryfikuj zakres importowanych ID i ustaw licznik zgodnie z dokumentacją danego silnika. |
| Potrzebujesz numerów bez przerw | Automatyczny klucz nie zapewnia takiej własności. | Oddziel identyfikator techniczny od numeracji biznesowej i zaprojektuj tę drugą osobno. |
W SQLite słowo AUTOINCREMENT ma węższy sens
W SQLite zapis INTEGER PRIMARY KEY już automatycznie przydziela identyfikator. Dodanie AUTOINCREMENT zmienia algorytm: baza nie użyje ponownie ID, które wcześniej należało do zatwierdzonego wiersza i zostało usunięte.
Ta gwarancja kosztuje dodatkową pracę przy zapisach, a i tak nie zapewnia numeracji bez luk. Użyj jej tylko wtedy, gdy ponowne wykorzystanie starego identyfikatora jest rzeczywistym problemem, a nie dlatego, że słowo wygląda na obowiązkowy element składni. Takie rozróżnienie podaje oficjalny opis SQLite AUTOINCREMENT.
Traktuj klucz jako identyfikator, nie numer porządkowy
Typowy klucz główny powinien być stabilny, unikatowy i obsługiwany przez bazę. Nie opieraj na nim kolejności zdarzeń, liczby zamówień ani numeracji dokumentów, bo każda z tych rzeczy podlega innym regułom.
Gdy potrzebujesz czytelnego numeru faktury lub zamówienia, zaprojektuj osobny mechanizm zgodny z wymaganiami aplikacji. Automatycznie nadawane ID zostaw jako techniczny adres wiersza, a zniknie pokusa, by każdą lukę w liczniku traktować jak awarię.
