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: Instant.MIN.

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: Instant.MAX.

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.