管理物化视图

权限要求

物化视图的SELECT权限。如无权限，则需要高权限账号或具备GRANT权限的普通账号通过控制台账号管理页面或SQL语句GRANT SELECT ON database.mv_name TO username;为您的账号授权。

语法

SHOW CREATE MATERIALIZED VIEW <mv_name>

示例

查询创建物化视图compl_mv1的DDL语句。

SHOW CREATE MATERIALIZED VIEW demo.compl_mv1;

统计整个集群有多少张物化视图

SELECT count(*) FROM information_schema.mv_info;

查询所有物化视图的元信息

SELECT * FROM information_schema.mv_info;

权限要求

指定数据库所有物化视图的SELECT权限。如无权限，则需要高权限账号或具备GRANT权限的普通账号通过控制台账号管理页面或SQL语句GRANT SELECT ON database.* TO username;为您的账号授权。

语法

查询当前数据库中的所有物化视图：

SHOW MATERIALIZED VIEWS [LIKE 'pattern']

查询某个数据库（可以是非当前所在的数据库）中的所有物化视图：

SELECT * FROM information_schema.mv_info WHERE mv_schema='schema_name';

示例

• 查询当前数据库中所有的物化视图。

  SHOW MATERIALIZED VIEWS;

• 查询当前数据库中名称以compl开头的所有物化视图。

  SHOW MATERIALIZED VIEWS LIKE 'compl%';

  LIKE 'pattern'的用法，请参见字符串函数。

• 查询demo数据库中的所有物化视图。

  SELECT * FROM information_schema.mv_info WHERE mv_schema='demo';

查询自动刷新记录

通过下列SQL查询指定物化视图的自动刷新记录，包括刷新的开始时间（START_TIME）、结束时间（END_TIME）、状态（STATE）、查询ID（PROCESS_ID）。

SELECT * FROM information_schema.mv_auto_refresh_jobs WHERE mv_schema='<schema_name>' AND mv_name = '<mv_name>';

information_schema.mv_auto_refresh_jobs存储了物化视图的自动刷新任务记录，最多保留1024条记录。仅定时自动刷新（配置了START WITH或NEXT参数）的物化视图才会出现在这张表里。

information_schema.mv_auto_refresh_jobs不包含创建物化视图时的第一次刷新记录。

示例：

查询demo数据库中名为compl_mv1的物化视图的所有刷新记录。

SELECT * FROM information_schema.mv_auto_refresh_jobs WHERE mv_schema = 'demo' AND mv_name = 'compl_mv1';

查询demo数据库中名为compl_mv1的物化视图的最近一次pending状态的刷新任务。

SELECT * FROM information_schema.mv_auto_refresh_jobs WHERE mv_schema = 'demo' AND mv_name = 'compl_mv1' AND state = 'PENDING';

常用字段解释：

查询手动刷新记录

• 查询过去30天的物化视图手动刷新记录，可以使用SQL审计功能。查询时，输入关键字REFRESH MATERIALIZED VIEW mv_name，可查询手动刷新的时间、时长、IP、用户名等信息。

  SQL审计功能需单独开通。开通前的SQL操作，不会记录在审计日志中。

  

• 查询过去14天的物化视图手动刷新记录和自动刷新记录，可以使用SQL诊断优化功能。查询时，输入物化视图的名称，例如compl_mv1，可查询该物化视图的所有相关SQL查询（包括创建、手动刷新、自动刷新、变更等）的开始时间、用户名、耗时、查询ID等。

  

权限要求

物化视图的ALTER权限。如无权限，则需要高权限账号或具备GRANT权限的普通账号通过控制台账号管理页面或SQL语句GRANT ALTER ON database.mv_name TO username;为您的账号授权。

语法

ALTER MATERIALIZED VIEW <mv_name>
[MV_PROPERTIES=<MV_PROPERTIES>]
[ENABLE|DISABLE QUERY REWRITE]

• MV_PROPERTIES：物化视图的属性，包括mv_resource_group和mv_refresh_hints参数。

  mv_resource_group：指定物化视图所使用的资源组。若指定的资源组不存在，创建物化视图时会报错。

  mv_refresh_hints：设置物化视图的参数。支持的配置参数详情，请参见常用Hint。

  重要

  ALTER语句中配置的<MV_PROPERTIES>属性会整体覆盖创建物化视图时配置的<MV_PROPERTIES>属性。

  例如：创建物化视图时同时配置了mv_resource_group和mv_refresh_hints参数，ALTER语句中仅配置mv_resource_group参数，执行该语句后，mv_resource_group参数被修改，mv_refresh_hints参数会被清除。

• ENABLE|DISABLE QUERY REWRITE：开启或关闭查询改写功能。

示例

• 开启物化视图compl_mv1的查询改写功能。

  ALTER MATERIALIZED VIEW compl_mv1 ENABLE QUERY REWRITE;

• 变更弹性物化视图job_mv所使用的资源组。

  ALTER MATERIALIZED VIEW job_mv 
  MV_PROPERTIES='{
    "mv_resource_group":"my_job_rg_2",
    "mv_refresh_hints":{"query_priority":"NORMAL"}
  }';

• 变更普通物化视图compl_mv1为弹性物化视图。

  ALTER MATERIALIZED VIEW compl_mv1 
  MV_PROPERTIES='{
    "mv_resource_group":"my_job_rg_2"
  }';

权限要求

物化视图的DROP权限。如无权限，则需要高权限账号或具备GRANT权限的普通账号通过控制台账号管理页面或SQL语句GRANT DROP ON database.mv_name TO username;为您的账号授权。

语法

DROP MATERIALIZED VIEW <mv_name>

示例

删除物化视图compl_mv1。

DROP MATERIALIZED VIEW compl_mv1;