架构：

ACCOUNT_USAGE

SEMANTIC_RELATIONSHIPS 视图

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

另请参阅:

SEMANTIC_RELATIONSHIPS 视图 (Information Schema)

列

列名称

数据类型

描述

semantic_relationship_id

NUMBER

Snowflake 为语义视图中的关系生成的内部标识符。

semantic_relationship_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

语义视图所属数据库。

semantic_table_id

NUMBER

Snowflake 为所引用的逻辑表生成的内部标识符。

semantic_table_name

VARCHAR

引用其他表的逻辑表的名称。

ref_semantic_table_id

NUMBER

Snowflake 为引用其他表的逻辑表生成的内部标识符。

ref_semantic_table_name

VARCHAR

被引用的逻辑表的名称。

foreign_keys

ARRAY(VARCHAR)

引用其他表列的列的名称列表。

ref_keys

ARRAY(VARCHAR)

One of the following values:

  • For relationships that represent range joins, an array that contains JSON-formatted strings for objects with the following keys:

    • The start_column key specifies the name of the column that represents the start of the range.

    • The end_column key specifies the name of the column that represents the end of the range.

    • The type key is RANGE.

  • For relationships that represent ASOF joins, an array that contains the following elements:

    • The name of the column in the first table.

    • A JSON object with the following fields:

      • column: Name of the column in the second table.

      • type：ASOF。

  • For other types of relationships, an array containing the name of the column in the other logical table in the relationship.

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_RELATIONSHIPS
  WHERE semantic_view_name = 'O_TPCH_SEMANTIC_VIEW'
    AND semantic_view_database_name = 'MY_DB';

+--------------------------+-------------------------------------------------------+------------------+----------------------+-------------------------+---------------------------+---------------------------+-----------------------------+-------------------+---------------------+-----------------+-----------------------+-------------------------+-----------------+-------------------------------+-------------------------------+---------+
| SEMANTIC_RELATIONSHIP_ID | SEMANTIC_RELATIONSHIP_NAME                            | SEMANTIC_VIEW_ID | SEMANTIC_VIEW_NAME   | SEMANTIC_VIEW_SCHEMA_ID | SEMANTIC_VIEW_SCHEMA_NAME | SEMANTIC_VIEW_DATABASE_ID | SEMANTIC_VIEW_DATABASE_NAME | SEMANTIC_TABLE_ID | SEMANTIC_TABLE_NAME | FOREIGN_KEYS    | REF_SEMANTIC_TABLE_ID | REF_SEMANTIC_TABLE_NAME | REF_KEYS        | CREATED                       | LAST_ALTERED                  | DELETED |
|--------------------------+-------------------------------------------------------+------------------+----------------------+-------------------------+---------------------------+---------------------------+-----------------------------+-------------------+---------------------+-----------------+-----------------------+-------------------------+-----------------+-------------------------------+-------------------------------+---------|
|                       99 | SYS_RELATIONSHIP_67ae9bb4-652a-4985-8dc5-c99fdf7f4276 |               49 | O_TPCH_SEMANTIC_VIEW |                      92 | MY_SCHEMA                 |                         7 | MY_DB                       |               100 | ORDERS              | [               |                    99 | CUSTOMER                | [               | 2025-02-28 16:16:04.321 -0800 | 2025-02-28 16:16:04.321 -0800 | NULL    |
|                          |                                                       |                  |                      |                         |                           |                           |                             |                   |                     |   "O_CUSTKEY"   |                       |                         |   "C_CUSTKEY"   |                               |                               |         |
|                          |                                                       |                  |                      |                         |                           |                           |                             |                   |                     | ]               |                       |                         | ]               |                               |                               |         |
|                      100 | SYS_RELATIONSHIP_906b4d92-582a-4bef-b2c1-9a69e8f61af1 |               49 | O_TPCH_SEMANTIC_VIEW |                      92 | MY_SCHEMA                 |                         7 | MY_DB                       |               101 | LINEITEM            | [               |                   100 | ORDERS                  | [               | 2025-02-28 16:16:04.363 -0800 | 2025-02-28 16:16:04.363 -0800 | NULL    |
|                          |                                                       |                  |                      |                         |                           |                           |                             |                   |                     |   "L_ORDERKEY"  |                       |                         |   "O_ORDERKEY"  |                               |                               |         |
|                          |                                                       |                  |                      |                         |                           |                           |                             |                   |                     | ]               |                       |                         | ]               |                               |                               |         |
|                      101 | SYS_RELATIONSHIP_fadc2c0f-db3a-48e4-b96a-53ea2767a2b0 |               49 | O_TPCH_SEMANTIC_VIEW |                      92 | MY_SCHEMA                 |                         7 | MY_DB                       |               102 | SUPPLIER            | [               |                    98 | NATION                  | [               | 2025-02-28 16:16:04.376 -0800 | 2025-02-28 16:16:04.376 -0800 | NULL    |
|                          |                                                       |                  |                      |                         |                           |                           |                             |                   |                     |   "S_NATIONKEY" |                       |                         |   "N_NATIONKEY" |                               |                               |         |
|                          |                                                       |                  |                      |                         |                           |                           |                             |                   |                     | ]               |                       |                         | ]               |                               |                               |         |
|                       98 | SYS_RELATIONSHIP_8c9ad09e-0ba4-489f-aabb-0503ef80e11b |               49 | O_TPCH_SEMANTIC_VIEW |                      92 | MY_SCHEMA                 |                         7 | MY_DB                       |                99 | CUSTOMER            | [               |                    98 | NATION                  | [               | 2025-02-28 16:16:04.309 -0800 | 2025-02-28 16:16:04.309 -0800 | NULL    |
|                          |                                                       |                  |                      |                         |                           |                           |                             |                   |                     |   "C_NATIONKEY" |                       |                         |   "N_NATIONKEY" |                               |                               |         |
|                          |                                                       |                  |                      |                         |                           |                           |                             |                   |                     | ]               |                       |                         | ]               |                               |                               |         |
|                       97 | SYS_RELATIONSHIP_8529b4a7-eaff-4c36-888f-d9e1ad2683de |               49 | O_TPCH_SEMANTIC_VIEW |                      92 | MY_SCHEMA                 |                         7 | MY_DB                       |                98 | NATION              | [               |                    97 | REGION                  | [               | 2025-02-28 16:16:04.294 -0800 | 2025-02-28 16:16:04.294 -0800 | NULL    |
|                          |                                                       |                  |                      |                         |                           |                           |                             |                   |                     |   "N_REGIONKEY" |                       |                         |   "R_REGIONKEY" |                               |                               |         |
|                          |                                                       |                  |                      |                         |                           |                           |                             |                   |                     | ]               |                       |                         | ]               |                               |                               |         |
+--------------------------+-------------------------------------------------------+------------------+----------------------+-------------------------+---------------------------+---------------------------+-----------------------------+-------------------+---------------------+-----------------+-----------------------+-------------------------+-----------------+-------------------------------+-------------------------------+---------+