Skip to main content
Version: 3.1.0 (Latest)

System Views

Ignite provides a number of built-in SQL views that provide information on the cluster's state and provide real-time insight into the status of its components. These views are available in the SYSTEM schema.

Getting Data

You access system views in Ignite by using SQL and selecting data from the system view like you would from any other table. For example, you can get a list of all available system views in the following way:

SELECT id, schema, name FROM system.system_views WHERE type = 'NODE'

You can also use joins to combine data from multiple views. The example below returns all columns of a view that was found in the SYSTEM_VIEWS view:

SELECT svc.*
FROM system.system_view_columns svc
JOIN system.system_views sv ON svc.view_id = sv.id
WHERE sv.name = 'SYSTEM_VIEWS'

Available Views

SYSTEM_VIEWS

Describes available system views.

ColumnData TypeDescription
IDINT32System view ID.
SCHEMASTRINGName of the schema used. Default is SYSTEM.
NAMESTRINGSystem view name.
TYPESTRINGSystem view type. Possible values:
- NODE - The view provides node-specific information. Data will be collected from all nodes, and represented in the view.
- CLUSTER - The view provides cluster-wide information. Data will be collected from one node, chosen to represent the cluster.

SYSTEM_VIEW_COLUMNS

Describes available system view columns.

ColumnData TypeDescription
VIEW_IDINT32System view ID.
NAMESTRINGColumn name.
TYPESTRINGColumn type. Can by any of the supported types.
NULLABLEBOOLEANDefines if the column can be empty.
PRECISIONINT32Maximum number of digits.
SCALEINT32Maximum number of decimal places.
LENGTHINT32Maximum length of the value. Symbols for string values or bytes for binary values.

SYSTEM.ZONES

ColumnData TypeDescription
NAMESTRINGThe name of the distribution zone.
PARTITIONSINT32The number of partitions in the distribution zone.
REPLICASSTRINGThe number of copies of each partition in the distribution zone.
DATA_NODES_AUTO_ADJUST_SCALE_UPINT32The delay in seconds between the new node joining and the start of data zone adjustment.
DATA_NODES_AUTO_ADJUST_SCALE_DOWNINT32The delay in seconds between the node leaving the cluster and the start of data zone adjustment.
DATA_NODES_FILTERSTRINGThe filter that specifies what nodes will be used by the distribution zone.
IS_DEFAULT_ZONEBOOLEANDefines if the data zone is used by default.