exactOnSingleWordQuery

Type: string

Engine default: attribute

Formerly: enableExactOnSingleWordQuery, useQueryEqualsOneAttributeInRanking

Parameter syntax

'exactOnSingleWordQuery' => 'attribute'|'none'|'word'

exactOnSingleWordQuery: 'attribute'|'none'|'word'

exactOnSingleWordQuery: 'attribute'|'none'|'word'

'exactOnSingleWordQuery': 'attribute'|'none'|'word'

exactOnSingleWordQuery = .attribute|.none|.word

exactOnSingleWordQuery: ExactOnSingleWordQuery = ExactOnSingleWordQuery.Attribute
| ExactOnSingleWordQuery.None
| ExactOnSingleWordQuery.Word

IndexSettings settings = new IndexSettings();
settings.ExactOnSingleWordQuery = "attribute"|"none"|"word";

.setExactOnSingleWordQuery("attribute"|"none"|"word")

opt.ExactOnSingleWordQuery("attribute"|"none"|"word")

exactOnSingleWordQuery = Some("attribute"|"none"|"word")

Can be used in these methods:
search, setSettings, browseObjects, searchForFacetValues, generateSecuredApiKey, addApiKey, updateApiKey search, set_settings, browse_objects, search_for_facet_values, generate_secured_api_key, add_api_key, update_api_key search, setSettings, browseObjects, searchForFacetValues, generateSecuredApiKey, addApiKey, updateApiKey search, set_settings, browse_objects, search_for_facet_values, generate_secured_api_key, add_api_key, update_api_key search, setSettings, browse, searchForFacetValues, generateSecuredApiKey, addAPIKey, updateAPIKey search, setSettings, browseObjects, searchForFacetValues, generateSecuredApiKey, addApiKey, updateApiKey Search, SetSettings, Browse, SearchForFacetValues, GenerateSecuredApiKey, AddApiKey, UpdateApiKey Search, setSettings, browse, searchForFacetValues, generateSecuredApiKey, addApiKey, updateApiKey Search, SetSettings, BrowseObjects, SearchForFacetValues, GenerateSecuredAPIKey, AddAPIKey, UpdateAPIKey search, setSettings, browse index, search into facet values, generateSecuredApiKey, add key, update key

See code examples

About this parameter# A

Controls how the exact ranking criterion is computed when the query contains only one word.

Usage notes#

If exactOnSingleWordQuery is set to word, only exact matches will be highlighted in the _highlightResult property of the search response: partials and prefixes will not be.

Options: #

attribute: (default): The exact ranking criterion is set to 1 if the query matches exactly an entire attribute value.

For example, if you search for the TV show “Road”, and in your dataset you have 2 records, “Road” and “Road Trip”, only the record with “Road” is considered exact.
none: The exact ranking criterion is ignored on single word queries.
word: The exact ranking criterion is set to 1 if the query word is found in the record. The query word must be at least 3 characters long and must not be a stop word in any supported language.

Continuing with our “Road” TV show example, in this case, both “Road” and “Road Trip” are considered to match exactly.

Examples# A

Set default exact ranking criterion computation on single word query#

Copy

1
2
3
4
5
$index->setSettings([
  'exactOnSingleWordQuery' => 'attribute'
  // 'exactOnSingleWordQuery' => 'none'
  // 'exactOnSingleWordQuery' => 'word'
]);

1
2
3
4
5
6
7
index.setSettings({
  exactOnSingleWordQuery: 'attribute',
  // exactOnSingleWordQuery: 'none'
  // exactOnSingleWordQuery: 'word'
}).then(() => {
  // done
});

1
2
3
4
5
6
7
8
9
10
let settings = Settings()
  .set(\.exactOnSingleWordQuery, to: .attribute)
  //.set(\.exactOnSingleWordQuery, to: ExactOnSingleWordQuery.none)
  //.set(\.exactOnSingleWordQuery, to: .word)

index.setSettings(settings) { result in
  if case .success(let response) = result {
    print("Response: \(response)")
  }
}

1
2
3
4
5
6
IndexSettings settings = new IndexSettings();
settings.ExactOnSingleWordQuery = "attribute"};
// settings.ExactOnSingleWordQuery = "none";
// settings.ExactOnSingleWordQuery = "word";

index.SetSettings(settings);

1
2
3
4
5
index.setSettings(
  new IndexSettings().setExactOnSingleWordQuery("attribute")
  // new IndexSettings().setExactOnSingleWordQuery("none")
  // new IndexSettings().setExactOnSingleWordQuery("word")
);

1
2
3
4
5
6
7
client.execute {
  changeSettings of "myIndex" `with` IndexSettings(
    exactOnSingleWordQuery = Some("attribute")
    // exactOnSingleWordQuery = Some("none")
    // exactOnSingleWordQuery = Some("word")
  )
}

1
2
3
4
5
6
7
val settings = settings {
    exactOnSingleWordQuery = ExactOnSingleWordQuery.Attribute
    // exactOnSingleWordQuery = ExactOnSingleWordQuery.None
    // exactOnSingleWordQuery = ExactOnSingleWordQuery.Word
}

index.setSettings(settings)

Override default exact ranking criterion computation on single word query for the current search#

Copy

1
2
3
4
5
$results = $index->search('query', [
  'exactOnSingleWordQuery' => 'none'
  // 'exactOnSingleWordQuery' => 'attribute'
  // 'exactOnSingleWordQuery' => 'word'
]);

1
2
3
4
5
6
7
index.search('query', {
  exactOnSingleWordQuery: 'none'
  // exactOnSingleWordQuery: 'attribute'
  // exactOnSingleWordQuery: 'word'
}).then(({ hits }) => {
  console.log(hits);
});

1
2
3
4
5
6
7
8
9
10
let query = Query("query")
  .set(\.exactOnSingleWordQuery, to: ExactOnSingleWordQuery.none)
  //.set(\.exactOnSingleWordQuery, to: .attribute)
  //.set(\.exactOnSingleWordQuery, to: .word)

index.search(query: query) { result in
  if case .success(let response) = result {
    print("Response: \(response)")
  }
}

1
2
3
4
5
index.search(
  new Query("query").setExactOnSingleWordQuery("none")
  // new Query("query").setExactOnSingleWordQuery("attribute")
  // new Query("query").setExactOnSingleWordQuery("word")
);

1
2
3
4
5
6
7
8
client.execute {
  search into "myIndex" query Query(
    query = Some("query"),
    exactOnSingleWordQuery = Some("none")
    // exactOnSingleWordQuery = Some("attribute")
    // exactOnSingleWordQuery = Some("word")
  )
}

1
2
3
4
5
6
7
val query = query("query") {
    exactOnSingleWordQuery = ExactOnSingleWordQuery.None
    // exactOnSingleWordQuery = ExactOnSingleWordQuery.Attribute
    // exactOnSingleWordQuery = ExactOnSingleWordQuery.Word
}

index.search(query)

Did you find this page helpful?