架构：

ACCOUNT_USAGE

SNOWPIPE_STREAMING_FILE_MIGRATION_HISTORY 视图

This Account Usage view can be used to query the history of data migrated into Snowflake tables using Snowpipe Streaming within the last 365 days (1 year). The view displays the number of rows and bytes migrated and credits used for migration billed for your entire Snowflake account.

列

列名称

数据类型

描述

START_TIME

TIMESTAMP_LTZ

发生数据迁移的时间范围的开始时间（本地时区）。

END_TIME

TIMESTAMP_LTZ

发生数据迁移的时间范围的结束时间（本地时区）。

CREDITS_USED

FLOAT

在 START_TIME 和 END_TIME 窗口期间为 Snowpipe Streaming 数据迁移计入的 Credit。

NUM_BYTES_MIGRATED

NUMBER

在 START_TIME 和 END_TIME 窗口期间迁移的字节数。

NUM_ROWS_MIGRATED

NUMBER

在 START_TIME 和 END_TIME 窗口期间迁移的行数。

TABLE_ID

NUMBER

Snowpipe Streaming 客户端将数据加载到的目标表的内部/系统生成的标识符。

TABLE_NAME

VARCHAR

Snowpipe Streaming 客户端将数据加载到的目标表的名称。

SCHEMA_ID

NUMBER

目标表所属架构的内部/系统生成的标识符。

SCHEMA_NAME

VARCHAR

目标表所属的架构的名称。

DATABASE_ID

NUMBER

目标表所属数据库的内部/系统生成的标识符。

DATABASE_NAME

VARCHAR

目标表所属的数据库的名称。

使用说明

  • 视图的延迟时间最长可达 12 小时。

  • 请注意，文件迁移有时可能会被群集或其他 DML 操作抢先。迁移可能并不总是发生，因此即使在 12 小时后，迁移历史记录也将为空。

  • NUM_BYTES_MIGRATED 和 NUM_ROWS_MIGRATED 列仅显示迁移过程中处理的字节数和行数。这些数字可能不等于 Snowpipe Streaming 插入到表的实际行数和字节数，因为某些行和字节由于群集或其他 DML 操作而在迁移过程之外进行处理。

    例如，Snowpipe Streaming 插入 1M 行，表有 1M 行，但迁移历史记录视图中的 NUM_ROWS_MIGRATED 列仅显示 800K 行。这是因为其他 200K 行是在迁移过程之外处理的。

示例

查询过去 365 天内使用 Snowpipe Streaming 迁移到 Snowflake 表的数据的历史记录。

SELECT * FROM SNOWFLAKE.ACCOUNT_USAGE.SNOWPIPE_STREAMING_FILE_MIGRATION_HISTORY;
Copy

查询将返回以下结果。

+-------------------------------+-------------------------------+--------------+--------------------+------------------+----------+-----------------+------------+--------------+---------------+--------------+
| START_TIME                    | END_TIME                      | CREDITS_USED | NUM_BYTES_MIGRATED | NUM_ROWS_MIGRATED| TABLE_ID |      TABLE_NAME | SCHEMA_ID  |  SCHEMA_NAME |   DATABASE_ID | DATABASE_NAME|
|-------------------------------+-------------------------------+--------------+--------------------+------------------+----------+----------------------------------------------------------------------------|
|2023-02-08 19:00:00.000 +0000  |2023-02-08 20:00:00.000 +0000  | 0.0000325    |                 0  |                0 |  16849926| STREAMING_TABLE |   101351   |   SNOW       |  3166         |STREAMING     |
|2023-02-07 19:00:00.000 +0000  |2023-02-07 20:00:00.000 +0000  | 0.000096761  |             7,850  |               39 |  16849926| STREAMING_TABLE |   101351   |   SNOW       |  3166         |STREAMING     |
+-------------------------------+-------------------------------+--------------+--------------------+------------------+----------+-----------------+------------+--------------+---------------|--------------+
Copy
语言: 中文