Incidentu reaģēšana

PostgreSQL "column does not exist": 8 cēloņi un kā tos novērst

Vairumā gadījumu kolonna ir vietā, un PostgreSQL jūsu vaicājumu lasa citādi: dubultpēdiņas ap virkni, lielais burts, aizstājvārds WHERE, tabulas nosaukums UPDATE SET. Pārējais ir izvietošanas secība, un tā produkcijā sāp.

· 13 min lasīšanai · AG Data komanda

"column does not exist" nozīmē, ka PostgreSQL nevarēja kādu nosaukumu jūsu vaicājumā piesaistīt nevienas redzamās tabulas kolonnai. Kļūdas kods ir 42703, undefined_column (kļūdu kodi). Atšķirībā no trūkstošas tabulas trūkstoša kolonna ļoti bieži ir lasīšanas problēma: kolonna ir vietā, bet jūsu SQL prasīja ko citu.

Vispirms izlasiet visu ziņojumu. PostgreSQL ziņo vai nu column "x" does not exist, vai kvalificētai atsaucei column t.x does not exist, un, ja atrod tuvu atbilstību, pievieno mājienu, piemēram, Perhaps you meant to reference the column "t.x". vai Perhaps you meant to reference the table alias "t". (parse_relation.c). Šis mājiens pats atrisina pusi gadījumu.

1. Dubultpēdiņas ap virknes vērtību

SELECT * FROM orders WHERE status = "paid";
-- ERROR:  column "paid" does not exist

SELECT * FROM orders WHERE status = 'paid';   -- string constant: single quotes

Šī ir klasika tiem, kas nāk no MySQL. PostgreSQL virkņu konstantes lieto vienpēdiņas; dubultpēdiņas veido identifikatoru pēdiņās, kas vienmēr ir nosaukums, nekad vērtība (leksiskā struktūra). Tātad "paid" ir kolonna ar nosaukumu paid, un kļūdas ziņojumā jūsu vērtība parādās kā trūkstošā kolonna. Tas pats notiek, kad JSON virkni vai parametru ar roku ielīmē SQL.

2. Lielais burts kolonnas nosaukumā

CREATE TABLE users ("userId" bigint, "createdAt" timestamptz);  -- typical ORM output

SELECT userId FROM users;
-- ERROR:  column "userid" does not exist
-- HINT:  Perhaps you meant to reference the column "users.userId".

SELECT "userId" FROM users;   -- works

Nosaukumi bez pēdiņām tiek pārvērsti mazajos burtos; nosaukumi pēdiņās ir reģistrjutīgi, tāpēc FOO, foo un "foo" ir viens un tas pats, bet "Foo" ir cits (leksiskā struktūra). ORM un migrāciju rīki, kas liek pēdiņas ap katru identifikatoru, izveido "userId", un tad katram ar roku rakstītam vaicājumam tas jāliek pēdiņās tieši tāpat. Mājiens to parasti atklāj. Mūsu pieredzē ilgtspējīgs risinājums ir ORM konfigurācijā izvēlēties mazo burtu snake_case nosaukumus, pirms shēma izaug, jo vēlāka pārdēvēšana skar katru vaicājumu.

3. Jūs skatāties citu tabulu

-- which columns does this table really have, in which schema?
SELECT table_schema, column_name, data_type
FROM information_schema.columns
WHERE table_name = 'users'
ORDER BY table_schema, ordinal_position;

-- in psql
\d users

Ja information_schema.columns rāda kolonnu tabulā app.users, bet jūsu sesija users atrisina uz public.users, jūs vaicājat citu tabulu ar to pašu nosaukumu. Cēloņi ir tie paši, kas trūkstošai tabulai: search_path, nepareiza datubāze, pūls, kas maina sesijas iestatījumus. Tie aprakstīti rakstā PostgreSQL relation does not exist. Tas pats attiecas uz savienojumu (join), kurā kolonna pieder citam aizstājvārdam, nevis tam, ko uzrakstījāt.

4. Izvades aizstājvārds WHERE vai HAVING

-- fails: output alias is not visible in WHERE
SELECT price * qty AS total FROM order_lines WHERE total > 100;
-- ERROR:  column "total" does not exist

-- works: repeat the expression, or wrap in a subquery
SELECT price * qty AS total FROM order_lines WHERE price * qty > 100;
SELECT * FROM (SELECT price * qty AS total FROM order_lines) s WHERE total > 100;

-- ORDER BY and GROUP BY may use the alias
SELECT price * qty AS total FROM order_lines ORDER BY total DESC;

Dokumentācija ir skaidra: izvades kolonnas nosaukumu var lietot ORDER BY un GROUP BY, bet ne WHERE vai HAVING; tur izteiksme jāraksta pilnībā (SELECT). WHERE tiek izvērtēts, pirms izvades saraksts eksistē, tāpēc aizstājvārds vienkārši vēl nav zināms.

5. Tabulas nosaukums UPDATE ... SET

UPDATE orders SET orders.status = 'paid' WHERE id = 1;   -- invalid
UPDATE orders SET status = 'paid' WHERE id = 1;          -- correct

-- qualification is fine (and often needed) on the right-hand side and in WHERE
UPDATE orders o SET status = s.status
FROM staging s
WHERE s.id = o.id;

Saskaņā ar UPDATE dokumentāciju mērķa kolonnā nedrīkst iekļaut tabulas nosaukumu: UPDATE table_name SET table_name.col = 1 nav derīgs (UPDATE). PostgreSQL kreisajā pusē orders lasa kā kolonnas nosaukumu, un kļūda nosauc orders par trūkstošo kolonnu. Uz to bieži paklūp kods, kas pārnests no citām datubāzēm vai ģenerēts ar rīku.

6. PL/pgSQL funkcijas, kas krīt pēc nedēļām

PL/pgSQL funkciju ar drukas kļūdu kolonnas nosaukumā vai ar atsauci uz izdzēstu kolonnu var izveidot bez jebkādas kļūdas. Dokumentācija skaidro, kāpēc: SQL komandas funkcijā tiek parsētas un analizētas tikai tad, kad izpilde tās pirmo reizi sasniedz, tāpēc kļūdas konkrētā komandā netiek atklātas, līdz šī funkcijas daļa izpildās (PL/pgSQL iekšiene). Reti lietots zars var nokrist ilgi pēc migrācijas, kas to salauza. Mūsu pieredzē katra kritiskās funkcijas zara izsaukšana testā pēc katras migrācijas vai tāds rīks kā plpgsql_check šīs kļūdas noķer pirms produkcijas.

Skati uzvedas citādi: kolonnas dzēšana, no kuras atkarīgs skats, tiek atteikta, ja nepievienojat CASCADE, kas izdzēš arī skatu (ALTER TABLE). Šī kļūda ir jūsu draugs; neķerieties pie CASCADE, neizlasījuši, ko tas izdzēsīs.

7. Kods un shēma nav sinhronā

Šīs kļūdas produkcijas versija parasti ir izvietošanas problēma:

Drošais paņēmiens ir expand and contract: pievienojiet jauno kolonnu, izvietojiet kodu, kas raksta abās, aizpildiet vēsturiskos datus, pārslēdziet lasīšanu un dzēsiet veco kolonnu tikai tad, kad neviens kods to nelieto. Sīkāk rakstā PostgreSQL migrācijas bez dīkstāves.

Nekad nepārdēvējiet kolonnu, ko lieto strādājošs kods. Pievienojiet jaunu, migrējiet soļos un veco dzēsiet atsevišķā laidienā. Pārdēvēšana, kas datubāzē aizņem milisekundes, var nogāzt visus lietotņu serverus.

8. Loģiskā replikācija

Loģiskā replikācija nereplicē shēmu un DDL. Kad publicētāja shēma mainās un sāk pienākt replicēti dati, kas neatbilst abonenta tabulai, replikācija krīt ar kļūdu, līdz shēma tiek atjaunināta; dokumentācija iesaka papildinošas shēmas izmaiņas vispirms piemērot abonentam (loģiskās replikācijas ierobežojumi). Jaunas kolonnas pievienojiet abonentiem pirms publicētāja, bet dzēsiet vispirms publicētājā.

Kas mainās lielās tabulās un daudzās datubāzēs

Testa datubāzē ar tūkstoš rindām kolonnas pievienošana un vaicājuma labošana aizņem minūti. Produkcijā:

Galvenās atziņas

PostgreSQL Kļūdas SQL Migrācijas
Sadarbība ar mums

Migrācijas krīt uz trūkstošām kolonnām?

Mēs pārskatām shēmas izmaiņas pirms produkcijas, ieviešam expand-and-contract migrācijas un labojam izvietošanas, kurās kods un shēma izkrīt no sinhrona.

Sazināties Vairāk no emuāra