Duomenų bazė (b77.db)
Kolekcijos, užklausos ir kiekvieno naudotojo duomenys.
b77.db yra dokumentų duomenų bazė be schemos. Kolekcija sukuriama automatiškai, kai į ją pirmą kartą ką nors įrašai.
Kūrimas
const task = await b77.db.create('tasks', { title: 'Ship v2', done: false, priority: 2 });
// → { id, title, done, priority, createdAt, updatedAt, ownerId }Skaitymas
const all = await b77.db.list('tasks');
const open = await b77.db.list('tasks', { where: { done: false }, sort: '-priority', limit: 50 });
const one = await b77.db.get('tasks', id); // null if missing
const count = await b77.db.count('tasks', { where: { done: true } });Filtrai
where lygina laukus tiksliai ir palaiko operatorius:
| Operatorius | Pavyzdys |
|---|---|
| lygu | { status: 'paid' } |
$ne | { status: { $ne: 'draft' } } |
$in | { status: { $in: ['sent', 'paid'] } } |
$gt / $gte / $lt / $lte | { total: { $gte: 100 } } |
$contains | { name: { $contains: 'ann' } } (neskiria didžiųjų ir mažųjų raidžių) |
sort priima lauko pavadinimą; priešdėlis - reiškia mažėjančią tvarką (numatytoji -createdAt). limit gali būti iki 500, o offset skirtas puslapiavimui.
Atnaujinimas ir trynimas
await b77.db.update('tasks', id, { done: true }); // shallow merge
await b77.db.replace('tasks', id, { title: 'New' }); // overwrite all fields
await b77.db.remove('tasks', id);Kiekvieno naudotojo duomenys
Įrašai, sukurti prisijungus naudotojui, gauna ownerId. Tik dabartinio naudotojo įrašus gausi su mine: true:
const myNotes = await b77.db.list('notes', { mine: true });Įrašą, turintį savininką, atnaujinti ar ištrinti gali tik tas savininkas.
Prieigos taisyklės
Kiekviena kolekcija turi prieigos taisyklę, kuri tikrinama serveryje. Jei kolekcija taisyklės neturi, ji gauna numatytąją pagal pavadinimą: tai, ką žmonės atsiunčia (orders, bookings, messages…), gauna submit, tavo skelbiamas turinys (products, menu, posts…) gauna readonly, leaderboard ir guestbook gauna append, o visa kita yra private. Taisyklę kiekvienai kolekcijai pakeisi redaktoriaus skiltyje Duomenys, arba programėlė gali nurodyti taisykles faile b77.config.json:
{ "rules": { "notes": "private", "menu": "readonly", "orders": "auth" } }| Taisyklė | Kas gali skaityti | Kas gali rašyti |
|---|---|---|
public | Bet kas | Bet kas |
auth | Prisijungę programėlės naudotojai | Prisijungę programėlės naudotojai |
private | Kiekvienas naudotojas mato tik savo įrašus | Tik įrašo savininkas |
readonly | Bet kas | Tik tu, skiltyje Duomenys |
submit | Tik tu ir programėlės administratoriai | Įrašus siųsti gali bet kas |
append | Bet kas | Pridėti gali bet kas; keisti ar trinti kiekvienas gali tik savo įrašus |
members | Prisijungę naudotojai su aktyvia prenumerata | Prisijungę naudotojai su aktyvia prenumerata |
members-private | Kiekvienas prenumeratorius mato tik savo įrašus | Tik įrašo savininkas |
team | Tu ir naudotojai, kuriuos paskiri administratoriais | Tu ir naudotojai, kuriuos paskiri administratoriais |
direct | Siuntėjas, gavėjas ir programėlės administratoriai | Žinutę pakeisti ar ištrinti gali tik siuntėjas |
Apribojimai
Vienas įrašas gali būti iki 64 KB (failus geriau saugok su b77.storage.upload). Kiek įrašų gali turėti programėlė, priklauso nuo plano: Free 2 000, Starter 20 000, Plus 50 000, Pro 100 000, Elite 200 000.