Somo fupi · Kiswahili

Jinsi ya kuhifadhi ujumbe wa fomu kwenye hifadhidata

Hifadhi fomu ya tovuti kwenye mradi wa hifadhidata wa mazoezi uliotolewa, kisha hakiki kwamba rekodi inabaki baada ya kufungua ukurasa tena.

Anza somo shirikishiSoma maelezo ya somo

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.

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.

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.

Utakachojifunza

  • 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.

Faili za mazoezi

Hatua 1

Fafanua maana ya kuhifadhi

Rekodi lazima iwepo nje ya ukurasa wa sasa wa kivinjari.

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.

Supabase: hifadhidata

Faili za hatua hii

Start hereFaili za mazoezi

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

Extra implementation exercise

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 2

Andaa mradi wa hifadhi uliotengwa

Mruhusu msaidizi atekeleze usanidi uliotolewa kwa usalama.

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.

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

Faili za hatua hii

Start hereFaili za mazoezi

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

Extra implementation exercise

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 3

Wasilisha rekodi kutoka ukurasa

Acha seva iliyo tayari ishughulikie uandishi.

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

Start hereFaili za mazoezi

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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 4

Kagua udumu na kushindwa

Rudia kitendo baada ya kufunga ukurasa wa kwanza.

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

Start hereFaili za mazoezi

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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 5

Ongeza mada bila kufungua data

Tumia msaidizi kubadilisha sehemu na ukague matokeo.

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

Start hereFaili za mazoezi

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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'));

Extra implementation exercise

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.

Endelea kujifunza

Angalia masomo mengine