// справочник ошибок PostgreSQL

PostgreSQL 21000: подзапрос вернул более одной строки

Скалярный подзапрос, используемый там, где ожидается одно значение, вернул несколько строк. Добавьте фильтр, агрегатную функцию, LIMIT 1 или используйте IN либо соединение.

SQLSTATE
21000
Имя
cardinality_violation
Категория
Нарушение кардинальности
Сообщение об ошибке
more than one row returned by a subquery used as an expression

Что это значит

Подзапрос в списке SELECT, в сравнении (= (SELECT ...)) или в SET должен возвращать не более одной строки. PostgreSQL обнаруживает это только при выполнении, когда подзапрос возвращает вторую строку, и завершается ошибкой 21000 (cardinality_violation).

Этот же код используют ON CONFLICT DO UPDATE command cannot affect row a second time, когда один INSERT предлагает один и тот же ключ дважды.

Распространённые причины

  • Подзапрос-поиск по неуникальному столбцу, например сопоставление клиентов по имени.
  • Коррелированный подзапрос, в котором отсутствует часть условия соединения.
  • Данные, которые раньше были уникальными, а теперь таковыми не являются.
  • Вот INSERT ... ON CONFLICT DO UPDATE входные данные которых содержат повторяющиеся ключи.

Как исправить

  1. Если подходит любое из нескольких значений или нужно получать его детерминированно, выберите его явно.

    SELECT o.id,
           (SELECT c.email FROM contacts c
            WHERE c.customer_id = o.customer_id
            ORDER BY c.is_primary DESC, c.id
            LIMIT 1) AS email
    FROM orders o;
  2. Если учитываются все совпадающие строки, используйте IN, ANY или соединение вместо =.

    SELECT * FROM orders WHERE customer_id IN (SELECT id FROM customers WHERE name = 'Ada');
  3. Найдите ключи, которые возвращают более одной строки.

    SELECT customer_id, count(*) FROM contacts GROUP BY customer_id HAVING count(*) > 1;
  4. Для ON CONFLICT, сначала удалите повторяющиеся ключи из входных данных.

    INSERT INTO prices (sku, price)
    SELECT DISTINCT ON (sku) sku, price FROM staging ORDER BY sku, updated_at DESC
    ON CONFLICT (sku) DO UPDATE SET price = EXCLUDED.price;

Безопасное воспроизведение

SELECT (SELECT x FROM (VALUES (1), (2)) v(x));  -- ERROR: more than one row returned by a subquery used as an expression

Связанные ошибки

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.