类别：

Information Schema、表函数

LISTING_REFRESH_HISTORY

返回 Cross-Cloud Auto-Fulfillment 列表过去 14 天的刷新历史记录。返回的信息包含刷新事件的复制详细信息，在刷新事件中，列表被同步到指定的目标区域。

此函数适用于对指定列表拥有任何权限的列表提供商。

语法

LISTING_REFRESH_HISTORY(
  LISTING_NAME => '<listing_name>'
  [ , SNOWFLAKE_REGION => '<snowflake_region>' ]
  [ , REGION_GROUP => '<region_group>' ] )
Copy

实参

必填

LISTING_NAME => 'listing_name'

此账户中的 Cross-Cloud Auto-Fulfillment 列表的 SQL 标识符。列表的 SQL 标识符可在“显示数据交换 <exchange_name> 中的列表”返回的名称列中找到。同样，数据交换的 SQL 标识符可在 show data exchanges 返回的名称列中找到。

可选

SNOWFLAKE_REGION => 'snowflake_region'

列表复制到的 Snowflake 区域组，可以在此查看该复制的刷新历史记录。其格式与 SHOW REGIONS 返回的列 snowflake_region 相同。如果未指定区域，则显示所有目标区域的历史记录。

REGION_GROUP =>  'region_group'

列表复制到的 Snowflake 区域组，可以查看其刷新历史记录。

默认为 PUBLIC。只有当受监控的目标区域位于 US 政府或 Virtual Private Snowflake 区域时，才需要指定此实参。

输出

该函数返回以下列：

列名称

数据类型

描述

LISTING_NAME

TEXT

此账户中的 Cross-Cloud Auto-Fulfillment 列表的名称。

SNOWFLAKE_REGION

TEXT

列表复制到的 Snowflake 区域的名称。例如 aws_us_east_1。

REGION_GROUP

TEXT

列表复制到的 Snowflake 区域组的名称。例如 PUBLIC。

PHASE

TEXT

复制操作的当前阶段，代表总共 X 个阶段中的一个阶段。例如，2/6。

PHASE_NAME

TEXT

到目前为止已完成（或正在进行）的复制阶段的名称。

有关阶段列表，请参阅 使用说明。

PROGRESS

TEXT

当前复制进度的百分比。

START_TIME

TIMESTAMP_LTZ

复制阶段开始的时间。

END_TIME

TIMESTAMP_LTZ

该阶段结束的时间（如果适用）。

如果该阶段正在进行或者是终止阶段 (COMPLETED/FAILED/CANCELED)，则为 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 架构，或者函数名称必须受到完全限定。

    有关更多信息，请参阅 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

  • 输出结果还将包括引用同一数据库的其他列表的历史记录，因为它们是一起刷新的。如果输入是应用程序列表，则包含给定区域内所有应用程序列表的历史记录。

  • 在 PRIMARY_UPLOADING_DATA 和 SECONDARY_DOWNLOADING_DATA 阶段，totalBytesToReplicate 值是在复制操作之前估计的。该值可能不同于相应阶段的 totalBytesToUpload 或 totalBytesToDownload 值。

    例如，如果在 PRIMARY_UPLOADING_DATA 阶段，先前的复制操作上传了一些字节，但在操作完成前被取消，则这些字节将不会再次上传。在这种情况下，totalBytesToUpload 将低于 totalBytesToReplicate。

示例

检索刷新至 AWS US 东部-1（公共云区域）的列表 my_listing 的历史记录。

select * from table(information_schema.listing_refresh_history(listing_name=>'my_listing',snowflake_region=>'AWS_US_EAST_1))
Copy
语言: 中文