Referência de Consulta
A lista integral de parâmetros de consulta, operadores e agregações do Discovery. Você pode consultar essas informações para ajuda ao gravar consultas com o Discovery Language de Consulta.
- Para obter mais informações, consulte o Discovery Referência de API.
- Para obter uma visão geral dos conceitos de consulta, veja a Visão geral da consulta.
Na interface do usuário Discovery, você pode escrever e testar consultas em linguagem natural na página Improve and customize.
Descrições de Parâmetros
Use parâmetros de consulta para pesquisar sua coleção, identificar um conjunto de resultados e analisar conjuntos de resultados.
| Parâmetro | Descrição | Exemplo |
|---|---|---|
aggregation |
Uma consulta | |
| de estatística do conjunto de resultados | aggregation=term(enriched_text.entities.type) |
|
filter |
Uma procura de linguagem | |
| de consulta não classificada para documentos correspondentes. | filter=bees |
|
natural_language_query |
Uma procura | |
| de língua natural classificada para documentos correspondentes | natural_language_query="How do bees fly" |
|
query |
Uma procura de linguagem de | |
| consulta classificada para documentos correspondentes. | query=bees |
| Parâmetro | Descrição | Exemplo |
|---|---|---|
count |
O número de | |
documentos result a serem retornados. |
count=15 |
|
highlight |
Destacar correspondências de consulta | highlight=true |
offset |
O número de resultados a | |
serem ignorados antes de retornar documentos result por meio do conjunto de resultados |
offset=100 |
|
return |
Lista de campos a | |
| serem retornados | return=title,url |
|
sort |
Campo pelo qual o | |
| conjunto de resultados será classificado | sort=enriched_text.sentiment.document.score |
|
spelling suggestions |
Sugestões de ortografia retornadas para consultas de língua natural | spelling_suggestions=true |
Limitações de consulta
Não é possível consultar nomes de campos que contenham os seguintes caracteres:
- Números (
0 - 9) no sufixo do nome do campo. Por exemplo,extracted-content2. - Os caracteres
_,+e-no prefixo do sitefield_name. Por exemplo,+extracted-content. - Os caracteres
.,,e:nofield_name. Por exemplo,new:extracted-content.
Operadores
Os operadores são os separadores entre diferentes partes de uma consulta. A tabela a seguir lista os operadores disponíveis.
| Operador | Descrição | Exemplo |
|---|---|---|
. |
Delimitador JSON | enriched_text.concepts.text |
: |
Inclusões | text:computer |
:: |
Correspondência exata | title::"Query building" |
:! |
Não inclui | text:!computer |
::! |
Não é uma correspondência exata | text::!winter |
\ |
Caractere de escape | title::"Dorothy said: \"There's no place like home.\"" |
"" |
Consulta de frase | enriched_text.concepts.text:"IBM Watson" |
(), [] |
Grupos aninhados | filter-entities:(text:Turkey,type:Location) |
| | | ou | query-enriched.entities.text:Google|IBM |
, |
e | query-enriched.entities.text:Google,IBM |
<=, >=, >, < |
Comparações numéricas | enriched_text.sentiment.document.score>0.679 |
^x |
Multiplicador de pontuação | text:IBM^3 |
* |
Caracteres curinga | query-enriched_text.concepts.text:pre* |
~n |
Variação de sequência | query-enriched_text.entities.text:cat~1 |
:* |
Existe | title:* |
!* |
Não existe | title!* |
Agregações
As agregações retornam um conjunto de valores de dados. A tabela a seguir lista as agregações disponíveis.
| Agregação | Descrição | Exemplo |
|---|---|---|
average |
Valor médio para o | |
| campo especificado no conjunto de resultados. | average(product.price) |
|
filter |
Filtrar resultados com base no padrão especificado | filter(enriched_text.concepts.text:cloud computing) |
histogram |
Distribuição baseada em intervalo | histogram(product.price,interval:1) |
max |
O valor máximo para o campo | |
| especificado no conjunto de resultados. | max(product.price) |
|
min |
Valor mínimo para o campo | |
| especificado no conjunto de resultados. | min(product.price) |
|
nested |
Restringir agregação | nested(enriched_text.entities) |
sum |
Soma de todos os campos no | |
| conjunto de resultados. | sum(product.price) |
|
term |
Contagem de valores idênticos | term(enriched_text.concepts.text,count:10) |
timeslice |
Distribuição baseada no tempo | timeslice(last_modified,2day,America/New York) |
top_hits |
Documentos de resultado de alto ranqueamento para a agregação atual | term(enriched_text.concepts.text).top_hits(10) |
unique_count |
Contagem de | |
| valores exclusivos para um campo dentro de uma agregação | unique_count(enriched_text.entities.type) |