架构：

ACCOUNT_USAGE

SNOWPIPE_STREAMING_FILE_MIGRATION_HISTORY 视图

此 Account Usage 视图可用于查询过去 365 天（1 年）内使用 Snowpipe Streaming 迁移到 Snowflake 表中的数据的历史记录。此视图显示迁移的行数和字节数，以及为整个 Snowflake 账户计入的用于迁移的 Credit的量。

列

列名称

数据类型

描述

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

TEXT

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

SCHEMA_ID

NUMBER

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

SCHEMA_NAME

TEXT

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

DATABASE_ID

NUMBER

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

DATABASE_NAME

TEXT

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

使用说明

  • 视图的延迟时间最长可达 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
语言: 中文