Snowflake Postgres 时间点恢复¶

概述¶

Snowflake Postgres supports creating forks of an instance using point-in-time recovery (PITR). A fork is a new instance that reflects the state of an existing instance at a specific time. A fork is similar to a CLONE operation in Snowflake. However, unlike the CLONE operation, a fork performs a full copy of all of the origin data.

由于分支与源实例隔离，对分支进行的任何更改（包括架构或数据）都不会影响源实例。

在以下情况下，时间点恢复非常有用：

从意外更改中恢复，例如被删除的表或错误的数据更新。
检查数据的历史状态，以进行调试或审计。
在不影响源实例的情况下，使用生产数据的真实副本 测试应用程序变更。

分支是基于指定时间之前源实例的最新基础备份创建的。源实例的预写日志 (WAL) 记录会被回放到所选时间点，从而确保分支实例在该时刻与源实例在事务上保持一致。

分支中复制的内容¶

创建分支时，将从源实例复制以下内容：

Postgres 版本。复制版本以保证二进制兼容性。
高可用性设置（启用或禁用）。
用于访问实例的凭据。

在创建新实例时，您可以自定义一些属性，例如存储和 实例大小（计划）。分支实例的定价与其他实例一样，取决于分支的配置（计划、存储和高可用性）。

创建分支¶

在导航菜单中，选择 Postgres。
选择要创建分支的实例。
在 Postgres Instance 页面的 Manage 下，选择 Fork 项，并输入配置选项。
选择 Fork 以创建分支。

要将 Postgres 实例创建为源实例的分支，请执行 CREATE POSTGRES INSTANCE 命令，并指定 FORK 子句。该命令会根据 AT 或 BEFORE 子句指定的时间点，从源实例创建分支。如果省略该子句，分支将基于源实例的当前状态创建。

CREATE POSTGRES INSTANCE <name>
  FORK <orig_name>
  [ { AT | BEFORE } ( { TIMESTAMP => <timestamp> | OFFSET => <time_difference> } ) ]
  [ COMPUTE_FAMILY = <compute_family> ]
  [ STORAGE_SIZE_GB = <storage_gb> ]
  [ HIGH_AVAILABILITY = { TRUE | FALSE } ]
  [ POSTGRES_SETTINGS = '<json_string>' ]
  [ COMMENT = '<string_literal>' ]
  [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , ... ] ) ]

Copy

对于命令参数：

FORK orig_name

指定分支的源实例。

{ AT | BEFORE } ( { TIMESTAMP => timestamp | OFFSET => time_difference } )

Specifies the point in time to fork from. The timestamp or offset must fall within the 10 day postgres data retention time.

默认值：None。使用当前时间。

AT | BEFORE 子句接受以下参数之一：

TIMESTAMP => timestamp
指定要用于 Time Travel 的确切日期和时间。该值必须显式转换为 TIMESTAMP、TIMESTAMP_LTZ、TIMESTAMP_NTZ 或 TIMESTAMP_TZ 数据类型。

如未指定显式转换，AT 子句中的时间戳会被视为采用 UTC 时区的时间戳（相当于 TIMESTAMP_NTZ）。为显式强制转换使用 TIMESTAMP 数据类型也可能导致值被视为 TIMESTAMP_NTZ 值。有关详细信息，请参阅日期和时间数据类型。

OFFSET => time_difference
指定自当前时间开始的、要用于 Time Travel 的时间差值（以秒为单位），其格式为 -N，其中 N 可以是整数或算术表达式（例如，-120 为 120 秒、-30*60 为 1800 秒或 30 分钟）。

默认值：None。从源实例复制。

COMPUTE_FAMILY = compute_family

指定 Snowflake Postgres 实例规格表中实例规格的名称。

默认值：None。从源实例复制。

STORAGE_SIZE_GB = storage_gb

指定存储大小，单位为 GB。必须介于 10 到 65,535 之间。

默认值：None。从源实例复制。

HIGH_AVAILABILITY = { TRUE | FALSE }

指定要用于分支的高可用性设置。

默认值：None。从源实例复制。

POSTGRES_SETTINGS = 'json_string'

Allows you to optionally set Postgres configuration parameters on your instance in JSON format. See Snowflake Postgres 服务器设置 for a list of available Postgres parameters.

'{"component:name" = "value", ...}'

Copy

默认值：None。从源实例复制。

COMMENT = 'string_literal'

指定用户的注释。

默认：NULL

TAG ( tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ] )

指定标签名称和标签字符串值。

标签值始终为字符串，标签值的最大字符数为 256。

有关在语句中指定标签的信息，请参阅 Tag quotas。

将返回一行，包含以下列：

status
host

CREATE FORK SQL 示例

通过源实例 my_origin_instance 在时间戳 2025-01-01 12:00:00 创建分支 my_fork。
CREATE POSTGRES INSTANCE my_fork
  FORK my_origin_instance
  AT (TIMESTAMP => '2025-01-01 12:00:00');
Copy
通过源实例 my_origin_instance 创建分支 my_fork，状态为 120 秒前的样子。
CREATE POSTGRES INSTANCE my_fork
  FORK my_origin_instance
  AT (OFFSET => -120);
Copy
创建分支 my_fork，基于源实例 my_origin_instance 的当前状态，使用 STANDARD_M 实例规格，不启用高可用性。
CREATE POSTGRES INSTANCE my_fork
  FORK my_origin_instance
  COMPUTE_FAMILY = STANDARD_M
  HIGH_AVAILABILITY = FALSE;
Copy

When you create a fork, no credentials will be displayed. Credentials for the fork are the same as the origin instance. You can regenerate credentials later if needed.

创建分支所需时间取决于源实例的大小。