9.20 版本说明：2025 年 7 月 21 日至 2025 年 7 月 25 日¶

CREATE INDEX 命令支持 INCLUDE 列¶

在此版本中，您可以使用 CREATE INDEX 命令创建包含 INCLUDE 列的二级索引。在以前的版本中，仅在 CREATE HYBRID TABLE 语句中定义的二级索引支持 INCLUDE 列。

语义视图：列出视图、架构、数据库或账户中的维度和指标¶

要列出语义视图、架构、数据库或账户中的维度和指标，请运行以下命令：

• SHOW SEMANTIC DIMENSIONS

• SHOW SEMANTIC METRICS

您还可以列出在查询特定指标时可指定的维度。当您在查询中同时指定维度和指标时，维度的基表必须与指标的基表相关联。此外，维度的基表粒度必须等于或低于指标的基表。

例如，以下示例查询 tpch_analysis 视图并返回 customer_order_count 指标和 order_date 维度：

SELECT * FROM SEMANTIC_VIEW (
  tpch_analysis
  DIMENSIONS orders.order_date
  METRICS customer.customer_order_count
);

此查询会失败，因为维度的 orders 表粒度高于指标的 customer 表：

010234 (42601): SQL compilation error:
Invalid dimension specified: The dimension entity 'ORDERS' must be related to and
have an equal or lower level of granularity compared to the base metric or dimension entity 'CUSTOMER'.

要列出其基表与某个指标的基表相关，且粒度等于或低于该指标基表的维度，请运行 SHOW SEMANTIC DIMENSIONS FOR METRIC 命令。例如：

SHOW SEMANTIC DIMENSIONS IN tpch_analysis FOR METRIC customer_order_count;

有关联接性能和优化的新查询见解¶

QUERY_INSIGHTS 视图现在包括对可能影响查询性能的以下条件的见解：

• 查询或子查询没有 WHERE 子句，这意味着该查询会扫描整个表，并且可能返回比预期更多的行。

• 如果一个联接包含了至少一个其他联接的输出，那么它返回的行数会远远多于被联接的表中的实际行数。

• 两个数据集（例如，表、视图或表函数调用的输出）的联接返回的行数远大于参与联接的表中的行数。

• 查询性能已通过搜索优化得到改善。

每项见解都包含一条消息，其中解释了查询性能可能受到的影响并提供后续步骤的常规通用建议。

有关信息，请参阅 使用查询见解提高性能。

任务：新的 EXECUTE AS USER 选项和用户对象的 IMPERSONATE 权限¶

在此版本中，按用户分配 Snowflake 安全权限的组织现在可以允许用户使用现有用户账户运行团队任务。

作为最佳实践，建议团队创建一个代表团队的服务用户，并为该用户分配所需的权限。然后，您可以使用 GRANT IMPERSONATE ON USER <user_name> TO ROLE <role_name> 命令授予用户权限，以便基于团队用户账户创建或修改任务：各个用户随后可以以团队用户的身份运行任务，并通过以下新参数使用其权限：CREATE TASK ... EXECUTE AS USER <user_name> 和 ALTER TASK ... EXECUTE AS USER <user_name>。

有关更多信息，请参阅 使用用户权限运行任务。

动态表：在无服务器仓库手动刷新动态表时禁止使用 COPY_SESSION 属性¶

在无服务器上下文中对动态表使用 COPY_SESSION 会导致刷新继承无服务器仓库，从而产生不受支持且未定义的行为。此配置现在会导致错误。

有关更多信息，请参阅 REFRESH [ COPY SESSION ]。