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

时间:2024-11-28 17:38:53

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指定的视图相同。

      示例:

      1
      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.”。
support.huaweicloud.com/sqlreference-830-dws/dws_06_0062.html