Visão geral
O Atlas Search permite que você realize pesquisas de texto completo em coleções hospedadas no MongoDB Atlas. Os índices do Atlas Search especificam o comportamento da pesquisa e quais campos indexar.
Você pode chamar os seguintes métodos em uma coleção para gerenciar seus índices de Atlas Search:
createSearchIndex()createSearchIndexes()listSearchIndexes()updateSearchIndex()dropSearchIndex()
Observação
Os métodos de gerenciamento de índice do Atlas Search são executados de forma assíncrona e podem retornar antes de confirmar que foram executados com êxito. Para determinar o status atual dos índices, chame o método listSearchIndexes().
As seções a seguir fornecem exemplos de código que demonstram como usar cada um dos métodos anteriores.
Criar um índice de pesquisa
Você pode usar os métodos createSearchIndex() e o createSearchIndexes() para criar um ou mais índices do Atlas Search.
Você também pode usar esses métodos para criar índices do Atlas Vector Search. O Atlas Vector Search permite que você realize pesquisas semânticas em incorporações vetoriais armazenadas no MongoDB Atlas. Para saber mais sobre esse recurso, consulte a Visão geral do Atlas Vector Search.
O seguinte exemplo de código mostra como criar um índice Atlas Search:
val index = Document("mappings", Document("dynamic", true)) collection.createSearchIndex("<index name>", index)
O seguinte exemplo de código mostra como criar múltiplos índices:
val indexOne = SearchIndexModel("<first index name>", Document("mappings", Document("dynamic", true))) val indexTwo = SearchIndexModel("<second index name>", Document("mappings", Document("dynamic", true))) collection.createSearchIndexes(listOf(indexOne, indexTwo))
Para saber mais sobre a sintaxe usada para definir os índices do Atlas Search, consulte o guia Review Atlas Search Index Syntax no manual do Atlas.
Listar índices de pesquisa
Você pode usar o método listSearchIndexes() para retornar todos os índices de Atlas Search em uma coleção.
O exemplo de código a seguir mostra como imprimir uma lista dos índices de pesquisa de uma coleção:
val results = collection.listSearchIndexes() results.forEach { result -> println(result) }
Atualizar um Índice de Pesquisa
Você pode utilizar o método updateSearchIndex() para atualizar um índice do Atlas Search.
O seguinte código mostra como atualizar um índice de pesquisa:
val newIndex = Document("mappings", Document("dynamic", true)) collection.updateSearchIndex("<index to update>", newIndex)
Excluir um índice de pesquisa
Você pode utilizar o método dropSearchIndex() para excluir um índice do Atlas Search.
O seguinte código mostra como excluir um índice de pesquisa de uma coleção:
collection.dropIndex("<index to delete>")
Informações adicionais
Para saber mais sobre o MongoDB Atlas Search, consulte a documentação dos índices do Atlas Search.