类别：

Information Schema、表函数

AVAILABLE_LISTING_REFRESH_HISTORY

使用 Cross-Cloud Auto-Fulfillment 功能返回可用列表或从列表安装的数据库过去 14 天的刷新历史记录。返回的信息包含每个刷新事件中添加到列表数据库中的数据的复制详细信息。此函数适用于对可用列表或挂载的数据库具有任意权限的列表使用者。

语法

AVAILABLE_LISTING_REFRESH_HISTORY(
  OBJECT_TYPE => '<object_type>',
  OBJECT_NAME => '<object_name>' )
Copy

实参

OBJECT_TYPE => 'object_type'

对象的类型，listing 或 database。

OBJECT_NAME => 'object_name'

对象的名称，可以是列表的全局名称，也可以是挂载的数据库名称，具体取决于对象类型。

输出

该函数返回以下列：

列名称

数据类型

描述

OBJECT_TYPE

TEXT

列出 Snowflake 对象的类型。例如，列表。

OBJECT_NAME

TEXT

列表或挂载数据库的名称。

PHASE

TEXT

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

PHASE_NAME

TEXT

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

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

PROGRESS

TEXT

PRIMARY_UPLOADING_DATA：复制的总字节数的百分比。

SECONDARY_DOWNLOADING_METADATA：复制的总对象数的百分比。

SECONDARY_DOWNLOADING_DATA：复制的总字节数的百分比。

剩余阶段为空。

START_TIME

TIMESTAMP_LTZ

复制阶段开始的时间。

END_TIME

TIMESTAMP_LTZ

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

如果该阶段正在进行或者是终止阶段 (COMPLETED/FAILED/CANCELED)，则为 NULL。

JOB_UUID

TEXT

用于刷新作业的查询 ID。

PRIMARY_SNAPSHOT_TIMESTAMP

TIMESTAMP_LTZ

创建主快照的时间戳。

ERROR

VARIANT

如果刷新操作成功，则为 NULL。如果刷新操作失败，则返回提供有关错误的详细信息的 JSON 对象：

  • errorCode：失败的错误代码。

  • errorMessage：失败的错误消息。

使用说明

  • 如果列表对账户可见，则仅返回对列表具有任意权限的角色的行。

  • 如果将 object_type 设置为 database``（与 ``listing 相对），仅返回对该数据库具有任意权限的角色的行。

  • 当调用 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

示例

检索数据库 my_mounted_database 的历史记录。

SELECT * FROM TABLE(
  INFORMATION_SCHEMA.AVAILABLE_LISTING_REFRESH_HISTORY(
    OBJECT_TYPE=>'database',
    OBJECT_NAME=>'my_mounted_database'
  )
);
Copy
语言: 中文