类别：: Information Schema、表函数

REPLICATION_GROUP_REFRESH_HISTORY¶

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

语法¶

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 *
from table(information_schema.replication_group_refresh_history('myfg'));

Copy