/ /

Queries e índices

Referência de índice

Página inicial do Docs

Defina campos de origem armazenados em seu índice de pesquisa MongoDB

A opção storedSource em um índice de pesquisa do MongoDB pesquisa especifica os campos no documento de origem que o MongoDB pesquisa deve armazenar. Você pode configurar o storedSource para melhorar o desempenho da query em determinados casos de uso, pois reduz a necessidade de pesquisa implícita de tempo de query no banco de dados de backend. Você pode armazenar campos de todos os Tipos de Campo de Pesquisa do MongoDB na Pesquisa do MongoDB.

O MongoDB Search não indexa campos armazenados, então você deve indexar os campos separadamente para executar queries neles. Você também pode recuperar campos armazenados no momento da query usando a opção returnStoredSource.

Observação

storedSource está disponível apenas em clusters que executam o MongoDB 7.0+.

Para saber mais sobre como recuperar os campos armazenados, consulte Retornar campos de origem armazenados.

Sintaxe

A opção storedSource tem a seguinte sintaxe em uma definição de índice:

Sintaxe

1 {
2   "storedSource": true | false | {
3     "include" | "exclude": [
4       "<field-name>",
5       ...
6     ]
7   }
8 }

Opções

A opção storedSource usa um valor booleano ou um objeto na definição do índice.

Valores booleanos

Valor	Descrição
`true`	Especifica que a MongoDB Search deve armazenar todos os campos nos documentos. Armazenar documentos completos pode impacto significativamente o desempenho durante a indexação e a query. Para saber mais, consulte Armazenar campos de origem. Isso não é aceito se a definição do índice contiver um campo do tipo vetor. Em vez disso, use `include` para especificar os campos a serem armazenados em `mongot` ou use `exclude` para excluir o campo do tipo `vector` do armazenamento.
`false`	Especifica que o MongoDB Search não deve armazenar o documento de origem original. Este é o valor padrão para a opção `storedSource`.

Valor

Descrição

true

Especifica que a MongoDB Search deve armazenar todos os campos nos documentos. Armazenar documentos completos pode impacto significativamente o desempenho durante a indexação e a query. Para saber mais, consulte Armazenar campos de origem.

Isso não é aceito se a definição do índice contiver um campo do tipo vetor. Em vez disso, use include para especificar os campos a serem armazenados em mongot ou use exclude para excluir o campo do tipo vector do armazenamento.

false

Especifica que o MongoDB Search não deve armazenar o documento de origem original. Este é o valor padrão para a opção storedSource.

Objeto

O objeto de opção storedSource deve conter um dos seguintes campos:

Campo	Tipo	Descrição
`include`	array de strings	Lista que contém os nomes dos campo ou caminhos separados por pontos para campos a serem armazenados. Além dos campos especificados, o MongoDB Search armazena `_id` também por padrão.
`exclude`	array de strings	Lista com os nomes de campo ou caminhos separados por ponto para os campos a serem excluídos de serem armazenados. Se especificado, o MongoDB Search armazena documentos originais, exceto os campos listados aqui. Se a definição do índice contiver um campo do tipo vetor, você deverá excluir o campo do tipo `vector` do armazenamento.

Exemplos

Os exemplos de índice seguintes utilizam os campos na coleção sample_mflix.movies para demonstrar como configurar os campos para armazenar no MongoDB Search utilizando a opção storedSource. Você pode usar mongosh, o Atlas UI Visual Editor ou o Atlas UI JSON Editor para configurar os índices.

Interface

Campos de Origem Armazenados

Voltar

Índice classificado

Mapeamentos de sinônimos

1	{
2	"storedSource": true \| false \| {
3	"include" \| "exclude": [
4	"<field-name>",
5	...
6	]
7	}
8	}