类别：

Information Schema、表函数

REPLICATION_GROUP_USAGE_HISTORY

返回过去 14 天内辅助复制组或故障转移组的复制使用历史记录。

语法

REPLICATION_GROUP_USAGE_HISTORY(
   [ DATE_RANGE_START => <constant_expr> ]
   [, DATE_RANGE_END => <constant_expr> ]
   [, REPLICATION_GROUP_NAME => '<string>' ] )
Copy

实参

所有实参均为可选。

DATE_RANGE_START => constant_expr、. DATE_RANGE_END => constant_expr

用于检索数据加载历史的日期/时间范围，限定在过去 2 周内。

  • 如果未指定结束日期，则会将 CURRENT_TIMESTAMP 用作范围的结束日期。

  • 如果未指定开始日期，则该范围在 DATE_RANGE_END 之前 12 小时开始

REPLICATION_GROUP_NAME => string

指定复制组或故障转移组的字符串。仅返回指定组的复制操作。

输出

该函数返回以下列：

列名称

数据类型

描述

START_TIME

TIMESTAMP_LTZ

指定时间范围的开始时间。

END_TIME

TIMESTAMP_LTZ

指定时间范围的结束时间。

REPLICATION_GROUP_NAME

TEXT

复制组的名称。

CREDITS_USED

TEXT

在 START_TIME 和 END_TIME 窗口内为复制计费的 Credit。

BYTES_TRANSFERRED

NUMBER

在 START_TIME 和 END_TIME 窗口期间为复制传输的字节数。

使用说明

  • 仅为 ACCOUNTADMIN 角色或任何已明确授予 MONITOR USAGE 全局权限的角色返回结果。

  • 仅返回当前账户中辅助复制或故障转移组的结果。

  • 当调用 Information Schema 表函数时，会话必须具有正在使用的 INFORMATION_SCHEMA 架构，或者 函数名称必须受到完全限定。有关更多详细信息，请参阅 Snowflake Information Schema。

示例

检索过去 7 天的复制使用历史记录：

SELECT START_TIME, END_TIME, REPLICATION_GROUP_NAME, CREDITS_USED, BYTES_TRANSFERRED
  FROM TABLE(information_schema.replication_group_usage_history(date_range_start=>dateadd('day', -7, current_date())));
Copy

检索复制组 myrg 过去 7 天的复制使用历史记录：

SELECT START_TIME, END_TIME, REPLICATION_GROUP_NAME, CREDITS_USED, BYTES_TRANSFERRED
  FROM TABLE(information_schema.replication_group_usage_history(
    date_range_start => dateadd('day', -7, current_date()),
    replication_group_name => 'myrg'
));
Copy
语言: 中文