Incidentu reaģēšana

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

Tabula ir redzama jūsu GUI rīkā, bet PostgreSQL saka, ka tās nav. Gandrīz vienmēr nosaukums tiek atrisināts citādi, nekā jūs gaidāt: nepareiza datubāze, nepareiza shēma, lielais burts, starpniekserveris, kas nomainīja search_path, vai atjaunošana ar stingrāku ceļu.

· 12 min lasīšanai · AG Data komanda

"relation does not exist" nozīmē, ka PostgreSQL pašreizējā sesijā nevarēja atrisināt tabulas, skata vai sekvences nosaukumu. "Relācija" PostgreSQL valodā ir viss, kas izskatās pēc tabulas. Objekts parasti eksistē; sesija to vienkārši meklē citā vietā nekā jūs. SQLSTATE ir 42P01, undefined_table (kļūdu kodi).

ERROR:  relation "orders" does not exist
LINE 1: SELECT * FROM orders;
                      ^

Sāciet ar trim jautājumiem

-- where am I?
SELECT current_database(), current_user;
SHOW search_path;
SELECT current_schemas(true);   -- the path as actually resolved

-- does a table with this name exist anywhere, in any case?
SELECT n.nspname AS schema, c.relname, c.relkind
FROM pg_class c
JOIN pg_namespace n ON n.oid = c.relnamespace
WHERE lower(c.relname) = lower('Orders');

-- NULL instead of an error if the name does not resolve
SELECT to_regclass('orders'), to_regclass('app.orders');

Kura datubāze, kurš lietotājs, kāds meklēšanas ceļš. current_schemas(true) ir godīgāks par SHOW search_path: tas parāda, kā ceļš patiesībā tika atrisināts, izlaiž ierakstus, kuriem neatbilst eksistējošas shēmas, un ar true iekļauj arī netiešās, piemēram, pg_catalog (sistēmas informācijas funkcijas). to_regclass kļūdas vietā atgriež NULL, tāpēc tas ir ērts skriptos un veselības pārbaudēs. Vaicājums pret pg_class meklē visās shēmās neatkarīgi no reģistra, tāpēc vienā reizē atbild uz jautājumu "vai tas vispār eksistē?".

1. Lielais burts nosaukumā

CREATE TABLE "Orders" (id bigint);   -- created by an ORM or a GUI tool

SELECT * FROM Orders;     -- ERROR: relation "orders" does not exist
SELECT * FROM "Orders";   -- works

Nosaukumi bez pēdiņām vienmēr tiek pārvērsti mazajos burtos; nosaukumi pēdiņās ir reģistrjutīgi. FOO, foo un "foo" ir viens un tas pats identifikators, bet "Foo" un "FOO" ir atšķirīgi (leksiskā struktūra). ORM, GUI rīki un migrācijas no citām datubāzēm bieži veido nosaukumus ar jauktiem burtiem pēdiņās, un tad katrs ar roku rakstīts vaicājums bez pēdiņām krīt. Pievērsiet uzmanību kļūdas ziņojumam: tajā redzams mazajos burtos pārvērstais nosaukums "orders", un tā ir pazīme. Ilgtermiņa risinājums ir pārdēvēt uz mazajiem burtiem; īstermiņa ir konsekventi lietot pēdiņas. Dokumentācijas ieteikums pārnesamam kodam ir nosaukumu vai nu vienmēr likt pēdiņās, vai nekad.

2. Tabula ir shēmā, kas nav meklēšanas ceļā

Nosaukums bez shēmas tiek meklēts search_path shēmās pēc kārtas. Noklusējums ir "$user", public; ieraksts $user tiek ignorēts, ja shēma ar lietotāja vārdu neeksistē (shēmas). Tabula shēmā app vai billing nav redzama vaicājumam bez shēmas, kamēr jūs to nenorādāt vai nemaināt ceļu:

-- per role (takes effect for new sessions)
ALTER ROLE app_user SET search_path = app, public;

-- per database
ALTER DATABASE shop SET search_path = app, public;

-- per function: do not depend on the caller at all
ALTER FUNCTION app.normalize_sku(text) SET search_path = app, pg_catalog;

3. Nepareiza datubāze

PostgreSQL katra datubāze ir atsevišķa: sesija, kas pieslēgta postgres, neredz tabulas datubāzē shop, un savienot datus starp datubāzēm bez paplašinājuma, piemēram, postgres_fdw, nevar. Mūsu pieredzē tas ir biežākais cēlonis, kad kāds pieslēdzas ar psql bez -d vai kad pēc izvietošanas vides mainīgais norāda lietotnei nepareizu datubāzi. current_database() to atrisina sekundē.

4. Pagaidu tabulas un neapstiprināts DDL

5. PgBouncer transakciju pūls

Transakciju režīmā katra transakcija var izpildīties citā servera savienojumā. PgBouncer funkciju tabulā SET/RESET transakciju pūlā norādīti kā nekad neatbalstīti (PgBouncer funkcijas). Tāpēc SET search_path sesijas sākumā var attiekties uz vienu servera savienojumu un pietrūkt nākamajā, un tas rada periodiskas "relation does not exist" kļūdas, ko neviens nevar atkārtot psql. Saskaņā ar PgBouncer dokumentāciju tas izseko search_path tikai ar PostgreSQL 18 vai jaunāku, jo vecākas versijas klientam neziņo par tā izmaiņām (PgBouncer konfigurācija). Drošāki varianti: iestatīt ceļu lomai vai datubāzei, vai norādīt shēmu nosaukumos. Vairāk par pūla režīmiem rakstā PgBouncer savienojumu pūls.

6. Atjaunošana un apkope ar stingrāku ceļu

Kopš CVE-2018-1058 labojumiem PostgreSQL 10.3 un paralēlajos mazajos laidienos pg_dump, pg_upgrade, vacuumdb un līdzīgi rīki savā meklēšanas ceļā iekļauj tikai pg_catalog, un tāpat rīkojas autovacuum procesi (10.3 laidiena piezīmes). Lietotāja funkcija, kas atsaucas uz tabulu bez shēmas, lietotnē strādā, bet krīt, kad to izsauc indeksa izteiksme vai materializēts skats atjaunošanas vai auto-analyze laikā. Laidiena piezīmes saka, ka šādas funkcijas nedrīkst pieņemt nekādu meklēšanas ceļu. Salabojiet funkciju, norādot shēmas atsaucēs vai piesaistot tai SET search_path, kā piemēra pēdējā rindā.

Ja atjaunošana apstājas uz "relation does not exist", skatieties uz objektu, ko atjauno, nevis uz kļūdā minēto tabulu. Mūsu pieredzē tas parasti ir indekss vai materializēts skats, kas balstīts uz funkciju ar atsauci uz tabulu bez shēmas.

7. Replikas un loģiskā replikācija

Kas mainās ar daudzām shēmām un lielām instalācijām

Testa datubāzē ar vienu shēmu un piecām tabulām nekas no tā neparādās. Produkcijā:

Galvenās atziņas

PostgreSQL Kļūdas Shēmas search_path
Sadarbība ar mums

Migrācijas vai atjaunošana krīt uz trūkstošām relācijām?

Sakārtojam shēmas, search_path un starpniekservera iestatījumus, salabojam atjaunošanu un migrācijas, kas lūst nosaukumu atrisināšanā, un padarām vairāku shēmu vidi paredzamu.

Sazināties Vairāk no emuāra