Skip to main content

Search Catalog

Search the metadata catalog for objects matching one or more terms, optionally narrowed by object type, by scope, or by when the object was last updated.

Results are filtered by permission: an object only appears if you have read access to it, so two users running the same search may see different results.

Syntax​

search catalog "<term>"[, "<term>" ...]
  [type <object type>[, <object type> ...]]
  [in { all repositories | repository <repository reference> | schema <schema reference> | project <project reference> }]
  [updated { after | before } "<timestamp>"]
  [limit <limit> [offset <offset>]]

The options may be given in any order, except that offset must follow limit — it cannot be given on its own.

An explicit scope cannot be combined with in all repositories; the command fails rather than picking one. With no scope given at all, the search runs against the current repository, and fails if none is set — use in all repositories or use repository <name> first.

Parameters​

term​

String — A quoted search term, at least three characters long. Give several, separated by commas, to search for more than one. A term shorter than three characters fails the whole command.

object type​

String — Restrict results to one or more types. Allowed values: table, stream, schema, data source, project, job, job schedule, validation suite. Default: all types.

repository reference​

String — Restrict results to a single repository.

schema reference​

String — Restrict results to a single schema.

project reference​

String — Restrict results to a single project.

timestamp​

String — ISO-8601 formatted string. A date alone (2026-04-29) is read as midnight UTC, a timestamp without a zone (2026-04-29T08:12:23) is read as UTC, and a full instant (2026-04-29T08:12:23Z) is used as given.

limit​

Integer — Maximum number of results to return. Default: 20. Values above 100 are reduced to 100 without warning, and values below 1 fall back to the default.

offset​

Integer — Number of results to omit from the beginning, so that further results can be paged through. Only accepted after limit. Default: 0.

Options​

in all repositories​

Search every repository you have access to rather than the current one. Cannot be combined with an explicit repository, schema, or project scope.

Examples​

Search the current repository for two terms:

search catalog "customer", "account"

Restrict to tables and streams in one schema:

search catalog "revenue" type table, stream in schema analytics

Find recently changed jobs across every repository, a page at a time:

search catalog "nightly" type job in all repositories updated after "2026-04-01" limit 25 offset 0