Skip to main content
Version: 1.2

INFORMATION_SCHEMA

INFORMATION_SCHEMA provides access to metadata such as database and table names and column data types. GreptimeDB also provides custom INFORMATION_SCHEMA tables for system, cluster, and runtime metadata.

Many INFORMATION_SCHEMA tables have a corresponding SHOW command. Unlike SHOW, INFORMATION_SCHEMA tables can be filtered, projected, and joined in SQL queries.

The tables below distinguish implemented metadata tables from compatibility tables that return no rows or are not supported.

Tables for MySQL compatibility

Table NameDescription
CHARACTER_SETSprovides information about available character sets.
CHECK_CONSTRAINTSNot implemented. Returns zero rows.
COLLATIONSProvides a list of collations that the server supports.
COLLATION_CHARACTER_SET_APPLICABILITYExplains which collations apply to which character sets.
COLUMNSProvides a list of columns for all tables.
COLUMN_PRIVILEGESNot implemented. Returns zero rows.
COLUMN_STATISTICSNot supported.
ENGINESProvides a list of supported storage engines.
EVENTSNot implemented. Returns zero rows.
FILESNot implemented. Returns zero rows.
GLOBAL_STATUSNot implemented. Returns zero rows.
GLOBAL_VARIABLESNot supported.
KEY_COLUMN_USAGEDescribes the key constraints of the columns, such as the primary key, and time index constraint.
OPTIMIZER_TRACENot implemented. Returns zero rows.
PARAMETERSNot implemented. Returns zero rows.
PARTITIONSProvides a list of table partitions.
PLUGINSNot supported.
PROCESSLISTNot supported, please use PROCESS_LIST instead.
PROFILINGNot implemented. Returns zero rows.
REFERENTIAL_CONSTRAINTSNot implemented. Returns zero rows.
ROUTINESNot implemented. Returns zero rows.
SCHEMATAProvides similar information to SHOW DATABASES.
SCHEMA_PRIVILEGESNot implemented. Returns zero rows.
SESSION_STATUSNot implemented. Returns zero rows.
SESSION_VARIABLESNot supported.
STATISTICSProvides index metadata in a MySQL-compatible shape.
TABLESProvides a list of tables that the current user has visibility of. Similar to SHOW TABLES.
TABLESPACESNot supported.
TABLE_PRIVILEGESNot implemented. Returns zero rows.
TRIGGERSNot supported. GreptimeDB Enterprise provides a differently shaped TRIGGERS table.
USER_ATTRIBUTESNot supported.
USER_PRIVILEGESNot supported.
VARIABLES_INFONot supported.
VIEWSProvides a list of views that the current user has visibility of. Similar to running SHOW FULL TABLES WHERE table_type = 'VIEW'
TABLE_CONSTRAINTSProvides time-index and primary-key constraint metadata.

Tables that GreptimeDB provides

Table NameDescription
BUILD_INFOProvides the system build info.
REGION_PEERSProvides details about where regions are stored.
REGION_INFOProvides Region runtime and manifest metadata, such as role and state, sequences, manifest version, Region options, SST format, and node ownership.
REGION_STATISTICSProvides details about region statistics info, such as disk size, etc.
CLUSTER_INFOProvides the topology information of the cluster.
FLOWSProvides the flow information.
PROCEDURE_INFOProcedure information.
PROCESS_LISTRunning queries information.
RECYCLE_BINProvides soft-dropped tables that are still eligible for restore.
TABLE_SEMANTICSProvides an experimental view over table semantic metadata.
SSTS_INDEX_METAProvides SST index metadata including inverted indexes, fulltext indexes, and bloom filters.
SSTS_MANIFESTProvides SST file information from the manifest including file paths, sizes, time ranges, row counts, and encoded primary key ranges.
SSTS_STORAGEProvides SST file information from the storage layer for verification and debugging.
TRIGGERSProvides the trigger information.
ALERTSProvides the alert information.