类别：: Information Schema、表函数

REPLICATION_GROUP_REFRESH_HISTORY¶

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

另请参阅：: REPLICATION_GROUP_REFRESH_HISTORY 视图

语法¶

REPLICATION_GROUP_REFRESH_HISTORY( '<secondary_group_name>' )

Copy

实参¶

secondary_group_name: 辅助组的名称。请注意，整个名称必须放在单引号内。

输出¶

该函数返回以下列：

列名称	数据类型	描述
PHASE_NAME	TEXT	复制操作的当前阶段。有关阶段列表，请参阅使用说明。
START_TIME	TIMESTAMP_LTZ	复制操作开始的时间。
END_TIME	TIMESTAMP_LTZ	复制操作完成的时间（如果适用）。如果正在进行中，则为 `NULL`。
JOB_UUID	TEXT	用于刷新作业的查询 ID。
TOTAL_BYTES	VARIANT	一个 JSON 对象，提供有关刷新数据库的详细信息： `totalBytesToReplicate`：预计要复制的字节总数。 `bytesUploaded`：实际上传的字节数。 `bytesDownloaded`：实际下载的字节数。 `databases`：每个成员数据库包含以下字段的 JSON 对象列表： `name`：数据库的名称。 `totalBytesToReplicate`：数据库预计要复制的总字节数。
OBJECT_COUNT	VARIANT	一个 JSON 对象，提供有关刷新对象的详细信息： `totalObjects`：复制或故障转移组中的对象总数。 `completedObjects`：完成的对象总数。 `objectTypes`：包含每种类型的以下字段的 JSON 对象列表： `objectType`：对象的类型（例如用户、角色、授权、仓库、架构、表、列等）。 `totalObjects`：复制或故障转移组中此类型的对象总数。 `completedObjects`：已完成的此类型对象总数。
PRIMARY_SNAPSHOT_TIMESTAMP	TIMESTAMP_LTZ	创建主快照的时间戳。
ERROR	VARIANT	如果刷新操作成功，则为 NULL。如果刷新操作失败，则返回提供有关错误的详细信息的 JSON 对象： `errorCode`：失败的错误代码。 `errorMessage`：失败的错误消息。

使用说明¶

仅返回对复制组或故障转移组具有任何权限的角色的行。
仅返回当前账户中辅助复制或故障转移组的行。
当调用 Information Schema 表函数时，会话必须具有正在使用的 INFORMATION_SCHEMA 架构，或者函数名称必须受到完全限定。有关更多详细信息，请参阅 Snowflake Information Schema。

以下是所处理订单中的阶段列表：

#	阶段名称	描述
1	`SECONDARY_SYNCHRONIZING_MEMBERSHIP`	辅助复制或故障转移组从主组接收有关该组中包括的对象的信息，并更新其成员元数据。
2	`SECONDARY_UPLOADING_INVENTORY`	辅助复制或故障转移组将目标账户中其对象的清单发送到主组。
3	`PRIMARY_UPLOADING_METADATA`	主复制或故障转移组在源账户中创建元数据快照并将其发送到辅助组。
4	`PRIMARY_UPLOADING_DATA`	主复制或故障转移组复制辅助组需要的文件，以协调源账户和目标账户中的对象之间的任何增量。
5	`SECONDARY_DOWNLOADING_METADATA`	辅助复制或故障转移组应用主复制或故障转移组发送的元数据快照。元数据更新不是以原子方式应用，而是随着时间的推移逐步应用。
6	`SECONDARY_DOWNLOADING_DATA`	辅助复制或故障转移组将主组发送的文件复制到目标账户。
7	`COMPLETED` / `FAILED` / `CANCELED`	刷新运行状态。

示例¶

检索辅助组 myfg 的刷新历史记录。

SELECT phase_name, start_time, end_time,
       total_bytes, object_count, error
  FROM TABLE(
      INFORMATION_SCHEMA.REPLICATION_GROUP_REFRESH_HISTORY('myfg')
  );

Copy