行为变更管理¶

概述¶

Snowflake 每月都会在定期 发布 的捆绑包实施行为变更。在每个行为变更捆绑包的测试期和选择退出期内，您可以在账户中启用或禁用捆绑包。本文档介绍如何检查您的账户中是否启用了特定的捆绑包以及如何启用或禁用行为变更捆绑包。

在本文档中，行为变更捆绑包的名称采用 YYYY_NN 形式。有关当前可用的行为变更捆绑包的名称，请参阅 行为变更日志。

检查账户中行为变更捆绑包的状态¶

要检查账户中是否启用了特定的行为变更捆绑包，请调用 SYSTEM$BEHAVIOR_CHANGE_BUNDLE_STATUS 函数。例如，要检查名为 2024_02 的捆绑包的状态，请执行以下操作：

SELECT SYSTEM$BEHAVIOR_CHANGE_BUNDLE_STATUS('2024_02');

+-------------------------------------------------+
| SYSTEM$BEHAVIOR_CHANGE_BUNDLE_STATUS('2024_02') |
|-------------------------------------------------|
| DISABLED                                        |
+-------------------------------------------------+

要检查所有当前可用的行为变更捆绑包的状态，请调用 SYSTEM$SHOW_ACTIVE_BEHAVIOR_CHANGE_BUNDLES 函数：

SELECT SYSTEM$SHOW_ACTIVE_BEHAVIOR_CHANGE_BUNDLES();

+--------------------------------------------------------------------------------------------------------------+
| SYSTEM$SHOW_ACTIVE_BEHAVIOR_CHANGE_BUNDLES()                                                                 |
|--------------------------------------------------------------------------------------------------------------|
| [{"name":"2023_08","isDefault":true,"isEnabled":true},{"name":"2024_01","isDefault":false,"isEnabled":true}] |
+--------------------------------------------------------------------------------------------------------------+

在您的账户中启用行为变更捆绑包¶

要在账户中启用特定的行为变更，请调用 SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE 函数。例如，要启用名为 2024_02 的捆绑包，请执行以下操作：

SELECT SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE('2024_02');

+-------------------------------------------------+
| SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE('2024_02') |
|-------------------------------------------------|
| ENABLED                                         |
+-------------------------------------------------+

禁用您账户中的行为变更捆绑包¶

要禁用账户中的特定行为变更，请调用 SYSTEM$DISABLE_BEHAVIOR_CHANGE_BUNDLE。例如，要禁用名为 2024_02 的捆绑包，请执行以下操作：

SELECT SYSTEM$DISABLE_BEHAVIOR_CHANGE_BUNDLE('2024_02');

+-------------------------------------------------+
| SYSTEM$DISABLE_BEHAVIOR_CHANGE_BUNDLE('2024_02')|
|-------------------------------------------------|
| DISABLED                                        |
+-------------------------------------------------+

确定您账户的当前版本¶

要查看账户中 Snowflake 的当前版本，请调用 CURRENT_VERSION 函数。例如：

SELECT CURRENT_VERSION();

Copy

+-------------------+
| CURRENT_VERSION() |
|-------------------|
| 8.5.1             |
+-------------------+

减少掩码策略返回值更新¶

在未来的行为变更捆绑包中，Snowflake 计划更新掩码策略条件中长度、精度和小数位数的值（统称为“返回值更新”）。当进行这些返回值更新时，如果满足以下条件，则对受掩码策略保护的列的查询将失败：

• 捆绑包已启用。

• 掩码策略条件返回值的长度或精度的值 大于 掩码策略所指定列的长度或精度。

如果返回值的小数位数大于列的小数位数，则该值将被截断为列的小数位数。

启用捆绑包后，您可以按如下方式测试其行为：

1. 创建策略：

   CREATE MASKING POLICY MP AS (s string)
   RETURNS STRING -> 'abcdef';
   

   Copy

2. 分配策略：

   CREATE TABLE t(col1 string(2));
   
   ALTER TABLE t MODIFY COLUMN col1 SET MASKING POLICY mp;
   

   Copy

3. 查询列（失败）：

   SELECT * FROM t;
   

   Copy

要确定此更改的影响并提供足够的时间来更新掩码策略条件以保护数据，请查询 SNOWFLAKE.BCR_ROLLOUT.BCR_2024_03_DDM_ROLLOUT 视图，以了解未来返回值更新对您的账户有何影响。

BCR_2024_03_DDM_ROLLOUT 视图是临时的。当返回值更新时，在未来的行为变更捆绑包中 普遍启用 时，Snowflake 将移除该视图。此时，您将无法查询视图以确定受影响的列和策略，也无法防止因返回值更新导致列查询或掩码策略分配操作失败。

该视图记录了从 2024 年 3 月开始的数据。如果查询视图需要很长时间才能完成，则可以使用 SET 命令指定开始日期和结束日期会话变量。这些变量有助于减少查询视图时要评估的行数。例如：

SET DDM_CASTING_BCR_START_DATE = '2024-03-01';
SET DDM_CASTING_BCR_END_DATE = '2024-04-03';

Copy