Stringhe di query

Questa API è supportata per runtime di prima generazione e può essere utilizzata quando eseguire l'upgrade ai runtime di seconda generazione corrispondenti. Se esegui l'aggiornamento ad App Engine Python 3 runtime, consulta guida alla migrazione per saperne di più sulle opzioni di migrazione per i servizi in bundle legacy.

Una stringa di query contiene caratteri Unicode. Lunghezza massima di una stringa di query è di 2000 caratteri. Tutte le stringhe di query contengono almeno un valore di campo. È si consiglia di scrivere i valori dei campi in minuscolo, perché le ricerche per atom, text, e i campi HTML non fanno distinzione tra maiuscole e minuscole e una stringa di query può contenere anche Operatori booleani AND, OR e NOT, che vengono riconosciuti mediante la scrittura in maiuscolo.

Una virgola può apparire in una stringa di query solo se viene utilizzata per separare gli argomenti di una funzione: distance(home, geopoint(35.2, 40.5)) > 100 o fa parte di una stringa tra virgolette.

Una stringa di query può assumere diverse forme. Ci sono due modi principali per creare una query: con e senza nomi dei campi. Una ricerca globale utilizza una stringa di query che contiene solo valori di campo:

query = "blue"
query = "NOT white"
query = "blue OR red"
query = "blue guitar"

Una ricerca campi utilizza una stringa di query contenente una o più espressioni che specificano i nomi e i valori dei campi:

query = "model:gibson date < 1965-01-01"
query = "title:\"Harry Potter\" AND pages<500"
query = "beverage:wine color:(red OR white) NOT country:france"

Questo documento descrive come costruire stringhe di query per globali e campi ricerche e come funziona la logica di ricerca in ciascun caso.

Ti consigliamo di registrare le stringhe di query nella tua applicazione se vuoi mantenere delle query eseguite.

Ricerca globale

La ricerca globale offre la possibilità di cercare documenti specificando valori che potrebbero essere presenti in qualsiasi campo del documento. Per eseguire una ricerca globale, scrivi una stringa di query contenente uno o più valori di campo. L'algoritmo di ricerca riconosce il tipo di ciascun valore e cerca in tutti i campi del documento potrebbe contenere quel valore.

Query con un valore

Viene gestita una ricerca con una stringa di query contenente un singolo valore in base a queste regole:

Se la stringa di query è una parola (red) o una stringa tra virgolette ("red rose"), cerca recupera tutti i documenti in un indice che hanno:

• Un campo di testo o HTML contenente la parola o la stringa tra virgolette (corrispondente senza distinzione tra maiuscole e minuscole).
• Un campo atomico con un valore che corrisponde alla parola o alla stringa tra virgolette (la corrispondenza è senza distinzione tra maiuscole e minuscole).

Se la stringa di query è un numero ("3.14159"), la ricerca recupera tutti i documenti che contengono:

• Un campo numerico con un valore uguale al numero nella query (campo numerico) con il valore 5 corrisponderà alla query "5" e "5.0").
• Un campo di testo o HTML contenente un token corrispondente al numero compare nella query (il campo di testo "ha impiegato 5 minuti" corrisponderà alla query "5" ma non "5.0").
• Un campo atomico che corrisponde letteralmente al numero visualizzato nella query.

Se la stringa di query è una data nel formato aaaa-mm-gg, la ricerca recupera tutti i documenti che includono:

• Un campo data il cui valore è uguale a quella data (inclusi zeri nella stringa di query) sono facoltative, "2012-07-04" e "4-7-2012" corrispondono alla stessa data).
• Un campo di testo o HTML contenente un token che corrisponde letteralmente alla data come visualizzato nella query.
• Un campo atom che corrisponde letteralmente alla data così come appare nella query.

Puoi anteporre l'operatore booleano NOT (in lettere maiuscole) a una query di una sola parola. La Il risultato è un elenco di documenti senza campi che corrispondono alla query in base alle stesse regole. Quindi la query NOT red recupererà documenti che non contengono campi di testo o HTML contenenti "rosso" o atom con il valore red.

Potresti aver notato che i campi dei punti geografici non sono stati menzionati. In questo momento non puoi specificare un valore di punti geografici non elaborati come stringa, quindi i punti geografici non possono compaiono nelle ricerche globali.

Query con più valori

In una stringa di ricerca globale puoi specificare più valori (separati da spazi). Lo spazio tra parole, stringhe tra virgolette, numeri e date viene trattato come un operatore AND implicito. Le due stringhe di ricerca seguenti sono quasi le stesse; differiscono nel modo in cui la ricerca globale tratta i campi atomici, come spiegato di seguito:

query = "small red"
query = "small AND red"

Quando si esegue una ricerca globale con più valori, la corrispondenza dei campi viene eseguita. in modo indipendente su ogni valore nella stringa, e la corrispondenza dei campi atom è gestita in modo diverso, in particolare:

• I valori della query possono essere visualizzati in qualsiasi ordine in un campo di testo o HTML.
• Valori diversi possono essere visualizzati in campi diversi.
• La ricerca dei campi Atom viene eseguita solo quando la stringa di query non contiene Operatori booleani (AND, OR, NOT). L'intera stringa di query deve corrispondere a un campo atomico.

Nota la terza regola che riguarda i campi atomici. La stringa di query "rossa piccola" non non contengono il valore booleano AND (anche se è implicito), quindi la ricerca proverà a per trovare campi atomici corrispondenti. La stringa "red AND small" contiene un valore booleano , quindi la ricerca non tenterà di trovare una corrispondenza tra la stringa di query e i campi atom.

L'esempio seguente mostra quattro documenti recuperati utilizzando la query la stringa "bocciolo di rosa". Ogni documento ha due campi di testo e un campo atom. La di commento spiega perché ogni documento soddisfa la query.

ID documento	Campo di testo 1	Campo di testo 2	Campo atomico	Commento
1	potente come una rosa	un auricolare per legare tutti	cespuglio spinoso	I valori corrispondenti possono essere visualizzati in campi diversi
2	largo come un fiume	come un germoglio su una rosa	rotolare erba	I valori corrispondenti possono apparire in qualsiasi ordine nello stesso campo di testo o HTML, con testo intermedio
3	nel profondo dell'oceano	i ragazzi rose bud	cuffia blu	I valori corrispondenti possono essere visualizzati in qualsiasi ordine nello stesso campo di testo o HTML
4	alta come una montagna	il bellissimo giardino	bocciolo di rosa	Il campo Atom corrisponde perché il suo valore è uguale all'intera stringa di query

Tieni presente che se hai invertito i valori nella query e hai cercato "bud rose" al contrario, i documenti 1, 2 e 3 verrebbero comunque restituiti, mentre il documento 4 . Per cercare una stringa di caratteri esatta nei campi atom, testo e HTML, tra virgolette la stringa nella stringa di query. La ricerca di "rose bud" restituirà il risultato solo i documenti 3 e 4 dell'esempio.

Operatori booleani

Puoi specificare una ricerca globale più complessa utilizzando l'operatore booleano NOT prima di un valore e gli operatori AND e OR tra i valori. Tieni presente che questi gli operatori devono essere scritti in maiuscolo. Se compaiono in una stringa tra virgolette vengono trattati come parte del valore del campo, non come operatori. Puoi utilizzare Le parentesi in una stringa di query rendono chiara la logica.

La precedenza dell'operatore booleano, dalla più alta alla più bassa, è: NOT, OR, AND:

NOT cat AND dogs OR horses --> (NOT cat) AND (dogs OR horses)
NOT cat OR dogs AND horses --> ((NOT cat) OR dogs) AND horses

Radice

Per cercare varianti comuni di una parola, ad esempio forme plurali e finali di verbi, utilizza l'operatore staminale ~ (il carattere tilde). Si tratta di un operatore prefisso che deve precedere un valore senza spazi. Il valore ~cat corrisponderà a "gatto" o "gatti", e allo stesso modo ~dog corrisponde a "cane" o "cani". L'algoritmo di stemming non è infallibile. Il valore ~care corrisponderà a "care" e "cura", ma non "se ne preoccupa" o "Curato". La radice viene utilizzata solo per la ricerca di campi di testo e HTML.

Tokenizzazione

Quando un documento viene indicizzato, i relativi campi vengono tokenizzato. Analogamente, vengono tokenizzati anche i valori in una stringa di query. Ciò significa che potrebbe sembrare che una query con un solo valore venga effettivamente trattata come una query con più valori. Ad esempio:

"real-time" --> "real time"
"2001-12-15" --> "2001 12 15"
"1.5" --> "1 5"

Ricerca campi

Una ricerca campi cerca i valori in campi di documenti specifici, in base al nome del campo. R la stringa di query di ricerca dei campi è composta da una o più espressioni che specificano nome campo, un operatore relazionale e un valore campo. Le opzioni disponibili e gli operatori relazionali dipendono dal tipo di campo. L'operatore di uguaglianza, rappresentati dai due punti o dal segno uguale, possono essere utilizzati per tutti i campi di testo. Ecco alcune stringhe di query per diversi tipi di campi:

query = "pet = dog"
query = "author = \"Ray Bradbury\""
query = "color:red"
query = "NOT color:red"
query = "price < 500"
query = "birthday>=2011-05-10"

Nota che l'uso di spazi vuoti su entrambi i lati dell'operatore relazionale facoltativo. Come per le stringhe di query di ricerca globali, il valore di un elemento testo, HTML o il campo atom può essere racchiuso tra virgolette per specificare una stringa e un'espressione per un valore di campo può essere annullato anteponendo il carattere NOT in maiuscolo.

Query sui campi atom

Il valore di un campo atom è una stringa di caratteri. Le query sui campi atom sono senza distinzione tra maiuscole e minuscole. Se la query specifica un valore di campo con uno spazio vuoto o la punteggiatura, assicurati di citare il valore all'interno della stringa di query. L'unico valore l'operatore relazionale per i campi atom è l'operatore di uguaglianza. L'intero il contenuto di un campo atom deve corrispondere al valore della query; sono inclusi tutti i dati Unicode combinando caratteri o caratteri accentati nel campo. La derivazione non è supportato per i campi atom.

Stringa di query	Commenti
"weather=stormy" "weather: stormy"	Entrambe le forme dell'operatore di uguaglianza sono valide. Recupera documenti con un campo meteorologico che indica "tempestoso".
"Title: \"Tom&Jerry\"" "Couple: \"Fred and Ethel\"" "Version = \"1HCP(21.3)\""	Se stai cercando un campo atomico contenente spazi vuoti caratteri speciali, racchiudi il valore tra virgolette.
"Color = (red OR blue)" "Color = (\"dark red\" OR \"bright blue\")"	Puoi utilizzare le parentesi e l'operatore logico OR per specificare un elenco di valori dei campi alternativi.

Query su campi di testo e HTML

L'unico operatore relazionale valido per i campi di testo e HTML è l'uguaglianza. In questo caso in cui l'operatore significa "il campo include un valore" non "campo è uguale a valore". Puoi Utilizzare l'operatore di radice per cercare varianti su una parola. Puoi anche utilizzare gli operatori OR e AND per specificare valori booleani complessi espressioni per il valore del campo. Se un operatore booleano appare tra virgolette stringa, non viene trattata in modo particolare, è solo un'altra parte del carattere stringa con cui trovare la corrispondenza. Ricorda che quando cerchi nei campi HTML, il testo all'interno I tag di markup HTML vengono ignorati. Le query sui campi di testo e HTML sono maiuscole e minuscole insensibile. Quando questi campi vengono indicizzati, qualsiasi codice Unicode che combina caratteri e i caratteri accentati al loro interno sono "normalizzati" agli equivalenti non accentati. Anche la combinazione di caratteri e accenti viene normalizzata nelle stringhe di query su questi campi, in modo che una query possa includere o meno i moduli accentati e e corrispondere ai campi in entrambi i casi.

Stringa di query	Commenti
"Comment = great" "Comment: great"	Entrambe le forme dell'operatore di uguaglianza sono valide. Recupera i documenti con un campo di commento che contiene almeno un'occorrenza della parola "great" nel Campo Commento.
"Comment = (great big ball)" "Comment = (great AND big AND ball)"	Per cercare due o più parole in un campo, in qualsiasi ordine, racchiudi le parole tra le parentesi. Questa stringa di query recupera i documenti con un campo Commento include tutte e tre le parole in qualsiasi ordine con un numero qualsiasi di altre parole tra che li rappresentano. Lo spazio tra le parole implica l'utilizzo di una logica AND; nel secondo modulo esplicito.
"Comment = \"insanely great\""	Per cercare una stringa di testo specifica, racchiudi la stringa tra virgolette. Questo la query recupererà i documenti il cui campo Commento contiene la frase "terribilmente fantastico" (e anche "incredibilmente grandioso", che è tokenizzato nello stesso ).
"pet = ~dog"	L'operatore di stemming corrisponderà alle varianti della parola "cane" nel campo degli animali da compagnia.
"Color = (red OR blue)"	Per cercare una corrispondenza in un elenco di alternative, racchiudi l'elenco tra parentesi con la parola chiave OPPURE tra alternative. Questa query recupera i documenti il cui campo Colore include "rosso" o "blu" o entrambe le cose.
"weather = ((rain OR snow) AND cold)"	Puoi utilizzare gli operatori logici OR e AND, insieme alle parentesi, per specificare un valore di campo più complesso.
"weather = \"rain OR shine\""	Poiché l'OR logico è incorporato in una stringa tra virgolette, non viene trattato come operatore relazionale. Questa stringa di query recupera i documenti con un campo meteo che contiene la stringa "pioggia o soleggiato"

Query sui campi numerici

Il valore di un campo numerico può essere scritto come numero intero, decimale o esponenziale. Gli operatori relazionali validi per i campi numerici sono gli operatori di uguaglianza, insieme agli operatori minore di/maggiore di (<, <=, >, >=). Nota che non esista un operatore di disuguaglianza (!=). Ecco alcuni esempi di stringhe di query per i campi numerici:

"quantity = 10000"
"size: 4"
"price < 9.99"
"theta > 1.5E-2"

Query sui campi data

Il valore di un campo data deve essere scritto in yyyy-mm-dd form. Gli zeri iniziali sono facoltativo per i mesi e i giorni con una sola cifra. Gli operatori relazionali validi per le date sono gli operatori di uguaglianza, insieme al valore minore di/maggiore di operatori (<, <=, >, >=). Tieni presente che non esiste un operatore di disuguaglianza. Tu può anteporre l'operatore NOT a un'espressione per annullarla. Ecco alcuni esempi stringhe di query di esempio per i campi delle date:

"start_date: 2012-05-20"
"end_date: 2013-5-1"
"birthday >= 2000-12-31"
"NOT birthday = 2000-12-25"

Query sui campi di punti geografici

Non esistono operatori relazionali che funzionino con i campi di punti geografici, quindi non possono essere denominati direttamente in una stringa di query. L'API Search fornisce due funzioni speciali che possono essere utilizzate per le query che coinvolgono i campi dei punti geografici:

geopoint(lat,long)

Definisce un punto geografico in base alla latitudine e alla longitudine.

distance(point1, point2)

Calcola la distanza in metri tra due punti geografici. Ogni punto può essere specificato utilizzando il nome di un campo di punti geografici o una chiamata della funzione di punto geografico. Tieni presente che non puoi fornire due come argomenti di questa funzione. Almeno un argomento deve essere un costante.

Queste funzioni possono essere utilizzate per creare query che recuperano posizioni rispetto a una posizione costante. I seguenti esempi presuppongono che l'indice contiene documenti con campi di punti geografici denominati "survey_marker" e "casa".

Stringa di query	Commenti
"distance(survey_marker, geopoint(35.2, 40.5)) < 100"	Cerca gli indicatori a meno di 100 metri da un determinato punto geografico.
"distance(home, geopoint(35.2, 40.5)) > 100"	Cerca case a più di 100 metri da un determinato punto geografico.

Le applicazioni che utilizzano la geolocalizzazione in genere ricevono informazioni dalla del browser. Se l'utente lo consente, la posizione può essere dedotta dal suo indirizzo IP oppure possono inserire un codice postale. La posizione può provenire anche da altre API come Geolocalizzazione di Google Maps tramite Google Cloud.

Query su più campi

Puoi combinare più espressioni di query sui campi in una query elencandole in separate da spazi vuoti. In questo modo viene inserito un AND implicito tra in modo che tutte siano soddisfatte per recuperare un documento. Puoi aggiungere esplicitamente gli operatori AND e OR tra le espressioni e utilizzare le parentesi per chiarisci la logica.

Stringa di query	Commenti
"product=piano manufacturer=steinway" "product=piano AND manufacturer=steinway"	Queste query recuperano tutti i pianoforti Steinway. Lo spazio tra i termini implica l'operatore logico AND; il secondo la rende esplicita.
"product=piano AND NOT manufacturer=steinway"	Recupera tutti i pianoforti non Steinway.
"product=piano AND price<2000"	Questa query recupera pianoforti economici.

Combinazione di ricerche globali e sul campo

Una stringa di query può contenere un numero illimitato di espressioni di ricerca globale e campi espressioni di ricerca. Gli spazi tra le espressioni vengono trattati come AND. Puoi anche usare esplicitamente OR e AND, insieme alle parentesi. Ogni espressione essere gestite in base alle regole associate a quel tipo di termine.

Stringa di query	Commenti
"keyboard great price<5000" "keyboard AND great AND price<5000"	Recupera i documenti in cui le parole "ottimo" e "tastiera" compaiono in qualsiasi campi di testo, HTML o atom ed è presente un campo del prezzo inferiore a 5000. Il valore AND è implicito, mentre il secondo è equivalente.
"keyboard OR product=piano"	Recupera i documenti con un campo prodotto che contiene un pianoforte, oppure documenti con qualsiasi campo di testo, HTML o atomico contenente la tastiera.