Le entità
Le «cose» che la tua app ricorda
- 15 minuti di lettura
Nives Corti tiene l'ufficio oggetti smarriti di Porta Codice. Con lei hai già scritto metà del canvas di Ritrovato, l'app che le serve: la frase, per chi è, il problema, le funzioni, le schermate. Se ti manca qualcosa, è nel capitolo Le domande da farsi.
Adesso tocca al riquadro 6: «Quali "cose" ricorda l'app? Cosa sai di ognuna?». Sono due domande, e hanno un capitolo ciascuna. Questo risponde alla prima: quali sono le cose. La seconda, cosa sai di ognuna, è nel capitolo Gli attributi.
Come si passa dal foglio alle tabelle lo sai già: sono le cinque mosse del capitolo Disegnare un database, e la prima dice «ogni cosa è una tabella». Qui non la rispieghiamo. Ti dà quello che lì manca: come si trovano le cose, e come si decide se un nome è davvero una cosa o soltanto un pezzo di un'altra.
Cos'è un'entità
Un'entità è una «cosa» di cui l'app si ricorda. Ha tre segni:
- ce ne sono tante, tutte dello stesso tipo;
- ognuna si distingue dalle altre: l'ombrello blu trovato lunedì e l'ombrello blu trovato martedì sono due oggetti, anche se si somigliano;
- ognuna ha cose sue da sapere: dove è stata trovata, quando, a che punto è.
Gli oggetti smarriti sono un'entità. Ogni entità diventerà una tabella, con il nome al plurale (oggetti), e ogni singola cosa sarà una riga.
Perché conta farlo bene? Lo dice già il capitolo sul disegno: un errore di disegno non dà nessun errore. Se ti manca una tabella, il database funziona lo stesso. Sono le risposte a essere sbagliate, e te ne accorgi quando hai già scritto metà dell'app.
Dove si trovano
Non devi inventarle: le hai già scritte. Prendi i riquadri 4, 5 e 7 del canvas di Ritrovato e sottolinea i nomi, quelli che indicano una cosa. Ecco i pezzi di canvas dove stanno:
4 · Le funzioni
registro un oggetto trovato · cerco tra gli oggetti trovati, per stazione, categoria e giorno ·
restituisco un oggetto: a chi, quando
5 · Le schermate
gli oggetti trovati · la scheda di un oggetto · nuovo oggetto · restituzione · login dell'addetto
7 · Le azioni
restituisco: scrivo una restituzione, e lo stato dell'oggetto diventa «restituito»
login: leggo un addetto e controllo la passwordSottolineati: oggetto, stazione, categoria, giorno, chi (il passeggero), restituzione, addetto, password, stato. Più due che stanno nel foglio di Nives, tra i riquadri 6, 7 e 8: colore e segno particolare. Undici nomi, e non sono tutte tabelle. Come si decide?
La prova delle quattro domande
Per ogni nome sottolineato, quattro domande, sempre nello stesso ordine. Ti fermi al primo «no».
| # | La domanda | Cosa vuol dire |
|---|---|---|
| 1 | Serve all'app? | L'app la crea, la cambia o la cerca? Se nessuna delle tre, non c'entra |
| 2 | Ce ne sono tante? | Più di poche, oppure ne possono arrivare di nuove senza che tu tocchi il codice? Una lista fissa di poche parole decise da te non conta |
| 3 | Si distinguono una dall'altra? | L'app può dire «questa, non quella», e la ritrova quando ricompare? |
| 4 | Hanno cose loro da sapere? | Qualcosa che sai di lei. Una parola che descrive un'altra cosa («azzurro») non ha niente di suo |
Un nome è un'entità solo se passa tutte e quattro. Ecco i nomi di Ritrovato:
| Il nome | 1 · Serve? | 2 · Tante? | 3 · Distinte? | 4 · Cose sue? | Il verdetto |
|---|---|---|---|---|---|
| oggetto | sì | sì | sì | sì | entità |
| stazione | sì | sì | sì | sì | entità |
| addetto | sì | sì | sì | sì | entità |
| restituzione | sì | sì | sì | sì | entità |
| giorno (quando è stato trovato) | sì | sì | sì | no | attributo |
| passeggero | sì | sì | no | attributo | |
| colore | sì | sì | no | attributo | |
| stato | sì | no | attributo | ||
| categoria | sì | no | valore | ||
| segnalazione «ho perso…» | no | fuori |
Le quattro domande, con un esempio ciascuna:
- Serve? La segnalazione («ho perso un ombrello, avvisatemi») è una bella idea, ma è tra i «se avanza tempo»: per ora l'app non la usa, quindi fuori. Quando la funzione entrerà nel progetto, la prova si rifà.
- Tante? Le stazioni sono poche. Ma la linea può allungarsi, e Nives vuole aggiungerne una senza chiedere a nessuno di cambiare il programma: per questo contano come «tante». La categoria invece sono sei parole decise da te e fisse (ombrelli, borse, telefoni, chiavi, abbigliamento, altro): non è un'entità.
- Distinte? Il passeggero non ha un account e non torna: l'app non lo ritrova mai, quindi non lo distingue da nessuno. Il colore è peggio: «azzurro» non è «quell'azzurro lì».
- Cose sue? Il giorno è una data: non ha niente da sapere, è lui stesso un dato dell'oggetto.
Cosa fare di ogni verdetto
- Entità: una tabella. Il resto del capitolo ti dice come si collegano.
- Attributo: una colonna di un'altra tabella. Il colore è una colonna di
oggetti; il nome del passeggero è una colonna direstituzioni. Le colonne sono il lavoro del capitolo Gli attributi. - Valore di una lista fissa: anche questo è una colonna, ma con una lista di parole ammesse, un
CHECK. La categoria non ha bisogno di una tabellacategorie: basta cheoggetti.categoriaaccetti solo le sei parole. - Fuori: non entra nel progetto. Scrivilo nel riquadro 4, sotto «cosa NON fa».
Una lista fissa diventa una tabella quando cambia spesso, oppure quando ogni parola ha dati suoi. Se ogni categoria avesse i suoi «giorni di custodia» (gli ombrelli trenta, i telefoni novanta), la categoria passerebbe la prova: avrebbe cose sue da sapere, e vorresti cambiarle senza toccare il codice. Allora sì, una tabella categorie.
La prova ti dà un risultato per questa app. La stessa parola può essere un'entità in un'app e un attributo in un'altra: dipende da cosa l'app ne fa. Il prossimo paragrafo lo mostra con le persone.
Le persone
Nel canvas le persone compaiono sempre, e sono il primo posto dove si sbaglia. La regola è una domanda: l'app deve riconoscerla quando torna?
- Gli addetti hanno un account (login, password): l'app li riconosce, e ogni oggetto ricorda quale addetto l'ha registrato. È un'entità. Come funziona il login lo vedrai nel libro Login e sicurezza.
- Il passeggero non ha un account e non torna: di lui servono il nome e le ultime quattro cifre del documento, e solo dentro la restituzione. Non è un'entità: sono due colonne di
restituzioni.
Niente tabella utenti che contiene tutti: addetti e passeggeri sono cose diverse, con dati diversi e permessi diversi. E se un giorno Nives volesse sapere «quante volte questo passeggero ha ritirato qualcosa»? Allora il passeggero dovrebbe essere riconosciuto, e diventerebbe un'entità. Cambia l'app, cambia la risposta.
Gli eventi sono entità
C'è un'altra famiglia di cose che si dimentica: quelle che succedono. Una restituzione, una prenotazione, un prestito, un pagamento. Sono eventi, e sono entità come le altre: ce ne sono tante, ognuna si distingue, ognuna ha cose sue da sapere. Hanno sempre un quando e un chi.
Si nascondono nei verbi. In Ritrovato la funzione 3 dice «restituisco un oggetto: a chi, quando». Potresti scrivere una colonna restituito_a dentro oggetti. Ma di una restituzione vuoi sapere il nome del passeggero, le ultime cifre del documento, il giorno, quale addetto c'era: quattro dati, e un'idea sola. Quando un verbo scrive qualcosa che ha un quando e un chi, quel qualcosa è un'entità.
Le relazioni
Le entità non vivono da sole: un oggetto è stato trovato in una stazione. Per ogni coppia di entità che le azioni collegano, due domande:
Un X quanti Y ha? E un Y quanti X ha?
Le risposte sono «uno» oppure «molti» (più di uno, anche zero), e danno quattro casi:
| Un X quanti Y? | Un Y quanti X? | Si chiama | Dove va la chiave esterna |
|---|---|---|---|
| molti | uno | uno a molti | nella tabella del molti (Y) |
| uno | molti | molti a uno (è un uno a molti letto al contrario) | nella tabella del molti (X) |
| molti | molti | molti a molti | in nessuna delle due: serve una tabella ponte |
| uno | uno | uno a uno | in una delle due, con UNIQUE (di solito quella che nasce dopo) |
Le regole le conosci dai capitoli Le relazioni e Disegnare un database: la chiave esterna sta sempre dalla parte del molti, perché una casella non può contenere tante righe. Qui le applichi alle coppie di Ritrovato:
| La coppia | Un X quanti Y? | Un Y quanti X? | La relazione | La chiave |
|---|---|---|---|---|
| stazione, oggetto | una stazione, molti oggetti | un oggetto, una stazione | uno a molti | oggetti.stazione_id |
| addetto, oggetto | un addetto, molti oggetti registrati | un oggetto, un addetto che l'ha registrato | uno a molti | oggetti.registrato_da |
| addetto, restituzione | un addetto, molte restituzioni | una restituzione, un addetto | uno a molti | restituzioni.addetto_id |
| oggetto, restituzione | un oggetto, al massimo una restituzione | una restituzione, un oggetto | uno a uno | restituzioni.oggetto_id, con UNIQUE |
Nell'uno a uno la chiave va in restituzioni e non in oggetti perché la restituzione nasce dopo: prima c'è l'oggetto, poi, forse, la restituzione. Un oggetto non ancora restituito non ha nessuna riga lì, e va bene così.
Non serve una relazione per ogni coppia. Stazioni e addetti, per esempio: nessuna azione li collega, quindi nessuna freccia. Non inventare legami che l'app non usa.
E il molti a molti? In Ritrovato oggi non c'è. Ma se un giorno entrasse la segnalazione, ci sarebbe: una segnalazione dice «ho perso un ombrello tra Piazza Query e Largo Lista», quindi riguarda molte stazioni, e una stazione ha molte segnalazioni. Nessuna delle due tabelle può portare la chiave: la porta una terza, segnalazioni_stazioni, con una riga per ogni coppia.
Il disegno delle entità di Ritrovato
Le quattro entità e le loro frecce. La freccia ◀ punta alla tabella a cui si riferisce la chiave, e sopra c'è il nome della colonna che la porta:
┌──────────┐ oggetti.stazione_id ┌─────────┐ restituzioni.oggetto_id ┌──────────────┐
│ stazioni │◀─────────────────────────│ oggetti │◀─────────────────────────────│ restituzioni │
└──────────┘ └────┬────┘ └───────┬──────┘
registrato_da │ │ addetto_id
└─────────────────────┬─────────────────────┘
▼
┌─────────┐
│ addetti │
└─────────┘Quattro tabelle, quattro frecce. Un passeggero non c'è, una categoria non c'è: ci sono le quattro cose che l'app ricorda.
Da 3 a 6
Quante entità deve avere un progetto? Da 3 a 6, ed è la domanda 8 per rileggere il canvas.
- Meno di 3: o l'app fa poco, o stai mettendo tutto in una tabella sola. Rifai la prova ai nomi che hai scartato come attributi: ce n'è uno che passa?
- Più di 6: ogni entità porta con sé una tabella, un modello, uno schema, delle rotte, dei test. Sei sono già molte settimane di lavoro. Torna al riquadro 4: quale funzione ti costringe ad avere la settima? Se non è indispensabile, spostala tra i «se avanza tempo».
Ritrovato ne ha quattro: giusto.
Il riquadro 6, a metà
Ecco cosa scrive Nives nel riquadro 6, per ora. La seconda metà, cosa sai di ognuna, arriva nel capitolo Gli attributi:
6 · I dati
gli oggetti trovati
le stazioni
gli addetti
le restituzioni
il passeggero? no: nome e ultime cifre stanno dentro la restituzione
la categoria? no: sei parole fisse, un CHECKScrivi anche gli scarti, con il perché: chi rilegge il canvas (il tuo compagno, o tu tra un mese) vede che ci hai pensato.
Ricorda
- Un'entità è una «cosa» di cui l'app si ricorda: ce ne sono tante, ognuna si distingue, ognuna ha cose sue. Diventa una tabella.
- Le entità si trovano sottolineando i nomi nei riquadri 4, 5 e 7. Anche quelli nascosti nei verbi.
- La prova delle quattro domande: serve all'app? ce ne sono tante? si distinguono? hanno cose loro? Ti fermi al primo «no».
- Chi non passa è un attributo (una colonna), un valore di una lista fissa (una colonna con
CHECK) o è fuori dal progetto. - Le persone: chi ha un account, e l'app riconosce quando torna, è un'entità. Gli eventi (restituzione, prenotazione, prestito) sono entità: hanno un quando e un chi.
- Per ogni coppia collegata da un'azione: «un X quanti Y? un Y quanti X?». La chiave esterna sta dalla parte del molti; il molti a molti passa da una tabella ponte; l'uno a uno è una chiave con
UNIQUE. - Da 3 a 6 entità. Il passo dopo, gli attributi: cosa sai di ognuna.