CREATE SNAPSHOT POLICY¶

创建快照策略。将策略与一个或多个快照集相关联。策略中的设置定义了使用该策略的每个快照集的计划和有效期。

该计划决定了 Snowflake 自动进行备份的频率，并将生成的快照添加到受策略管理的快照集中。有效期决定了在 Snowflake 自动将快照从关联的快照集中删除之前每个快照的保留时间。

小技巧

对于快照集，快照策略是可选的。如果您不需要计划备份、保留锁定或有效期，则可以在没有快照策略的情况下创建快照集。您也可以使用 ALTER SNAPSHOT SET 将快照策略随后应用到现有快照集，或者暂停和恢复快照策略中指定的计划备份。

另请参阅：: ALTER SNAPSHOT POLICY、DROP SNAPSHOT POLICY、SHOW SNAPSHOT POLICIES、CREATE SNAPSHOT SET ALTER SNAPSHOT SET

语法¶

CREATE [OR REPLACE] SNAPSHOT POLICY [IF NOT EXISTS] <name>
   [ WITH RETENTION LOCK ]
   [ SCHEDULE = '{ <num> MINUTE | USING CRON <expr> <time_zone> }' ]
   [ EXPIRE_AFTER_DAYS = <days_integer> ]
   [ COMMENT = <string> ];

Copy

必填参数¶

name

快照策略的标识符；对于您的账户必须唯一。

此外，标识符必须以字母字符开头，且不能包含空格或特殊字符，除非整个标识符字符串放在双引号内（例如，"My object"）。放在双引号内的标识符也区分大小写。

有关更多信息，请参阅标识符要求。

可选参数¶

OR REPLACE

如果存在同名快照策略，则删除现有快照策略并创建新的快照策略。此子句与 IF NOT EXISTS 互斥。

IF NOT EXISTS

仅当不存在同名快照策略时，才会创建快照策略。如果快照策略已存在，则该命令将返回成功消息（即使其未产生实际效果）。此子句与 OR REPLACE 互斥。

WITH RETENTION LOCK

指定快照的强制保留期。即使是特权用户也无法删除带有保留锁定的快照。有关更多信息，请参阅具有保留锁定的快照的限制。

备注

只有具备 APPLY SNAPSHOT RETENTION LOCK 权限的用户才能创建具有保留锁定的快照策略。

重要

对快照集应用带保留锁定的快照策略是 不可逆操作。由于监管合规性所需的强保障要求，对快照集设置保留锁定后，您将无法撤销该锁定。Snowflake 支持部门也无法撤销此类保留锁定。在对具有较长有效期的快照集设置保留锁定前，请谨慎规划，以避免产生不可删除的快照集及其所含模式和数据库的意外存储费用。

如果删除了 Snowflake 组织，该组织将不再是 Snowflake 客户。此种情况下，Snowflake 会删除所有快照（包括带保留锁定的快照）。删除 Snowflake 组织需要 Snowflake 支持部门介入。管理员不可能意外执行此操作。

SCHEDULE = '{ num MINUTE | USING CRON expr time_zone }'

指定创建对象快照的计划。

备注

快照的最短计划必须为 60 分钟。

每个快照策略都必须具有一个或两个计划和有效期属性。有关更多信息，请参阅快照策略。

USING CRON expr time_zone
为创建对象快照的时间点指定 cron 表达式和时区。支持标准 cron 实用程序语法的子集。

有关时区列表，请参阅 ` tz 数据库时区列表 <https://en.wikipedia.org/wiki/List_of_tz_database_time_zones (link removed)>`_ （在维基百科中）。

cron 表达式由以下字段组成：
# __________ minute (0-59) # | ________ hour (0-23) # | | ______ day of month (1-31, or L) # | | | ____ month (1-12, JAN-DEC) # | | | | __ day of week (0-6, SUN-SAT, or L) # | | | | | # | | | | | * * * * *
支持以下特殊字符：

*
通配符。指定字段的任何出现。

L
代表“last”。在星期几字段中使用时，它允许您指定结构，例如给定月份的“最后一个星期五”（“5L”）。在日期字段中，它指定该月的最后一天。

/n
指示给定时间单位的第 n 个实例。每个时间量子都是独立计算的。例如，如果在月份字段中指定 4/3，则快照将安排在 4 月、7 月和 10 月执行（即从一年中的第 4 个月开始，每 3 个月一次）。在随后的几年中保持相同的计划。也就是说，快照不会安排在 1 月（10 月运行后 3 个月）运行。
备注
- cron 表达式当前仅根据指定的时区进行计算。更改账户的 TIMEZONE 参数值（或在用户或会话级别设置该值）:emph:不会 更改快照的时区。
- cron 表达式定义快照的所有有效运行时间。Snowflake 尝试根据此计划创建快照；但是，如果在下一个有效运行时间开始之前未完成上一次运行，则跳过任何有效运行时间。
- 当 cron 表达式中同时包含一个月中的特定一天和一周中的某一天时，快照将计划在满足该月中的某一天或一周中的某一天的日期。例如，SCHEDULE = 'USING CRON 0 0 10-20 * TUE,THU UTC' 计划在每月的任何第 10 到 20 天以及这些日期之外任何星期二或星期四的 0AM（午夜）运行快照。
num MINUTE
指定快照之间的等待时间间隔（以分钟为单位）。仅接受正整数。

还支持 num M 语法。

为避免歧义，在以下情况下设置了 基本间隔时间：
- 创建对象时（使用 CREATE SNAPSHOT SET ... WITH SNAPSHOT POLICY）。
- 当设置不同的间隔时（使用 ALTER SNAPSHOT SET ... APPLY SNAPSHOT POLICY 或 ALTER SNAPSHOT POLICY ... SET SCHEDULE）。
基本间隔时间从当前时钟时间开始间隔计数器。例如，如果将 INTERVAL 值设置为 10，并在 9:03 AM 启用计划快照，则下一个快照将在 9:13 AM、9:23 AM 创建，以此类推。请注意，我们尽最大努力确保绝对精度，但仅保证快照不会在设定的时间间隔发生之前执行（即，在当前示例中，快照可以首先在 9:14 AM 运行，但绝对不会在 9:12 AM 运行）。

EXPIRE_AFTER_DAYS = days_integer

指定距离快照过期的天数。Snowflake 会自动删除过期的快照。如果未指定此参数，则快照将保留在快照集中，直到从快照集中手动删除为止。

最小值：1。
如果您未指定 SCHEDULE 子句，则最大值：``3653``（大约 10 年）。如果您指定了 SCHEDULE 子句，则最大值取决于拍摄快照的频率。有关更多信息，请参阅公共预览期间快照的限制。

备注

每个快照策略都必须具有一个或两个计划和有效期属性。有关更多信息，请参阅快照策略。

COMMENT = 'string_literal'

指定快照策略的注释。

默认：无值

访问控制要求¶

用于执行此操作的角色必须至少具有以下权限：

权限	备注
CREATE SNAPSHOT POLICY	用于创建快照策略的角色必须具有架构（在其中创建该策略）的这一权限。
APPLY SNAPSHOT RETENTION LOCK	只有具备该账户的这一权限的用户才能创建具有保留锁定的快照策略。

有关创建具有指定权限集的自定义角色的说明，请参阅创建自定义角色。

有关对安全对象执行 SQL 操作的相应角色和权限授予的一般信息，请参阅访问控制概述。

使用说明¶

Time Travel 和故障安全保留不适用于快照。快照过期后无法恢复。
关于元数据：

注意

客户应确保在使用 Snowflake 服务时，不会将个人数据（用户对象除外）、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息，请参阅 Snowflake 中的元数据字段。

重要

如果快照策略应用了保留锁定，并且快照集中有任何未过期的快照，则您无法删除该快照集。在这种情况下，必须等待快照集中的所有快照过期。此限制甚至适用于特权角色（如 ACCOUNTADMIN）和 Snowflake 支持部门。因此，在快照策略中指定保留锁定和较长有效期时务必谨慎。

示例¶

创建快照策略，该策略每小时创建一次快照，并在 90 天后过期：

CREATE SNAPSHOT POLICY hourly_snapshot_policy
  SCHEDULE = '60 MINUTE'
  EXPIRE_AFTER_DAYS = 90
  COMMENT = 'Hourly snapshots that expire after 90 days';

Copy

创建具有保留锁定的快照策略，该策略每 24 小时创建一次快照，并在 90 天后过期。在有效期结束之前，无法修改或删除使用此快照策略创建的快照：

CREATE SNAPSHOT POLICY daily_snapshot_policy_with_lock
  WITH RETENTION LOCK
  SCHEDULE = '1440 MINUTE'
  EXPIRE_AFTER_DAYS = 90
  COMMENT = 'regulatory backups expire after 90 days with retention lock';

Copy

使用 cron 表达式为计划创建快照策略。以下语句可创建策略，该策略在每周的周二和周五 11PM 创建快照：

CREATE SNAPSHOT POLICY twice_weekly_snapshot_policy
  SCHEDULE = 'USING CRON 0 23 * * 2,5 UTC'
  EXPIRE_AFTER_DAYS = 7
  COMMENT = 'Twice-weekly snapshots that expire after 7 days';

Copy