Categories:: Data metric functions

INVALID_USA_STATE_CODE_COUNT (system data metric function)¶

Returns the count of non-NULL column values that are not a two-letter code for one of the 50 U.S. states or the District of Columbia.

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.INVALID_USA_STATE_CODE_COUNT(<query>)

Arguments¶

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

Allowed data types¶

The column projected by the query must have the VARCHAR data type.

Returns¶

The function returns a NUMBER value. NULL values are not counted.

Usage notes¶

The comparison is case-insensitive. Leading and trailing spaces are not trimmed.
U.S. territories are not included.

Example¶

Measure the number of invalid state codes in the state_code column:

SELECT SNOWFLAKE.CORE.INVALID_USA_STATE_CODE_COUNT(
  SELECT
    state_code
  FROM crm.tables.addresses
);