System keyspaces and tables

The database uses a set of internal keyspaces to store metadata about the cluster, its schema, security, and operational state. The tables in these keyspaces are managed by the database; do not modify them directly.

The system keyspace

Tables in the system keyspace store metadata about the local node.

Table name Column names Comment

local

key, bootstrapped, broadcast_address, cluster_name, cql_version, data_center, dse_version, gossip_generation, graph, host_id, jmx_port, listen_address, native_protocol_version, native_transport_address, native_transport_port, native_transport_port_ssl, partitioner, rack, release_version, rpc_address, schema_version, server_id, storage_port, storage_port_ssl, tokens, truncated_at, workload, workloads

Information that a node has about itself and a superset of gossip. Gossip is a peer-to-peer communication protocol for exchanging location and state information between nodes.

peers

peer, data_center, dse_version, graph, host_id, jmx_port, native_transport_address, native_transport_port, native_transport_port_ssl, preferred_ip, rack, release_version, rpc_address, schema_version, server_id, storage_port, storage_port_ssl, tokens, workload, workloads

Each node records what other nodes tell it about themselves over the gossip.

size_estimates

keyspace_name, table_name, range_start, range_end, mean_partition_size, partitions_count

Information on partitions.

The system_schema keyspace

Use CQL to query system_schema tables to view keyspace, table, and column information. The same information is also available using the CQL shell DESCRIBE commands, which is the preferred method. The system_schema tables does not show search index or row-level access control settings.

Table name Column names Comment

aggregates

keyspace_name, aggregate_name, argument_types, final_func, initcond, return_type, state_func, state_type

Information about user-defined aggregates.

columns

keyspace_name, table_name, column_name, clustering_order, column_name_bytes, kind, position, type

Information about table columns.

dropped_columns

keyspace_name, table_name, column_name, dropped_time, type

Information about dropped columns.

functions

keyspace_name, function_name, argument_types, argument_names, body, called_on_null_input, language, return_type

Information on user-defined functions.

indexes

keyspace_name, table_name, index_name, kind, options

Information about indexes.

keyspaces

keyspace_name, durable_writes, replication

Information on keyspace durable writes and replication.

tables

keyspace_name, table_name, bloom_filter_fp_chance, caching, comment, compaction, compression, crc_check_chance, default_time_to_live, extensions, flags, gc_grace_seconds, id, max_index_interval, memtable_flush_period_in_ms, min_index_interval, speculative_retry

Information on columns and column indexes. Used internally for compound primary keys.

types

keyspace_name, type_name, field_names, field_types

Information about user-defined types.

views

keyspace_name, view_name, base_table_id, base_table_name, bloom_filter_fp_chance, caching, comment, compaction, compression, crc_check_chance, default_time_to_live, extensions, flags, gc_grace_seconds, include_all_columns, max_index_interval, memtable_flush_period_in_ms, min_index_interval, speculative_retry, where_clause

Information about materialized views.

Was this helpful?

Give Feedback

How can we improve the documentation?

© Copyright IBM Corporation 2026 | Privacy policy | Terms of use |  Manage Privacy Choices

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: Contact IBM