Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

hasRoot Operador

Definição

hasRoot

O operador hasRoot pode ser usado para executar queries em campos de nível-raiz quando você especificar as opções returnScope e returnStoredSource.

Sintaxe

hasRoot tem a seguinte sintaxe:

{  $search: {    "index": "<index name>", // optional, defaults to "default"    "hasRoot": {      "operator": {        <operator-specification>      }    },    "returnScope": {      "path": "<embedded-documents-field-to-retrieve>"    },    "returnStoredSource": true,  }}

Campos

Campo
Tipo
Descrição
necessidade

operator

Objeto

Operador a ser usado para consultar um campo indexado. Isso especifica os critérios de pesquisa para filtrar os documentos secundários.

Obrigatório

Requisitos

Para usar este operador, você deve fazer o seguinte na definição do índice:

  • Indexe o campo no nível-raiz que você deseja para a query.

  • Indexe o array de objetos que você deseja recuperar como o tipo embeddedDocuments. Você também deve configurar storedSource para campos aninhados que deseja recuperar.

Na query, você deve fazer o seguinte:

  • Especifique returnScope para definir o escopo do campo a ser pesquisado pelo operador.

  • Defina returnStoredSource para true para retornar os campos storedSource.

Exemplos

Os exemplos desta seção usam o namespace sample_training.companies. Se você carregar o conjunto de dados de amostra e criar o índice na coleção, pode tentar as queries de amostra demonstradas nesta seção.

Índice de amostra

As queries nesta seção usam o seguinte índice. Esta definição de índice configura o MongoDB Search para fazer o seguinte:

  • Indexe automaticamente todos os campos dinamicamente indexáveis na coleção.

  • Indexe os campos products, funding_rounds e funding_rounds.investments como o tipo embeddedDocuments.

  • Armazene os seguintes campos em mongot:

    • funding_rounds.raised_currency_code

    • funding_rounds.raised_amount

    • funding_rounds.investments

    • products.name

{  "mappings": {    "dynamic": true,    "fields": {      "funding_rounds": {        "dynamic": true,        "fields": {          "investments": [            {              "dynamic": true,              "type": "embeddedDocuments"            }          ]        },        "storedSource": {          "include": [            "raised_currency_code",            "raised_amount",            "investments"          ]        },        "type": "embeddedDocuments"      },      "products": {        "dynamic": true,        "storedSource": {          "include": [            "name"          ]        },        "type": "embeddedDocuments"      }    }  }}

Consulta Simples

A query a seguir retorna products onde o campo de nível-raiz founded_year está entre os anos 2005 e 2010.

db.companies.aggregate([  {    "$search": {       "returnStoredSource": true,      "returnScope": { "path": "products" },      "hasRoot": {        "operator": {          "range": {            "path": "founded_year",            "gte": 2005,            "lte": 2010          }        }      }    }  }])

Consulta Multinível

A consulta a seguir pesquisa no campo name para a empresa nomeada Facebook usando o operador text para recuperar o valor investido (funding_rounds.raised_amount e funding_rounds.raised_currency_code) por todos os investidores (investments.person e investments.financial_org) da empresa.

db.companies.aggregate([  {    "$search": {       "returnStoredSource": true,      "returnScope": { "path": "funding_rounds" },      "hasRoot": {        "operator": {          "text": {            "path": "name",            "query": "Facebook"          }        }      }    }  }])

query composta

A query a seguir pesquisa no campo funding_rounds.investments aninhado organizações financeiras com o termo Ventures (em qualquer lugar do campo name) que investiram em empresas descritas usando o termo network (em qualquer lugar do campo description). A query usa o operador composto para pesquisar:

  • Campo funding_rounds.investments.financial_org.name aninhado usando o operador embeddedDocument

  • Campo description de nível-raiz usando o operador hasRoot

O returnScope define o contexto para os operadores no campo do tipo funding_rounds embeddedDocuments e o campo returnStoredSource é configurado como true para retornar apenas os campos storedSource. A query limita os resultados a 5 documentos.

db.companies.aggregate([  {    "$search": {       "compound": {        "should": [          {            "embeddedDocument": {              "path": "funding_rounds.investments",              "operator": {                "wildcard": {                  "path": "funding_rounds.investments.financial_org.name",                  "query": "*Ventures*",                  "allowAnalyzedField": true                }              }            }          },          {            "hasRoot": {              "operator": {                "wildcard": {                  "path": "description",                  "query": "*network*",                  "allowAnalyzedField": true                }              }            }          }        ]      },      "returnScope": {"path": "funding_rounds"},      "returnStoredSource": true    }  },  {    "$limit": 5  }])
Voltar
hasAncestor
Próximo
Em
Avalie esta página

Nesta página