Schemas:: ACCOUNT_USAGE

SEMANTIC_METRICS view¶

This ACCOUNT_USAGE view displays a row for each metric defined in a semantic view.

See also:: SEMANTIC_METRICS view (Information Schema)

Columns¶

Column name	Data type	Description
`semantic_metric_id`	NUMBER	ID of the metric in the semantic view.
`semantic_metric_name`	VARCHAR	Name of the metric in the semantic view.
`semantic_table_id`	NUMBER	ID of the logical table the metric belongs to.
`semantic_table_name`	VARCHAR	Name of the logical table the metric belongs to.
`semantic_view_id`	NUMBER	Internal, Snowflake-generated identifier for the semantic view in which the metric is defined.
`semantic_view_name`	VARCHAR	Name of the semantic view in which the metric is defined.
`semantic_view_schema_id`	NUMBER	Internal, Snowflake-generated identifier for the schema that the semantic view belongs to.
`semantic_view_schema_name`	VARCHAR	Schema that the semantic view belongs to.
`semantic_view_database_id`	NUMBER	Internal, Snowflake-generated identifier for the database that the semantic view belongs to.
`semantic_view_database_name`	VARCHAR	Database that the semantic view belongs to.
`data_type`	VARCHAR	Data type of the metric expression.
`expression`	VARCHAR	The SQL expression used to calculate the metric.
`synonyms`	ARRAY(VARCHAR)	List of the synonyms for the metric.
`comment`	VARCHAR	Description of the metric.
`created`	TIMESTAMP_LTZ	Creation time of the metric.
`last_altered`	TIMESTAMP_LTZ	Date and time the object was last altered by a DML, DDL, or background metadata operation. See Usage Notes.
`deleted`	TIMESTAMP_LTZ	Date and time when the metric was dropped.

Usage notes¶

Latency for the view can be up to 120 minutes (2 hours).
The LAST_ALTERED column is updated when the following operations are performed on an object:
- DDL operations.
- DML operations (for tables only). This column is updated even when no rows are affected by the DML statement.
- Background maintenance operations on metadata performed by Snowflake.

Examples¶

Retrieve the list of all metrics for the semantic view O_TPCH_SEMANTIC_VIEW in the database MY_DB:

SELECT * FROM SNOWFLAKE.ACCOUNT_USAGE.SEMANTIC_METRICS
  WHERE semantic_view_name = 'O_TPCH_SEMANTIC_VIEW'
    AND semantic_view_database_name = 'MY_DB';

Copy

i+--------------------+------------------------+-------------------+---------------------+------------------+----------------------+-------------------------+---------------------------+---------------------------+-----------------------------+--------------+--------------------------------------+----------+-------------------------------+-------------------------------+---------+---------+
| SEMANTIC_METRIC_ID | SEMANTIC_METRIC_NAME   | SEMANTIC_TABLE_ID | SEMANTIC_TABLE_NAME | SEMANTIC_VIEW_ID | SEMANTIC_VIEW_NAME   | SEMANTIC_VIEW_SCHEMA_ID | SEMANTIC_VIEW_SCHEMA_NAME | SEMANTIC_VIEW_DATABASE_ID | SEMANTIC_VIEW_DATABASE_NAME | DATA_TYPE    | EXPRESSION                           | SYNONYMS | CREATED                       | LAST_ALTERED                  | DELETED | COMMENT |
|--------------------+------------------------+-------------------+---------------------+------------------+----------------------+-------------------------+---------------------------+---------------------------+-----------------------------+--------------+--------------------------------------+----------+-------------------------------+-------------------------------+---------+---------|
|                396 | M_CUSTOMER_ORDER_COUNT |                99 | CUSTOMER            |               49 | O_TPCH_SEMANTIC_VIEW |                      92 | MY_SCHEMA                 |                         7 | MY_DB                       | NUMBER(30,0) | SUM(customer.a_customer_order_count) | NULL     | 2025-02-28 16:16:04.389 -0800 | 2025-02-28 16:16:04.389 -0800 | NULL    | NULL    |
|                395 | M_CUSTOMER_COUNT       |                99 | CUSTOMER            |               49 | O_TPCH_SEMANTIC_VIEW |                      92 | MY_SCHEMA                 |                         7 | MY_DB                       | NUMBER(18,0) | COUNT(c_custkey)                     | NULL     | 2025-02-28 16:16:04.389 -0800 | 2025-02-28 16:16:04.389 -0800 | NULL    | NULL    |
|                398 | M_SUPPLIER_COUNT       |               102 | SUPPLIER            |               49 | O_TPCH_SEMANTIC_VIEW |                      92 | MY_SCHEMA                 |                         7 | MY_DB                       | NUMBER(18,0) | COUNT(s_suppkey)                     | NULL     | 2025-02-28 16:16:04.389 -0800 | 2025-02-28 16:16:04.389 -0800 | NULL    | NULL    |
|                397 | M_ORDER_COUNT          |               100 | ORDERS              |               49 | O_TPCH_SEMANTIC_VIEW |                      92 | MY_SCHEMA                 |                         7 | MY_DB                       | NUMBER(18,0) | COUNT(o_orderkey)                    | NULL     | 2025-02-28 16:16:04.389 -0800 | 2025-02-28 16:16:04.389 -0800 | NULL    | NULL    |
+--------------------+------------------------+-------------------+---------------------+------------------+----------------------+-------------------------+---------------------------+---------------------------+-----------------------------+--------------+--------------------------------------+----------+-------------------------------+-------------------------------+---------+---------+