Reference

This reference page provides the technical specifications, definitions, and permission structures governing WarehousePG Enterprise Manager (WEM).

Keyboard shortcuts

ShortcutActionContext
Ctrl+EnterExecute queryQuery Editor
Ctrl+KOpen AI AssistantQuery Editor
Ctrl+SpaceAuto-completeQuery Editor
EscapeClose modal/dialogAnywhere

Role permissions matrix

PermissionAdminOperatorViewer
View dashboardYesYesYes
View cluster statusYesYesYes
View active queriesYesYesYes
Cancel queriesYesYesNo
Terminate sessionsYesYesNo
Execute DDL (CREATE/DROP)YesNoNo
Execute DML (INSERT/UPDATE/DELETE)YesLimitedNo
Execute SELECTYesYesYes
View data analysisYesYesNo
Run ANALYZEYesNoNo
View storageYesYesYes
View metricsYesYesYes
View logsYesYesYes
View backupsYesYesNo
Manage usersYesNoNo
Configure permissionsYesNoNo
View audit logYesNoNo
Note

This matrix represents the default system settings. Administrators can customize these permissions for each role via the Users panel under the Permissions tab.

Monitoring views

Core views (available in all databases)

View NameDescription
v_activityEnhanced session monitoring. This view extends the standard pg_stat_activity by adding WarehousePG-specific columns to help identify distributed query bottlenecks.
v_table_sizes_summaryComprehensive storage analysis. Displays table sizes while accounting for different storage formats (Heap/Append-Only) and compression ratios.
v_check_data_skewDistribution health check. Analyzes how data is spread across segments to identify "hot" segments that might be slowing down parallel processing.
v_bloat_tablesMaintenance indicator. Detects table bloat (fragmented space) caused by high volumes of UPDATE or DELETE operations.
v_locksConcurrency monitoring. Provides a clear view of current database locks and identifies exactly which queries are blocking others.
v_size_filesLow-level storage view. Provides file-level size information directly from the underlying file system of the cluster.
v_indexes_sizeIndex audit tool. Lists all index definitions along with their current storage footprint to help identify redundant or oversized indexes.

Dashboard-specific views (WarehousePG database only)

View NameDescription
v_database_sizesHistorical storage tracking. Provides total database sizes alongside trend data to help with capacity planning.
v_query_statsPerformance analytics. Aggregates query performance statistics to identify the most resource-intensive or frequently executed queries.

Technical glossary

  • Coordinator: The primary node that manages distributed queries and coordinates segment activity.
  • Standby: A replica of the coordinator for high availability.
  • Segment: A data storage node that holds a portion of the database.
  • Primary segment: The active segment handling reads and writes.
  • Mirror segment: A replica segment for redundancy.
  • Content ID: A unique identifier for a segment pair (primary + mirror).
  • Distribution key: Column(s) determining how data is distributed across segments.
  • Bloat: Wasted space in tables from UPDATE/DELETE operations.
  • Skew: Uneven data distribution across segments.
  • Motion: Data movement between segments during query execution.
  • Redistribute: Re-distributing data between segments for a join.
  • Broadcast: Sending all data to all segments.
  • Gather: Collecting results from segments to the coordinator.
  • Resource group: A container for resource limits and concurrency.
  • Resource queue: A queue managing query concurrency and resources.
  • Canary check: Automated health check query.
  • DDL: Data Definition Language (CREATE, DROP, ALTER).
  • DML: Data Manipulation Language (INSERT, UPDATE, DELETE).

Could this page be better? Report a problem or suggest an addition!