2025 年 2 月 24 日至 3 月 1 日 - 9.4 版本说明¶

为绑定到引用的对象返回的附加信息 - 正式发布¶

Snowflake Native App 提供商现在可以使用以下内容来提取绑定到引用的对象的对象名称、架构名称和数据库名称：

• SYSTEM$GET_ALL_REFERENCES 系统函数。

• Python Permission SDK 的 snowflake.permissions.get_detailed_reference_associations 方法。

对应用程序中的日志、跟踪和指标级别进行更精细的控制 - 正式发布¶

在 Snowflake Native App 中，您现在可以替换应用程序内特定对象的日志、跟踪和指标级别，包括：

• 数据库架构

• 版本化架构

• 存储过程

• 函数

这允许对这些对象进行精准监控和分析，并为提供商提供对遥测数据收集的更精细控制。应用程序级日志、跟踪和指标级别用作默认值，仅在未定义特定对象或架构替换时应用。您可以在应用程序的清单文件中设置默认的应用程序级日志、跟踪和指标级别。有关更多信息，请参阅 为应用程序配置事件定义。setup.sql 中特定对象的替换优先于应用程序级默认值。

要获取日志记录、指标和跟踪级别的替换值，请使用以下系统函数：

• SYSTEM$APPLICATION_GET_LOG_LEVEL

• SYSTEM$APPLICATION_GET_TRACE_LEVEL

• SYSTEM$APPLICATION_GET_METRIC_LEVEL

克隆包含混合表的数据库 - 预览版¶

在此版本中，我们很高兴地宣布推出支持对包含混合表的数据库进行克隆的预览版。您可以创建克隆数据库，为 Unistore 应用程序设置备份和恢复解决方案。

有关更多信息，请参阅：

• 克隆包含混合表的数据库

• CREATE <object> ... CLONE

• AT | BEFORE

新 SQL 函数¶

此版本现在提供以下函数：

支持将事件表与数据库相关联 - 正式发布¶

在此版本中，已正式发布对事件表与数据库关联的支持。将事件表分配给数据库时，事件表中收集事件的对象范围仅限于数据库中的对象。

以前，事件表只能与账户关联。

有关更多信息，请参阅 事件表概述。

动态表和任务：记录刷新和任务执行事件¶

您现在可以配置 Snowflake，来记录动态表刷新和任务执行事件。这些事件存储在与动态表或任务关联的 活动事件表 中。

刷新动态表时，Snowflake 会记录一个事件，以指示：

• 刷新成功。

• 刷新失败。在这种情况下，事件还包括错误消息。

• 由于刷新上游动态表失败，刷新失败。

同样，任务执行时，Snowflake 会记录一个事件，以指示任务是成功完成还是发生错误。如果发生错误，则事件包括错误消息。

您可以查询这些事件，以识别失败的刷新或导致错误的任务执行。

例如，以下查询获取数据库 my_db 中的时间戳、动态表名、查询 ID，以及动态表错误的错误消息：

SELECT
    timestamp,
    resource_attributes:"snow.executable.name"::VARCHAR AS dt_name,
    resource_attributes:"snow.query.id"::VARCHAR AS query_id,
    value:message::VARCHAR AS error
  FROM my_event_table
  WHERE
    resource_attributes:"snow.executable.type" = 'DYNAMIC_TABLE' AND
    resource_attributes:"snow.database.name" = 'MY_DB' AND
    value:state = 'FAILED'
  ORDER BY timestamp DESC;

以下查询获取数据库 my_db 中的时间戳、任务名称、查询 ID，以及任务错误的错误消息：

SELECT
    timestamp,
    resource_attributes:"snow.executable.name"::VARCHAR AS task_name,
    resource_attributes:"snow.query.id"::VARCHAR AS query_id,
    value:message::VARCHAR AS error
  FROM my_event_table
  WHERE
    resource_attributes:"snow.executable.type" = 'TASK' AND
    resource_attributes:"snow.database.name" = 'MY_DB' AND
    value:state = 'FAILED'
  ORDER BY timestamp DESC;

有关更多信息，请参阅：

• :ref:`label-dynamic_tables_monitoring_sql_events`（适用于动态表）

• 监控任务执行事件

目录集成的 CATALOG_NAMESPACE 参数现为可选项¶

在此版本中，目录集成的 CATALOG_NAMESPACE 参数现在是可选项，而非必填项：

• 如果创建目录集成以 将 Snowflake 托管的 Iceberg 表与 Snowflake Open Catalog 同步，则不再需要指定 CATALOG_NAMESPACE 参数。Snowflake 将 Apache Iceberg™ 表同步到您在目录集成中指定的 Open Catalog。

• 如果为非托管 Iceberg 表创建目录集成，且没有使用目录集成指定 CATALOG_NAMESPACE，则必须在表级别指定。您也可以使用目录集成指定，然后在表级别替换。