Schema:

ACCOUNT_USAGE

SNOWPIPE_STREAMING_CHANNEL_HISTORY view

This Account Usage view provides a historical record of pipeline errors, enabling users to monitor performance trends. This view displays key metrics such as processed data volume, error rates, and latency.

You can use this Account Usage view to query the error history for a specific pipe or channel.

Note

The SNOWPIPE_STREAMING_CHANNEL_HISTORY view only applies to Snowpipe Streaming with high-performance architecture.

Columns

Column NameData TypeDescription
ACCOUNT_IDNUMBERThe ID of the Snowflake account.
CREATED_ONTIMESTAMP_LTZDate and time when the rowset channel history was created.
CHANNEL_IDNUMBERThe internal, system-generated ID of the Snowpipe Streaming channel.
CHANNEL_NAMEVARCHARThe user-defined name of the Snowpipe Streaming channel.
PIPE_IDNUMBERThe internal ID of the Snowpipe object associated with this Snowpipe Streaming channel.
END_OFFSETVARCHARThe last offset token processed and included in this specific channel history record.
TABLE_IDNUMBERThe internal ID of the target table for this Snowpipe Streaming channel.
TABLE_NAMEVARCHARThe name of the target table for this Snowpipe Streaming channel.
TABLE_SCHEMA_IDNUMBERThe internal ID of the schema containing the target table.
TABLE_SCHEMA_NAMEVARCHARThe name of the schema containing the target table.
TABLE_DATABASE_IDNUMBERThe internal ID of the database containing the target table.
TABLE_DATABASE_NAMEVARCHARThe name of the database containing the target table.
PIPE_NAMEVARCHAR“The name of the Snowpipe object associated with the current Snowpipe Streaming channel history entry.
Named pipes: The value is the user-defined name of the Snowpipe object associated with the channel.
Default pipe: The value is automatically derived from the target table name; for example, MY_TABLE-STREAMING.”
PIPE_SCHEMA_IDNUMBER“The internal identifier for the schema associated with the Snowpipe Streaming channel.
Named pipes: The value is the internal ID of the schema that contains the user-defined Snowpipe object.
Default pipe: The value is the internal ID of the schema that contains the target table.”
PIPE_SCHEMA_NAMEVARCHAR“The name of the schema associated with the Snowpipe Streaming channel.
Named pipes: The value is the user-defined name of the schema that contains the Snowpipe object.
Default pipe: The value is the name of the schema that contains the target table.”
PIPE_DATABASE_IDNUMBER“The internal identifier for the database associated with the Snowpipe Streaming channel.
Named pipes: The value is the internal ID of the database that contains the user-defined Snowpipe object.
Default pipe: The value is the internal ID of the database that contains the target table.”
PIPE_DATABASE_NAMEVARCHAR“The name of the database associated with the Snowpipe Streaming channel.
Named pipes: The value is the user-defined name of the database that contains the Snowpipe object.
Default pipe: The value is the name of the database that contains the target table.”
LAST_ERROR_OFFSET_UPPER_BOUNDVARCHARThe upper bound of the offset token range of the last rowset that encountered errors during this historical period.
LAST_ERROR_MESSAGEVARCHARThe last error message encountered while writing data to the channel. This column displays a redacted error message when an error is encountered.
SNOWFLAKE_PROCESSING_LATENCY_MSNUMBERThe average latency, in milliseconds, observed by the Snowflake service in processing rowsets for this channel during this historical period.
ROWS_INSERTEDNUMBERThe total number of rows successfully inserted through this channel during this historical period.
ROWS_PARSEDNUMBERThe total number of rows parsed (processed) by the channel during this historical period.
ROW_ERROR_COUNTNUMBERThe total number of rows that encountered errors and were not inserted through this channel during this historical period.

Usage notes

  • The Snowpipe Streaming high-performance architecture only supports ON_ERROR=CONTINUE. Other ON_ERROR options are not supported.