Information schema for engine history

You can use the information_schema.engine_history view to return information about each engine’s history in an account. The view shows operations performed on each engine, including creation, deletion, starts, stops, resizing, and logical operations like renames. It is often useful to filter this view to a particular engine. In the example below, a filter is applied to look at the history of engines starting with capacity_test_. By default, shows the events from the last 30 days.

SELECT
  *
FROM
  information_schema.engine_history
WHERE
  engine_name LIKE 'capacity_test_%'

Columns in information_schema.engines_history

Each row has the following columns with information about each engine.

Column Name Data Type Description
engine_name TEXT The last known name of the engine. Either reflects the current name or the name at time of deletion.
engine_owner TEXT The name of the user who owns the engine.
cluster_id INT Ordinal numbers to identify engine clusters.
type TEXT(5) Node type used in a given engine (S, M, L or XL).
nodes INT Number of nodes in each of the cluster of the engine.
clusters INT The number of clusters used in the engine.
auto_start BOOLEAN If True, automatically start the engine if in stopped state when a query comes in.
auto_stop INT Automatically stop the engine after specified number of minutes.
initially_stopped BOOLEAN If True, the engine will not be automatically started after creation.
url TEXT Engine URL used by the users to issue queries to the engine.
default_database TEXT Default database for the engine as specified by the user.
version TEXT Engine version.
event_type TEXT Name of the event.
event_reason TEXT Reason why the engine event was triggered.
event_status TEXT Status of the event, indicating whether the action corresponding to the event has succeeded, failed or is in process. Can have one of the following values: SUCCEEDED, FAILED or IN_PROGRESS.
event_start_time TIMESTAMPTZ Time when the event was initiated.
event_finish_time TIMESTAMPTZ Time when the event was completed.
user_name TEXT User who triggered the event.
description TEXT Description of the engine as specified by the user.
query_id TEXT Unique identifier for the SQL query used for engine operations.