"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;
- Lomas un datubāzes iestatījumi attiecas uz jaunām sesijām, tāpēc ilgi dzīvojoši savienojumi pūlā patur veco vērtību, līdz pieslēdzas no jauna.
- Shēmas pievienošana
search_pathfaktiski nozīmē uzticēties ikvienam, kam tajā irCREATE, kā brīdina dokumentācija. Turiet ceļus īsus un neiekļaujiet tajos koplietojamas shēmas ar rakstīšanas tiesībām. PostgreSQL 15 jaunās datubāzēs vairs nedod visiemCREATEuzpublic; saistītā kļūda "permission denied" aprakstīta rakstā permission denied for schema public. CREATE TABLEbez shēmas nonāk pirmajā eksistējošajā ceļa shēmā. Nepareizs ceļš migrācijas laikā nozīmē, ka tabula tiek izveidota citur, un lietotne to pēc tam neatrod.
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
- Pagaidu tabula eksistē tikai sesijā, kas to izveidoja. Sesijas pagaidu shēma tiek meklēta pirmā, pat pirms
pg_catalog, ja vien tā nav norādīta skaidri, bet tikai relācijām un tipiem, nekad funkcijām (search_path). Cits savienojums no pūla to neredzēs. - DDL PostgreSQL ir transakcionāls. Tabula, kas izveidota vēl neapstiprinātā transakcijā, nav redzama nevienai citai sesijai, un atritināšana to izdzēš pilnībā.
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
- Fiziskā replika, kas atpaliek, vienkārši vēl nav atskaņojusi
CREATE TABLE. Lietotnes, kas lasa no replikām tūlīt pēc migrācijas, redz kļūdu, kamēr ilgst nobīde. - Loģiskā replikācija nereplicē shēmu un DDL (loģiskās replikācijas ierobežojumi). Publicētājā pievienota tabula abonentā jāizveido ar roku, pirms to var replicēt; citādi abonents krīt ar kļūdu
logical replication target relation "public.x" does not exist.
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ā:
- Shēma katram klientam. Ar simtiem vai tūkstošiem klientu shēmu migrācija, kas krīt pusceļā, atstāj daļu klientu bez jaunās tabulas. Tad kļūda parādās tikai dažiem klientiem. Palaidiet klientu migrācijas ar statusa tabulu katrai shēmai un pēc izlaišanas pārbaudiet ar
to_regclasskatrā shēmā. - Meklēšanas ceļš kā maršrutēšana. Klienta izvēle caur
search_pathstrādā ar sesiju pūlu, un saskaņā ar PgBouncer dokumentāciju tiek izsekota ar PostgreSQL 18 vai jaunāku. Vecākās versijās ar transakciju pūlu tas ir datu noplūdes risks, ne tikai kļūdu avots: vaicājums var nonākt cita klienta shēmā. Mūsu pieredzē drošāki ir nosaukumi ar shēmu vai viena loma katram klientam. - Izvietošanas secība. Kods, kas gaida jaunu tabulu, nedrīkst nonākt produkcijā, pirms migrācija nav apstiprināta primārajā serverī un atskaņota replikās, no kurām kods lasa.
- Lielu dump atjaunošana. Atjaunošana, kas pēc trim stundām krīt uz viena funkcijās balstīta indeksa, ir dārga. Regulāri testējiet produkcijas izmēra dump atjaunošanu un pirms lielas versijas jaunināšanas pārbaudiet funkciju definīcijas, vai tajās nav atsauču bez shēmas.
Galvenās atziņas
- Vispirms pārbaudiet
current_database(),current_useruncurrent_schemas(true). - Nosaukumi bez pēdiņām tiek pārvērsti mazajos burtos; tabulai ar jauktiem burtiem pēdiņas vajag katru reizi.
- Iestatiet
search_pathlomai, datubāzei vai funkcijai, nevis arSETaiz transakciju pūla. - Dump, atjaunošanas, vacuum rīki un autovacuum lieto ceļu tikai ar
pg_catalog; funkcijām jānorāda shēma savās atsaucēs uz tabulām. - Replikas atpaliek, un loģiskā replikācija nekopē DDL: vispirms izvietojiet shēmu, tad kodu.