Когда база данных говорит «нет»

Несколько раз в этом уроке база данных отклоняла изменение. Такие ошибки приходят от ограничений (constraints): правил, которые таблица устанавливает для своих данных. База данных проверяет их при каждом INSERT и UPDATE (а внешние ключи — и при каждом DELETE), и если инструкция нарушила бы одно из них, она отклоняет всю инструкцию и ничего не меняет. Правила — часть базы данных, поэтому они защищают данные, кто бы их ни записывал: сайт магазина, складское приложение или вы.

Вот ограничения Pixel Shop, каждое с примером сообщения:

• NOT NULL: у столбца должно быть значение. В Pixel Shop пустыми могут быть только дата выхода игры, город и рекомендовавший клиент у клиента и комментарий отзыва. Игра без возрастного ограничения получит NOT NULL constraint failed: games.age_rating.
• UNIQUE: никакие две строки не могут иметь одинаковое значение в этом столбце. У каждого клиента свой адрес электронной почты, поэтому второй клиент с emma.clark@mail.com получит UNIQUE constraint failed: customers.email. Первичный ключ тоже уникален: занятый ID получит UNIQUE constraint failed: games.id, а поскольку первичный ключ отзыва — это игра и клиент вместе, каждый клиент может оставить отзыв на каждую игру только один раз.
• CHECK: условие, которому должна удовлетворять каждая строка. В Pixel Shop это оценка от 1 до 5, количество больше 0 и статус paid или refunded. В сообщении показано условие: CHECK constraint failed: stars BETWEEN 1 AND 5.
• FOREIGN KEY: внешний ключ должен указывать на существующую строку. Отзыв от клиента 99 получит FOREIGN KEY constraint failed, как и удаление строки, на которую указывают другие строки. В этом сообщении не сказано, о каком столбце речь.
• Типы: в таблицах STRICT столбец INTEGER хранит только целые числа, а столбец TEXT — только текст. Текст в числовом столбце получит cannot store TEXT value in INTEGER column reviews.stars. Целое число в кавычках, например '5', без проблем превращается в число 5, но 'five' или 4.5 отклоняются.

Если сразу добавляется несколько строк и одна из них нарушает правило, не попадёт ни одна:

INSERT INTO reviews (game_id, customer_id, stars)
VALUES
    (4, 4, 5),
    (14, 2, 6);

Error on line 1: CHECK constraint failed: stars BETWEEN 1 AND 5

Первый отзыв в порядке, но у второго оценка 6, поэтому база данных отклоняет всю инструкцию, и первый отзыв тоже не добавляется.

Если инструкция нарушает сразу несколько правил, база данных сообщает об одном из них. Исправьте его и запустите инструкцию снова — возможно, вы получите следующее. Таблица и столбец в сообщении подскажут, где искать. А откуда берутся правила? Они записаны в определении каждой таблицы — в инструкции CREATE TABLE, которая её создала. В следующем уроке вы напишете собственные таблицы, вместе со всеми ограничениями.

Типичная ошибка: убирать ошибку с дороги вместо того, чтобы исправлять данные. Когда новый клиент получает UNIQUE constraint failed: customers.email, решение — не менять в адресе букву за буквой, пока база не согласится. Возможно, клиент уже есть в таблице, или адрес неверный. Ограничение нашло настоящую проблему, так что выясните, какую.