数据仓库服务 GaussDB(DWS)-其它函数:wdr_xdb_query(db_name text, snapshot_id bigint, view_name text)

时间：2023-11-01 16:20:15

wdr_xdb_query(db_name text, snapshot_id bigint, view_name text)

描述：查询指定数据库下的指定视图。有的视图在不同数据库中查询结果不同，例如global_table_stat视图用于查询表格的统计信息，由于不同数据库下表格不同，在不同数据库中查询该视图得到的结果也不同。wdr_xdb_query函数可以在当前连接中访问db_name指定的数据库，并在该数据库中查询view_name指定的视图。输入参数含义如下：

db_name：指定的数据库名称，text型。
snapshot_id：快照ID，bigint型，参见“性能视图快照”。
view_name：指定视图名称，text型。视图名称必须在如下白名单中：
- global_table_stat
- global_table_change_stat
- global_column_table_io_stat
- global_row_table_io_stat
  返回值类型：record，其第一列为snapshot_id bigint，第二列为db_name text，其他列的名称、类型和顺序与view_name指定的视图相同。
  示例：select snapshot_id, db_name, schemaname, relname, distribute_mode, seq_scan ,seq_tuple_read ,index_scan ,index_tuple_read ,tuple_inserted
  ,tuple_updated ,tuple_deleted ,tuple_hot_updated ,live_tuples ,dead_tuples from wdr_xdb_query('postgres'::text, 1, 'global_table_stat'::text) as i(snapshot_id bigint, db_name text, schemaname name, relname name, distribute_mode char, seq_scan bigint, seq_tuple_read bigint, index_scan bigint, index_tuple_read bigint, tuple_inserted bigint, tuple_updated bigint, tuplee_deleted bigint, tuple_hot_updated bigint, live_tuples bigint, dead_tuples bigint);
  - 该函数仅8.1.2及以上版本支持。
  - 该函数只有数据库管理员SYSADMIN才有权执行，非管理员执行会提示无权限。
  - 该函数只能查询白名单中的视图，如果查询其他视图，会报错：“Input view name is invalid.”。