Chiavi naturali e lookup

Chiavi naturali

Una chiave naturale è un indirizzo facoltativo e leggibile di un record, restituito come _naturalKey. È un unico segmento sicuro per gli URL, composto da lettere, cifre, trattini, trattini bassi, punti e tilde. Puoi leggere un record tramite la sua chiave in GraphQL, nell'SDK e nella CLI, e una lettura che non trova nulla restituisce null. La chiave è sempre disponibile per filtrare e ordinare.

Collisioni e rinomine

Imposta la chiave quando crei il record. Se un altro record del modello la detiene già, la creazione riesce comunque e Fóir aggiunge un suffisso (about-1, about-2), quindi rileggi la chiave dalla risposta. La rinomina è una mutation separata. Viene rifiutata quando un altro record detiene la nuova chiave, e l'id del record non cambia mai.

Lookup

Un lookup è una chiave aggiuntiva con nome su un modello, dichiarata nel tuo file di configurazione con keyBy. Ognuno genera una query tipizzata che restituisce un record o null: un lookup sullo SKU di un prodotto ti dà productBySku. Un lookup può combinare fino a quattro campi, e un modello può avere fino a quattro lookup. I campi devono essere campi di primo livello di tipo testo, intero, decimale, booleano o enum.

Una query di lookup corrisponde al valore della variante che viene servita al chiamante, e accetta un locale come argomento.

Unicità e backfill

I lookup sono univoci e indicizzati. Salvare un record il cui valore di lookup collide con quello di un altro viene rifiutato, e l'errore nomina il modello, il lookup e i suoi campi. La console segnala il conflitto direttamente nel campo.

Aggiungere un lookup a un modello che ha già record lo riempie con un backfill al push. Se i record esistenti contengono valori duplicati, il push si ferma e il lookup non viene aggiunto.