MasomoJinsi ya kuhifadhi ujumbe wa fomu kwenye hifadhidata

Somo fupi 10 kati ya 30 · Fanya tovuti yako iwe na manufaa

Fafanua maana ya kuhifadhi

Somo hili ni la nani?

Kwa watu wanaotaka kuhifadhi yaliyowasilishwa kwenye tovuti. Msaidizi wa programu anaweza kutekeleza usanidi uliotolewa na kuunganisha fomu; huhitaji kuandika SQL au msimbo wa seva.

Rekodi lazima iwepo nje ya ukurasa wa sasa wa kivinjari.

Utakachojifunza katika somo hili

  • Tuma rekodi ya fomu kwenye hifadhi halisi.
  • Hakiki udumu kwenye mwonekano wa jedwali wa mtoa huduma.
  • Kataa taarifa zisizo sahihi bila kufichua rekodi za kila mtu.
Maelezo, mfano uliotatuliwa na zoezi

Kabla ya kuanza

Unahitaji mradi wako wa Supabase unaoweza kufutwa na Netlify Functions wa zoezi. Tumia faili kamili na msaidizi kwa usanidi. Siri za hifadhidata zibaki seva na majaribio yatumie ujumbe wa kubuni tu. Majibu ya mfano yanaonyesha namna ya kujibu, si majaribio yaliyofanywa katika akaunti yako. Badilisha matokeo ya mfano kwa uliyoyaona mwenyewe, au taja hatua ambayo bado imekwama.

Angalia ujuzi wa kuanzia

Huu ni ujuzi muhimu, si sharti la kumaliza kozi zilizofungwa. Ukiujua, anza hapa; la sivyo fungua maandalizi. Faili za kuanzia zimetolewa, kwa hiyo huhitaji tovuti yako ya awali.

  1. Jinsi ya kuchapisha tovuti yako kutoka GitHub

    Unganisha hifadhi ya mazoezi na huduma ya upangishaji.

Muda unaokadiriwa: 20–37 dakika

Makadirio yanatumia faili za kuanzia zilizotolewa, huku akaunti na zana zinazohitajika zikiwa tayari. Usanidi, foleni za uchapishaji na kusubiri barua pepe au DNS huhitaji muda zaidi. Usanidi wa akaunti ni muda wa ziada. Zoezi lenye mipaka si huduma ya umma ya maoni ya watu wasioingia; kagua mipaka endelevu ya matumizi mabaya kabla ya kulibadili kwa matumizi ya umma.

Elewa wazo

Fungua fomu iliyo tayari na msaidizi wako na uchague ujumbe wa kubuni unaotambulika. Tutauifadhi kupitia seva iliyotolewa kwenye hifadhidata tofauti ya mazoezi.

Thamani inayoendelea kuonekana kwenye ukurasa si uthibitisho wa uhifadhi kwenye hifadhidata. Panga kupata ujumbe uleule kwa mtoa huduma na baada ya kufungua tena.

Mfano halisi

Jedwali la mtoa huduma na ukurasa wa sasa wa kivinjari ni sehemu tofauti. Ujumbe unaobaki kwenye jedwali baada ya kufunga programu unaonyesha zaidi ya sentensi inayobaki karibu na kitufe cha kutuma.

Tumia mradi uliotolewa wa kuhifadhi maoni. Nisaidie kutekeleza muundo wake uliotolewa kwenye hifadhidata yangu tofauti ya Supabase ya mazoezi pekee na kusanidi mazingira binafsi ya seva. Zuia ufikiaji wa wageni wa jedwali la maoni. Anzisha fomu, niongoze kwenye mwonekano wa jedwali wa mtoa huduma na unisaidie kuhakiki kwamba data halali inadumu na maombi yasiyo halali hayaundi mstari. Eleza ukaguzi wangu, si sintaksia ya SQL.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Utatafuta wapi kuhakiki kwamba ujumbe wako umehifadhiwa kweli?

Onyesha mfano wa suluhisho

Jibu la mfano: Nitatuma maandishi ya kubuni “D1 — blue notebook”, niyapate kwenye jedwali feedback la mwenye mradi, kisha nifunge na kufungua programu na kuona bado yapo. Lebo kwenye fomu ni jibu la kwanza linaloonekana tu.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anatambua rekodi inayolingana kwa mtoa hifadhidata kama ushahidi wa kuhifadhi.
  • Anajumuisha kufungua/kupakia tena badala ya kutegemea lebo ya muda ya mafanikio.
Jinsi inavyofanya kazi (si lazima)

Hifadhi rekodi nje ya kivinjari

Rekodi iliyohifadhiwa kwenye hifadhidata ibaki hata baada ya kufunga ukurasa.

Kigezo cha JavaScript hupotea ukurasa wake unapofungwa. Local storage hubaki kwenye kivinjari hicho. Hifadhidata huhifadhi rekodi kwenye huduma ambayo programu inaweza kufikia chini ya ruhusa maalumu.

Tutatumia jedwali la siri la Supabase na function ya seva. Kivinjari hutuma ujumbe mfupi; seva huuhakiki na kuandika rekodi. Somo halifungui endpoint ya umma inayoorodhesha ujumbe wa kila mtu.

Mfano uliotatuliwa

Baada ya kutuma “Database test D1”, funga ukurasa na upate ujumbe huo halisi kwenye kihariri cha jedwali la mradi. Ujumbe unaoonekana kwenye ukurasa pekee si ushahidi wa kuhifadhi.

Supabase: hifadhidata

Zoezi la ziada la utekelezaji

Ukurasa unaonyesha ujumbe uliotumwa kutoka kigezo cha ndani. Je, hilo linathibitisha hifadhidata imeuhifadhi?

Onyesha mfano wa suluhisho

Hapana. Hakikisha rekodi halisi kwenye hifadhidata. Kivinjari kinaweza kuonyesha ingizo hata bila ombi lolote kwa seva.

  • Anatenganisha hali inayoonyeshwa na uhifadhi.
  • Anakagua rekodi inayolingana kupitia mwonekano wa hifadhidata wenye ruhusa.

Hatua 1 · Jinsi ya kuhifadhi ujumbe wa fomu kwenye hifadhidata

Andaa mradi wa hifadhi uliotengwa

Mruhusu msaidizi atekeleze usanidi uliotolewa kwa usalama.

Maelezo, mfano uliotatuliwa na zoezi

Elewa wazo

Unda au chagua mradi wako wa Supabase wa kutupwa. Mwombe msaidizi apitie na kusaidia kutekeleza schema.sql huko, kusanidi thamani binafsi na kuendesha mradi kamili kwa kutumia run-locally.txt.

Thibitisha mradi sahihi kabla ya kutekeleza mabadiliko. Wageni wa umma wasiweze kuvinjari maoni yote; tumia Table Editor ya mwenye mradi kukagua mstari wa jaribio.

Mfano halisi

Jedwali feedback lililotolewa lina ujumbe, ID iliyozalishwa na muda wa kuundwa. Mwenye mradi anaweza kulikagua kwa mtoa huduma; wageni hawahitaji ruhusa ya kusoma taarifa za kila mtu ili jaribio lifanye kazi.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Umeandaa mradi upi wa mazoezi, na unaweza kutambua mwonekano wake wa jedwali wa mwenye mradi?

Onyesha mfano wa suluhisho

Rekodi ya mfano: Msaidizi alitumia schema.sql kwenye mradi wangu wa kufutika tu, akasanidi thamani binafsi za seva na kuanza programu. Naweza kukagua feedback kama mwenye mradi katika Table Editor. Wageni bado hawawezi kupekua jedwali.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anataja mradi wa kufutika na hatua ya schema/seva iliyokamilika au iliyokwama.
  • Anapata Table Editor ya feedback ya mwenye mradi bila kuruhusu wageni kusoma jedwali.
Jinsi inavyofanya kazi (si lazima)

Unda jedwali la siri la mazoezi

Washa usalama wa kila rekodi na uzuie ufikiaji wa moja kwa moja wa kivinjari katika njia hii ya mfano.

Endesha schema hii katika mradi pekee wa Supabase wa mazoezi uliotajwa kwenye usanidi. Ufikiaji wa kivinjari umezuiwa kimakusudi; hakikisha rekodi kama mmiliki katika Dashboard → Table Editor. Usiendeshe schema ya zoezi kwenye hifadhidata ya uzalishaji.

Unda mradi tofauti wa Supabase wa mazoezi na uendeshe schema.sql katika kihariri chake cha SQL. Jedwali lina ID inayotengenezwa, ujumbe wenye masharti na muda unaowekwa na seva. Usiendeshe mabadiliko ya mfano kwenye hifadhidata halisi isiyohusiana.

Skripti huwasha usalama wa kila rekodi na kuondoa ruhusa za jedwali kwa majukumu ya kivinjari. Ufunguo wa siri/service-role wa seva unaweza kuandika kwa mamlaka ya juu; lazima ubaki kwenye seva. Ufunguo wa publishable wa kivinjari ni tofauti na hautoi ruhusa hizo za usimamizi.

Fungua Table Editor kwenye dashibodi ya mradi wa Supabase kukagua rekodi ya mazoezi; hii si console ya msanidi ya kivinjari. Insert ikishindwa, kagua jibu la seva na usanidi wa hifadhidata/schema ya mradi. Usiruhusu SELECT ya watu wasioingia ili kuona tu kama insert ilifaulu.

Kwa mfuatano wote wa ndani, fungua run-locally.txt: andaa mazingira ya siri kwenye mzizi, unganisha mradi wa mazoezi pekee na uanzishe wakala wa functions wa Netlify. server-env.example.txt huorodhesha majina ya vigezo bila siri halisi. Kufungua HTML pekee hakuwezi kuendesha seva.

Mfano uliotatuliwa

Hakuna sera pana ya “ruhusu yote” inayohitajika kwa zoezi linalopitia seva. Kufungua SELECT kwa watu wasioingia ili kuchunguza kosa kungefichua pia ujumbe uliotumwa.

create table public.feedback (
 id uuid primary key default gen_random_uuid(),
 message text not null check (char_length(message) between 1 and 1000),
 created_at timestamptz not null default now()
);
alter table public.feedback enable row level security;
revoke all on public.feedback from anon, authenticated;
grant insert on public.feedback to service_role;
-- No browser read/write policies: the practice server uses its secret key.

Supabase: usalama katika kiwango cha kila rekodi · Node.js: hali ya usaidizi wa matoleo

Zoezi la ziada la utekelezaji

Swali la kivinjari limekataliwa. Je, ulitatue kwa kuruhusu watu wasioingia kusoma jedwali lote la maoni?

Onyesha mfano wa suluhisho

Hapana. Muundo huu unakataa usomaji wa kivinjari kimakusudi. Kagua usanidi wa uandishi wa seva na uchunguze jedwali kama mmiliki.

  • Anahifadhi mpaka unaokusudiwa wa data ya siri.
  • Anatumia njia ya seva au dashibodi yenye ruhusa badala ya kufungua usomaji wa kila mtu.

Hatua 2 · Jinsi ya kuhifadhi ujumbe wa fomu kwenye hifadhidata

Wasilisha rekodi kutoka ukurasa

Acha seva iliyo tayari ishughulikie uandishi.

Maelezo, mfano uliotatuliwa na zoezi

Elewa wazo

Fungua programu halisi ya mazoezi ya ndani ya kifaa au iliyopangishwa na utume ujumbe kama D1. Mwombe msaidizi ahifadhi sehemu za mgeni zilizokusudiwa pekee kwenye rekodi.

Tafuta maandishi kamili ya D1 kwenye jedwali la mtoa huduma na ukague kitambulisho na muda wake uliotengenezwa. Usiweke thamani za siri za akaunti kwenye picha za skrini au maelezo yanayoshirikiwa.

Mfano halisi

Tuma D1, kisha pata maandishi hayo halisi kwenye feedback. ID iliyozalishwa inatofautisha mstari huu na ujumbe wa zamani wenye maneno yanayofanana; mgeni asichague au kubadili utambulisho huo.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Nini kilionekana kwenye fomu na kwa mtoa huduma kwa D1?

Onyesha mfano wa suluhisho

Rekodi ya mfano: Fomu ilisema ujumbe umehifadhiwa. Kwenye feedback nilipata “D1 — blue notebook” yenye ID na muda wa kuundwa. Niliweka ID kwenye maelezo binafsi ili kutambua mstari huo tena.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anaunganisha maandishi halisi ya D1 na mstari wa mtoa huduma wenye ID/muda vilivyozalishwa.
  • Anaripoti matokeo ya ukurasa na hifadhi tofauti bila kushiriki usanidi binafsi.
Jinsi inavyofanya kazi (si lazima)

Unganisha uandishi wa seva unaohakikiwa

Seva huchagua jedwali na sehemu zinazoruhusiwa; mwombaji hutoa ujumbe pekee.

Sanidi vigezo vitatu vya seva vilivyotajwa na uchapishe au uendeshe mradi tofauti wa functions. Anayejaribu huingiza msimbo wa mazoezi. Unaruhusu endpoint hii yenye mipaka, si akaunti ya Supabase.

Soma mini-feedback.mjs: function hukagua method, msimbo, ukubwa na ujumbe kabla ya kuita huduma. Hupuuza ID au majina ya majedwali ya mwombaji na kuripoti mafanikio ya kuhifadhi baada tu ya jibu la insert kufaulu.

Mfano uliotatuliwa

Ombi lenye sehemu ya ziada ya admin haliwi sasisho la usimamizi: seva hutengeneza kitu kipya chenye message pekee.

Zoezi la ziada la utekelezaji

Kwa nini kutengeneza {message} badala ya kupeleka kitu kizima cha JSON cha kivinjari kwenye hifadhidata?

Onyesha mfano wa suluhisho

Hufanya muundo unaokubaliwa na seva uwe wazi na kuzuia sehemu zisizotarajiwa kuandikwa. Hakiki ujumbe pia; kuchagua sehemu pekee hakutoshi.

  • Anaweka mipaka kwa sehemu zinazoweza kuandikwa.
  • Haamini ID, muda au mamlaka vinavyodhibitiwa na kivinjari.

Hatua 3 · Jinsi ya kuhifadhi ujumbe wa fomu kwenye hifadhidata

Kagua udumu na kushindwa

Rudia kitendo baada ya kufunga ukurasa wa kwanza.

Maelezo, mfano uliotatuliwa na zoezi

Elewa wazo

Funga na ufungue programu tena, kisha hakiki D1 bado ipo kwenye hifadhi. Jaribu taarifa zilizokosekana au ndefu kupita kiasi na msimbo usio sahihi wa mazoezi kwenye usanidi wa kutupwa.

Majaribio yasiyo halali hayapaswi kuunda mistari mipya. Ujumbe wa mafanikio wa awali usibaki kana kwamba jaribio la baadaye lililoshindwa limehifadhiwa pia.

Mfano halisi

Andika rekodi halali kabla ya majaribio hasi, kisha kagua jedwali baadaye. “Fomu ilionyesha kosa” na “hakuna mstari batili uliongezwa” ni sehemu mbili zenye manufaa za ukaguzi.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Rekodi zipi zilibaki baada ya kufungua tena, na nini kilitokea kwa majaribio yako yasiyo halali?

Onyesha mfano wa suluhisho

Rekodi ya mfano: Baada ya kufunga na kufungua ukurasa, D1 ilibaki kwenye jedwali. Ujumbe tupu, mkubwa mno na msimbo batili havikuongeza mistari. Jaribio lililoshindwa lilionyesha kosa badala ya kuacha Saved ya awali kana kwamba inahusu jaribio hili pia.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anakagua rekodi halali iliyotambuliwa bado ipo baada ya kufungua tena.
  • Anahakiki majaribio batili ya data/ufikiaji hayaongezi mistari wala kuacha ujumbe wa mafanikio wa kupotosha.
Jinsi inavyofanya kazi (si lazima)

Hakikisha uhifadhi wa kudumu na hali za kushindwa

Tumia rekodi zinazotofautishika na ukague hifadhidata bila kutegemea ukurasa.

Tuma D1 kwa msimbo sahihi na ukague rekodi inayolingana kwenye Table Editor. Funga na ufungue ukurasa tena, kisha uhakikishe rekodi bado ipo. Rekodi ID na muda wake bila kushiriki siri za akaunti.

Jaribu ujumbe unaokosekana, ujumbe mkubwa kupita kiasi na msimbo usio sahihi. Hakuna unaopaswa kuunda rekodi mpya. Katika mradi wa mazoezi, kagua kukosekana kwa usanidi wa seva kunatoa kushindwa kwa uaminifu.

Mfano uliotatuliwa

Rekodi sahihi na maombi mawili yasiyo sahihi yaliyokataliwa hutoa taarifa zaidi kuliko mibofyo mitatu ya mafanikio inayorudiwa. Epuka maoni binafsi halisi katika zoezi la kwanza.

Zoezi la ziada la utekelezaji

Endpoint inarudisha kosa lakini kivinjari bado kinasema “Saved” kutoka jaribio la awali. Uhakikishe nini?

Onyesha mfano wa suluhisho

Kagua kama thamani mpya ina rekodi. Kiolesura kionyeshe kosa la sasa, na mafanikio ya zamani yasihesabiwe kuwa matokeo ya jaribio hili.

  • Anakagua jibu la sasa na thamani mpya mahsusi ya majaribio.
  • Hatumii ujumbe wa zamani wa mafanikio kuwa ushahidi wa ombi lililoshindwa.

Hatua 4 · Jinsi ya kuhifadhi ujumbe wa fomu kwenye hifadhidata

Ongeza mada bila kufungua data

Tumia msaidizi kubadilisha sehemu na ukague matokeo.

Maelezo, mfano uliotatuliwa na zoezi

Elewa wazo

Mwombe msaidizi aongeze Project na Question kwenye fomu, usanidi wa kuhifadhi na uthibitishaji wa seva. Thamani za kuhifadhi ni project na question. Rejea iliyotolewa ni ya kulinganisha baada ya kujaribu, si mahali pa kugundua kwanza hitaji la kazi.

Unda rekodi moja kwa kila mada na ujaribu other isiyoruhusiwa kwa msaada wa msaidizi. Hakiki thamani zote na kukataliwa, bila kuwafungulia wageni jedwali feedback.

Mfano halisi

Ongeza mada mbili halali, Project na Question. Kila thamani ihifadhiwe karibu na ujumbe wake. Other ni jaribio la kukataliwa, hivyo selector inayopendeza pekee haikamilishi badiliko la kuhifadhi.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Toa badiliko la mada na matokeo uliyoyaona ya hifadhi halali na isiyo halali.

Unachopaswa kuandaa: Rekodi ya hifadhi iliyofichwa taarifa nyeti inayoonyesha udumu halali na majaribio yasiyo halali yaliyokataliwa.

Onyesha mfano wa suluhisho

Rekodi ya mfano: “D2 — project test” ilihifadhiwa na topic project; “D3 — question test” na topic question. Thamani other ilikataliwa bila mstari mpya. Nilikagua kama mwenye mradi; wageni bado hawakusoma jedwali lote.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anahifadhi thamani za Project na Question na rekodi zinazolingana za jaribio.
  • Anakataa mada isiyoruhusiwa huku wageni wakiendelea kutoweza kupekua feedback.
Jinsi inavyofanya kazi (si lazima)

Kazi yako: hifadhi mada iliyohakikiwa

Panua muundo wa data na seva pamoja bila kufungua ruhusa za kivinjari.

Ongeza safu ya topic yenye thamani project au question tu. Sasisha seva ihakiki orodha inayoruhusiwa na itengeneze kitu kinachoingizwa wazi. Ongeza kidhibiti kinacholingana cha fomu.

Unda rekodi moja kwa kila mada inayoruhusiwa na ukatae thamani isiyoruhusiwa. ID na muda unaotengenezwa vibaki chini ya udhibiti wa hifadhidata.

DEFAULT huweka question kwenye rekodi zilizopo katika zoezi hili. Bila thamani/default, kuongeza safu wima (column) yenye sharti la NOT NULL kunaweza kushindwa ikiwa rekodi tayari zipo. Katika mabadiliko halisi ya muundo wa hifadhidata (migration), chagua thamani ya kujaza rekodi za zamani kulingana na data badala ya kunakili chaguo hili la zoezi.

Mfano uliotatuliwa

Sharti la hifadhidata huimarisha uhakiki wa seva. Hakuna linalochukua nafasi ya jingine katika makosa yanayoeleweka na uadilifu wa data.

Maelezo kamili ya hatua za suluhisho yanapatikana katika reference/assignment-walkthrough.txt. Linganisha hatua zake na matokeo yako; jaza rekodi ya majaribio kwa ulichokiona katika mradi wako mwenyewe.

-- Existing rows need a value when the new column is NOT NULL.
alter table public.feedback add column topic text not null default 'question';
alter table public.feedback add constraint feedback_topic_allowed
 check (topic in ('project','question'));

Zoezi la ziada la utekelezaji

Ongeza topic na uthibitishe data sahihi inabaki huku isiyo sahihi ikikataliwa.

Onyesha mfano wa suluhisho

Upanuzi wa topic unahitaji tabaka zote tatu zilingane: select ya kivinjari, orodha ya ruhusa ya seva na safu pamoja na sharti la check kwenye hifadhidata. ALTER TABLE ya marejeo hushughulikia rekodi zilizopo kwa kuweka mada ya default iliyoelezwa kabla ya kutekeleza sharti.

Seva huandika {message,topic} tu. Lazima ikatae mada isiyoruhusiwa kabla ya kutumia ufunguo wa siri wa hifadhidata. Pia ipuuze ID/majina ya majedwali yanayotolewa na mwombaji na iripoti kushindwa kwa uandishi wa huduma kuwa kushindwa.

Kagua ujumbe/topic halisi iliyohifadhiwa kwenye Table Editor ya dashibodi ya Supabase, si aya ya mafanikio kwenye kivinjari. Pakia upya au funga kivinjari na uhakikishe rekodi ileile. Tumia uchunguzi wenye ruhusa ya mmiliki; usifungue usomaji wa watu wasioingia ili kutatua kosa.

  • Uhakiki wa mada upo kwenye seva na hifadhidata.
  • Rekodi sahihi zinazolingana zinabaki na thamani zisizoruhusiwa haziundi rekodi.

Somo hili lilikufaa?

Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.