Questo documento descrive le best practice per l'API Search. Utilizziamo virgolette singole ('') per delimitare le stringhe di query. In questo modo una query che contiene
frasi composte da più parole racchiuse tra virgolette doppie può essere delimitata senza confusione:
'field:"some text" some-value'.
Utilizzare i campi Atom per i dati booleani
L'archiviazione di dati booleani in campi numerici è molto inefficiente. Usa i campi Atom e assegna le tue costanti preferite (Vero/Falso, sì/no, 0/1).
Trasforma le parole chiave escluse in positive
Supponiamo che tu utilizzi un termine speciale per identificare i ristoranti la cui cucina non è definita. Per escludere questi ristoranti, puoi utilizzare 'NOT cuisine:undefined' come query. Tuttavia, la valutazione è più costosa (sia per le operazioni fatturabili che per i tempi di calcolo) che avere il contrario, trovare ristoranti di cui si conoscono la cucina. Invece di avere un solo campo, la cucina, puoi utilizzarne due, cuisine e cuisine_known, il secondo è un campo di atomi. Per i ristoranti per cui è definita la cucina, imposti il primo campo sulla cucina effettiva e il secondo su "yes". Per i ristoranti di cui non conosci la cucina, puoi impostare la cucina su "" (una stringa vuota) e cuisine_known su "no". Ora, per trovare ristoranti di cui è nota la cucina, esegui una query 'cuisine_known:yes', che è molto più veloce della negazione.
Trasformare le disgiunzioni in congiunzioni
La disgiunzione "OR" è un'operazione costosa sia per le operazioni fatturabili che per i tempi di calcolo. Supponiamo che tu voglia cercare 'cuisine:Japanese OR cuisine:Korean'. Un'alternativa è indicizzare i documenti con categorie più generali di tipi di cucina. In questo caso, la query può essere semplificata in 'cuisine:Asian'.
Elimina le tautologie dalle query
Supponiamo che tu voglia trovare tutti i ristoranti a Toronto. Supponendo che i tuoi documenti abbiano un solo campo denominato "city", se utilizzi la query 'city:toronto AND NOT city:montreal' ottieni gli stessi risultati di 'city:toronto'; infatti, se la città è impostata su "toronto", non può essere impostata su "montreal". La seconda query viene eseguita molto più velocemente poiché interessa un solo termine. La prima query esegue tre passaggi: in primo luogo, trova un elenco di documenti in cui la città è impostata su "toronto", poi trova un elenco di tutte le città in cui questa non è impostata su "montreal" e infine calcola l'intersezione dei due elenchi.
Restringi l'intervallo prima di ordinare
Supponiamo che la tua applicazione archivi informazioni sui ristoranti di tutto il mondo e voglia mostrare i ristoranti più vicini all'utente corrente. Un modo per farlo è ordinare i documenti corrispondenti in base alla distanza dalla posizione dell'utente. Tuttavia, se hai 1.000.000 di ristoranti, l'esecuzione di una query come 'cuisine:japanese' con l'espressione di ordinamento distanza(geopoint(x, y), ristorante_loc) richiederà molto tempo. È consigliabile aggiungere filtri a una query in modo da iniziare con un insieme più rilevante di documenti selezionati da ordinare. Una soluzione consiste nel creare categorie geografiche, ad esempio paese, provincia e città, che puoi dedurre dalla località dell'utente. La query diventa 'cuisine:japanese AND city:<user-city>'. È molto probabile che non avrai più bisogno di ordinare 1.000.000 di documenti.
Utilizza categorie limitate per evitare o ridurre al minimo l'ordinamento
Se utilizzi il ranking per ordinare i ristoranti per prezzo, potresti creare un campo price_range contenente le categorie di prezzo: price_0_10, price_11_20, price_21_30, price_31_40, price_41_lots. Successivamente, potresti trovare tutti i ristoranti che costano tra i 21 $e i 40 $senza ordinamento utilizzando la query 'price_range:price_21_30 OR price_range:price_31_40'. In molti casi le categorie appropriate non sono così chiare, ma con questa tecnica puoi rifiutare un numero elevato di documenti prima di limitare la ricerca con query costose come '... AND price>25 AND price<35'.
Non segnare partite a meno che non sia necessario
Il punteggio viene utilizzato per indicare il livello di corrispondenza di un determinato documento con una query. Tuttavia, a meno che tu non intenda ordinare i dati per punteggio, non richiedere il punteggio. Rallenerà solo la tua ricerca.