架构：

ACCOUNT_USAGE

TABLE_DML_HISTORY 视图

此 Account Usage 视图可用于确定对表执行的 DML 操作的大小和效果。请注意，这些 DML 操作包括由 :doc:` Snowpipe </user-guide/data-load-snowpipe-intro>` 启动的操作，但不包括由后台维护服务（例如 自动群集、物化视图维护和 搜索优化）启动的操作。

您可以使用 QUERY_HISTORY 视图 和 LOAD_HISTORY 视图 查询此视图，以确定有重大影响的 DML 操作。这可以帮助您确定优化机会。

此外，您可以使用 AUTOMATIC_CLUSTERING_HISTORY 视图 和 SEARCH_OPTIMIZATION_HISTORY 视图 查询此视图，以可视化这些 DML 操作与自动群集和搜索优化服务所收取的 Credit 之间的关系。（这些服务可以通过 DML 操作触发。）

列

列名称

数据类型

描述

START_TIME

TIMESTAMP_LTZ

执行 DML 操作的时间范围（以小时为单位）的开始时间。

END_TIME

TIMESTAMP_LTZ

执行 DML 操作的时间范围（以小时为单位）的结束时间。

TABLE_ID

NUMBER

DML 操作修改的表的内部/系统生成的标识符。

TABLE_NAME

VARCHAR

DML 操作修改的表的名称。

SCHEMA_ID

NUMBER

包含 DML 操作修改的表的架构的内部/系统生成的标识符。

SCHEMA_NAME

VARCHAR

包含 DML 操作修改的表的架构的名称。

DATABASE_ID

NUMBER

包含 DML 操作修改的表的数据库的内部/系统生成的标识符。

DATABASE_NAME

VARCHAR

包含 DML 操作修改的表的数据库的名称。

ROWS_ADDED

NUMBER

START_TIME 到 END_TIME 窗口期间，用户通过对表执行 DML 操作添加的行数。

ROWS_REMOVED

NUMBER

START_TIME 到 END_TIME 窗口期间，用户通过对表执行 DML 操作移除的行数。

ROWS_UPDATED

NUMBER

START_TIME 到 END_TIME 窗口期间，用户通过对表执行 DML 操作更新的行数。

使用说明

  • 视图的延迟时间最长可达 6 小时。

  • 此视图不包括对 混合表 进行的 DML 操作。

示例

以下示例返回过去七天内，通过 DML 操作添加、移除和更新行数最多的前五个表。

SELECT
    table_id,
    ANY_VALUE(table_name) AS table_name,
    SUM(rows_added) AS total_rows_added,
    SUM(rows_removed) AS total_rows_removed,
    SUM(rows_updated) AS total_rows_updated
  FROM SNOWFLAKE.ACCOUNT_USAGE.TABLE_DML_HISTORY
  WHERE start_time >= DATEADD(day, -7, CURRENT_TIMESTAMP())
  GROUP BY table_id
  ORDER BY total_rows_added + total_rows_removed + total_rows_updated DESC
  LIMIT 5;

+----------+----------------------+------------------+--------------------+--------------------+
| TABLE_ID | TABLE_NAME           | TOTAL_ROWS_ADDED | TOTAL_ROWS_REMOVED | TOTAL_ROWS_UPDATED |
|----------+----------------------+------------------+--------------------+--------------------|
|   338948 | SENSOR_DATA_TS       |          5356800 |             259200 |                  0 |
|   338950 | SENSOR_DATA_DEVICE2  |          2678400 |                  0 |                  0 |
|   341006 | SENSOR_DATA_30_ROWS  |               30 |                  0 |                  0 |
|   341004 | SENSOR_DATA_12_HOURS |               12 |                  0 |                  0 |
|   340005 | SENSOR_DATA_12_HOURS |               12 |                  0 |                  0 |
+----------+----------------------+------------------+--------------------+--------------------+