RisingWave catalogs

RisingWave 目录包含系统表和视图，提供有关系统中不同关系的元数据，以及有关集群作业及其状态的信息。元数据包括有关系统中每个数据库、schema 和关系的详细信息，如物化视图、表、source、sink、索引和视图。状态信息包括 DDL 命令的进度、系统快照等。

如何显示 RisingWave 目录

连接到 RisingWave vis psql 后，输入 \d 来显示 RisingWave 目录。

结果如下：

\d
------返回结果
                        List of relations
   Schema   |                Name                 | Type  | Owner 
------------+-------------------------------------+-------+-------
 rw_catalog | rw_actors                           | table | root
 rw_catalog | rw_columns                          | table | root
 rw_catalog | rw_connections                      | table | root
...

可以查看这些目录的 schema：

DESCRIBE rw_catalog.rw_ddl_progress;
------返回结果
Name      |  Type   
---------------+---------
 ddl_id        | bigint
 ddl_statement | varchar
 progress      | varchar
(3 rows)

DESCRIBE rw_catalog.rw_meta_snapshot;
------返回结果
          Name          |            Type
------------------------+-----------------------------
 meta_snapshot_id       | bigint
 hummock_version_id     | bigint
 safe_epoch             | bigint
 safe_epoch_ts          | timestamp without time zone
 max_committed_epoch    | bigint
 max_committed_epoch_ts | timestamp without time zone
(6 rows)

还可以检索目录的值。请注意，schema（rw_catalog）是可选的。

SELECT name, owner, definition FROM rw_tables;
------返回结果
 name | owner |            definition            
------+-------+----------------------------------
 t1   |     1 | CREATE TABLE t1 (v1 INT, v2 INT)
(1 row)

可以使用两个与时间相关的字段 created_at 和 initiated_at 检索对象创建和初始化的时间。这对了解 source 或物化视图创建或初始化的时间非常有用。

SELECT name, initialized_at, created_at FROM rw_sources;
------返回结果
 name |        initialized_at         |          created_at
------+-------------------------------+-------------------------------
 s    | 2023-07-25 10:53:30.128+00:00 | 2023-07-25 10:53:30.130+00:00
(1 row)

可用的 RisingWave 目录

关系名称	描述
rw_actors	包含可用的角色 ID、其状态以及相应的片段 ID 和并行单元 ID。
rw_columns	包含数据库中所有关系（source 除外）的列信息，包括名称、位置、数据类型等。
rw_connections	包含数据库中所有关系（source 除外）的列信息，包括名称、位置、数据类型等。
rw_databases	包含有关数据库中可用数据库的信息，例如 ID、名称和所有者。
rw_ddl_progress	包含运行 DDL 语句的进度。可以使用此关系查看 DDL 语句的运行进度。有关详细信息，请参阅查看语句进度。
rw_description	包含每个数据库对象的可选描述（注释）。可以使用 COMMENT ON 命令添加描述，并使用 DESCRIBE 或 SHOW COLUMNS FROM 命令查看。
rw_event_logs	包含有关事件的信息，包括事件 ID、时间戳、事件类型以及其他可用信息。
rw_fragments	包含数据库中片段的底层信息，包括片段 ID、表 ID 等。
rw_functions	包含数据库中函数的信息，包括其 ID、名称、schema ID、类型、参数和返回数据类型、编程语言等。
rw_hummock_branched_objects	包含有关 Hummock（RisingWave 中的存储引擎）分支对象的信息，包括对象 ID、相应的 SST ID 和压缩组 ID。
rw_hummock_checkpoint_version	包含有关 Hummock（RisingWave 中的存储引擎）中数据的检查点版本的信息，包括版本 ID、提交的最大 epoch、安全 epoch 和压缩组详细信息。
rw_hummock_compact_task_progress	包含有关压缩任务状态的信息，包括压缩组 ID、任务 ID、 SST 相关信息、待处理的读写 IO 数量等。
rw_hummock_compaction_group_configs	包含数据库中 Hummock 压缩组的配置设置信息，包括压缩组 ID、父压缩组 ID、成员表、压缩设置和活动写入限制。
rw_hummock_current_version	包含有关 Hummock（RisingWave 中的存储引擎）中数据当前版本的信息，包括版本 ID、提交的最大 epoch、安全 epoch 和压缩组详情。
rw_hummock_meta_configs	包含 Hummock（RisingWave 中的存储引擎）的元数据配置及其值。
rw_hummock_pinned_snapshots	包含有关 Hummock（RisingWave 中的存储引擎）中固定快照的信息，包括工作节点 ID 和最小固定快照 ID。
rw_hummock_pinned_versions	包含有关 Hummock（RisingWave 中的存储引擎）中固定版本的信息，包括工作节点 ID 和最小固定快照 ID。
rw_hummock_sstables	包含有关 Hummock（RisingWave 中的存储引擎）中使用的 SSTables（排序字符串表）的信息。
rw_hummock_version_deltas	包含有关 Hummock（RisingWave 中的存储引擎）中版本增量的信息。版本增量表示数据在连续的 epoch 之间的修改或差异。
rw_indexes	包含数据库中索引的相关信息，包括索引 ID、名称、schema ID、定义等。
rw_internal_tables	包含数据库中内部表的信息。内部表是存储查询的中间结果（也称为内部状态）的表。相当于 SHOW INTERNAL TABLES 命令。
rw_materialized_views	包含数据库中物化视图的信息，包括名称、定义、schema 和所有者 ID 以及访问控制列表。
rw_meta_snapshot	包含有关 RisingWave 元服务现有快照的信息。可以使用此关系获取元快照的 ID，然后从快照恢复元服务。详情请参阅备份和恢复元服务。
rw_parallel_units	包含用于执行数据库操作的并行工作单元的信息，包括其唯一 ID、工作单元 ID 和主键。
rw_relation_info	包含有关数据库中可用的表、source、物化视图和索引的底层关系信息。
rw_relations	包含数据库中关系的信息，包括唯一 ID、名称、类型、schema ID 和所有者 ID。
rw_schemas	包含数据库中可用 schema 的信息，包括名称、唯一 ID、所有者 ID 等。
rw_sinks	包含数据库中可用 sink 的信息，包括其唯一 ID、名称、schema ID、所有者 ID、连接器类型、sink 类型、连接 ID、定义等。
rw_sources	包含数据库中可用 source 的信息，包括其唯一 ID、名称、schema ID、所有者 ID、连接器类型、列定义、行格式、仅追加数据标志、连接 ID 等。
rw_system_tables	包含数据库中系统表的信息，包括唯一 ID、名称、schema ID、所有者等。
rw_table_fragments	包含数据库中表片段的信息，包括其父表 ID、片段状态和主键。
rw_table_stats	包含有关表的统计信息，包括其唯一 ID、总键数、总键大小和总值大小（以字节为单位）。
rw_tables	包含数据库中可用表的信息，包括唯一 ID、名称、schema ID、所有者 ID、定义等。
rw_types	包含数据库支持的数据类型信息，包括 ID 和名称。
rw_user_secrets	该表存储数据库中所有用户的加密密码，只有超级用户才能访问。
rw_users	包含数据库中可用用户的信息，包括其唯一 ID、名称和表明其是否为超级用户的布尔标志、是否可以创建数据库、是否可以创建其他用户以及是否可以登录。
rw_views	包含数据库中可用视图的信息，包括唯一 ID、名称、schema ID、所有者 ID、定义等。
rw_worker_nodes	包含数据库中可用 worker 节点的信息，如 Meta 节点、Compactor 节点、 Compute 节点和前端节点。详细信息包括其唯一 ID、主机名、端口、类型、状态、并行性等级、布尔标志（表明其是否用于流处理、服务或是否不可调度）、内核版本、内存、CPU 和正常运行时间。