Categories:

Data metric functions

NOT_NULL_PERCENT (system data metric function)

Returns the percentage of column values that are not NULL for the specified column in a table. The percentage is computed over the total row count, including NULL values in the denominator.

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.NOT_NULL_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
  • FLOAT
  • NUMBER
  • TIMESTAMP_LTZ
  • TIMESTAMP_NTZ
  • TIMESTAMP_TZ
  • VARCHAR

Returns

The function returns a FLOAT value.

Example

Measure the percentage of non-NULL values for the SSN column:

SELECT SNOWFLAKE.CORE.NOT_NULL_PERCENT(
  SELECT
    ssn
  FROM hr.tables.empl_info
);