Metadata Usage History

Show the recent usage of a given metadata object and optionally that object's children.

Syntax

usage history of { organization | repository | data source | schema | project | table | job } <object ref> [cascade] [from "<start>" [to "<end>"]] [limit <limit> [offset <offset>]]

Parameters

object ref

String — The (optionally qualified) name of the object to display usage history for.

cascade

If present, also display usage history for all children of this object.

start

String — ISO-8601 formatted string including the timezone, such as 2021-04-29T08:12:23Z. If the timezone is omitted, it will default to UTC. If the time and time zone portions are omitted, it will default to T00:00:00. The provided time must be before end, and it must be in the past.

Default: unset — history is returned from the earliest available record.

end

String — ISO-8601 formatted string including the timezone, such as 2021-04-29T08:12:23Z. If the timezone is omitted, it will default to UTC. If the time and time zone portions are omitted, it will default to T00:00:00. Can only be used if start is explicitly defined. Default: unset — history is returned up to the most recent record.

limit

Integer — Maximum number of history results to show. Default: 50.

offset

Integer — Number of results to omit from the beginning of the query, allowing farther past records to be queried. Default: 0.