System keyspaces in Amazon Keyspaces
This section provides details about working with system keyspaces in Amazon Keyspaces (for Apache Cassandra).
Amazon Keyspaces uses four system keyspaces:
-
system
-
system_schema
-
system_schema_mcs
-
system_multiregion_info
The following sections provide details about the system keyspaces and the system tables that are supported in Amazon Keyspaces.
system
This is a Cassandra keyspace. Amazon Keyspaces uses the following tables.
Table names | Column names | Comments |
---|---|---|
|
|
Information about the local keyspace. |
|
|
Query this table to see the available endpoints. For example, if you're connecting through a public endpoint, you see a list of nine available IP addresses. If you're connecting through a FIPS endpoint, you see a list of three IP addresses. If you're connecting through an Amazon PrivateLink VPC endpoint, you see the list of IP addresses that you have configured. For more information, see Populating system.peers table entries with interface VPC endpoint information. |
|
|
This table defines the total size and number of partitions for each token range for every table. This is needed for the Apache Cassandra Spark Connector, which uses the estimated partition size to distribute the work. |
|
|
This table contains information about saved queries. |
system_schema
This is a Cassandra keyspace. Amazon Keyspaces uses the following tables.
Table names | Column names | Comments |
---|---|---|
|
|
Information about a specific keyspace. |
|
|
Information about a specific table. |
|
|
Information about a specific column. |
system_schema_mcs
This is an Amazon Keyspaces keyspace that stores information about Amazon or Amazon Keyspaces specific settings.
Table names | Column names | Comments |
---|---|---|
|
|
Query this table to find out programmatically if a keyspace has been created. For more information, see Check keyspace creation status in Amazon Keyspaces. |
|
|
Query this table to find out the status of a specific table. For more information, see Check table creation status in Amazon Keyspaces. You can also query this table to list settings that are
specific to Amazon Keyspaces and are stored as
|
|
|
Query this table to learn about schema changes for a specific table. |
|
|
This table is identical to the Cassandra table in the
|
|
|
Query this table to find out if a keyspace has tags. For more information, see View the tags of a table. |
|
|
Query this table to get the auto scaling settings of a
provisioned table. Note that these settings won't be available
until the table is active. To query this table, you have to
specify |
system_multiregion_info
This is an Amazon Keyspaces keyspace that stores information about Multi-Region Replication.
Table names | Column names | Comments |
---|---|---|
|
|
This table contains information about multi-Region
tables—for example, the Amazon Web Services Regions that the table is
replicated in and the table's status. You can also query this
table to list settings that are specific to Amazon Keyspaces that are
stored as
To query this table, you have to specify
|
|
|
Query this table to get the auto scaling settings of a
multi-Region provisioned table. Note that these settings won't
be available until the table is active. To query this table, you
have to specify |