スキーマ:

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