- スキーマ:
SEMANTIC_METRICS ビュー¶
この ACCOUNT_USAGE ビューでは、 セマンティックビュー で定義された各メトリックの行が表示されます。
- こちらもご覧ください:
列¶
列名 |
データ型 |
説明 |
---|---|---|
|
NUMBER |
セマンティックビューでのメトリックの ID。 |
|
VARCHAR |
セマンティックビューでのメトリックの名前。 |
|
NUMBER |
メトリックが属する論理テーブルの ID。 |
|
VARCHAR |
メトリックが属する論理テーブルの名前。 |
|
NUMBER |
内部でSnowflakeが生成した、メトリックが定義されているセマンティックビューの識別子。 |
|
VARCHAR |
メトリックが定義されているセマンティックビューの名前。 |
|
NUMBER |
セマンティックビューが属するスキーマの、Snowflakeが生成した内部識別子。 |
|
VARCHAR |
セマンティックビューが属するスキーマ。 |
|
NUMBER |
セマンティックビューが属するデータベースの、Snowflakeが生成した内部識別子。 |
|
VARCHAR |
セマンティックビューが属するデータベース。 |
|
VARCHAR |
メトリック式のデータ型。 |
|
VARCHAR |
メトリックの計算に使用される SQL 式。 |
|
ARRAY(VARCHAR) |
メトリックの同義語のリスト。 |
|
VARCHAR |
メトリックの説明。 |
|
TIMESTAMP_LTZ |
メトリックの作成時刻。 |
|
TIMESTAMP_LTZ |
オブジェクトが DML、 DDL、 またはバックグラウンドでのメタデータ処理によって最後に変更された日時。 使用上の注意 をご参照ください。 |
|
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 |
+--------------------+------------------------+-------------------+---------------------+------------------+----------------------+-------------------------+---------------------------+---------------------------+-----------------------------+--------------+--------------------------------------+----------+-------------------------------+-------------------------------+---------+---------+