Generatore di nomi per tabelle di database

Leggere la tabella prima delle colonne

Il nome di una tabella di database viene ripetuto ovunque i dati transitino: codice applicativo, SQL, migrazioni, dashboard, report sugli incidenti e discussioni di team. Questa ripetizione rende la denominazione una scelta architetturale. I nomi delle entità, come CustomerContactDetails, dovrebbero identificare direttamente i record. I nomi delle relazioni, come UserRoleAssignments, dovrebbero rendere visibile l'associazione stessa. I nomi operativi, come SchemaMigrationLocks, dovrebbero indicare ai lettori che le coordinate della tabella funzionano, piuttosto che rappresentare un oggetto aziendale.

Assicuratevi che il nome corrisponda al ciclo di vita dei dati

Il ciclo di vita spesso fornisce il qualificatore più importante. PaymentEvents implica una cronologia di sola aggiunta. DailySalesRollups implica aggregazioni derivate. StagedCustomers suggerisce record importati temporaneamente in attesa di convalida. ArchivedCustomerRecords avverte che le righe non sono attive. CacheInvalidationEvents indica il coordinamento attorno ai dati derivati. DataErasureRequests implica aspettative in termini di privacy e flusso di lavoro. Scegli queste parole solo quando i vincoli, la conservazione e i modelli di scrittura della tabella lo rendono necessario.

Usa il linguaggio di dominio con precisione tecnica

I nomi appropriati allineano il vocabolario del prodotto alla struttura del database. Usa termini riconosciuti da supporto, finanza, operazioni e analisi, quindi aggiungi qualificatori tecnici solo quando prevengono una reale ambiguità. InvoicePaymentAllocations è utile quando l'allocazione è un'azione prioritaria. CountryCodes è sufficiente per una ricerca limitata. TenantNotificationRules è appropriato quando ogni riga appartiene a un tenant. Evita souvenir di implementazione come numeri di versione temporanei o nomi di servizi che potrebbero scomparire mentre i dati rimangono.

Una rapida revisione della denominazione

• Indica prima l'entità o l'evento centrale.
• Riserva Log, Eventi, Audit e Cronologia a cicli di vita realmente diversi.
• Rendi coerente il linguaggio delle tabelle di join in tutto lo schema.
• Usa Staged, Cached, Archived o Rollup solo quando il qualificatore è operativamente vero.
• Preferisci i nomi di dominio stabili alle etichette di implementazione temporanee.

Domande per la prossima migrazione

Prima di accettare un nome generato, testalo in un join, nel titolo di una migrazione e in un avviso. Chiediti se identifica il proprietario dei dati, se distingue lo stato corrente dalla cronologia e se un'altra tabella rivendica già lo stesso nome. Quindi scegli il nome più breve che mantenga intatte queste distinzioni.

• Cosa dedurrebbe un tecnico di turno dal solo nome?
• Quale parola distingue questa tabella dalla sua vicina più prossima?
• Il nome funziona ancora dopo la sostituzione della funzionalità corrente?
• Quale vincolo o ciclo di vita dovrebbe segnalare implicitamente il nome?