Categories:

Data metric functions

MIN (system data metric function)

Returns the minimum value for the specified column in a table.

The MIN system data metric function is optimized to calculate the minimum value for a single column and provides greater performance when compared to calling the MIN function.

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 to automate data quality checks.

Syntax

SNOWFLAKE.CORE.MIN(<query>)
Copy

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:

  • FLOAT

  • NUMBER

Returns

The function returns either a NUMBER or FLOAT value.

Access control requirements

Associating and running a system DMF requires the USAGE privilege on the system DMF. You can grant the SNOWFLAKE.DATA_METRIC_USER database role to give users the USAGE privilege on all system DMFs. For more information, see Grant the USAGE privilege on system DMFs.

For instructions on creating a custom role with a specified set of privileges, see Creating custom roles.

For general information about roles and privilege grants for performing SQL actions on securable objects, see Overview of Access Control.

Example

Measure the minimum value for the SALARY column in a table:

SELECT SNOWFLAKE.CORE.MIN(
  SELECT
    salary
  FROM hr.tables.empl_info
);
Copy
+------------------------------------------------------------+
| SNOWFLAKE.CORE.MIN(SELECT salary FROM hr.tables.empl_info) |
+------------------------------------------------------------+
| 60000                                                      |
+------------------------------------------------------------+
Language: English