Indicizzazione delle query per le prestazioni
Renda veloci e conformi alle regole le query del Realtime Database dichiarando gli indici con .indexOn, comprendendone l’importanza ed evitando l’avviso sulle query non indicizzate.
Indicizzazione delle query per le prestazioni è una lezione Firebase Auth & Realtime Database Apps gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Firebase Auth & Realtime Database Apps, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Firebase Auth & Realtime Database Apps include 4 lezioni in totale.
Parti di questa lezione non sono ancora state tradotte e vengono mostrate in inglese.
Why Indexing Matters
Querying with orderByChild works on small data, but as nodes grow, unindexed queries force the client to download and sort everything. That is slow and expensive.
Indexes tell Firebase to pre-sort data on the server for a given field.
The Unindexed Warning
Run an orderByChild query on a field with no index and Firebase logs a warning: it had to perform the sort on the client. In large datasets this is a real performance problem.
Declaring an Index
Indexes are declared in your Security Rules using the .indexOn directive at the parent of the records you query.
{
"rules": {
"users": {
".indexOn": ["age"]
}
}
}Matching the Query to the Index
The indexed field must match the field you order by. This query benefits from the age index above.
import { ref, query, orderByChild } from 'firebase/database';
const q = query(ref(db, 'users'), orderByChild('age'));Indexing Multiple Fields
You can index several fields under the same node by listing them. Each supports a different orderByChild query.
{
"rules": {
"products": {
".indexOn": ["price", "rating", "createdAt"]
}
}
}Indexing on $key and $value
For queries using orderByKey or orderByValue, use the special tokens .key and .value in the index list.
{
"rules": {
"leaderboard": {
".indexOn": ".value"
}
}
}Indexing Under Dynamic Paths
When records sit under a dynamic parent (like per-user lists), put .indexOn inside a wildcard segment so it applies to every child group.
{
"rules": {
"posts": {
"$uid": {
".indexOn": ["timestamp"]
}
}
}
}Indexes Are Free to Maintain
Unlike some databases, Realtime Database indexes add no extra storage cost and are maintained automatically. The trade-off is simply that you must declare them in rules ahead of time.
Index vs Data Structure
Indexing speeds queries, but it does not replace good data modeling. If you constantly query by a field, consider also restructuring data so the common access pattern is a direct lookup.
Limitations to Remember
Keep these constraints in mind:
- You can order by only one field per query
- The index field must exist on the child for it to appear in results
- Deeply nested data is harder to index efficiently
Verifying Your Index
After deploying rules, re-run the query and confirm the unindexed warning is gone from the logs. That confirms the server is now doing the sort.
Quick Check
Test your understanding of query indexing.
Recap
Your queries are now ready to scale.
- Unindexed
orderByChildsorts on the client and warns - Declare indexes with
.indexOnin Security Rules - Match the indexed field to your query field
- Use
.key/.valuefor key and value ordering - Index inside wildcards for dynamic parents
Impara Firebase Auth & Realtime Database Apps con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 11
- Lezioni
- 44
Domande Frequenti
La lezione «Indicizzazione delle query per le prestazioni» è gratuita?
Sì — il testo completo di «Indicizzazione delle query per le prestazioni» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Firebase Auth & Realtime Database Apps, passa a CoddyKit PRO. Il corso Firebase Auth & Realtime Database Apps include 4 lezioni in totale.
Cosa imparerò in «Indicizzazione delle query per le prestazioni»?
Renda veloci e conformi alle regole le query del Realtime Database dichiarando gli indici con .indexOn, comprendendone l’importanza ed evitando l’avviso sulle query non indicizzate. Eserciti Firebase Auth & Realtime Database Apps con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Firebase Auth & Realtime Database Apps?
Non è richiesta alcuna esperienza precedente. Firebase Auth & Realtime Database Apps su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.
Quanto tempo richiede la lezione «Indicizzazione delle query per le prestazioni»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Firebase Auth & Realtime Database Apps?
Sì. Ogni lezione Firebase Auth & Realtime Database Apps include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Query di base sui dati
- Filtraggio e ordinamento dei dati
- Tecniche di paginazione dei dati
- Indicizzazione delle query per le prestazioni