|
| 1 | +--- |
| 2 | +title: System Tables |
| 3 | +--- |
| 4 | + |
| 5 | +# System Tables |
| 6 | + |
| 7 | +Databend provides a set of system tables that contain metadata about your Databend deployment, databases, tables, queries, and system performance. These tables are read-only and are automatically updated by the system. |
| 8 | + |
| 9 | +System tables are organized in the `system` schema and can be queried using standard SQL. They provide valuable information for monitoring, troubleshooting, and understanding your Databend environment. |
| 10 | + |
| 11 | +## Available System Tables |
| 12 | + |
| 13 | +### Database & Table Metadata |
| 14 | + |
| 15 | +| Table | Description | |
| 16 | +|-------|-------------| |
| 17 | +| [system.tables](system-tables.md) | Provides metadata information for all tables including properties, creation time, size, and more. | |
| 18 | +| [system.tables_with_history](system-tables-with-history.md) | Provides historical metadata information for tables, including dropped tables. | |
| 19 | +| [system.databases](system-databases.md) | Contains information about all databases in the system. | |
| 20 | +| [system.databases_with_history](system-databases-with-history.md) | Contains historical information about databases, including dropped databases. | |
| 21 | +| [system.columns](system-columns.md) | Provides information about columns in all tables. | |
| 22 | +| [system.indexes](system-indexes.md) | Contains information about table indexes. | |
| 23 | +| [system.virtual_columns](system-virtual-columns.md) | Lists virtual columns available in the system. | |
| 24 | + |
| 25 | +### Query & Performance |
| 26 | + |
| 27 | +| Table | Description | |
| 28 | +|-------|-------------| |
| 29 | +| [system.query_log](system-query-log.md) | Contains information about executed queries, including performance metrics. | |
| 30 | +| [system.metrics](system-metrics.md) | Contains information about system metric events. | |
| 31 | +| [system.query_cache](system-query-cache.md) | Provides information about the query cache. | |
| 32 | +| [system.locks](system-locks.md) | Contains information about acquired locks in the system. | |
| 33 | + |
| 34 | +### Functions & Settings |
| 35 | + |
| 36 | +| Table | Description | |
| 37 | +|-------|-------------| |
| 38 | +| [system.functions](system-functions.md) | Lists all available built-in functions. | |
| 39 | +| [system.table_functions](system-table-functions.md) | Lists all available table functions. | |
| 40 | +| [system.user_functions](system-user-functions.md) | Contains information about user-defined functions. | |
| 41 | +| [system.settings](system-settings.md) | Contains information about system settings. | |
| 42 | +| [system.configs](system-configs.md) | Contains configuration information for the Databend deployment. | |
| 43 | + |
| 44 | +### System Information |
| 45 | + |
| 46 | +| Table | Description | |
| 47 | +|-------|-------------| |
| 48 | +| [system.build_options](system-build-options.md) | Contains information about build options used to compile Databend. | |
| 49 | +| [system.clusters](system-clusters.md) | Contains information about clusters in the system. | |
| 50 | +| [system.contributors](system-contributors.md) | Lists contributors to the Databend project. | |
| 51 | +| [system.credits](system-credits.md) | Contains information about third-party libraries used in Databend. | |
| 52 | +| [system.caches](system-caches.md) | Provides information about system caches. | |
| 53 | + |
| 54 | +### Utility Tables |
| 55 | + |
| 56 | +| Table | Description | |
| 57 | +|-------|-------------| |
| 58 | +| [system.numbers](system-numbers.md) | A table containing a single column with integers starting from 0, useful for generating test data. | |
| 59 | +| [system.streams](system-streams.md) | Contains information about streams in the system. | |
| 60 | +| [system.temp_tables](system-temp-tables.md) | Contains information about temporary tables. | |
| 61 | +| [system.temp_files](system-temp-files.md) | Contains information about temporary files. | |
| 62 | + |
| 63 | +### Information Schema |
| 64 | + |
| 65 | +| Table | Description | |
| 66 | +|-------|-------------| |
| 67 | +| [information_schema.tables](information-schema-tables.md) | ANSI SQL standard metadata view for tables. | |
| 68 | + |
0 commit comments