Bunachar sonraí m77 a úsáid: bailiúcháin, scagairí agus sonraí in aghaidh an úsáideora

An chuid is mó den am ní bheidh ort an bunachar sonraí a láimhseáil go díreach — déanann tú cur síos ar d'aip, agus scríobhann builder77 an cód a stórálann agus a léann sonraí. Ach má thuigeann tú conas a oibríonn sé, scríobhfaidh tú leideanna níos fearr, réiteoidh tú fadhbanna níos tapúla agus déanfaidh tú cinntí maithe faoi phríobháideachas. Seo turas ar m77.db.

Bailiúcháin agus taifid

Maireann sonraí i mbailiúcháin — grúpaí ainmnithe taifead cosúil le tasks, bookings nó posts. Níl scéimre le sainiú: cruthaítear bailiúchán an chéad uair a scríobhann tú chuige, agus is réad simplí é gach taifead le cibé réimsí a thugann tú dó.

const task = await m77.db.create('tasks', { title: 'Write launch post', done: false });
// -> { id, title, done, createdAt, updatedAt, ownerId }

Cuireann builder77 id, createdAt, updatedAt agus ownerId leis go huathoibríoch. Socraítear ownerId don úsáideoir aipe atá logáilte isteach nuair a bhíonn duine ann, rud a bheidh tábhachtach do cheadanna thíos.

Sonraí a léamh: list, get agus count

const open = await m77.db.list('tasks', {
  where: { done: false },   // exact-match filter
  sort: '-createdAt',       // '-' = descending
  limit: 50                 // up to 500
});

const one = await m77.db.get('tasks', id);          // record or null
const doneCount = await m77.db.count('tasks', { where: { done: true } });

Meaitseálann where réimsí go beacht, rud a chlúdaíonn an chuid is mó de riachtanais aipe: scagairí stádais, catagóirí, ID tuismitheora do thaifid ghaolmhara. Le cuardach agus tú ag clóscríobh thar liosta measartha, is gnách na taifid a lódáil agus iad a scagadh sa bhrabhsálaí.

Nuashonrú agus scriosadh

await m77.db.update('tasks', id, { done: true });   // shallow merge
await m77.db.remove('tasks', id);

Cumascann update na réimsí a sheolann tú isteach sa taifead atá ann, mar sin ní gá duit ach an méid a d'athraigh a sheoladh.

Sonraí in aghaidh an úsáideora le mine: true

D'aipeanna ina bhfuil a sonraí féin ag gach duine — dialanna, buiséid, rianairí nósanna — comhcheangail m77.auth leis an rogha mine. Nuair a bhíonn úsáideoir logáilte isteach, ní thugann mine: true ar ais ach na taifid a chruthaigh sé féin.

await m77.auth.signIn({ email, password });

const myEntries = await m77.db.list('entries', { mine: true, sort: '-createdAt' });

Tá an dara sraith cosanta ionsuite: ní féidir taifead a chruthaigh úsáideoir logáilte isteach a nuashonrú ná a scriosadh ach ag an úsáideoir sin féin. Fiú má chumann duine iarratas de láimh, diúltaíonn an API d'athruithe ar thaifid nach leis.

Sonraí poiblí agus príobháideacha: treoir thapa

• Ábhar poiblí (míreanna roghchláir, postálacha blag, liostaí táirgí): níl logáil isteach ag teastáil chun iad a léamh. Iarr ar builder77 sonraí tosaigh a chur isteach, nó scáileán riaracháin a chur leis chun iad a bhainistiú, agus cuir in eagar iad am ar bith sa chluaisín Sonraí.
• Aighneachtaí (foirmeacha teagmhála, liostaí feithimh, áirithintí): is féidir le duine ar bith iad a chruthú; léann tusa iad sa chluaisín Sonraí.
• Sonraí pearsanta (nótaí, logaí sláinte, airgeadas): éiligh logáil isteach agus déan ceisteanna i gcónaí le mine: true.

Riail amháin: tá gach rud i gcód tosaigh d'aipe le feiceáil ag cuairteoirí, agus is féidir le duine ar bith a bhfuil nasc na haipe aige liostaí gan mine: true a léamh. Más sonraí pearsanta iad, cuir taobh thiar de logáil isteach agus mine iad. Más duitse nó do d'fhoireann amháin an aip ar fad, cuir Aip phríobháideach ar siúl sna Socruithe.

An cluaisín Sonraí

Sa tógálaí, ligeann an cluaisín Sonraí duit gach bailiúchán a bhrabhsáil, taifid a chur in eagar nó a scriosadh, úsáideoirí d'aipe a fheiceáil agus comhaid uaslódáilte a athbhreithniú. Is é an bealach is tapúla é chun botún cló san ábhar a cheartú, iontrálacha tástála a ghlanadh, nó a sheiceáil go bhfuil foirm ag sábháil an rud a bhfuil súil agat leis.

Na sonraí céanna ó Flutter agus cliaint eile

Is fillteán tanaí é an SDK gréasáin timpeall REST API, agus is é sin a úsáideann easpórtálacha Flutter freisin. Ciallaíonn sé sin gur féidir le haon chliant na bailiúcháin chéanna a léamh agus a scríobh:

GET  /api/runtime/<projectId>/db/tasks?where={"done":false}&sort=-createdAt&limit=100
POST /api/runtime/<projectId>/db/tasks   { "data": { "title": "Hi" } }
Authorization: Bearer <appUserToken>   (optional, from /auth/signin)

Tá comharthaí úsáideoirí aipe teoranta do thionscadal amháin, mar sin ní féidir comhartha ó aip amháin a úsáid in aghaidh aipe eile. Ní úsáideann léamh ná scríobh sa bhunachar sonraí creidmheasanna — tóg aip chomh trom ar shonraí agus is mian leat.

Leideanna do shonraí

Is féidir leat é seo go léir a stiúradh i ngnáththeanga: “stóráil costais le méid, catagóir agus dáta; ní fheiceann gach úsáideoir ach a chuid féin”, nó “cuir réimse stádais le háirithintí agus scagaire dóibh siúd atá ar feitheamh”. Tá eolas ag an AI ar an SDK, mar sin de ghnáth is leor cur síos a dhéanamh ar an tsamhail sonraí.