备份和不可变存储的快照¶

快照¶

快照 代表对象的时间点备份。

• 对象可以是单个表、架构或整个数据库。

• 特定的快照可以通过 Snowflake 生成的唯一 ID 来识别。

• 快照无法修改。但是，可以删除，并且可以修改快照的有效期（除非应用 保留锁定）。

在日常操作期间，您很少与单个快照进行交互。相反，您可以管理包含它们的 快照集。例如，您可以通过运行 SHOW SNAPSHOTS IN SNAPSHOT SET 命令来获得快照列表。您可以通过运行 ALTER SNAPSHOT SET 命令来创建新快照。

快照集¶

快照集 是架构级对象，包含特定数据库、架构或表的一组快照。Snowflake 提供 SQL 命令，用于对快照集进行 CREATE、ALTER、DROP、SHOW 和 DESCRIBE 操作。

您可以为同一个对象设置多个快照集。在公共预览期间，同一对象的快照集数量受到限制。有关更多信息，请参阅 公共预览期间快照的限制。

集合内快照的生命周期由可选的 快照策略 决定，您可以将其附加到快照集。您还可以在快照集中手动添加或删除快照。您删除快照的能力受其他因素的影响，尤其是 保留锁定 和 法律保留。

快照策略¶

快照策略 是架构级对象，包含定义快照集内快照生命周期的设置。这些设置包括时间表、到期时间和保留锁定。

• 时间表 决定何时创建快照。时间表可以定义为以分钟为单位的时间间隔，也可以定义为 cron 表达式。例如，如果将时间表设置为一小时，则每 60 分钟拍摄一次对象快照。

• 到期期限 是快照的有效时长。快照到期后，Snowflake 会自动将其删除，除非对该特定快照进行了法律保留。

  小技巧

  如果快照集没有保留锁定且特定快照未应用法律保留，则可以在有效期结束之前手动删除快照。您可以手动逐一删除快照，始终从没有法律保留的最早快照开始。

每个快照策略都必须具有一个或两个计划和有效期属性。例如，您可以创建具有时间表和有效期的策略，并让 Snowflake 处理应用该策略的所有快照集中快照的创建和移除。或者，如果您想自己管理旧快照的移除，则可以创建有时间表且没有有效期的策略。或者，您可以创建有有效期但没有时间表的策略，然后自己管理快照创建。您无法创建没有时间表和有效期的策略。

如果将快照策略与快照集相关联，则可以在创建快照集时进行关联，也可以稍后应用该策略。或者，您可以拥有一个没有关联快照策略的快照集。在这种情况下，您可以手动控制何时拍摄新快照和使旧快照过期。

您可以将快照策略应用于多个快照集。如果您修改快照策略，Snowflake 会将变更应用到该策略所关联的所有快照集。

保留锁定¶

保留锁定 可保护快照在规定的有效期内不被删除。您可以使用带保留锁定的快照进行备份，以实现合规性和网络弹性。以下限制适用于具有保留锁定的快照集：

• 任何角色（包括 ACCOUNTADMIN 角色）都无法删除快照。

• 您无法缩短快照的有效期，但可以延长该期限。

• 如果快照集中有任何未到期的快照，您无法删除该快照集。

• 如果架构包含的快照集有任何未到期的快照，您无法删除该架构。

• 如果数据库包含的快照集有任何未到期的快照，您无法删除该数据库。

• 如果账户包含的数据库具有含任何未到期的快照的快照集，您无法删除该账户。

法律保留¶

Snowflake 快照的 法律保留 功能可防止快照被覆盖或删除。这样，您就可以根据自己的法律要求保留 Snowflake 数据库、架构或表。

Snowflake 允许您对特定快照进行法律保留。当 Snowflake 快照处于法律保留状态时，以下条件适用：

• 任何人都无法修改快照。

• 任何人都无法删除快照。即使快照已经过了 EXPIRE_AFTER_DAYS 期限，也是如此。

• 对快照的访问记录在案，可进行审计。

• 与保留锁定不同，特权用户可以移除法律保留。

快照生命周期概述¶

下图显示了 Snowflake 对象、快照、快照集和快照策略之间的关系。该图涉及最简单的快照：单个表的快照。每项备份操作都会生成一个新快照。该特定对象的所有快照都组合在一个快照集中。快照集中快照的自动添加和移除受快照策略的约束。要从快照中恢复信息，您可以使用 CREATE 命令从特定快照中创建新对象。

公共预览期间快照的限制¶

当快照功能正式发布时，以下限制可能会发生变化：

• 当您为快照设置定期计划时，Snowflake 会根据计划快照的频率规定最长保留期。在快照策略中，EXPIRE_AFTER_DAYS 属性根据关联的 SCHEDULE 属性受到限制，如下所示：

  • 频率为 60 到 119 分钟的快照策略的最大 EXPIRE_AFTER_DAYS 值为 90。

  • 频率为 120 分钟到 23 小时 59 分钟的快照策略的最大 EXPIRE_AFTER_DAYS 值为 180。

  • 频率为 24 小时或更长时间的快照策略的最大 EXPIRE_AFTER_DAYS 值为 366。

  • 没有计划的快照策略的最大 EXPIRE_AFTER_DAYS 值为 3653。

• 您最多可以为特定数据库创建两个数据库快照集。同样，您最多可以为特定架构创建两个架构快照集，为特定表创建两个表快照集。一个对象可能仍出现在两个以上的快照集中。例如，一个表可能有一个或两个关联的表快照集。同一个表也可能包含在一个或两个架构快照集中，以及一个或两个数据库快照集中。

• 将快照策略应用于快照集后，您无法从该快照集中移除该策略。

从表到其他对象的引用¶

对象（例如视图或函数）可以引用快照中架构或数据库之外的对象。为确保此类引用在您从快照恢复后继续运行，请使用以下策略之一：

• 如果表及其引用的其他对象都在同一个架构或同一个数据库中，则为整个架构或数据库创建快照集。这样，当您从快照恢复时，Snowflake 可以一次恢复所有相互连接的对象。

• 如果快照集中的对象引用未包含在快照集中的对象，请注意，恢复快照时，恢复对象的引用指向来自其他数据库或架构的原始对象。如果您在拍摄快照后删除了这些其他对象或更改了其属性，则在访问恢复的对象时可能会遇到错误。

• 对于账户级对象，来自恢复对象的任何引用 始终 指向原始账户级对象。那是因为账户级对象不是任何快照的一部分。例如，架构快照可能包含一个涉及安全集成的密钥。安全集成是账户级对象，不能包含在任何快照中。

数据库和架构快照中的对象类型¶

下表列出了数据库或架构快照中包含的对象：

Snowflake 如何将对象与其快照集相关联¶

当您为数据库、架构或表创建快照集时，Snowflake 会将快照集与该数据库、架构或表的内部 ID 关联。如果您删除原始对象，则无法再向该快照集添加任何快照。即使您重新创建同名对象，或者将其替换为从快照恢复的对象，此行为也适用。

如果您改为重命名原始对象，则可以通过向同一快照集添加更多快照来继续对其进行更多备份。在这种情况下，SHOW SNAPSHOT SETS 的输出会更改以反映重命名对象的 OBJECT_NAME 值。

如果您想备份某个表，但您频繁删除并重新创建该表（可能通过 CREATE OR REPLACE 语句），请将其包含在包含该表的架构或数据库的快照集中。这样，无论表有何更改，您都可以继续使用相同的快照集。

当您从快照恢复表时，恢复的表以不同于原始表的名称开头。假设您想要将原始表的内容完全替换为快照数据，并继续使用相同的快照集对同一表进行更多备份。在这种情况下，使用 TRUNCATE 或 DELETE 语句移除原始表的内容，并使用 INSERT ... SELECT 语句从恢复的表中复制数据。不要删除原始表，也不要将恢复的表重命名为原始表的名称。

快照和加密¶

快照集中的数据受与其他 Snowflake 对象和表数据相同的端到端加密保护。有关 Snowflake 加密的更多信息，请参阅 了解 Snowflake 中的端到端加密。

密钥轮换也适用于快照中的数据。

快照和数据沿袭¶

Snowflake 不使用数据库、架构和表快照保留 数据沿袭 元数据。从快照恢复对象后，您无法使用 Snowsight 查看恢复的数据的沿袭信息。

授予创建快照策略和集所需的权限¶

要使角色 myrole 能够在架构 myschema 中创建快照策略，请执行以下语句：

GRANT CREATE SNAPSHOT POLICY ON SCHEMA policy_schema TO ROLE myrole;

要使角色 myrole 能够在架构 myschema 中创建快照集，请执行以下语句：

GRANT CREATE SNAPSHOT SET ON SCHEMA policy_schema TO ROLE myrole;

向角色授予快照策略的 APPLY 权限¶

要使角色 myrole 能够将快照策略 hourly_snapshot_policy 应用到快照集，请执行以下语句：

GRANT APPLY ON SNAPSHOT POLICY hourly_snapshot_policy TO ROLE myrole;

向角色授予 APPLY SNAPSHOT RETENTION LOCK 权限¶

您可以向角色授予在快照集上应用具有保留锁定的快照策略的权限。

只有拥有 ACCOUNTADMIN 角色的用户才能授予此权限。

要使角色 retention_lock_admin_role 能够对快照集应用具有保留锁定的快照策略，请执行以下语句：

GRANT APPLY SNAPSHOT RETENTION LOCK ON ACCOUNT TO ROLE retention_lock_admin_role;

创建计划快照¶

创建按计划自动创建快照的快照集。

1. 使用 CREATE SNAPSHOT POLICY 命令创建快照策略。例如，从创建快照集之时起，以下策略每小时创建一次快照。每个快照在 90 天后到期。

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

   Copy

2. 为表 t1 创建快照集并附加快照策略 hourly_snapshot_policy：

   CREATE SNAPSHOT SET t1_snapshots
     FOR TABLE t1
     WITH SNAPSHOT POLICY hourly_snapshot_policy;
   

   Copy

3. 为架构 s1 创建快照集并附加快照策略 hourly_snapshot_policy：

   CREATE SNAPSHOT SET s1_snapshots
     FOR SCHEMA s1
     WITH SNAPSHOT POLICY hourly_snapshot_policy;
   

   Copy

4. 为数据库 d1 创建快照集并附加快照策略 hourly_snapshot_policy：

   CREATE SNAPSHOT SET d1_snapshots
     FOR DATABASE d1
     WITH SNAPSHOT POLICY hourly_snapshot_policy;
   

   Copy

创建具有保留锁定的计划快照¶

创建快照集，按计划自动创建具有保留锁定的快照。保留锁定可防止任何人（甚至是特权用户）删除或修改该策略所附加到的任何快照集中的快照。

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

1. 创建具有保留锁定的策略，用于创建有效期为 90 天的每日快照：

   CREATE SNAPSHOT POLICY daily_snapshot_policy_with_lock
     WITH RETENTION LOCK
     SCHEDULE = '1440 MINUTE'
     EXPIRE_AFTER_DAYS = 90
     COMMENT = 'regulatory backups: they have a retention lock and expire after 90 days';
   

   Copy

2. 为表 t2 创建快照集并附加快照策略 daily_snapshot_policy_with_lock：

   CREATE SNAPSHOT SET t2_snapshots
     FOR TABLE t2
     WITH SNAPSHOT POLICY daily_snapshot_policy_with_lock;
   

   Copy

3. 为架构 s2 创建快照集并附加快照策略 daily_snapshot_policy_with_lock：

   CREATE SNAPSHOT SET s2_snapshots
     FOR SCHEMA s2
     WITH SNAPSHOT POLICY daily_snapshot_policy_with_lock;
   

   Copy

4. 为数据库 d2 创建快照集并附加快照策略 daily_snapshot_policy_with_lock：

   CREATE SNAPSHOT SET d2_snapshots
     FOR DATABASE d2
     WITH SNAPSHOT POLICY daily_snapshot_policy_with_lock;
   

   Copy

手动创建快照¶

您可以随时手动向快照集添加快照。此操作会生成与快照集关联的数据库、架构或表的快照。无论快照集是否还有按快照策略计划的快照，您都可以手动创建快照。如果存在与快照集关联的快照策略，并且该策略定义了有效期，则该有效期也适用于手动创建的快照。

以下示例创建了一个表快照集 t1_snapshots，然后向其添加第一个快照：

CREATE SNAPSHOT SET t1_snapshots FOR TABLE t1;
ALTER SNAPSHOT SET t1_snapshots ADD SNAPSHOT;

以下示例创建了一个包含每小时备份的快照策略、一个使用该策略的表快照集 t2_snapshots，然后向该快照集添加手动创建的快照：

CREATE SNAPSHOT POLICY hourly_snapshot_policy
  SCHEDULE = '60 MINUTE'
  EXPIRE_AFTER_DAYS = 7;

CREATE SNAPSHOT SET t2_snapshots FOR TABLE t2 WITH SNAPSHOT POLICY hourly_snapshot_policy;
-- Wait several hours. Then the snapshot set already contains several scheduled snapshots.
-- You can manually add a snapshot at any time, in addition to the scheduled snapshots.
ALTER SNAPSHOT SET t2_snapshots ADD SNAPSHOT;

您可以运行类似的命令，将快照添加到架构或数据库快照集。替换 ALTER SNAPSHOT SET 命令中架构或数据库快照集的名称。

暂停快照集的快照策略¶

当您暂停快照集的快照策略时，会阻止该快照策略用于在该快照集中创建新的计划快照。您还可以暂停该快照集中使用快照策略的现有快照的到期时间。使用相同策略的其他快照集不受影响。

以下示例暂停快照集 t2_snapshots 的快照策略：

ALTER SNAPSHOT SET t2_snapshots SUSPEND SNAPSHOT POLICY;

Copy

有关 ALTER SNAPSHOT SET 命令的更多信息，请参阅 ALTER SNAPSHOT SET。

恢复快照集的快照策略¶

您可以恢复已暂停的快照策略。根据快照策略，此操作会恢复快照的创建和到期。如果在策略暂停期间有任何快照已达到到期时间，Snowflake 将在策略恢复后立即删除这些快照。

以下示例恢复快照集 t1_snapshot 的快照策略：

ALTER SNAPSHOT SET t1_snapshots
  RESUME SNAPSHOT POLICY;

Copy

有关 ALTER SNAPSHOT SET 命令的更多信息，请参阅 ALTER SNAPSHOT SET。

恢复快照¶

您可以使用特定快照的 ID，从快照集恢复对象。例如，要从当前架构中的快照集 t1_snapshots 恢复表 t1，请执行以下语句：

1. 在 snapshot_id 列中找到要恢复的表快照的 ID：

   SHOW SNAPSHOTS IN SNAPSHOT SET t1_snapshots ->> SELECT "created_on", "snapshot_id", "expire_on" FROM $1;
   

   Copy

   +-------------------------------+--------------------------------------+-------------------------------+
   | created_on                    | snapshot_id                          | expire_on                     |
   |-------------------------------+------------------------------------------+---------------------------|
   | 2024-08-19 17:12:28.991 -0700 | 983e0b66-91eb-41cb-8a0b-037abfec1914 | 2024-08-20 17:12:28.991 -0700 |
   | 2024-08-19 18:12:33.824 -0700 | b5624ef0-1f35-452f-b132-09d8f0592e52 | 2024-08-20 18:12:33.824 -0700 |
   | 2024-08-19 19:12:43.830 -0700 | eca1a94a-fd40-46db-a2bc-4afba6a38c0a | 2024-08-20 19:12:43.830 -0700 |
   | 2024-08-19 20:12:45.446 -0700 | 8ee2fd7e-1afe-42e1-acd7-79582765a910 | 2024-08-20 20:12:45.446 -0700 |
   | 2024-08-19 21:12:55.305 -0700 | d38caf14-f8a5-4ba8-a248-8287e0cdcf40 | 2024-08-20 21:12:55.305 -0700 |
   +-------------------------------+--------------------------------------+-----------+-------------------+
   

2. 在 snapshot_id 列中找到要恢复的架构快照的 ID：

   SHOW SNAPSHOTS IN SNAPSHOT SET s1_snapshots;
   

   Copy

   +-------------------------------+--------------------------------------+-------------------------------+
   | created_on                    | snapshot_id                          | expire_on                     |
   |-------------------------------+--------------------------------------+-------------------------------|
   | 2024-08-19 17:12:28.991 -0700 | 0a0382e1-d265-46e9-b152-4c3b2b859e65 | 2024-08-20 17:12:28.991 -0700 |
   | 2024-08-19 18:12:33.824 -0700 | 8dbcf919-3393-4590-928f-5481d7f2502f | 2024-08-20 18:12:33.824 -0700 |
   | 2024-08-19 19:12:43.830 -0700 | 8ee2fd7e-1afe-42e1-acd7-79582765a910 | 2024-08-20 19:12:43.830 -0700 |
   | 2024-08-19 20:12:45.446 -0700 | bd729a79-01bc-444d-a550-adaaa31ab62f | 2024-08-20 20:12:45.446 -0700 |
   | 2024-08-19 21:12:55.305 -0700 | 9a8802c5-5fbd-4200-a09d-43e046103939 | 2024-08-20 21:12:55.305 -0700 |
   +-------------------------------+--------------------------------------+-------------------------------+
   

3. 在 snapshot_id 列中找到要恢复的数据库快照的 ID：

   SHOW SNAPSHOTS IN SNAPSHOT SET d1_snapshots;
   

   Copy

   +-------------------------------+--------------------------------------+-------------------------------+
   | created_on                    | snapshot_id                          | expire_on                     |
   |-------------------------------+--------------------------------------+-------------------------------|
   | 2024-08-19 17:12:28.991 -0700 | 42435925-4e77-4b01-ba89-8163ac03e12f | 2024-08-20 17:12:28.991 -0700 |
   | 2024-08-19 18:12:33.824 -0700 | 29c2c1b9-6599-4f0b-87b8-d43377fd7c77 | 2024-08-20 18:12:33.824 -0700 |
   | 2024-08-19 19:12:43.830 -0700 | a4283984-a063-4415-acc4-0e3c19259fad | 2024-08-20 19:12:43.830 -0700 |
   | 2024-08-19 20:12:45.446 -0700 | ffe25397-64b9-4c5f-b061-23a1885dc2dc | 2024-08-20 20:12:45.446 -0700 |
   | 2024-08-19 21:12:55.305 -0700 | 28e12b8a-aab8-40a8-ae39-9a5a5f654d66 | 2024-08-20 21:12:55.305 -0700 |
   +-------------------------------+--------------------------------------+-------------------------------+
   

4. 恢复在 2024 年 8 月 19 日 18:12:33 拍摄的表 t1 的快照：

   CREATE TABLE restored_t1 FROM SNAPSHOT SET t1_snapshots IDENTIFIER 'b5624ef0-1f35-452f-b132-09d8f0592e52';
   

   Copy

5. 恢复在 2024 年 8 月 19 日 18:12:33 拍摄的架构 s1 的快照：

   CREATE SCHEMA restored_s1 FROM SNAPSHOT SET s1_snapshots IDENTIFIER '8dbcf919-3393-4590-928f-5481d7f2502f';
   

   Copy

6. 恢复在 2024 年 8 月 19 日 18:12:33 拍摄的数据库 d1 的快照：

   CREATE DATABASE restored_d1 FROM SNAPSHOT SET d1_snapshots IDENTIFIER '29c2c1b9-6599-4f0b-87b8-d43377fd7c77';
   

   Copy

从快照集中删除快照¶

对于任何快照集，您只能删除没有法律保留的最早快照。您可以通过指定快照 ID 来完成此操作。您可以通过检查 is_under_legal_hold 属性来找到没有法律保留的快照。您可以通过检查 created_on 属性来找到最早的快照。

备注

如果将具有保留锁定的快照策略附加到快照集，或者该特定快照已应用法律保留，则无法从该快照集中删除任何快照。

您从快照集中删除的快照必须是该快照集中最早的快照。

1. 在以下输出的 snapshot_id 列中找到要删除的表快照的 ID。按 created_on 列升序排序，将最早的快照放在首位。您可以向 SELECT 命令添加 LIMIT 1，仅返回包含最早快照的详细信息的行。

   SHOW SNAPSHOTS IN SNAPSHOT SET t1_snapshots ->>
     SELECT "created_on", "snapshot_id", "expire_on" FROM $1
       WHERE "is_under_legal_hold" = 'N'
       ORDER BY "created_on";
   

   Copy

   +-------------------------------+--------------------------------------+-------------------------------+
   | created_on                    | snapshot_id                          | expire_on                     |
   |-------------------------------+--------------------------------------+-------------------------------|
   | 2024-08-19 17:12:28.991 -0700 | 983e0b66-91eb-41cb-8a0b-037abfec1914 | 2024-08-20 17:12:28.991 -0700 |
   | 2024-08-19 18:12:33.824 -0700 | b5624ef0-1f35-452f-b132-09d8f0592e52 | 2024-08-20 18:12:33.824 -0700 |
   | 2024-08-19 19:12:43.830 -0700 | eca1a94a-fd40-46db-a2bc-4afba6a38c0a | 2024-08-20 19:12:43.830 -0700 |
   | 2024-08-19 20:12:45.446 -0700 | 8ee2fd7e-1afe-42e1-acd7-79582765a910 | 2024-08-20 20:12:45.446 -0700 |
   | 2024-08-19 21:12:55.305 -0700 | d38caf14-f8a5-4ba8-a248-8287e0cdcf40 | 2024-08-20 21:12:55.305 -0700 |
   +-------------------------------+--------------------------------------+-------------------------------+
   

2. 使用 snapshot_id 删除在 2024 年 8 月 19 日 17:12:28 创建的 t1_snapshots 快照：

   ALTER SNAPSHOT SET t1_snapshots DELETE SNAPSHOT IDENTIFIER '983e0b66-91eb-41cb-8a0b-037abfec1914';
   

   Copy

3. 在以下输出的 snapshot_id 列中找到要删除的架构快照的 ID。

   SHOW SNAPSHOTS IN SNAPSHOT SET s1_snapshots ->>
     SELECT "created_on", "snapshot_id", "expire_on" FROM $1 ORDER BY "created_on";
   

   Copy

   +-------------------------------+--------------------------------------+-------------------------------+
   | created_on                    | snapshot_id                          | expire_on                     |
   |-------------------------------+--------------------------------------+-------------------------------|
   | 2024-08-19 17:12:28.991 -0700 | 28e12b8a-aab8-40a8-ae39-9a5a5f654d66 | 2024-08-20 17:12:28.991 -0700 |
   | 2024-08-19 18:12:33.824 -0700 | 46a1e22a-8557-432f-a14c-1261a4ca2b34 | 2024-08-20 18:12:33.824 -0700 |
   | 2024-08-19 19:12:43.830 -0700 | 3e42fef6-b895-4055-a59f-179744d015d3 | 2024-08-20 19:12:43.830 -0700 |
   | 2024-08-19 20:12:45.446 -0700 | 7807d24e-285e-4741-b332-87c32bad5cb6 | 2024-08-20 20:12:45.446 -0700 |
   | 2024-08-19 21:12:55.305 -0700 | e022e619-ee83-45a0-b2b7-9007e284bdb3 | 2024-08-20 21:12:55.305 -0700 |
   +-------------------------------+--------------------------------------+-------------------------------+
   

4. 使用 snapshot_id 删除在 2024 年 8 月 19 日 17:12:28 创建的 s1_snapshots 快照：

   ALTER SNAPSHOT SET s1_snapshots DELETE SNAPSHOT IDENTIFIER '28e12b8a-aab8-40a8-ae39-9a5a5f654d66';
   

   Copy

5. 在以下输出的 snapshot_id 列中找到要删除的数据库快照的 ID。

   SHOW SNAPSHOTS IN SNAPSHOT SET d1_snapshots ->>
     SELECT "created_on", "snapshot_id", "expire_on" FROM $1 ORDER BY "created_on";
   

   Copy

   +-------------------------------+--------------------------------------+-------------------------------+
   | created_on                    | snapshot_id                          | expire_on                     |
   |-------------------------------+--------------------------------------+-------------------------------|
   | 2024-08-19 17:12:28.991 -0700 | d3a77432-c98d-4969-91a9-fffae5dd655c | 2024-08-20 17:12:28.991 -0700 |
   | 2024-08-19 18:12:33.824 -0700 | 0a0382e1-d265-46e9-b152-4c3b2b859e65 | 2024-08-20 18:12:33.824 -0700 |
   | 2024-08-19 19:12:43.830 -0700 | 25e01ee0-ea9d-4bb7-af7f-f3fe87f9409e | 2024-08-20 19:12:43.830 -0700 |
   | 2024-08-19 20:12:45.446 -0700 | a12294f5-fc63-49cf-84f1-c7b72f7664af | 2024-08-20 20:12:45.446 -0700 |
   | 2024-08-19 21:12:55.305 -0700 | 28e12b8a-aab8-40a8-ae39-9a5a5f654d66 | 2024-08-20 21:12:55.305 -0700 |
   +-------------------------------+--------------------------------------+-------------------------------+
   

6. 使用 snapshot_id 删除在 2024 年 8 月 19 日 17:12:28 创建的 d1_snapshots 快照：

   ALTER SNAPSHOT SET d1_snapshots DELETE SNAPSHOT IDENTIFIER 'd3a77432-c98d-4969-91a9-fffae5dd655c';
   

   Copy

7. 尝试删除在 2024 年 8 月 19 日 21:12:55 创建的更新 d1_snapshots 快照。注意 Snowflake 如何防止您删除快照集中最早快照以外的快照。

   ALTER SNAPSHOT SET d1_snapshots DELETE SNAPSHOT IDENTIFIER '28e12b8a-aab8-40a8-ae39-9a5a5f654d66';
   

   Copy

   Snapshot '28e12b8a-aab8-40a8-ae39-9a5a5f654d66' cannot be deleted as it is not the oldest active snapshot in the snapshot set D1_SNAPSHOTS.
   

删除快照集¶

您可以使用 DROP SNAPSHOT SET 命令删除快照集。

删除 t1_snapshots 快照集：

DROP SNAPSHOT SET t1_snapshots;

删除 s1_snapshots 快照集：

DROP SNAPSHOT SET s1_snapshots;

删除 d1_snapshots 快照集：

DROP SNAPSHOT SET d1_snapshots;

查找所有包含特定表备份的快照集¶

以下示例说明如何在特定架构和数据库中查找包含特定表的所有快照集。SHOW TABLES 命令使用管道运算符检索数据库、架构和表的名称，并将它们存储在变量中。对 SHOW SNAPSHOT SETS 输出进行筛选以显示快照集，该快照集备份包含该表的数据库，或者包含该表或单个表的架构。

SHOW SNAPSHOT SETS 的筛选输出显示有两个针对数据库 MY_BIG_IMPORTANT_DATABASE 的数据库快照集、一个针对架构 MY_BIG_IMPORTANT_DATABASE.PUBLIC 的快照集，以及一个针对表 MY_BIG_IMPORTANT_DATABASE.PUBLIC.MY_SMALL_SECONDARY_TABLE 的表快照集。

SHOW TABLES IN SCHEMA public ->>
  SET (dname, sname, tname) =
    (SELECT "database_name", "schema_name", "name" FROM $1
      WHERE "name" = 'MY_SMALL_SECONDARY_TABLE' AND "kind" = 'TABLE');

SHOW SNAPSHOT SETS ->> SELECT "object_kind", "name", "database_name", "schema_name", "object_name" FROM $1
  WHERE ("object_kind" = 'TABLE' AND "database_name" = $dname AND "schema_name" = $sname AND "object_name" = $tname)
    OR ("object_kind" = 'SCHEMA' AND "database_name" = $dname AND "object_name" = $sname)
    OR ("object_kind" = 'DATABASE' AND "object_name" = $dname);

+-------------+------------------+---------------------------+-------------+---------------------------+
| object_kind | name             | database_name             | schema_name | object_name               |
|-------------+------------------+---------------------------+-------------+---------------------------|
| DATABASE    | DATABASE_BACKUP  | MY_BIG_IMPORTANT_DATABASE | PUBLIC      | MY_BIG_IMPORTANT_DATABASE |
| DATABASE    | DATABASE_BACKUP2 | MY_BIG_IMPORTANT_DATABASE | PUBLIC      | MY_BIG_IMPORTANT_DATABASE |
| SCHEMA      | SCHEMA_BACKUP3   | MY_BIG_IMPORTANT_DATABASE | PUBLIC      | PUBLIC                    |
| TABLE       | TABLE_BACKUP2    | MY_BIG_IMPORTANT_DATABASE | PUBLIC      | MY_SMALL_SECONDARY_TABLE  |
+-------------+------------------+---------------------------+-------------+---------------------------+

为具有依赖关系的表创建快照¶

以下示例显示如何为引用不同架构中序列和外键的表创建表快照。为做好准备，我们创建了包含序列和表的架构 other_schema。然后，我们在 public 架构中创建主表，引用序列和其他表。

USE DATABASE my_big_important_database;

CREATE SCHEMA other_schema;
USE SCHEMA other_schema;

CREATE SEQUENCE my_sequence;
CREATE TABLE my_dimension_table (id INT AUTOINCREMENT PRIMARY KEY);

USE SCHEMA public;
CREATE TABLE dependent_table
(
   id INT DEFAULT my_big_important_database.other_schema.my_sequence.NEXTVAL PRIMARY KEY,
   foreign_id INT,
   FOREIGN KEY (foreign_id) REFERENCES my_big_important_database.other_schema.my_dimension_table(id)
 );

SELECT GET_DDL('TABLE','dependent_table');

GET_DDL() 输出显示指向其他架构的引用：

+-------------------------------------------+
| GET_DDL('TABLE','DEPENDENT_TABLE')        |
|-------------------------------------------|
| create or replace TABLE DEPENDENT_TABLE ( |
|     ID NUMBER(38,0) NOT NULL DEFAULT MY_BIG_IMPORTANT_DATABASE.OTHER_SCHEMA.MY_SEQUENCE.NEXTVAL,
|     FOREIGN_ID NUMBER(38,0),                |
|     primary key (ID),                       |
|     foreign key (FOREIGN_ID) references MY_BIG_IMPORTANT_DATABASE.OTHER_SCHEMA.MY_DIMENSION_TABLE(ID)
| );                                        |
+-------------------------------------------+

接下来，我们为该表创建快照集并向其添加快照：

CREATE SNAPSHOT SET dependency_experiments FOR TABLE dependent_table;
ALTER SNAPSHOT SET dependency_experiments ADD SNAPSHOT;
SHOW SNAPSHOTS IN SNAPSHOT SET dependency_experiments;

SHOW SNAPSHOTS 输出包含用于恢复操作的 snapshot_id 值：

+-------------------------------+--------------------------------------+------------------------+---------------------------+--------------+-----------+
| created_on                    | snapshot_id                          | snapshot_set_name      | database_name             | schema_name  | expire_on |
|-------------------------------+--------------------------------------+------------------------+---------------------------+--------------+-----------|
| 2025-07-01 11:53:27.860 -0700 | 0fd44138-b571-449b-be0a-72779501f80e | DEPENDENCY_EXPERIMENTS | MY_BIG_IMPORTANT_DATABASE | OTHER_SCHEMA | NULL      |
+-------------------------------+--------------------------------------+------------------------+---------------------------+--------------+-----------+

我们使用新名称恢复该表，并确认恢复的表引用其他架构中的对象：

CREATE TABLE restored_dependent_table FROM SNAPSHOT SET dependency_experiments
  IDENTIFIER '0fd44138-b571-449b-be0a-72779501f80e';

SELECT GET_DDL('TABLE','restored_dependent_table');

+----------------------------------------------------+
| GET_DDL('TABLE','RESTORED_DEPENDENT_TABLE')        |
|----------------------------------------------------|
| create or replace TABLE RESTORED_DEPENDENT_TABLE ( |
|     ID NUMBER(38,0) NOT NULL DEFAULT MY_BIG_IMPORTANT_DATABASE.OTHER_SCHEMA.MY_SEQUENCE.NEXTVAL,
|     FOREIGN_ID NUMBER(38,0),                         |
|     foreign key (FOREIGN_ID) references MY_BIG_IMPORTANT_DATABASE.OTHER_SCHEMA.MY_DIMENSION_TABLE(ID),
|     primary key (ID)                                 |
| );                                                 |
+----------------------------------------------------+

为说明如果引用的对象不再存在时会发生什么，我们删除了序列，然后从同一个快照中再次恢复表：

DROP SEQUENCE my_big_important_database.other_schema.my_sequence;
CREATE TABLE OR REPLACE restored_dependent_table FROM SNAPSHOT SET dependency_experiments
  IDENTIFIER '0fd44138-b571-449b-be0a-72779501f80e';

SELECT * FROM restored_dependent_table;

查询表仍然有效：

+----+------------+
| ID | FOREIGN_ID |
|----+------------|
+----+------------+
0 Row(s) produced. Time Elapsed: 0.129s

但是，GET_DDL()、DESCRIBE 和 INSERT 之类的操作都会失败，因为它们依赖于已不存在的序列：

SELECT GET_DDL('TABLE','restored_dependent_table');

002073 (02000): SQL compilation error:
Sequence used as a default value in table 'MY_BIG_IMPORTANT_DATABASE.OTHER_SCHEMA.RESTORED_DEPENDENT_TABLE'
  column 'ID' was not found or could not be accessed.

DESC TABLE restored_dependent_table;

+------------+--------------+--------+-------+----------------------------------------+-------------+------------+-------+------------+---------+-------------+----------------+
| name       | type         | kind   | null? | default                                | primary key | unique key | check | expression | comment | policy name | privacy domain |
|------------+--------------+--------+-------+----------------------------------------+-------------+------------+-------+------------+---------+-------------+----------------|
| ID         | NUMBER(38,0) | COLUMN | N     | [sequence cannot be found or accessed] | Y           | N          | NULL  | NULL       | NULL    | NULL        | NULL           |
| FOREIGN_ID | NUMBER(38,0) | COLUMN | Y     | NULL                                   | N           | N          | NULL  | NULL       | NULL    | NULL        | NULL           |
+------------+--------------+--------+-------+----------------------------------------+-------------+------------+-------+------------+---------+-------------+----------------+

INSERT INTO restored_dependent_table (foreign_id) VALUES (2);

002073 (02000): SQL compilation error:
Sequence used as a default value in table 'MY_BIG_IMPORTANT_DATABASE.OTHER_SCHEMA.RESTORED_DEPENDENT_TABLE'
  column 'ID' was not found or could not be accessed.

为动态表创建快照¶

动态表总是涉及对某些其他表的引用。出于这个原因，您可能更愿意对动态表使用架构快照或数据库快照，这样原始表和动态表就可以包含在同一个快照中。

如果您为动态表创建表快照，则当您从快照恢复时，应在 CREATE SNAPSHOT SET 命令以及 CREATE TABLE 命令中包含关键字 DYNAMIC。以下示例设置动态表、该表的表快照集，并创建第一个快照：

CREATE DYNAMIC TABLE my_dynamic_table
  TARGET_LAG = '1 minute'
  WAREHOUSE = my_wh
  AS SELECT * FROM my_base_table WHERE col1 IS NOT NULL;

CREATE SNAPSHOT SET dynamic_table_snapshots
  FOR DYNAMIC TABLE my_dynamic_table;

ALTER SNAPSHOT SET dynamic_table_snapshots ADD SNAPSHOT;

以下示例说明如何确定在不同时间创建的快照的快照 IDs。在这种情况下，最新的快照是结果集中的第一行。然后，在 CREATE DYNAMIC TABLE 命令中使用快照的 ID。

SHOW SNAPSHOTS IN SNAPSHOT SET dynamic_table_snapshots
  ->> SELECT "created_on", "snapshot_id" FROM $1
        ORDER BY "created_on" DESC;

CREATE DYNAMIC TABLE restored_dynamic_table
  FROM SNAPSHOT SET dynamic_table_snapshots
    IDENTIFIER '<snapshot_id_from_SHOW_SNAPSHOTS_output>';

添加和移除法律保留¶

在处理 Snowflake 快照的法律保留之前，请了解其目的和要求。有关更多信息，请参阅 法律保留。

假设组织的法律或合规团队发送了诉讼保留请求，具体说明了需要保留哪些类型的数据。在这种情况下，您可以遵循以下流程：

• 与法律团队合作，确定相关数据的存储位置以及哪些快照集包含关联对象。

• 对快照集内相应时间段的快照进行法律保留。这样做会禁用该快照的任何自动到期。您可以对 Snowflake 根据计划自动创建的快照或您手动创建的快照设置法律保留。无论快照集是否具有相关的快照策略、有效期或保留锁定，法律保留均适用。

• 对于复制包含快照集的数据库的任何辅助账户，您可以执行刷新操作。这样，在任何故障转移和故障恢复操作中，法律保留和相关的快照都得以保留。

• 您可以使用 Snowflake 访问控制和日志来审核处于法律保留状态的数据的访问权限。

• 法律案件结束且法律团队批准移除法律保留后，具有 APPLY LEGAL HOLD 权限的用户将解除法律保留。然后，正常的自动到期将恢复。

此示例显示了在法律保留生命周期内对特定快照集内快照可使用的 SQL 命令序列。您可以使用 SHOW SNAPSHOTS IN SNAPSHOT SET 命令找到相关快照的标识符，然后检查 "is_under_legal_hold" 列以查看是否已存在法律保留。然后，您在特定快照中添加或移除法律保留。

USE ROLE <role_name>; -- use a role that has the APPLY LEGAL HOLD privilege
SHOW SNAPSHOTS IN SNAPSHOT SET <snapshot_set_name>
  ->> SELECT * FROM $1 WHERE "is_under_legal_hold" = 'N';
ALTER SNAPSHOT SET <snapshot_set_name>
  MODIFY SNAPSHOT IDENTIFIER '<snapshot_identifier>'
  ADD LEGAL HOLD;

USE ROLE <role_name>; -- use a role that has the APPLY LEGAL HOLD privilege
SHOW SNAPSHOTS IN SNAPSHOT SET <snapshot_set_name>
  ->> SELECT * FROM $1 WHERE "is_under_legal_hold" = 'Y';
ALTER SNAPSHOT SET <snapshot_set_name>
  MODIFY SNAPSHOT IDENTIFIER '<snapshot_identifier>'
  REMOVE LEGAL HOLD;

复制与快照相关的对象¶

当您将复制与数据库、架构和表快照结合使用时，您需要在复制组和故障转移组中指定包含快照集和快照策略的数据库。您可以管理复制组和故障转移组以及选择哪些数据库和架构包含您的快照集和快照策略，控制与快照相关的对象的复制方式。有关更多信息，请参阅 数据库、架构和表快照的快照复制。

快照集和快照策略是数据库对象。Snowflake 复制快照集和快照策略以及包含它们的数据库和架构。

Snowflake 使用类似于克隆的机制更大限度地减少快照的时间和存储使用量，因此每个快照不需要所有表数据的完整新副本。如果快照集与快照集应用的数据库、架构或表属于不同的故障转移组，则该复制组或故障转移组在首次刷新时会一次性完整传输数据。

当复制组或故障转移组包含快照集时，刷新延迟的增加与自上次刷新以来创建的快照数量成正比。

如果您为更早的快照定义了有效期，则自动删除将在主账户上进行。当您执行刷新操作时，这些到期的快照将从辅助账户中删除。

因此，您可以按照以下做法微调与快照相关的对象的复制：

• 为更大限度地减少刷新失败的机会，请将快照集和可选的快照策略放在同一个数据库和架构中。如果这不切实际，请将这些内容放在同一个复制组或故障转移组中。这样，所有这些相关对象都可以同时复制。

• 为最大限度地灵活确定要复制哪些快照相关对象和复制计划，请将快照集和可选快照策略放在与关联数据库、架构或表不同的数据库中。这样，您可以指定是否复制与快照相关的对象以及复制频率。

• 如果您对较早的快照应用具有有效期的策略，请使有效期长于复制刷新操作之间的间隔。这样，每个新快照都会在到期前至少复制到辅助账户一次。

• 添加法律保留后，立即对复制包含快照集的数据库的所有辅助账户执行刷新操作。这样，在任何故障转移和故障恢复操作中，法律保留和相关的快照都得以保留。

• 假设您将快照策略和关联的快照集放到属于不同复制组或故障转移组的数据库中。在这种情况下，请确保首先对包含快照策略的组进行初始刷新。否则，刷新操作将失败，因为您无法在辅助账户中创建缺少关联快照策略的快照集。

  备注

  在首次刷新包含快照集的组期间，要将快照集放入与快照集对象不同的复制组或故障转移组中，确实需要完全传输所有数据。

  如果您使用辅助账户恢复架构快照或数据库快照，则除非引用的对象与快照属于同一个故障转移组，否则对恢复架构或数据库中对象的引用可能无法正确解析。

监控快照和快照操作¶

您可以通过查询以下视图来确定存在哪些与快照相关的对象、它们的属性以及它们使用的存储空间。

Information Schema：

• SNAPSHOT_POLICIES 视图

• SNAPSHOT_SETS 视图

• SNAPSHOTS 视图

Account Usage：

• SNAPSHOT_OPERATION_HISTORY 视图

• SNAPSHOT_POLICIES 视图

• SNAPSHOT_SETS 视图

• SNAPSHOT_STORAGE_USAGE 视图

• SNAPSHOTS 视图

快照策略¶

• CREATE SNAPSHOT POLICY

• ALTER SNAPSHOT POLICY

• DROP SNAPSHOT POLICY

• SHOW SNAPSHOT POLICIES

快照集¶

• CREATE SNAPSHOT SET

• ALTER SNAPSHOT SET

• DROP SNAPSHOT SET

• SHOW SNAPSHOT SETS

快照¶

您没有运行实际的 CREATE SNAPSHOT 命令。要创建新快照，请运行 ALTER SNAPSHOT SET ... ADD SNAPSHOT。或者，当您将快照集与具有计划的快照策略关联时，Snowflake 会根据指定的计划自动在快照集中创建快照。要删除更早的快照，请运行 ALTER SNAPSHOT SET ... DELETE SNAPSHOT。此类操作需要您为特定快照指定标识符。您可以使用以下命令查找快照标识符以及其他信息，例如每个快照的创建时间。

• SHOW SNAPSHOTS IN SNAPSHOT SET

从快照中恢复对象¶

您可以使用语法 CREATE object_kind FROM SNAPSHOT SET 从相应的快照集恢复每种对象。

快照集中的其他快照使用原始对象，而不是恢复的对象。即使您将恢复的对象重命名为与原始对象相同的名称，也是如此。如果要在恢复后继续使用相同的快照集，则应使用新名称恢复对象，然后将数据传输回原始对象。

• CREATE DATABASE FROM SNAPSHOT SET

• CREATE SCHEMA FROM SNAPSHOT SET

• CREATE TABLE FROM SNAPSHOT SET

视图¶

以下系统视图包含与快照、快照集和快照策略相关的元数据。