Categories:

Data metric functions

UNIQUE_PERCENT (system data metric function)

Returns the percentage of non-NULL rows whose value occurs exactly once in the specified column. NULL values are excluded from both the numerator and 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.UNIQUE_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. The function returns 0 if the column contains no non-NULL values.

Example

Measure the percentage of unique values in the email column:

SELECT SNOWFLAKE.CORE.UNIQUE_PERCENT(
  SELECT
    email
  FROM crm.tables.contacts
);