Adaptive Compute¶

MAX_QUERY_PERFORMANCE_LEVEL¶

MAX_QUERY_PERFORMANCE_LEVEL 表示任何单个查询的性能上限。它在仓库级别设置，并承担告诉系统“加快”或“减慢”查询执行的机制。

该属性以 T 恤尺码单位表示（XSMALL 到 X4LARGE）。每种 T 恤尺寸所传达的性能水平与其相称的经典仓库尺寸相当或更好。

类型:

{ XSMALL | SMALL | MEDIUM | LARGE | XLARGE | XXLARGE | XXXLARGE | X4LARGE }

默认值:

XLARGE

语义：

• 较大的值可为每个语句提供更多的计算空间，改善大型复杂查询的延迟，并增加单个语句的潜在瞬时支出。

• 较小的值会限制每条语句的支出，但可能会减慢大型查询的速度，同时为并发性留出更多动态余量。

• 此值不会映射到特定的底层计算配置。它仅表示性能级别：Snowflake 确定每个查询所需的实际资源。

行为：

Adaptive Compute 根据查询计划确定查询所需的最佳计算。如果服务确定最佳性能的计算需求大于 MAX_QUERY_PERFORMANCE_LEVEL，Snowflake 会将其限制在 MAX_QUERY_PERFORMANCE_LEVEL。对于较小的查询，Snowflake 会选择与查询需求相称的性能水平（低于 MAX_QUERY_PERFORMANCE_LEVEL）。

指南：

将 MAX_QUERY_PERFORMANCE_LEVEL 设置为您希望最大查询达到的最高查询性能。使用 Budgets 和 资源监视器 管理一段时间内的总支出。

QUERY_THROUGHPUT_MULTIPLIER¶

QUERY_THROUGHPUT_MULTIPLIER 表示用于计算任何给定时间的最大吞吐量的乘数。您指定的不是绝对最大吞吐量，而是指定系统计算的最小值的整数比例因子。

要在 MAX_QUERY_PERFORMANCE_LEVEL 上并行运行 N 语句，请将乘数设置为 N。由于 MAX_QUERY_PERFORMANCE_LEVEL 表示上限，此设置通常支持 N 个以上的查询并行运行，因为许多查询所需的资源少于最大值。

类型:

非负整数

默认值:

2

将此值设置为 0 表示无限吞吐量：仓库可以使用所有可用的突发容量，不受限制。

语义：

当设置为正值时，最大吞吐量计算如下：

MAX_THROUGHPUT = QUERY_THROUGHPUT_MULTIPLIER * MINIMUM

其中 MINIMUM 是针对仓库上设置的 MAX_QUERY_PERFORMANCE_LEVEL 由系统计算得出的基本容量。

• 充当此系统计算的基本容量的比例因子。

• 较高的值会增加峰值吞吐量（更多并发工作）并减少排队，但代价可能是更高的瞬时支出。

• 较低的值会限制突发吞吐量，并降低支出突然激增的风险，但可能会导致排队。

行为：

Snowflake 根据 MAX_QUERY_PERFORMANCE_LEVEL、迁移历史记录（经典大小、最大集群计数、QAS 比例因子）以及其他系统微调参数，计算仓库的内部基本容量费率。

将 QUERY_THROUGHPUT_MULTIPLIER 与此基本容量相乘，以确定可并发执行的查询总数。当系统低于此目标时，允许执行查询。当它到达目标时，它会把查询排入队列。

指南：

如果您观察到持久的加载排队时间并希望提高吞吐量，请增加 QUERY_THROUGHPUT_MULTIPLIER。如果您更关心限制瞬时支出，请减少 QUERY_THROUGHPUT_MULTIPLIER 并依靠 Budgets 和资源监视器进行绝对成本控制。

转换期间的属性行为¶

将 Standard Warehouse 转换为 Adaptive Warehouse 时，唯一必须更改的属性是 WAREHOUSE_TYPE。Snowflake 会自动为 MAX_QUERY_PERFORMANCE_LEVEL 和 QUERY_THROUGHPUT_MULTIPLIER 计算适当的值。

系统从 Standard Warehouse 的现有配置中派生出这些配置：

• 仓库规模。

• MAX_CLUSTER_COUNT（适用于多集群仓库）。

• QAS 比例因子。

• 仓库生成（硬件/软件生成）。

目标是与原始 Standard Warehouse 相比，保持或提高性能，为典型的负载峰值提供足够的突发容量，并避免在切换到 Adaptive Warehouse 时需要手动调整。

转换后，您可以选择使用 ALTER WAREHOUSE 替换 MAX_QUERY_PERFORMANCE_LEVEL 和 QUERY_THROUGHPUT_MULTIPLIER。WAREHOUSE_SIZE 和 MAX_CLUSTER_COUNT 等 Standard Warehouse 属性转换为 Adaptive 后不再适用，而 Adaptive 属性在转换回 Standard 后不再适用。

CREATE ADAPTIVE WAREHOUSE¶

创建新的自适应虚拟仓库。

CREATE [ OR REPLACE ] ADAPTIVE WAREHOUSE [ IF NOT EXISTS ] <name>
  [ [ WITH ] adaptiveProperties ]
  [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , ... ] ) ]
  [ objectParams ]

adaptiveProperties ::=
  COMMENT = '<string_literal>'
  MAX_QUERY_PERFORMANCE_LEVEL = { XSMALL | SMALL | MEDIUM | LARGE
                                | XLARGE | XXLARGE | XXXLARGE | X4LARGE }
  QUERY_THROUGHPUT_MULTIPLIER = <integer>

objectParams ::=
  STATEMENT_QUEUED_TIMEOUT_IN_SECONDS = <num>
  STATEMENT_TIMEOUT_IN_SECONDS = <num>

您还可以使用标准 CREATE WAREHOUSE 语法和 WAREHOUSE_TYPE = 'ADAPTIVE' 来创建 Adaptive Warehouse：

CREATE [ OR REPLACE ] WAREHOUSE [ IF NOT EXISTS ] <name>
  [ [ WITH ] WAREHOUSE_TYPE = 'ADAPTIVE'
    [ adaptiveProperties ]
  ]
  [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , ... ] ) ]
  [ objectParams ]

CREATE ADAPTIVE WAREHOUSE my_adaptive_wh;

CREATE ADAPTIVE WAREHOUSE my_adaptive_wh
  WITH MAX_QUERY_PERFORMANCE_LEVEL = XXLARGE;

CREATE ADAPTIVE WAREHOUSE my_adaptive_wh
  WITH MAX_QUERY_PERFORMANCE_LEVEL = MEDIUM
       QUERY_THROUGHPUT_MULTIPLIER = 6;

CREATE WAREHOUSE my_adaptive_wh
  WITH WAREHOUSE_TYPE = 'ADAPTIVE'
       MAX_QUERY_PERFORMANCE_LEVEL = LARGE
       QUERY_THROUGHPUT_MULTIPLIER = 3;

ALTER WAREHOUSE（自适应）¶

您可以使用 ALTER WAREHOUSE 将 Standard Warehouse 转换为 Adaptive Warehouse、修改 Adaptive Warehouse 属性，或将 Adaptive Warehouse 转换回 Standard Warehouse。

将 Standard Warehouse 转换为 Adaptive Warehouse：

ALTER WAREHOUSE my_warehouse SET WAREHOUSE_TYPE = 'ADAPTIVE';

在创建或转换后修改 Adaptive Warehouse 属性：

ALTER WAREHOUSE my_adaptive_wh SET
  MAX_QUERY_PERFORMANCE_LEVEL = XLARGE
  QUERY_THROUGHPUT_MULTIPLIER = 8;

将 Adaptive Warehouse 转换回 Standard Warehouse：

ALTER WAREHOUSE my_warehouse SET WAREHOUSE_TYPE = 'STANDARD';