类别：

Information Schema、表函数

DATA_TRANSFER_HISTORY

此表函数的用途是，查询指定日期范围内从 Snowflake 表传输到另一个云存储提供商网络（即从 Snowflake on AWS、Google Cloud Platform 或 Microsoft Azure 传输到另一个云提供商的网络）和/或地理区域的数据的历史记录。该函数返回整个 Snowflake 账户的历史记录。

备注

此函数返回过去 14 天内的数据传输活动。

语法

DATA_TRANSFER_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [, DATE_RANGE_END => <constant_expr> ] )
Copy

实参

所有实参均为可选。

DATE_RANGE_START => constant_expr、. DATE_RANGE_END => constant_expr

过去 2 周内要检索数据传输历史记录的日期/时间范围：

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

  • 如果未指定开始日期，则范围会在 DATE_RANGE_END 开始前 10 分钟开始（即默认值是显示前 10 分钟的数据传输历史记录）。例如，如果 DATE_RANGE_END 是 CURRENT_DATE，则默认 DATE_RANGE_START 是 前一天 11:50 PM。

历史记录以 5 分钟、1 小时或 24 小时为增量显示（取决于指定范围的长度）。

如果范围超出了过去 15 天，则返回错误。

使用说明

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

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

输出

该函数返回以下列：

列名称

数据类型

描述

START_TIME

TIMESTAMP_LTZ

发生数据传输的指定时间范围的开始时间。

END_TIME

TIMESTAMP_LTZ

发生数据传输的指定时间范围的结束时间。

SOURCE_CLOUD

TEXT

数据传输来源的云提供商名称：Amazon Web Services、Google Cloud Platform 或 Microsoft Azure。

SOURCE_REGION

TEXT

数据传输来源的区域。

TARGET_CLOUD

TEXT

发送数据的云提供商名称：AWS、Google Cloud Platform 或 Microsoft Azure。

TARGET_REGION

TEXT

发送数据的区域。

BYTES_TRANSFERRED

NUMBER

START_TIME 和 END_TIME 窗口期间传输的字节数。

TRANSFER_TYPE

VARCHAR

导致传输的操作类型。COPY、EXTERNAL_ACCESS、EXTERNAL_FUNCTION、REPLICATION。

示例

检索账户 30 分钟范围内的数据传输历史记录，以 5 分钟为周期：

select *
  from table(mydb.information_schema.data_transfer_history(
    date_range_start=>to_timestamp_tz('2017-10-24 12:00:00.000 -0700'),
    date_range_end=>to_timestamp_tz('2017-10-24 12:30:00.000 -0700')));
Copy

检索账户过去 12 小时内的数据传输历史记录，以 1 小时为周期：

select *
  from table(information_schema.data_transfer_history(
    date_range_start=>dateadd('hour',-12,current_timestamp())));
Copy

检索账户过去 14 天的数据传输历史记录，以 1 天为周期：

select *
  from table(information_schema.data_transfer_history(
    date_range_start=>dateadd('day',-14,current_date()),
    date_range_end=>current_date()));
Copy
语言: 中文