架构：: ACCOUNT_USAGE

SEMANTIC_METRICS 视图¶

此 ACCOUNT_USAGE 视图为语义视图中定义的每个指标显示一行。

另请参阅:: SEMANTIC_METRICS 视图 (Information Schema)

列¶


列名称	数据类型	描述
`semantic_metric_id`	NUMBER	语义视图中的指标 ID。
`semantic_metric_name`	VARCHAR	语义视图中的指标名称。
`semantic_table_id`	NUMBER	指标所属逻辑表的 ID。
`semantic_table_name`	VARCHAR	指标所属逻辑表的名称。
`semantic_view_id`	NUMBER	Snowflake 为在其中定义指标的语义视图生成的内部标识符。
`semantic_view_name`	VARCHAR	在其中定义指标的语义视图的名称。
`semantic_view_schema_id`	NUMBER	Snowflake 为语义视图所属架构生成的内部标识符。
`semantic_view_schema_name`	VARCHAR	语义视图所属架构。
`semantic_view_database_id`	NUMBER	Snowflake 为语义视图所属数据库生成的内部标识符。
`semantic_view_database_name`	VARCHAR	语义视图所属数据库。
`data_type`	VARCHAR	指标表达式的数据类型。
`expression`	VARCHAR	用于计算指标的 SQL 表达式。
`synonyms`	ARRAY(VARCHAR)	指标的同义词列表。
`comment`	VARCHAR	指标的描述。
`created`	TIMESTAMP_LTZ	指标的创建时间。
`last_altered`	TIMESTAMP_LTZ	对象上次经 DML、DDL 或后台元数据操作修改的日期和时间。请参阅使用说明。
`deleted`	TIMESTAMP_LTZ	删除指标的日期和时间。

使用说明¶

视图的延迟时间最长可达 120 分钟（2 小时）。
对对象执行以下操作时，将更新 LAST_ALTERED 列：
- DDL 操作。
- DML 操作（仅适用于表）。即使 DML 语句不影响任何行，也会更新此列。
- 由 Snowflake 对元数据执行的后台维护操作。

示例¶

检索数据库 MY_DB 中语义视图 O_TPCH_SEMANTIC_VIEW 的所有指标列表：

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

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    |
+--------------------+------------------------+-------------------+---------------------+------------------+----------------------+-------------------------+---------------------------+---------------------------+-----------------------------+--------------+--------------------------------------+----------+-------------------------------+-------------------------------+---------+---------+