Esquemas:

ACCOUNT_USAGE

Exibição SEMANTIC_METRICS

Essa exibição do ACCOUNT_USAGE exibe uma linha para cada métrica definida em uma exibição semântica.

Consulte também:

Exibição SEMANTIC_METRICS (Information Schema)

Colunas

Nome da coluna

Tipo de dados

Descrição

semantic_metric_id

NUMBER

ID da métrica na exibição semântica.

semantic_metric_name

VARCHAR

Nome da métrica na exibição semântica.

semantic_table_id

NUMBER

ID da tabela lógica à qual a métrica pertence.

semantic_table_name

VARCHAR

Nome da tabela lógica à qual a métrica pertence.

semantic_view_id

NUMBER

Identificador interno, gerado pelo Snowflake, para a exibição semântica na qual a métrica é definida.

semantic_view_name

VARCHAR

Nome da exibição semântica na qual a métrica é definida.

semantic_view_schema_id

NUMBER

Identificador interno gerado pelo Snowflake para o esquema ao qual a exibição semântica pertence.

semantic_view_schema_name

VARCHAR

Esquema ao qual a exibição semântica pertence.

semantic_view_database_id

NUMBER

Identificador interno gerado pelo Snowflake para o banco de dados ao qual a exibição semântica pertence.

semantic_view_database_name

VARCHAR

Banco de dados ao qual a exibição semântica pertence.

data_type

VARCHAR

Tipo de dados da expressão da métrica.

expression

VARCHAR

A expressão SQL usada para calcular a métrica.

synonyms

ARRAY(VARCHAR)

Lista de sinônimos para a métrica.

comment

VARCHAR

Descrição da métrica.

created

TIMESTAMP_LTZ

Hora de criação da métrica.

last_altered

TIMESTAMP_LTZ

Data e hora em que o objeto foi alterado pela última vez por uma operação de metadados de DML, DDL ou em segundo plano. Consulte as Notas de uso.

deleted

TIMESTAMP_LTZ

Data e hora em que a métrica foi descartada.

Notas de uso

  • A latência da exibição pode ser de até 120 minutos (2 horas).

  • A coluna LAST_ALTERED é atualizada quando as seguintes operações são executadas em um objeto:

    • operações DDL.

    • operações DML (somente para tabelas). Esta coluna é atualizada mesmo quando nenhuma linha é afetada pela instrução DML.

    • Operações de manutenção em segundo plano em metadados realizadas pelo Snowflake.

Exemplos

Recupere a lista de todas as métricas para a exibição semântica O_TPCH_SEMANTIC_VIEW no banco de dados 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    |
+--------------------+------------------------+-------------------+---------------------+------------------+----------------------+-------------------------+---------------------------+---------------------------+-----------------------------+--------------+--------------------------------------+----------+-------------------------------+-------------------------------+---------+---------+