SAI 索引和 SSTable 的虛擬表格

儲存附加索引 (SAI) 提供基於 CQL 的虛擬表格，讓您能找出 SAI 索引和相關 SSTable 的系統元資料目前狀態。這些虛擬表格位於 system_views 鍵集空間中。

有關相關資訊，請參閱 SAI 資訊。

system_views.indexes

system_views.indexes 虛擬表格包含 SAI 索引的狀態資訊。此檢視提供索引欄位層級的資訊，包括索引名稱、索引 SSTable 數量、磁碟使用量和索引狀態。從索引狀態中，資料會顯示索引目前是否正在建置，以及索引是否可查詢。

使用 CQL 檢視表格說明。範例

DESCRIBE TABLE system_views.indexes;

/*
Warning: Table system_views.indexes is a virtual table and cannot be recreated with CQL.
Structure, for reference:
VIRTUAL TABLE system_views.indexes (
    keyspace_name text,
    index_name text,
    analyzer text,
    cell_count bigint,
    column_name text,
    indexed_sstable_count int,
    is_building boolean,
    is_queryable boolean,
    is_string boolean,
    per_column_disk_size bigint,
    per_table_disk_size bigint,
    table_name text,
    PRIMARY KEY (keyspace_name, index_name)
) WITH CLUSTERING ORDER BY (index_name ASC)
    AND comment = 'Storage-attached column index metadata';
*/

若要檢視目前的資料，請提交類似下列的查詢

SELECT * FROM system_views.indexes;

 keyspace_name | index_name           | analyzer                                                    | cell_count | column_name  | indexed_sstable_count | is_building | is_queryable | is_string | per_column_disk_size | per_table_disk_size | table_name
---------------+----------------------+-------------------------------------------------------------+------------+--------------+-----------------------+-------------+--------------+-----------+----------------------+---------------------+------------------
       cycling |          age_sai_idx |                                              NoOpAnalyzer{} |          0 |          age |                     0 |       False |         True |     False |                    0 |                   0 | cyclist_semi_pro
       cycling |      country_sai_idx | NonTokenizingAnalyzer{caseSensitive=false, normalized=true} |          0 |      country |                     0 |       False |         True |      True |                    0 |                   0 | cyclist_semi_pro
       cycling |     lastname_sai_idx | NonTokenizingAnalyzer{caseSensitive=false, normalized=true} |          0 |     lastname |                     0 |       False |         True |      True |                    0 |                   0 | cyclist_semi_pro
       cycling | registration_sai_idx |                                              NoOpAnalyzer{} |          0 | registration |                     0 |       False |         True |     False |                    0 |                   0 | cyclist_semi_pro

(4 rows)

system_views.indexes metadata
欄位名稱	CQL 類型	意義
`keyspace_name`	`text`	索引所屬鍵空間的名稱。
`index_name`	`text`	索引的名稱。
`analyzer`	`text`	索引所使用的分析器的 `toString` 呈現。
`cell_count`	`bigint`	已編製索引的資料表儲存格數目，或索引值金鑰條目數目。這是每個 SSTable 中索引條目數目的總和。
`column_name`	`text`	已編製索引的欄位名稱。
`indexed_sstable_count`	`int`	已編製索引的 SSTable 數目。請注意，沒有相關資料的 SSTable 這裡不會編製索引或計算在內。
`is_building`	`boolean`	索引是否正在建置中。
`is_queryable`	`boolean`	是否可以查詢索引。如果初始任務建置尚未完成，則無法查詢。
`is_string`	`boolean`	索引是否針對文字欄位（`ascii`、`text` 或 `varchar`）。
`per_column_disk_size`	`bigint`	索引組件僅限於該欄位的磁碟大小（以位元組為單位）。
`per_table_disk_size`	`bigint`	索引組件與相同資料表的其他 SAI 索引共用的磁碟大小（以位元組為單位）。
`table_name`	`text`	已編製索引的欄位所屬資料表的名稱。

system_views.sstable_indexes

system_views.sstable_indexes 虛擬資料表針對每個 SAI 索引和 SSTable 有一列。此檢視描述個別 SSTable 索引，並包含磁碟大小、最小/最大列 ID、最小/最大環狀代碼和索引的寫入時間版本等資訊。

使用 CQL 檢視表格說明。範例

DESCRIBE TABLE system_views.sstable_indexes;

/*
Warning: Table system_views.sstable_indexes is a virtual table and cannot be recreated with CQL.
Structure, for reference:
VIRTUAL TABLE system_views.sstable_indexes (
    keyspace_name text,
    index_name text,
    sstable_name text,
    cell_count bigint,
    column_name text,
    end_token text,
    format_version text,
    max_row_id bigint,
    min_row_id bigint,
    per_column_disk_size bigint,
    per_table_disk_size bigint,
    start_token text,
    table_name text,
    PRIMARY KEY (keyspace_name, index_name, sstable_name)
) WITH CLUSTERING ORDER BY (index_name ASC, sstable_name ASC)
    AND comment = 'SSTable index metadata';
*/

若要檢視目前的資料，請提交類似下列的查詢

SELECT * FROM system_views.sstable_indexes;

system_views.sstable_indexes metadata<
欄位名稱	CQL 類型	意義
`keyspace_name`	`text`	索引所屬鍵空間的名稱。
`index_name`	`text`	索引的名稱。
`sstable_name`	`text`	SSTable 的名稱。
`cell_count`	`bigint`	已編製索引的資料表儲存格數目，或索引值金鑰條目數目。
`column_name`	`text`	已編製索引的欄位名稱。
`start_token`	`text`	已編製索引的 SSTable 所涵蓋的代碼範圍的開頭。
`end_token`	`text`	已編製索引的 SSTable 所涵蓋的代碼範圍的結尾。
`min_row_id`	`bigint`	SSTable 索引中的最小列 ID。
`max_row_id`	`bigint`	SSTable 索引中的最大列 ID。
`per_column_disk_size`	`bigint`	SSTable 索引組件僅限於該欄位的磁碟大小（以位元組為單位）。
`per_table_disk_size`	`bigint`	與同一張表的其他 SAI 索引共用的 SSTable 索引元件的磁碟大小（以位元組為單位）。
`table_name`	`text`	已編製索引的欄位所屬資料表的名稱。

system_views.sstable_index_segments

system_views.sstable_index_segments 虛擬表格針對每個 SAI 索引和 SSTable 片段有一列。此檢視會描述 SSTable 索引的片段。它會公開片段列 ID 偏移量和 SSTable 層級虛擬表格中的大部分資訊，特別是片段粒度。

使用 CQL 檢視表格說明。範例

DESCRIBE TABLE system_views.sstable_index_segments;

/*
Warning: Table system_views.sstable_index_segments is a virtual table and cannot be recreated with CQL.
Structure, for reference:
VIRTUAL TABLE system_views.sstable_index_segments (
    keyspace_name text,
    index_name text,
    sstable_name text,
    segment_row_id_offset bigint,
    cell_count bigint,
    column_name text,
    component_metadata frozen<map<text, map<text, text>>>,
    end_token text,
    max_sstable_row_id bigint,
    max_term text,
    min_sstable_row_id bigint,
    min_term text,
    start_token text,
    table_name text,
    PRIMARY KEY (keyspace_name, index_name, sstable_name, segment_row_id_offset)
) WITH CLUSTERING ORDER BY (index_name ASC, sstable_name ASC, segment_row_id_offset ASC)
    AND comment = 'SSTable index segment metadata';
*/

若要檢視目前的資料，請提交類似下列的查詢

SELECT * FROM system_views.sstable_index_segments;

system_views.sstable_index_segments 元資料
欄位名稱	CQL 類型	意義
`keyspace_name`	`text`	索引所屬鍵空間的名稱。
`index_name`	`text`	索引的名稱。
`sstable_name`	`text`	SSTable 的名稱。
`segment_row_id_offset`	`bigint`	SSTable 片段的列 ID 偏移量。
`cell_count`	`bigint`	已編製索引的片段數目，或索引片段值金鑰條目的數目。
`column_name`	`text`	已編製索引的欄位名稱。
`component_metadata`	`frozen<map<text, map<text, text>>>`	SSTable 片段中的元件元資料。
`end_token`	`text`	SSTable 片段涵蓋的權杖範圍結束。
`max_sstable_row_id`	`bigint`	SSTable 片段中的最大列 ID。
`max_term`	`text`	SSTable 片段中的最大詞彙。
`min_sstable_row_id`	`bigint`	SSTable 片段中的最小列 ID。
`min_term`	`text`	SSTable 片段中的最小詞彙。
`start_token`	`text`	SSTable 片段涵蓋的權杖範圍開始。
`table_name`	`text`	SSTable 片段所屬的表格名稱。

Cassandra 文件

版本

SAI 索引和 SSTable 的虛擬表格

system_views.indexes

system_views.sstable_indexes

system_views.sstable_index_segments