ArangoDB v3.8 reached End of Life (EOL) and is no longer supported.

This documentation is outdated. Please see the most recent version at docs.arangodb.com

Searching Full-text with ArangoSearch

Search for tokens in full-text that can occur in any order

Full-text strings can be tokenized by text Analyzers so that each token (usually a word) gets indexed separately. Subsequently, it becomes possible to search for individual tokens. This is also possible with arrays of strings, where each element is one token (or multiple, additionally tokenized by a text Analyzer).

There are two ways to search for tokens:

  • Token search: The tokens can occur in any order. The words you search for merely need to be contained in the source string somehow.
  • Phrase search: The order of the tokens needs to match the query. This allows you to search for partial or full sentences.

Token search is covered below. For phrase search see Phrase and Proximity Search.

Dataset: IMDB movie dataset

View definition:

{
  "links": {
    "imdb_vertices": {
      "fields": {
        "description": {
          "analyzers": [
            "text_en"
          ]
        }
      }
    }
  }
}

AQL Queries:

Search for movies with dinosaur or park (or both) in their description:

FOR doc IN imdb
  SEARCH ANALYZER(doc.description IN TOKENS("dinosaur park", "text_en"), "text_en")
  RETURN {
    title: doc.title,
    description: doc.description
  }
title description
Alone in the Wilderness … the Aleutian Peninsula, in what is now Lake Clark National Park. …
Madagascar Collection … The plot follows the adventures of story of four Central Park Zoo animals …
Sea Monsters: A Prehistoric Adventure Journey 80 million years back in time to an age when mighty dinosaurs dominated the land …
Land of the Lost … their only ally in a world full of dinosaurs and other fantastic creatures.

Search for movies with both dinosaur and park in their description:

FOR doc IN imdb
  SEARCH ANALYZER(TOKENS("dinosaur park", "text_en") ALL == doc.description , "text_en")
  RETURN {
    title: doc.title,
    description: doc.description
  }
title description
Jurassic Park Series … the Jurassic Park films. This trilogy of films brings all our childhood fantasies to life with dinosaurs
Jurassic Park A wealthy entrepreneur secretly creates a theme park featuring living dinosaurs
The Lost World: Jurassic Park Four years after Jurassic Park’s genetically bred dinosaurs ran amok …
Cesta do pravěku … Four young boys visit a dinosaur exhibit … They then row out onto Central Park Lake …

The results will be the same if you use park dinosaur as search terms, as the tokens can be ordered arbitrarily.