架构：

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';
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    |
+--------------------+------------------------+-------------------+---------------------+------------------+----------------------+-------------------------+---------------------------+---------------------------+-----------------------------+--------------+--------------------------------------+----------+-------------------------------+-------------------------------+---------+---------+
语言: 中文