Menu Docs
Página inicial do Docs
/ /
Operadores e coletores
Página inicial do Docs
/ /
Referência de query
/
Operadores e coletores
Página inicial do Docs
/
Desenvolvimento
/
Pesquisa
/
Queries e índices
/
Referência de query
/
Operadores e coletores

hasAncestor Operador

Definição

hasAncestor

O operador hasAncestor consulta um campo do tipo embeddedDocuments que você especifica no ancestorPath. O ancestorPath é pai do campo que você especifica no returnScope. O returnScope especifica o campo aninhado , incluindo o nível de aninhamento, que você deseja recuperar.

Você pode usar esse operador ao pontuar e recuperar objetos dentro de arrays como documentos independentes para:

  • Filtrar em campos ancestrais (nível mais alto de aninhamento).

  • Filtrar em campos irmãos (nível igual de aninhamento).

Sintaxe

O operador hasAncestor tem a seguinte sintaxe:

1{
2  $search: {
3    "index": "<index name>", // optional, defaults to "default"
4    "hasAncestor": {
5      "ancestorPath": "<embeddedDocuments-type-higher-level-field>",
6      "operator": {
7        <operator-specification>
8      }
9    },
10    "returnScope": {
11      "path": "<embeddedDocuments-type-field-to-retrieve>"
12    }
13  }
14}

Campos

Campo
Tipo
Descrição
necessidade

ancestorPath

String

Nome do campo do tipo embeddedDocuments que é um ancestral intermediário do campo aninhado usado na query. Este é o documento pai que o operador avalia.

Obrigatório

operator

Objeto

Operador a utilizar para fazer query do campo aninhado dentro do campo de tipo embeddedDocuments especificado no ancestorPath. O caminho da consulta deve ser um filho do ancestorPath, independentemente do nível de aninhamento. Isto especifica os critérios de pesquisa para filtrar o documento principal.

Você não pode usar o operador hasAncestor dentro da especificação do operador.

Obrigatório

Requisitos

Para usar esse operador, você deve:

  • Indexe os campos ancestrais como o tipoembeddedDocuments. Na query, especifique ancestorPath como este campo. Se o campo estiver no nível raiz, use hasRoot.

  • Especifique returnScope para definir o escopo do documento a ser consultado e recuperado.

Exemplos

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

Índice de amostra

As queries nesta seção utilizam 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 funding_rounds os funding_rounds.investments campos e como o tipo embeddedDocuments.

  • Armazene os seguintes campos em mongot:

    • funding_rounds.investments.financial_org

    • funding_rounds.investments.person

1{
2  "mappings": {
3    "dynamic": true,
4    "fields": {
5      "funding_rounds": {
6        "dynamic": true,
7        "fields": {
8          "investments": [
9            {
10              "dynamic": true,
11              "storedSource": {
12                "include": [
13                  "financial_org",
14                  "person"
15                ]
16              },
17              "type": "embeddedDocuments"
18            }
19          ]
20        },
21        "type": "embeddedDocuments"
22      }
23    }
24  }
25}

Amostra de query

A query a seguir pesquisa no campo funding_rounds.founded_year empresas que foram fundadas no ano 2005 usando o operador equals para recuperar detalhes de capitalização, como organizações financeiros ou individuais que aplicaram nas empresas.

1db.companies.aggregate([
2  { 
3    "$search": { 
4      "returnStoredSource": true, 
5      "returnScope": { "path": "funding_rounds.investments" }, 
6      "hasAncestor": { 
7        "ancestorPath": "funding_rounds", 
8        "operator": { 
9          "equals": { 
10            "path": "funding_rounds.funded_year", 
11            "value": 2005 
12          } 
13        } 
14      } 
15    } 
16  }
17])
[
  {
    financial_org: {
      name: 'Frazier Technology Ventures',
      permalink: 'frazier-technology-ventures'
    },
    person: null
  },
  {
    financial_org: { name: 'Trinity Ventures', permalink: 'trinity-ventures' },
    person: null
  },
  {
    financial_org: { name: 'Accel Partners', permalink: 'accel-partners' },
    person: null
  },
  {
    financial_org: null,
    person: {
      first_name: 'Mark',
      last_name: 'Pincus',
      permalink: 'mark-pincus'
    }
  },
  {
    financial_org: null,
    person: {
      first_name: 'Reid',
      last_name: 'Hoffman',
      permalink: 'reid-hoffman'
    }
  },
  {
    financial_org: { name: 'First Round Capital', permalink: 'first-round-capital' },
    person: null
  },
  {
    financial_org: null,
    person: {
      first_name: 'Ram',
      last_name: 'Shriram',
      permalink: 'ram-shriram'
    }
  },
  {
    financial_org: null,
    person: {
      first_name: 'Mitch',
      last_name: 'Kapor',
      permalink: 'mitch-kapor'
    }
  },
  {
    financial_org: null,
    person: { first_name: 'Ron', last_name: 'Conway', permalink: 'ron-conway' }
  },
  {
    financial_org: null,
    person: {
      first_name: 'Silvio',
      last_name: 'Scaglia',
      permalink: 'silvio-scaglia'
    }
  },
  {
    financial_org: {
      name: 'Shelter Capital Partners',
      permalink: 'shelter-capital-partners'
    },
    person: null
  },
  {
    financial_org: { name: 'First Round Capital', permalink: 'first-round-capital' },
    person: null
  },
  {
    financial_org: {
      name: 'Liberty Associated Partners',
      permalink: 'liberty-associated-partners'
    },
    person: null
  },
  {
    financial_org: { name: 'Rose Tech Ventures', permalink: 'rose-tech-ventures' },
    person: null
  },
  {
    financial_org: { name: 'First Round Capital', permalink: 'first-round-capital' },
    person: null
  },
  {
    financial_org: { name: 'Lead Dog Ventures', permalink: 'lead-dog-ventures' },
    person: null
  },
  {
    financial_org: { name: 'Accel Partners', permalink: 'accel-partners' },
    person: null
  },
  {
    financial_org: { name: 'Benchmark', permalink: 'benchmark-2' },
    person: null
  },
  {
    financial_org: { name: 'Sequoia Capital', permalink: 'sequoia-capital' },
    person: null
  },
  { financial_org: null, person: null }
]

Voltar

GeoWithin

Próximo

hasRoot

Nesta página