Categories:: Data metric functions

FUTURE_TIMESTAMP_PERCENT (system data metric function)¶

Returns the percentage of column values that are in the future relative to the scheduled evaluation time. The percentage is computed over the total row count, including NULL values in the denominator. NULL values are not counted as future.

This topic provides the syntax for calling the function directly. To learn how to associate the function with a table or view so it runs at regular intervals, see Associate a DMF.

Syntax¶

SNOWFLAKE.CORE.FUTURE_TIMESTAMP_PERCENT(<query>)

Arguments¶

query: Specifies a SQL query that projects a single column.

Allowed data types¶

The column projected by the query must have one of the following data types:

DATE
TIMESTAMP_LTZ
TIMESTAMP_TZ

Returns¶

The function returns a FLOAT value.

Example¶

Measure the percentage of future-dated rows in the event_time column:

SELECT SNOWFLAKE.CORE.FUTURE_TIMESTAMP_PERCENT(
  SELECT
    event_time
  FROM events.tables.activity
);