Menu Docs

Página inicial do Docs → Iniciar e gerenciar o MongoDB → MongoDB Atlas

Em

Nesta página

  • Definição
  • Sintaxe
  • Campos
  • Exemplos
  • Índice de amostra
  • Exemplos de queries

Definição

O operador in executa uma pesquisa para uma array de BSON number, date, boolean, objectId, uuid ou string valores no caminho fornecido e retorna documentos onde o valor do campo é igual a qualquer valor na array especificada. Se o campo contiver uma array, o operador in selecionará os documentos cujo campo contém uma array que contenha pelo menos um elemento que corresponda a qualquer valor na array especificada.

Sintaxe

O operador in tem a seguinte sintaxe:

{
  $search: {
    "index": <index name>, // optional, defaults to "default"
    "in": {
      "path": "<field-to-search>",
      "score": <options>,
      "value": <single-or-array-of-values-to-search>
    }
  }
}

Campos

Campo
Tipo
Descrição
necessidade
path
string

Campo indexado para pesquisar. Você também pode especificar um caminho curinga para pesquisa. Consulte construção de caminho para obter mais informações.

Observação

Para pesquisar valores dastring em um campo, você deve indexar o campo como o tipo de token do Atlas Search.

Obrigatório
score
objeto

Pontuação para atribuir aos resultados do termo de pesquisa correspondente. Use uma das opções seguintes para modificar a pontuação:

  • boost: multiplique a pontuação do resultado pelo número fornecido.

  • constant: substitui a pontuação do resultado pelo número fornecido.

  • function: substitua a pontuação do resultado usando a expressão de função.

Opcional
value
boolean, ObjectId, número, data, uuid ou string

Valor ou valores a serem pesquisados. O valor pode ser um único valor ou uma array de valores de apenas um dos tipos de BSON suportados e não pode ser uma mistura de tipos diferentes.

Observação

Para pesquisar valores de string em um campo, você deve indexar o campo como o tipo de token do Atlas Search.

Obrigatório

Exemplos

Os exemplos seguintes utilizam o operador in para consultar collections na collection sample_analytics.customers . Se você carregar os dados de amostra em seu cluster do Atlas e criar um índice do Atlas Search chamado default que usa mapeamentos estáticos na coleção, poderá executar as seguintes queries nas coleções.

Índice de amostra

A definição do índice de amostra especifica as seguintes ações para suportar queries do operador in em relação aos campos indexados na coleção:

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

  • Indexa estaticamente o campo name como o tipo de token e converte o texto no campo em minúsculas.

{
  "mappings": {
    "index": "default",
    "dynamic": true,
    "fields": {
      "name": {
        "normalizer": "lowercase",
        "type": "token"
      }
    }
  }
}

Para saber como criar um índice do Atlas Search, consulte Criar um índice do Atlas Search.

Exemplos de queries

← GeoWithin
knnBeta →

Nesta página