PersistentQueryConfigurationLogV2

Every time a Persistent Query (PQ) is created or modified, details on the query are stored in the PersistentQueryConfigurationLogV2 table. Deephaven uses this log when a query is reverted to a previous version.

Note

The PersistentQueryConfigurationLogV2 table replaces the Legacy PersistentQueryConfigurationLog table.

Columns

Column NameColumn TypeDescription
DateStringThe date on which the state change occurred. This is the partitioning column.
TimestampDateTimeThe timestamp for the state change.
SerialNumberlongThe query's serial number (a system-generated identifier unique to each PQ).
VersionNumberlongThe query's version number (a number that starts at 1 for each query and is incremented each time the query is updated).
OwnerStringThe owner of the PQ.
NameStringThe name of the PQ.
EventTypelongThe query configuration event that triggered the log entry:
  • ADDED - a PQ was added or modified
  • INITIAL - a controller logs all queries it is managing with EventType of INITIAL when it first starts
  • REMOVED - a PQ was deleted
Enabledboolean
  • true - the query is enabled
  • false - the query is disabled (will not be started by the controller)
HeapSizeInGBdoubleThe heap size for the query in GB (the memory the query has available)
DataBufferPoolToHeapSizeRatiodoubleThe data buffer to heap size ratio - this is the fraction of the query's heap that will be dedicated to caching binary data from the underlying Deephaven data sources.
DetailedGCLoggingEnabledbooleanIf true, then Java garbage collection details are logged for the query.
OmitDefaultGCParametersbooleanThis parameter is deprecated.
DbServerNameStringThe server on which the query will be run; this is shown as DB_SERVER_<number>, and these names are translated to physical or virtual servers by the controller.
RestartUsersStringSpecifies which group of users are allowed to restart the query:
  • Admin - only administrators of the query can restart it
  • AdminAndViewers - administrators and viewers of the query can restart it
  • ViewersWhenDown - administrators can restart the query, and viewers only if it is not running
ScriptCodeStringThe code for the script if it is not stored in git.
ScriptPathStringThe script path if it is stored in git.
ExtraJvmArgumentsString[]Extra JVM arguments to be passed to Java when the query is started.
ExtraEnvironmentVariablesString[]Environment variables to be set before the query is started.
ClassPathAdditionsString[]Additional elements to be added to the class path for the JVM.
AdminGroupsString[]Additional administrators for the query (i.e., users or groups that can edit, start, stop, or delete the query).
ViewerGroupsString[]Additional viewers for the query (i.e., users or groups that can view the query and its resulting tables).
ConfigurationTypeStringThe type of the configuration:
  • Live Query Replay - (ReplayScript) - a configuration that replays data.
  • Revert Helper - a Deephaven internal query that is used to help to revert PQs to previous versions; this should not be modified except by a system administrator.
  • Batch Query (RunAndDone) - a query that runs and terminates once the queries are complete.
  • Live Query (Script) - a query that runs until it is terminated.
SchedulingString[]Specifies the scheduling details for the query.
TimeoutlongTimeout value in milliseconds.
TypeSpecificFieldsjava.util.MapMap for fields specific to configuration types.
JVMProfileStringThe JVM profile to be used for the query.
LastModifiedByAuthenticatedStringThe authenticated user who last modified this query.
LastModifiedByEffectiveStringThe effective user who last modified this query.
LastModifiedTimeDateTimeThe last time this query was modified.