Skip to content

Latest commit

 

History

History
83 lines (76 loc) · 10.2 KB

information-schema.md

File metadata and controls

83 lines (76 loc) · 10.2 KB
title summary aliases
Information Schema
TiDB implements the ANSI-standard information_schema for viewing system metadata.
/docs/dev/system-tables/system-table-information-schema/
/docs/dev/reference/system-databases/information-schema/
/tidb/dev/system-table-information-schema/

Information Schema

Information Schema provides an ANSI-standard way of viewing system metadata. TiDB also provides a number of custom INFORMATION_SCHEMA tables, in addition to the tables included for MySQL compatibility.

Many INFORMATION_SCHEMA tables have a corresponding SHOW command. The benefit of querying INFORMATION_SCHEMA is that it is possible to join between tables.

Tables for MySQL compatibility

Table Name Description
CHARACTER_SETS Provides a list of character sets the server supports.
COLLATIONS Provides a list of collations that the server supports.
COLLATION_CHARACTER_SET_APPLICABILITY Explains which collations apply to which character sets.
COLUMNS Provides a list of columns for all tables.
COLUMN_PRIVILEGES Not implemented by TiDB. Returns zero rows.
COLUMN_STATISTICS Not implemented by TiDB. Returns zero rows.
ENGINES Provides a list of supported storage engines.
EVENTS Not implemented by TiDB. Returns zero rows.
FILES Not implemented by TiDB. Returns zero rows.
GLOBAL_STATUS Not implemented by TiDB. Returns zero rows.
GLOBAL_VARIABLES Not implemented by TiDB. Returns zero rows.
KEY_COLUMN_USAGE Describes the key constraints of the columns, such as the primary key constraint.
OPTIMIZER_TRACE Not implemented by TiDB. Returns zero rows.
PARAMETERS Not implemented by TiDB. Returns zero rows.
PARTITIONS Provides a list of table partitions.
PLUGINS Not implemented by TiDB. Returns zero rows.
PROCESSLIST Provides similar information to the command SHOW PROCESSLIST.
PROFILING Not implemented by TiDB. Returns zero rows.
REFERENTIAL_CONSTRAINTS Not implemented by TiDB. Returns zero rows.
ROUTINES Not implemented by TiDB. Returns zero rows.
SCHEMATA Provides similar information to SHOW DATABASES.
SCHEMA_PRIVILEGES Not implemented by TiDB. Returns zero rows.
SESSION_STATUS Not implemented by TiDB. Returns zero rows.
SESSION_VARIABLES Provides similar functionality to the command SHOW SESSION VARIABLES
STATISTICS Provides information on table indexes.
TABLES Provides a list of tables that the current user has visibility of. Similar to SHOW TABLES.
TABLESPACES Not implemented by TiDB. Returns zero rows.
TABLE_CONSTRAINTS Provides information on primary keys, unique indexes and foreign keys.
TABLE_PRIVILEGES Not implemented by TiDB. Returns zero rows.
TRIGGERS Not implemented by TiDB. Returns zero rows.
USER_PRIVILEGES Summarizes the privileges associated with the current user.
VIEWS Provides a list of views that the current user has visibility of. Similar to running SHOW FULL TABLES WHERE table_type = 'VIEW'

Tables that are TiDB extensions

Table Name Description
ANALYZE_STATUS Provides information about tasks to collect statistics.
CLUSTER_CONFIG Provides details about configuration settings for the entire TiDB cluster.
CLUSTER_HARDWARE Provides details on the underlying physical hardware discovered on each TiDB component.
CLUSTER_INFO Provides details on the current cluster topology.
CLUSTER_LOAD Provides current load information for TiDB servers in the cluster.
CLUSTER_LOG Provides a log for the entire TiDB cluster
CLUSTER_PROCESSLIST Provides a cluster-level view of the PROCESSLIST table.
CLUSTER_SLOW_QUERY Provides a cluster-level view of the SLOW_QUERY table.
CLUSTER_STATEMENTS_SUMMARY Provides a cluster-level view of the STATEMENTS_SUMMARY table.
CLUSTER_STATEMENTS_SUMMARY_HISTORY Provides a cluster-level view of the CLUSTER_STATEMENTS_SUMMARY_HISTORY table.
CLUSTER_SYSTEMINFO Provides details about kernel parameter configuration for servers in the cluster.
DDL_JOBS Provides similar output to ADMIN SHOW DDL JOBS
INSPECTION_RESULT Triggers internal diagnostics checks.
INSPECTION_RULES A list of internal diagnostic checks performed.
INSPECTION_SUMMARY A summarized report of important monitoring metrics.
METRICS_SUMMARY A summary of metrics extracted from Prometheus.
METRICS_SUMMARY_BY_LABEL See METRICS_SUMMARY table.
METRICS_TABLES Provides the PromQL definitions for tables in METRICS_SCHEMA.
SEQUENCES The TiDB implementation of sequences is based on MariaDB.
SLOW_QUERY Provides information on slow queries on the current TiDB server.
STATEMENTS_SUMMARY Similar to performance_schema statement summary in MySQL.
STATEMENTS_SUMMARY_HISTORY Similar to performance_schema statement summary history in MySQL.
TABLE_STORAGE_STATS Provides details about table sizes in storage.
TIDB_HOT_REGIONS Provides statistics about which regions are hot.
TIDB_INDEXES Provides index information about TiDB tables.
TIDB_SERVERS_INFO Provides a list of TiDB servers (i.e. tidb-server component)
TIFLASH_REPLICA Provides details about TiFlash replicas.
TIKV_REGION_PEERS Provides details about where regions are stored.
TIKV_REGION_STATUS Provides statistics about regions.
TIKV_STORE_STATUS Provides basic information about TiKV servers.