/ /

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

The following index examples use the fields in the sample_mflix.movies collection to demonstrate how to configure the fields to store on MongoDB Search using the storedSource option. You can use mongosh, the Atlas UI Visual Editor, or the Atlas UI JSON Editor to configure the indexes.

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	}