Skip to main content

Search Experiments

mlflow.search_experiments() and MlflowClient.search_experiments() support the same filter string syntax as mlflow.search_runs() and MlflowClient.search_runs, but the supported identifiers and comparators are different.

Syntax​

See Search Runs Syntax for more information.

Identifier​

The following identifiers are supported:

  • attributes.name: Experiment name
  • attributes.creation_time: Experiment creation time
  • attributes.last_update_time: Experiment last update time
note

attributes can be omitted. name is equivalent to attributes.name.

  • tags.<tag key>: Tag

Comparator​

Comparators for string attributes and tags:

  • =: Equal
  • !=: Not equal
  • LIKE: Case-sensitive pattern match
  • ILIKE: Case-insensitive pattern match

Comparators for numeric attributes:

  • =: Equal
  • !=: Not equal
  • <: Less than
  • <=: Less than or equal to
  • >: Greater than
  • >=: Greater than or equal to

Examples​

# Matches experiments with name equal to 'x'
"attributes.name = 'x'"  # or "name = 'x'"

# Matches experiments with name starting with 'x'
"attributes.name LIKE 'x%'"

# Matches experiments with 'group' tag value not equal to 'x'
"tags.group != 'x'"

# Matches experiments with 'group' tag value containing 'x' or 'X'
"tags.group ILIKE '%x%'"

# Matches experiments with name starting with 'x' and 'group' tag value equal to 'y'
"attributes.name LIKE 'x%' AND tags.group = 'y'"