# Aurora PostgreSQL Limitless Database 的函数和视图 Aurora PostgreSQL Limitless Database 添加了函数和视图。它们基于相应的 Aurora PostgreSQL 函数和视图。 **注意** 如果有正在进行的事务，某些统计数据可能会返回不一致的结果。 **Topics** + [Aurora PostgreSQL Limitless Database 函数](limitless-monitoring-functions.md) + [Aurora PostgreSQL Limitless Database 视图](limitless-monitoring-views.md) # Aurora PostgreSQL Limitless Database 函数 下表列出了 Aurora PostgreSQL Limitless Database 的新函数。 **注意** 此表中列出的函数位于 `rds_aurora` 架构中。使用 Limitless Database 函数时，请确保包含完全限定的对象名称：`rds_aurora`.`object_name`。 | Aurora PostgreSQL Limitless Database 函数 | 对应的 Aurora PostgreSQL 函数 | | --- | --- | | [limitless\$1backend\$1dsid](#limitless_backend_dsid) | pg\$1backend\$1pid | | [limitless\$1cancel\$1session](#limitless_cancel_session) | pg\$1cancel\$1backend | | [limitless\$1stat\$1clear\$1snapshot](#limitless_stat_clear_snapshot) | pg\$1stat\$1clear\$1snapshot | | [limitless\$1stat\$1database\$1size](#limitless_stat_database_size) | pg\$1database\$1size | | [limitless\$1stat\$1get\$1snapshot\$1timestamp](#limitless_stat_get_snapshot_timestamp) | pg\$1stat\$1get\$1snapshot\$1timestamp | | [limitless\$1stat\$1prepared\$1xacts](#limitless_stat_prepared_xacts) | pg\$1prepared\$1xacts | | [limitless\$1stat\$1relation\$1sizes](#limitless_stat_relation_sizes) | pg\$1indexes\$1size、pg\$1relation\$1size、pg\$1table\$1size、pg\$1total\$1relation\$1size | | [limitless\$1stat\$1reset](#limitless_stat_reset) | pg\$1stat\$1reset | | [limitless\$1stat\$1statements\$1reset](#limitless_stat_statements_reset) | pg\$1stat\$1statements\$1reset | | [limitless\$1stat\$1system\$1waits](#limitless_stat_system_waits) | aurora\$1stat\$1system\$1waits | | [limitless\$1terminate\$1session](#limitless_terminate_session) | pg\$1terminate\$1backend | | [limitless\$1wait\$1report](#limitless_wait_report) | aurora\$1wait\$1report | 以下示例提供了有关 Aurora PostgreSQL Limitless Database 函数的详细信息。有关 PostgreSQL 函数的更多信息，请参阅 PostgreSQL 文档中的 [Functions and operators](https://www.postgresql.org/docs/15/functions.html)。 **limitless\$1backend\$1dsid** `limitless_backend_dsid` 函数返回当前会话的分布式会话 ID。分布式会话在数据库分片组中的路由器上运行，涉及数据库分片组中一个或多个分片上的后端进程。 以下示例演示了如何使用 `limitless_backend_dsid` 函数。 ``` SELECT rds_aurora.limitless_backend_dsid(); limitless_backend_dsid ------------------------ 8CACD7B04D0FC2A5 (1 row) ``` **limitless\$1cancel\$1session** `limitless_cancel_session` 函数的工作原理与 `pg_cancel_backend` 类似，但它尝试通过发送 `SIGINT`（中断信号）来取消与提供的分布式会话 ID 相关的所有后端进程。 以下是输入参数： + `distributed_session_id`（文本）– 要取消的分布式会话的 ID。 以下是输出参数： + `subcluster_id`（文本）– 此进程所属的子集群 ID。 + `pid`（文本）– 后端进程 ID。 + `success`（布尔值）– 取消是否成功。 以下示例演示了如何使用 `limitless_cancel_session` 函数。 ``` SELECT * FROM rds_aurora.limitless_cancel_session('940CD5C81E3C796B'); subcluster_id | pid | success ---------------+-------+--------- 1 | 26920 | t (1 row) ``` **limitless\$1stat\$1clear\$1snapshot** `limitless_stat_clear_snapshot` 函数丢弃所有节点上的当前统计快照或缓存信息。 以下示例演示了如何使用 `limitless_stat_clear_snapshot` 函数。 ``` SELECT rds_aurora.limitless_stat_clear_snapshot(); ``` **limitless\$1stat\$1database\$1size** `limitless_stat_database_size` 函数返回数据库分片组中数据库的大小。 以下是输入参数： + `dbname`（名称）– 要获取其大小的数据库。 以下是输出参数： + `subcluster_id`（文本）– 此进程所属的子集群 ID。 + `subcluster_type`（文本）– 此进程所属的子集群的类型：`router` 或 `shard`。 + `db_size` – 此子集群中数据库的大小（以字节为单位）。 以下示例演示了如何使用 `limitless_stat_database_size` 函数。 ``` SELECT * FROM rds_aurora.limitless_stat_database_size('postgres_limitless'); subcluster_id | subcluster_type | db_size ---------------+-----------------+---------- 1 | router | 8895919 2 | router | 8904111 3 | shard | 21929391 4 | shard | 21913007 5 | shard | 21831087 (5 rows) ``` **limitless\$1stat\$1get\$1snapshot\$1timestamp** `limitless_stat_get_snapshot_timestamp` 函数返回当前统计快照的时间戳，如果没有拍摄统计快照，则返回 `NULL`。如果 `stats_fetch_consistency` 设置为 `snapshot`，则会在事务中首次访问累积统计数据时拍摄快照。返回所有节点快照时间戳的合并视图。`subcluster_id` 和 `subcluster_type` 列显示了数据来自哪个节点。 以下示例演示了如何使用 `limitless_stat_get_snapshot_timestamp` 函数。 ``` SELECT * FROM rds_aurora.limitless_stat_get_snapshot_timestamp(); subcluster_id | subcluster_type | snapshot_timestamp ---------------+-----------------+-------------------- 1 | router | 2 | router | 3 | shard | 4 | shard | 5 | shard | (5 rows) ``` **limitless\$1stat\$1prepared\$1xacts** `limitless_stat_prepared_xacts` 函数返回有关当前准备进行两阶段提交的所有节点上的事务信息。有关更多信息，请参阅 PostgreSQL 文档中的 [pg\$1prepared\$1xacts](https://www.postgresql.org/docs/current/view-pg-prepared-xacts.html)。 以下示例演示了如何使用 `limitless_stat_prepared_xacts` 函数。 ``` postgres_limitless=> SELECT * FROM rds_aurora.limitless_stat_prepared_xacts; subcluster_id | subcluster_type | transaction_id | gid | prepared | owner_id | database_id ---------------+-----------------+----------------+------------------------------+-------------------------------+------------+-------------------- 8 | shard | 5815978 | 7_4599899_postgres_limitless | 2024-09-03 15:51:17.659603+00 | auroraperf | postgres_limitless 12 | shard | 4599138 | 7_4599899_postgres_limitless | 2024-09-03 15:51:17.659637+00 | auroraperf | postgres_limitless (2 rows) ``` **limitless\$1stat\$1relation\$1sizes** `limitless_stat_relation_sizes` 函数返回数据库分片组中表的不同大小。 以下是输入参数： + `relnspname`（名称）– 包含表的架构名称。 + `relname`（名称）– 表的名称。 以下是输出参数： + `subcluster_id`（文本）– 此进程所属的子集群 ID。 + `subcluster_type`（文本）– 此进程所属的子集群的类型：`router` 或 `shard`。 + `main_size` – 此节点中主数据分叉的大小（以字节为单位）。 + `fsm_size` – 此节点中表的可用空间映射的大小（以字节为单位）。 + `vm_size` – 此节点中表的可见性映射的大小（以字节为单位）。 + `init_size` – 此节点中表的初始化大小（以字节为单位）。 + `toast_size` – 与该分叉中的表关联的 toast 表的大小（以字节为单位）。 + `index_size` – 此节点中表的所有索引的大小（以字节为单位）。 + `total_size` – 此节点中所有表段的大小（以字节为单位）。 以下示例演示如何使用 `limitless_stat_relation_sizes` 函数（省略了一些列）。 ``` SELECT * FROM rds_aurora.limitless_stat_relation_sizes('public','customers'); subcluster_id | subcluster_type | main_size | fsm_size | vm_size | toast_size | table_size | total_size ---------------+-----------------+-----------+----------+---------+------------+------------+------------ 1 | router | 0 | 0 | 0 | 0 | 0 | 0 2 | router | 0 | 0 | 0 | 0 | 0 | 0 3 | shard | 4169728 | 4177920 | 1392640 | 1392640 | 11132928 | 11132928 4 | shard | 4169728 | 4177920 | 1392640 | 1392640 | 11132928 | 11132928 5 | shard | 3981312 | 4227072 | 1409024 | 1409024 | 11026432 | 11026432 (5 rows) ``` **limitless\$1stat\$1reset** `limitless_stat_reset` 函数将当前数据库的所有统计计数器重置为零（0）。如果启用 `track_functions`，则 `limitless_stat_database` 中的 `stats_reset` 列将显示上次重置数据库统计信息的时间。默认情况下，`limitless_stat_reset` 只能由超级用户运行。其他用户可以使用 `EXECUTE` 权限获得权限。 以下示例演示了如何使用 `limitless_stat_reset` 函数。 ``` SELECT tup_inserted, tup_deleted FROM pg_stat_database WHERE datname = 'postgres_limitless'; tup_inserted | tup_deleted --------------+------------- 896 | 0 (1 row) SELECT rds_aurora.limitless_stat_reset(); limitless_stat_reset --------------------- (1 row) SELECT tup_inserted, tup_deleted FROM pg_stat_database WHERE datname = 'postgres_limitless'; tup_inserted | tup_deleted -------------+------------- 0 | 0 (1 row) ``` **limitless\$1stat\$1statements\$1reset** `limitless_stat_statements_reset` 函数丢弃 `limitless_stat_statements` 迄今为止收集到的与指定 `username`、`dbname`、`distributed_query_id` 和 `queryid` 参数相对应的统计数据。如果未指定任何参数，则将对每个参数使用默认值 `""` 或 `0`（无效），并重置与其他参数匹配的统计数据。如果未指定任何参数，或者所有指定的参数均为 `""` 或 `0`（无效），则该函数将丢弃所有统计数据。如果 `limitless_stat_statements` 视图中的所有统计数据都被丢弃，则该函数还会重置 `limitless_stat_statements_info` 视图中的统计数据。 以下是输入参数： + `username`（名称）– 查询语句的用户。 + `dbname`（名称）– 运行查询的数据库。 + `distributed_query_id`（bigint）– 来自协调器节点的父查询的查询 ID。如果是父查询，则此列为 `NULL`。协调器节点将分布式查询 ID 向下推送到参与者节点。因此，对于参与者节点，分布式查询 ID 和查询 ID 的值不同。 + `queryid`（bigint）– 语句的查询 ID。 以下示例说明如何使用 `limitless_stat_statements_reset` 函数重置 `limitless_stat_statements` 收集的所有统计数据。 ``` SELECT rds_aurora.limitless_stat_statements_reset(); ``` **limitless\$1stat\$1system\$1waits** `limitless_stat_system_waits` 函数返回来自 `aurora_stat_system_waits` 的等待事件数据的合并视图，该视图报告实例中来自所有节点的系统范围的等待活动。`subcluster_id` 和 `subcluster_type` 列显示了数据来自哪个节点。 以下示例演示了如何使用 `limitless_stat_system_waits` 函数。 ``` postgres_limitless=> SELECT * FROM rds_aurora.limitless_stat_system_waits() lssw, pg_catalog.aurora_stat_wait_event() aswe WHERE lssw.event_id=aswe.event_id and aswe.event_name='LimitlessTaskScheduler'; subcluster_id | subcluster_type | type_id | event_id | waits | wait_time | event_name ---------------+-----------------+---------+-----------+--------+--------------+------------------------ 1 | router | 12 | 201326607 | 677068 | 616942216307 | LimitlessTaskScheduler 2 | router | 12 | 201326607 | 678586 | 616939897111 | LimitlessTaskScheduler 3 | shard | 12 | 201326607 | 756640 | 616965545172 | LimitlessTaskScheduler 4 | shard | 12 | 201326607 | 755184 | 616958057620 | LimitlessTaskScheduler 5 | shard | 12 | 201326607 | 757522 | 616963183539 | LimitlessTaskScheduler (5 rows) ``` **limitless\$1terminate\$1session** `limitless_terminate_session` 函数的工作原理与 `pg_terminate_backend` 类似，但它尝试通过发送 `SIGTERM`（结束信号）来结束与提供的分布式会话 ID 相关的所有后端进程。 以下是输入参数： + `distributed_session_id`（文本）– 要结束的分布式会话的 ID。 以下是输出参数： + `subcluster_id`（文本）– 此进程所属的子集群 ID。 + `pid`（文本）– 后端进程 ID。 + `success`（布尔值）– 进程是否成功结束。 以下示例演示了如何使用 `limitless_terminate_session` 函数。 ``` SELECT * FROM rds_aurora.limitless_terminate_session('940CD5C81E3C796B'); subcluster_id | pid | success ---------------+-------+--------- 1 | 26920 | t (1 row) ``` **limitless\$1wait\$1report** `limitless_wait_report` 函数返回一段时间内所有节点的等待事件活动。`subcluster_id` 和 `subcluster_type` 列显示了数据来自哪个节点。 以下是输出参数： + `subcluster_id`（文本）– 此进程所属的子集群 ID。 + `subcluster_type`（文本）– 此进程所属的子集群的类型：`router` 或 `shard`。 其余各列与 `aurora_wait_report` 中的相同。 以下示例演示了如何使用 `limitless_wait_report` 函数。 ``` postgres_limitless=> select * from rds_aurora.limitless_wait_report(); subcluster_id | subcluster_type | type_name | event_name | waits | wait_time | ms_per_wait | waits_per_xact | ms_per_xact ---------------+-----------------+-----------+------------+-------+-----------+-------------+--------------- +------------- 1 | router | Client | ClientRead | 57 | 741550.14 | 13009.652 | 0.19 | 2505.237 5 | shard | Client | ClientRead | 54 | 738897.68 | 13683.290 | 0.18 | 2496.276 4 | shard | Client | ClientRead | 54 | 738859.53 | 13682.584 | 0.18 | 2496.147 2 | router | Client | ClientRead | 53 | 719223.64 | 13570.257 | 0.18 | 2429.810 3 | shard | Client | ClientRead | 54 | 461720.40 | 8550.378 | 0.18 | 1559.86 ``` # Aurora PostgreSQL Limitless Database 视图 下表列出了 Aurora PostgreSQL Limitless Database 的新视图。 **注意** 此表中列出的视图位于 `rds_aurora` 架构中。使用 Limitless Database 视图时，请确保包含完全限定的对象名称：`rds_aurora`.`object_name`。 | Aurora PostgreSQL Limitless Database 视图 | 对应的 Aurora PostgreSQL 视图 | | --- | --- | | [limitless\$1database](#limitless_database) | pg\$1database | | [limitless\$1locks](#limitless_locks) | pg\$1locks | | [limitless\$1stat\$1activity](#limitless_stat_activity) | pg\$1stat\$1activity | | [limitless\$1stat\$1all\$1indexes](#limitless_stat_all_indexes) | pg\$1stat\$1all\$1indexes | | [limitless\$1stat\$1all\$1tables](#limitless_stat_all_tables) | pg\$1stat\$1all\$1tables | | [limitless\$1stat\$1database](#limitless_stat_database) | pg\$1stat\$1database | | [limitless\$1stat\$1progress\$1vacuum](#limitless_stat_progress_vacuum) | pg\$1stat\$1progress\$1vacuum | | [limitless\$1stat\$1statements](#limitless_stat_statements) | pg\$1stat\$1statements | | [limitless\$1stat\$1subclusters](#limitless_stat_subclusters) | 无 | | [limitless\$1stat\$1statements\$1info](#limitless_stat_statements_info) | pg\$1stat\$1statements\$1info | | [limitless\$1statio\$1all\$1indexes](#limitless_statio_all_indexes) | pg\$1statio\$1all\$1indexes | | [limitless\$1statio\$1all\$1tables](#limitless_statio_all_tables) | pg\$1statio\$1all\$1tables | | [limitless\$1tables](#limitless_tables) | pg\$1tables | | [limitless\$1table\$1collocations](#limitless_table_collocations) | 无 | | [limitless\$1table\$1collocation\$1distributions](#limitless_table_collocation_distributions) | 无 | 以下示例提供了有关 Aurora PostgreSQL Limitless Database 视图的详细信息。有关 PostgreSQL 视图的更多信息，请参阅 PostgreSQL 文档中的 [Viewing statistics](https://www.postgresql.org/docs/15/monitoring-stats.html#MONITORING-STATS-VIEWS)。 **注意** 如果有正在进行的事务，某些统计数据视图可能会返回不一致的结果。 **limitless\$1database** 此视图包含有关数据库分片组中可用数据库的信息。例如： ``` postgres_limitless=> SELECT subcluster_id, subcluster_type, oid, datname, datacl FROM rds_aurora.limitless_database; subcluster_id | subcluster_type | oid | datname | datacl ---------------+-----------------+-------+--------------------+------------------------------------------------------------------------------------------------------------------------ 2 | router | 4 | template0 | {=c/rdsadmin,rdsadmin=CTc/rdsadmin} 2 | router | 5 | postgres | 2 | router | 16384 | rdsadmin | {rdsadmin=CTc/rdsadmin,rds_aurora_limitless_metadata_admin=c/rdsadmin,rds_aurora_limitless_heat_mgmt_admin=c/rdsadmin} 2 | router | 16477 | postgres_limitless | 2 | router | 1 | template1 | {=c/rdsadmin,rdsadmin=CTc/rdsadmin} 6 | shard | 4 | template0 | {=c/rdsadmin,rdsadmin=CTc/rdsadmin} ``` 以下是输出参数： + `subcluster_id`（文本）– 子集群（节点）的 ID + `subcluster_type`（文本）– 子集群（节点）、路由器或分片的类型 其余各列与 `pg_database` 中的相同。 **limitless\$1locks** 此视图包含每个节点上每个进程的一行。它提供对数据库服务器中活动进程持有的锁的相关信息的访问。 **Example 使用两个事务创建锁的示例** 在此示例中，我们在两台路由器上同时运行两个事务。 ``` # Transaction 1 (run on router 1) BEGIN; SET search_path = public; SELECT * FROM customers; INSERT INTO customers VALUES (400,'foo','bar'); # Transaction 2 (run on router 2) BEGIN; SET search_path = public; ALTER TABLE customers ADD COLUMN phone VARCHAR; ``` 第一个事务已开始运行。后续事务必须等到第一个事务完成。因此，第二个事务被锁屏蔽。为了检查其根本原因，我们运行一条命令，将 `limitless_locks` 与 `limitless_stat_activity` 连接起来。 ``` # Run on router 2 SELECT distributed_session_id, state, usename, query, query_start FROM rds_aurora.limitless_stat_activity WHERE distributed_session_id in ( SELECT distributed_session_id FROM rds_aurora.limitless_locks WHERE relname = 'customers' ); distributed_session_id | state | usename | query | query_start ------------------------+---------------------+--------------------------+---------------------------------- -------------+------------------------------- 47BDE66E9A5E8477 | idle in transaction | limitless_metadata_admin | INSERT INTO customers VALUES (400,'foo','bar'); | 2023-04-13 17:44:45.152244+00 2AD7F370202D0FA9 | active | limitless_metadata_admin | ALTER TABLE customers ADD COLUMN phone VARCHAR; | 2023-04-13 17:44:55.113388+00 47BDE66E9A5E8477 | | limitless_auth_admin | | 2AD7F370202D0FA9 | | limitless_auth_admin | | 47BDE66E9A5E8477 | | limitless_auth_admin | | 2AD7F370202D0FA9 | | limitless_auth_admin | | (6 rows) ``` **Example 显式创建锁示例** 在此示例中，我们显式创建了一个锁，然后使用 `limitless_locks` 视图来查看锁（省略了某些列）。 ``` BEGIN; SET search_path = public; LOCK TABLE customers IN ACCESS SHARE MODE; SELECT * FROM rds_aurora.limitless_locks WHERE relname = 'customers'; subcluster_id | subcluster_type | distributed_session_id | locktype | datname | relnspname | relname | virtualtransaction | pid | mode ---------------+-----------------+------------------------+----------+--------------------+------------+ ----------+--------------------+-------+----------------- 1 | router | 7207702F862FC937 | relation | postgres_limitless | public | customers | 28/600787 | 59564 | AccessShareLock 2 | router | 7207702F862FC937 | relation | postgres_limitless | public | customers | 28/600405 | 67130 | AccessShareLock 3 | shard | 7207702F862FC937 | relation | postgres_limitless | public | customers | 15/473401 | 27735 | AccessShareLock 4 | shard | 7207702F862FC937 | relation | postgres_limitless | public | customers | 13/473524 | 27734 | AccessShareLock 5 | shard | 7207702F862FC937 | relation | postgres_limitless | public | customers | 13/472935 | 27737 | AccessShareLock 6 | shard | 7207702F862FC937 | relation | postgres_limitless | public | customers | 13/473015 | 48660 | AccessShareLock (6 rows) ``` **limitless\$1stat\$1activity** 此视图包含每个节点上每个进程的一行。它可用于跟踪整个系统的运行状况，并对耗时较长的流程进行分类。例如： ``` postgres=# SELECT subcluster_id, subcluster_type, distributed_session_id, distributed_session_state, datname, distributed_query_id, is_sso_query FROM rds_aurora.limitless_stat_activity WHERE distributed_session_id in ('D2470C97E3D07E06', '5A3CD7B8E5FD13FF') order by distributed_session_id; subcluster_id | subcluster_type | distributed_session_id | distributed_session_state | datname | distributed_query_id | is_sso_query ---------------+-----------------+------------------------+---------------------------+--------------------+----------------------+-------------- 2 | router | 5A3CD7B8E5FD13FF | coordinator | postgres_limitless | | f 3 | shard | 5A3CD7B8E5FD13FF | participant | postgres_limitless | 6808291725541680947 | 4 | shard | 5A3CD7B8E5FD13FF | participant | postgres_limitless | 6808291725541680947 | 2 | router | D2470C97E3D07E06 | coordinator | postgres_limitless | | t 3 | shard | D2470C97E3D07E06 | participant | postgres_limitless | 4058400544464210222 | (5 rows) ``` 以下是输出参数： + `subcluster_id`（文本）– 此进程所属的子集群 ID。 + `subcluster_type`（文本）– 此进程所属的子集群的类型：`router` 或 `shard`。 + `distributed_session_id`（文本）– 此进程所属的分布式会话的 ID。 + `distributed_session_state`（文本）– 这是协调器进程、参与者进程还是独立/非分布式进程（显示为 `NULL`）。 + `datname`（文本）– 此进程所连接的数据库。 + `distributed_query_id`（bigint）– 来自协调器节点的父查询的查询 ID。如果是父查询，则此列为 `NULL`。协调器节点将分布式查询 ID 向下推送到参与者节点。因此，对于参与者节点，分布式查询 ID 和查询 ID 的值不同。 + `is_sso_query`（文本）：这可以让我们知道查询是否经过单分片优化。 其余各列与 `pg_stat_activity` 中的相同。 **limitless\$1stat\$1all\$1indexes** 此视图包含数据库分片组中索引的使用情况统计数据。例如： ``` postgres_limitless=> SELECT schemaname, relname, indexrelname, idx_scan FROM rds_aurora.limitless_stat_all_indexes WHERE relname LIKE 'orders_ts%' ORDER BY indexrelname LIMIT 10; schemaname | relname | indexrelname | idx_scan ------------+----------------+---------------------+---------- ec_sample | orders_ts00001 | orders_ts00001_pkey | 196801 ec_sample | orders_ts00002 | orders_ts00002_pkey | 196703 ec_sample | orders_ts00003 | orders_ts00003_pkey | 196376 ec_sample | orders_ts00004 | orders_ts00004_pkey | 197966 ec_sample | orders_ts00005 | orders_ts00005_pkey | 195301 ec_sample | orders_ts00006 | orders_ts00006_pkey | 195673 ec_sample | orders_ts00007 | orders_ts00007_pkey | 194475 ec_sample | orders_ts00008 | orders_ts00008_pkey | 191694 ec_sample | orders_ts00009 | orders_ts00009_pkey | 193744 ec_sample | orders_ts00010 | orders_ts00010_pkey | 195421 (10 rows) ``` **limitless\$1stat\$1all\$1tables** 此视图包含数据库分片组中当前数据库中所有表的统计数据。这在跟踪清理操作和数据操纵语言（DML）操作时很有用。例如： ``` postgres_limitless=> SELECT subcluster_id, subcluster_type, relname, n_ins_since_vacuum, n_tup_ins, last_vacuum FROM rds_aurora.limitless_stat_all_tables WHERE relname LIKE 'orders_ts%' ORDER BY relname LIMIT 10; subcluster_id | subcluster_type | relname | n_ins_since_vacuum | n_tup_ins | last_vacuum ---------------+-----------------+----------------+--------------------+-----------+------------- 5 | shard | orders_ts00001 | 34779 | 196083 | 5 | shard | orders_ts00002 | 34632 | 194721 | 5 | shard | orders_ts00003 | 34950 | 195965 | 5 | shard | orders_ts00004 | 34745 | 197283 | 5 | shard | orders_ts00005 | 34879 | 195754 | 5 | shard | orders_ts00006 | 34340 | 194605 | 5 | shard | orders_ts00007 | 33779 | 192203 | 5 | shard | orders_ts00008 | 33826 | 191293 | 5 | shard | orders_ts00009 | 34660 | 194117 | 5 | shard | orders_ts00010 | 34569 | 195560 | (10 rows) ``` 以下是输出参数： + `subcluster_id`（文本）– 此进程所属的子集群 ID。 + `subcluster_type`（文本）– 此进程所属的子集群的类型：`router` 或 `shard`。 + `relname`（名称）– 表的名称。 其余各列与 `pg_stat_all_tables` 中的相同。 **limitless\$1stat\$1database** 此视图包含数据库分片组中所有数据库的统计数据。每个节点的每个数据库返回一行。例如： ``` postgres_limitless=> SELECT subcluster_id, subcluster_type, datname, blks_read, blks_hit FROM rds_aurora.limitless_stat_database WHERE datname='postgres_limitless'; subcluster_id | subcluster_type | datname | blks_read | blks_hit ---------------+-----------------+--------------------+-----------+---------- 1 | router | postgres_limitless | 484 | 34371314 2 | router | postgres_limitless | 673 | 33859317 3 | shard | postgres_limitless | 1299 | 17749550 4 | shard | postgres_limitless | 1094 | 17492849 5 | shard | postgres_limitless | 1036 | 17485098 6 | shard | postgres_limitless | 1040 | 17437257 (6 rows) ``` 以下是输出参数： + `subcluster_id`（文本）– 此进程所属的子集群 ID。 + `subcluster_type`（文本）– 此进程所属的子集群的类型：`router` 或 `shard`。 + `datname`（文本）– 数据库的名称。 其余各列与 `pg_stat_database` 中的相同。 **limitless\$1stat\$1progress\$1vacuum** 此视图包含有关正在进行的清理操作的信息。例如： ``` postgres_limitless=> SELECT * FROM rds_aurora.limitless_stat_progress_vacuum; -[ RECORD 1 ]----------+------------------ subcluster_id | 3 subcluster_type | shard distributed_session_id | A56D96E2A5C9F426 pid | 5270 datname | postgres nspname | public relname | customer_ts2 phase | vacuuming heap heap_blks_total | 130500 heap_blks_scanned | 100036 heap_blks_vacuumed | 0 index_vacuum_count | 0 max_dead_tuples | 11184810 num_dead_tuples | 0 -[ RECORD 2 ]----------+------------------ subcluster_id | 3 subcluster_type | shard distributed_session_id | 56DF26A89EC23AB5 pid | 6854 datname | postgres nspname | public relname | sales_ts1 phase | vacuuming heap heap_blks_total | 43058 heap_blks_scanned | 24868 heap_blks_vacuumed | 0 index_vacuum_count | 0 max_dead_tuples | 8569523 num_dead_tuples | 0 ``` 以下是输出参数： + `subcluster_id`（文本）– 此进程所属的子集群 ID。 + `subcluster_type`（文本）– 此进程所属的子集群的类型：`router` 或 `shard`。 + `distributed_session_id`（文本）– 启动清理操作的会话的标识符。 + `datname`（名称）– 正在进行清理的数据库。 + `nspname`（名称）– 正在清理的表的架构名称。如果被清理的表与用户连接的表不在同一个数据库中，则为 `null`。 + `relname`（名称）– 正在清理的表的名称。如果被清理的表与用户连接的表不在同一个数据库中，则为 `null`。 其余各列与 `pg_stat_progress_vacuum` 中的相同。 **limitless\$1stat\$1statements** 此视图提供了一种跟踪在所有节点上运行的所有 SQL 语句的规划和运行统计数据的方法。 必须安装 [pg\$1stat\$1statements](https://www.postgresql.org/docs/current/pgstatstatements.html) 扩展程序才能使用 `limitless_stat_statements` 视图。 ``` -- CREATE EXTENSION must be run by a superuser CREATE EXTENSION pg_stat_statements; -- Verify that the extension is created on all nodes in the DB shard group SELECT distinct node_id FROM rds_aurora.limitless_stat_statements LIMIT 10; ``` 以下示例说明了 `limitless_stat_statements` 视图的用法。 ``` postgres_limitless=> SELECT subcluster_id, subcluster_type, distributedqueryid, username, dbname, sso_calls FROM rds_aurora.limitless_stat_statements; subcluster_id | subcluster_type | distributedqueryid | username | dbname | sso_calls ---------------+-----------------+----------------------+-------------------------------------+--------------------+----------- 2 | router | | postgres | postgres_limitless | 0 2 | router | | postgres | postgres_limitless | 0 2 | router | | postgres | postgres_limitless | 0 2 | router | | postgres | postgres_limitless | 0 2 | router | | postgres | postgres_limitless | 0 2 | router | | postgres | postgres_limitless | 1 3 | shard | -7975178695405682176 | postgres | postgres_limitless | [...] ``` 以下是输出参数： + `subcluster_id`（文本）– 此进程所属的子集群 ID。 + `subcluster_type`（文本）– 此进程所属的子集群的类型：`router` 或 `shard`。 + `distributedqueryid`（bigint）– 来自协调器节点的父查询的查询 ID。如果是父查询，则此列为 `NULL`。协调器节点将分布式查询 ID 向下推送到参与者节点。因此，对于参与者节点，分布式查询 ID 和查询 ID 的值不同。 + `username`（名称）– 查询语句的用户。 + `dbname`（名称）– 运行查询的数据库。 + `sso_calls`（名称）：已对语句执行单分片优化的次数。 其余列与 [pg\$1stat\$1statements](https://www.postgresql.org/docs/current/pgstatstatements.html) 中的列相同。 **limitless\$1stat\$1statements\$1info** 此视图包含 `limitless_stat_statements` 视图的统计数据。每行都包含来自每个节点的 [pg\$1stat\$1statements\$1info](https://www.postgresql.org/docs/current/pgstatstatements.html#id-1.11.7.41.7) 视图的数据。`subcluster_id` 列标识每个节点。 ``` postgres_limitless=> SELECT * FROM rds_aurora.limitless_stat_statements_info; subcluster_id | subcluster_type | dealloc | stats_reset ---------------+-----------------+---------+------------------------------- 1 | router | 0 | 2023-06-30 21:22:09.524781+00 2 | router | 0 | 2023-06-30 21:21:40.834111+00 3 | shard | 0 | 2023-06-30 21:22:10.709942+00 4 | shard | 0 | 2023-06-30 21:22:10.740179+00 5 | shard | 0 | 2023-06-30 21:22:10.774282+00 6 | shard | 0 | 2023-06-30 21:22:10.808267+00 (6 rows) ``` 以下是输出参数： + `subcluster_id`（文本）– 此进程所属的子集群 ID。 其余列与 [pg\$1stat\$1statements\$1info](https://www.postgresql.org/docs/current/pgstatstatements.html#id-1.11.7.41.7) 中的列相同。 **limitless\$1stat\$1subclusters** 此视图包含路由器与其他节点之间的网络统计数据。它包含每对路由器和其他节点的一行，例如： ``` postgres_limitless=> SELECT * FROM rds_aurora.limitless_stat_subclusters; orig_subcluster | orig_instance_az | dest_subcluster | dest_instance_az | latency_us | latest_collection | failed_requests | received_bytes | sent_bytes | same_az_requests | cross_az_requests | stat_reset_timestamp -----------------+------------------+-----------------+------------------+------------+-------------------------------+-----------------+----------------+------------+------------------+-------------------+------------------------------- 3 | us-west-2b | 2 | us-west-2a | 847 | 2024-10-07 17:25:39.518617+00 | 0 | 35668633 | 92090171 | 0 | 302787 | 2024-10-05 12:39:55.239675+00 3 | us-west-2b | 4 | us-west-2b | 419 | 2024-10-07 17:25:39.546376+00 | 0 | 101190464 | 248795719 | 883478 | 0 | 2024-10-05 12:39:55.231218+00 3 | us-west-2b | 5 | us-west-2c | 1396 | 2024-10-07 17:25:39.52122+00 | 0 | 72864849 | 172086292 | 0 | 557726 | 2024-10-05 12:39:55.196412+00 3 | us-west-2b | 6 | us-west-2c | 729 | 2024-10-07 17:25:39.54828+00 | 0 | 35668584 | 92090171 | 0 | 302787 | 2024-10-05 12:39:55.247334+00 3 | us-west-2b | 7 | us-west-2a | 1702 | 2024-10-07 17:25:39.545307+00 | 0 | 71699576 | 171634844 | 0 | 556278 | 2024-10-05 12:39:52.715168+00 2 | us-west-2a | 3 | us-west-2b | 868 | 2024-10-07 17:25:40.293927+00 | 0 | 35659611 | 92011872 | 0 | 302817 | 2024-10-05 12:39:54.420758+00 2 | us-west-2a | 4 | us-west-2b | 786 | 2024-10-07 17:25:40.296863+00 | 0 | 102437253 | 251838024 | 0 | 895060 | 2024-10-05 12:39:54.404081+00 2 | us-west-2a | 5 | us-west-2c | 1232 | 2024-10-07 17:25:40.292021+00 | 0 | 71990027 | 168828110 | 0 | 545453 | 2024-10-05 12:39:36.769549+00 ``` 以下是输出参数： + `orig_subcluster`（文本）– 发起通信的路由器 ID + `orig_subcluster_az`（文本）– 发起方路由器的可用区（AZ） + `dest_subcluster`（文本）– 目标节点的 ID + `dest_subcluster_az`（文本）– 目标节点上次收集的可用区 + `latency_us`（bigint）– 上次收集的节点间网络延迟，以微秒为单位。如果无法访问该节点，则该值为 `0`。 + `latest_collection`（时间戳）– 最新可用区集合的时间戳和目标节点的延迟 + `failed_requests`（bigint）– 失败的内部请求的累积计数 + `received_bytes`（bigint）– 从该节点接收到的估计累积字节数 + `sent_bytes`（bigint）– 发送到该节点的估计累积字节数 + `same_az_requests`（bigint）– 当该节点与发起方路由器位于同一可用区时，向该节点发出的内部数据库请求的累积数量 + `cross_az_requests`（bigint）– 当该节点与发起方路由器位于不同可用区时，向该节点发出的内部数据库请求的累积数量 + `stat_reset_timestamp`（时间戳）-上次重置此视图的累积统计数据的时间戳 **limitless\$1statio\$1all\$1indexes** 此视图包含数据库分片组中所有索引的输入/输出（I/O）统计数据。例如： ``` postgres_limitless=> SELECT * FROM rds_aurora.limitless_statio_all_indexes WHERE relname like'customers_ts%'; subcluster_id | subcluster_type | schemaname | relname | indexrelname | idx_blks_read | idx_blks_hit ---------------+-----------------+------------+-------------------+-------------------------------------+ --------------+-------------- 3 | shard | public | customers_ts00002 | customers_ts00002_customer_name_idx | 1 | 0 3 | shard | public | customers_ts00001 | customers_ts00001_customer_name_idx | 1 | 0 4 | shard | public | customers_ts00003 | customers_ts00003_customer_name_idx | 1 | 0 4 | shard | public | customers_ts00004 | customers_ts00004_customer_name_idx | 1 | 0 5 | shard | public | customers_ts00005 | customers_ts00005_customer_name_idx | 1 | 0 5 | shard | public | customers_ts00006 | customers_ts00006_customer_name_idx | 1 | 0 6 | shard | public | customers_ts00007 | customers_ts00007_customer_name_idx | 1 | 0 6 | shard | public | customers_ts00008 | customers_ts00008_customer_name_idx | 1 | 0 (8 rows) ``` **limitless\$1statio\$1all\$1tables** 此视图包含数据库分片组中所有表的输入/输出（I/O）统计数据。例如： ``` postgres_limitless=> SELECT subcluster_id, subcluster_type, schemaname, relname, heap_blks_read, heap_blks_hit FROM rds_aurora.limitless_statio_all_tables WHERE relname LIKE 'customers_ts%'; subcluster_id | subcluster_type | schemaname | relname | heap_blks_read | heap_blks_hit ---------------+-----------------+------------+-------------------+----------------+--------------- 3 | shard | public | customers_ts00002 | 305 | 57780 3 | shard | public | customers_ts00001 | 300 | 56972 4 | shard | public | customers_ts00004 | 302 | 57291 4 | shard | public | customers_ts00003 | 302 | 57178 5 | shard | public | customers_ts00006 | 300 | 56932 5 | shard | public | customers_ts00005 | 302 | 57386 6 | shard | public | customers_ts00008 | 300 | 56881 6 | shard | public | customers_ts00007 | 304 | 57635 (8 rows) ``` **limitless\$1tables** 此视图包含有关 Aurora PostgreSQL Limitless Database 中表的信息。 ``` postgres_limitless=> SELECT * FROM rds_aurora.limitless_tables; table_gid | local_oid | schema_name | table_name | table_status | table_type | distribution_key -----------+-----------+-------------+-------------+--------------+-------------+------------------ 5 | 18635 | public | placeholder | active | placeholder | 6 | 18641 | public | ref | active | reference | 7 | 18797 | public | orders | active | sharded | HASH (order_id) 2 | 18579 | public | customer | active | sharded | HASH (cust_id) (4 rows) ``` **limitless\$1table\$1collocations** 此视图包含有关并置的分片表的信息。 在以下示例中，`orders` 和 `customers` 表并置，`users` 和 `followers` 表并置。并置的表具有相同的 `collocation_id`。 ``` postgres_limitless=> SELECT * FROM rds_aurora.limitless_table_collocations ORDER BY collocation_id; collocation_id | schema_name | table_name ----------------+-------------+------------ 2 | public | orders 2 | public | customers 5 | public | users 5 | public | followers (4 rows) ``` **limitless\$1table\$1collocation\$1distributions** 此视图显示了每个并置的密钥分配几率。 ``` postgres_limitless=> SELECT * FROM rds_aurora.limitless_table_collocation_distributions ORDER BY collocation_id, lower_bound; collocation_id | subcluster_id | lower_bound | upper_bound ----------------+---------------+----------------------+---------------------- 2 | 6 | -9223372036854775808 | -4611686018427387904 2 | 5 | -4611686018427387904 | 0 2 | 4 | 0 | 4611686018427387904 2 | 3 | 4611686018427387904 | 9223372036854775807 5 | 6 | -9223372036854775808 | -4611686018427387904 5 | 5 | -4611686018427387904 | 0 5 | 4 | 0 | 4611686018427387904 5 | 3 | 4611686018427387904 | 9223372036854775807 (8 rows) ```