Guida di riferimento per le query
L'elenco completo di parametri di query, operatori e aggregazioni di Discovery. Puoi fare riferimento a queste informazioni per assistenza quando scrivi query con il linguaggio di query Discovery.
- Per ulteriori informazioni, vedi il Riferimento API Discovery.
- Per una panoramica dei concetti di query, vedi Panoramica delle query.
Nell'interfaccia utente di Discovery, è possibile scrivere e testare query in linguaggio naturale nella pagina Migliora e personalizza.
Descrizioni dei parametri
Utilizzare i parametri della query per ricercare la propria raccolta, identificare una serie di risultati e analizzare le serie di risultati.
| Parametro | Descrizione | Esempio |
|---|---|---|
aggregation |
Una query statistica dell'insieme di risultati | aggregation=term(enriched_text.entities.type) |
filter |
Una ricerca in linguaggio di query non classificata per i documenti che corrispondono. | filter=bees |
natural_language_query |
Una ricerca in linguaggio naturale classificata per i documenti che corrispondono. | natural_language_query="How do bees fly" |
query |
Una ricerca in linguaggio di query classificata per i documenti che corrispondono. | query=bees |
| Parametro | Descrizione | Esempio |
|---|---|---|
count |
Il numero di documenti result da restituire. |
count=15 |
highlight |
Evidenzia le corrispondenze di query | highlight=true |
offset |
Il numero di risultati da ignorare prima di restituire i documenti result dall'insieme di risultati |
offset=100 |
return |
Elenco dei campi da restituire | return=title,url |
sort |
Campo in base a cui ordinare l'insieme di risultati | sort=enriched_text.sentiment.document.score |
spelling suggestions |
Suggerimenti di ortografia restituiti per le query in linguaggio naturale | spelling_suggestions=true |
Limitazioni delle query
Non è possibile eseguire query sui nomi dei campi che contengono i seguenti caratteri:
- Numeri (
0 - 9) nel suffisso del nome campo. Ad esempio,extracted-content2. - I caratteri
_,+, e-nel prefisso difield_name. Ad esempio,+extracted-content. - I caratteri
.,,e:infield_name. Ad esempio,new:extracted-content.
Operatori
Gli operatori sono i separatori tra le diverse parti di una query. La seguente tabella elenca gli operatori disponibili.
| Operatore | Descrizione | Esempio |
|---|---|---|
. |
Delimitatore JSON | enriched_text.concepts.text |
: |
Include | text:computer |
:: |
Corrispondenza esatta | title::"Query building" |
:! |
Non include | text:!computer |
::! |
Non una corrispondenza esatta | text::!winter |
\ |
Carattere Escape | title::"Dorothy said: \"There's no place like home.\"" |
"" |
Query di frasi | enriched_text.concepts.text:"IBM Watson" |
(), [] |
Gruppi nidificati | filter-entities:(text:Turkey,type:Location) |
| | | o | query-enriched.entities.text:Google|IBM |
, |
e | query-enriched.entities.text:Google,IBM |
<=, >=, >, < |
Confronti numerici | enriched_text.sentiment.document.score>0.679 |
^x |
Moltiplicatore del punteggio | text:IBM^3 |
* |
Carattere jolly | query-enriched_text.concepts.text:pre* |
~n |
Variazione di stringa | query-enriched_text.entities.text:cat~1 |
:* |
Esiste | title:* |
!* |
Non esiste | title!* |
Aggregazioni
Le aggregazioni restituiscono una serie di valori di dati. La seguente tabella elenca le aggregazioni disponibili.
| Aggregazione | Descrizione | Esempio |
|---|---|---|
average |
Valore medio per il campo specificato nell'insieme di risultati. | average(product.price) |
filter |
Filtra i risultati in base al modello specificato | filter(enriched_text.concepts.text:cloud computing) |
histogram |
Distribuzione basata sull'intervallo | histogram(product.price,interval:1) |
max |
Valore massimo per il campo specificato nell'insieme di risultati. | max(product.price) |
min |
Valore minimo per il campo specificato nell'insieme di risultati. | min(product.price) |
nested |
Limita aggregazione | nested(enriched_text.entities) |
sum |
Somma di tutti i campi nell'insieme di risultati. | sum(product.price) |
term |
Conteggio dei valori identici | term(enriched_text.concepts.text,count:10) |
timeslice |
Distribuzione basata sul tempo | timeslice(last_modified,2day,America/New York) |
top_hits |
Documenti dei risultati più classificati per l'aggregazione corrente | term(enriched_text.concepts.text).top_hits(10) |
unique_count |
Conteggio dei valori univoci per un campo all'interno di un'aggregazione | unique_count(enriched_text.entities.type) |