Snowflake 交互式表和交互式仓库¶

交互式仓库的限制¶

• Snowflake interactive warehouses don't support long-running queries. The query timeout for SELECT commands defaults to five seconds. After five seconds, the query is canceled. You can reduce the query timeout value, but you can't increase it. Other kinds of commands, such as SHOW and INSERT OVERWRITE, aren't subject to the five-second timeout interval.

  If a query consistently times out, that's a signal that it might not be suitable for use with interactive warehouses. Otherwise, you need to apply some of the performance tuning techniques to reduce the time to less than five seconds.

• An interactive warehouse is always up and running by design. It doesn't automatically suspend when idle. Although you can manually suspend an interactive warehouse, expect significant query latency when you resume the warehouse.

• You can't query standard Snowflake tables from an interactive warehouse. To query both standard tables and interactive tables in the same session, run USE WAREHOUSE to switch to the appropriate warehouse type depending on the type of table.

• If an interactive warehouse is a multi-cluster warehouse, it doesn't auto-scale. In a multi-cluster interactive warehouse, always keep MIN_CLUSTER_COUNT and MAX_CLUSTER_COUNT set to the same value.

• You can't run CALL commands to call stored procedures in an interactive warehouse.

• You can't use the ->> pipe operator. That operator uses stored procedures behind the scenes.

• Interactive warehouses currently don't support replication. They aren't included in failover groups and replication groups.

交互式表的限制¶

• 交互式表不支持以下功能：

  • Data manipulation language (DML) commands such as UPDATE and DELETE. The only DML that you can perform is INSERT OVERWRITE.

  • Replication. They aren't included in failover groups and replication groups.

  • 故障安全。此数据恢复机制不适用于交互式表。您仍然可以将 Time Travel 与交互式表结合使用。

• Query insights are currently not collected or available for queries executing on interactive tables.

• 交互式表目前不支持 搜索优化服务。

• 您不能执行以下操作：

  • Use an interactive table as the source for a materialized view.

  • Modify properties of an interactive table by using ALTER TABLE clauses such as ADD COLUMN or REMOVE COLUMN. ALTER TABLE operations that you can perform include:

    • Renaming the table.

    • 修改列以设置或取消设置注释。

    • 设置或取消设置列的掩码策略。

    • 为表添加或取消设置 掩码策略、联接策略、聚合策略 或 行访问策略。

    • Adding a storage lifecycle policy to the table, or dropping a storage lifecycle policy from the table.

  • Use streams with an interactive table.

  • Create a dynamic table with an interactive table as a base table.

  • Use the RESAMPLE clause for queries on an interactive table.

  • 使用 CREATE INTERACTIVE TABLE 或 ALTER TABLE 设置 Time Travel 保留期。交互式表会继承父架构、数据库或账户中的值 DATA_RETENTION_TIME_IN_DAYS。

创建交互式表¶

表创建遵循标准 CTAS (CREATE TABLE AS SELECT) 语法，并附加了 INTERACTIVE 关键字来定义表类型。

CREATE INTERACTIVE TABLE 命令还需要 CLUSTER BY 子句。在 CLUSTER BY 子句中指定一列或多列，以匹配对时间要求最高的查询中的 WHERE 子句。您在 CLUSTER BY 子句中指定的列可以显著影响对交互式表的查询性能。因此，请谨慎选择群集列。有关选择最佳群集列的更多信息，请参阅 群集密钥和聚类表。

使用以下命令创建一个交互式表，其中包含与标准表相同的列和数据。CLUSTER BY 子句引用源表中名为 id 的列。

CREATE INTERACTIVE TABLE
  IF NOT EXISTS orders
  CLUSTER BY (id)
AS
  SELECT * FROM demoSource;

TARGET_LAG = '<num> { seconds | minutes | hours | days }'

CREATE INTERACTIVE TABLE my_dynamic_interactive_table
  CLUSTER BY (c1, c2)
  TARGET_LAG = '20 minutes'
  WAREHOUSE = my_standard_warehouse
AS SELECT c1, SUM(c2) FROM my_source_table GROUP BY c1;

创建交互式仓库¶

创建交互式表后，要实现最佳查询性能，需要使用交互式仓库。在 CREATE WAREHOUSE 或 CREATE OR REPLACE WAREHOUSE 命令中指定关键字 INTERACTIVE。

（可选）您可以指定 TABLES 子句，其中包含以逗号分隔的交互式表名称列表。使用该子句会立即将这些交互式表与交互式仓库关联起来。

以下命令创建了一个与名为 orders 的交互式表关联的交互式仓库。在这种情况下，您可以立即运行 USE WAREHOUSE 命令，并开始对交互式表运行查询：

CREATE OR REPLACE INTERACTIVE WAREHOUSE interactive_demo
  TABLES (orders)
  WAREHOUSE_SIZE = 'XSMALL';

以下命令创建了一个没有关联交互式表的交互式仓库。在这种情况下，您可以在之后运行 ALTER WAREHOUSE 命令，将交互式表与交互式仓库相关联：

CREATE or REPLACE INTERACTIVE WAREHOUSE interactive_demo
  WAREHOUSE_SIZE = 'XSMALL';

创建交互式仓库后，仓库默认无限期保持活动状态。与传统仓库不同，交互式仓库不包含闲置一段时间后自动暂停的选项。

交互式仓库的查询最佳实践¶

交互式仓库针对具有 选择性工作负载 的查询进行了优化。这意味着与其他查询类型相比，具有良好选择性的查询在性能方面有更多的改进。

SELECT col1, col4, AVG(col_x)
  FROM my_table
  GROUP BY col1, col2;

SELECT * FROM my_table;

SELECT col1, col2
  FROM my_table
  WHERE
    col_x IN (1,4,7,8)
    AND event_time >=
      DATEADD(hour, -1, CURRENT_TIMESTAMP());

SELECT col1, col2
  FROM my_table
  WHERE
    event_time >=
      DATEADD(day, -365, CURRENT_TIMESTAMP());

Other complexities such as large joins (for example, by joining two fact tables), or compute-intensive expressions such as regular expressions, might result in lower concurrency due to higher use of compute resources. See 选择交互式仓库的大小 for information about optimizing for those situations.

交互式表的数据布局最佳实践¶

交互式表遵循标准 Snowflake 性能最佳实践。特别是，交互式表受益于 聚类良好的表，该表根据您要筛选的相同列进行排序。例如，如果您的查询经常筛选 TIMESTAMP 列（如 sale_date），则可以在创建交互式表时使用该列作为群集密钥。例如，您可以按如下方式创建交互式表：

CREATE INTERACTIVE TABLE product_sales (<column definitions>) CLUSTER BY (sale_date);

这样，筛选 sale_date 的 SELECT 查询可以快速跳过所有不相关的数据并返回结果。例如，以下查询通过测试 sale_date 列对日期范围进行筛选：

SELECT ... WHERE sale_date > '2025-10-24' AND ...

有关选择最佳群集密钥的更多详细信息，请参阅 群集密钥和聚类表。

选择交互式仓库的大小¶

完成所有查询和布局优化后，请考虑 扩展仓库 以满足需求。交互式仓库的大小范围从 XSMALL 到 3XLARGE，以及 多集群仓库。

建议您首先根据交互式表中 工作数据集 的大致大小来调整仓库大小。工作数据集是指经常查询的数据部分。例如，如果您的查询通常只查询过去七天的销售数据，则工作集是交互式表中与这七天相对应的部分。

这是因为交互式仓库使用 本地存储缓存。虽然整个数据集（表）的数据始终可访问，但访问非缓存数据确实会在首次读取时产生更高的读取延迟。

选择适合工作负载需求的仓库大小。试验特定的数据和工作负载，以确定交互式仓库的最佳大小。您可以创建一个交互式的多群集仓库。但是，目前最小和最大群集计数必须相等。也就是说，交互式多群集仓库不会自动扩展。

建议根据工作数据集大小从以下仓库大小开始。

将交互式表添加到交互式仓库¶

要获得交互式表的最佳查询性能，应使用交互式仓库。

Before you can query the interactive table from an interactive warehouse, you must perform a one-time operation to add the interactive table to the interactive warehouse. Otherwise, you'll see an object not found error when running a query against such a table from the interactive warehouse. If you didn't specify the interactive tables to associate with the interactive warehouses by using the TABLES clause in your CREATE INTERACTIVE WAREHOUSE command, you can do that later by using an ALTER WAREHOUSE command.

以下命令将 orders 表与 interactive_demo 仓库相关联。您可以使用 ADD TABLES 子句指定多个表名，并用逗号分隔。

ALTER WAREHOUSE interactive_demo ADD TABLES (orders);

此操作将启动缓存预热过程。该过程可能需要大量时间。

如果交互式表已与交互式仓库关联，则该命令会成功，但不起作用。

您可以将一个交互式表与多个交互式仓库相关联。

从交互式仓库中移除交互式表¶

您可以通过运行带 DROP TABLES 子句的 ALTER WAREHOUSE 命令，从交互式仓库中分离一个或多个交互式表。

ALTER WAREHOUSE interactive_demo DROP TABLES (orders, customers);

恢复和暂停仓库¶

以下命令可恢复交互式仓库。您必须在创建仓库后执行此操作，因为该仓库是在暂停状态下创建的：

ALTER WAREHOUSE interactive_demo RESUME;

如果您手动暂停了仓库，您还可以执行此操作，以通过该仓库开始运行查询。

恢复后，在预热缓存期间，查询速度会很慢。可能需要几分钟到一个小时左右，具体取决于该表中的数据量。

以下命令可暂停交互式仓库：

ALTER WAREHOUSE interactive_demo SUSPEND;

您可以在开发和测试环境中暂停仓库，因为在这些环境中仓库将有很长时间不会使用。在生产环境中，通常将交互式仓库用于全天候运行许多并发查询的工作负载，或者低延迟对查询至关重要的工作负载。因此，您通常不会暂停在生产环境中使用的交互式仓库。Snowflake 不会自动暂停交互式仓库。

删除交互式仓库¶

您可以运行 DROP WAREHOUSE 命令来完全移除交互式仓库。删除交互式仓库会移除该仓库与任何交互式表之间的关联。但是，您仍然可以使用其他交互式仓库来查询这些相同的交互式表。

查询交互式表¶

在查询会话中，确保当前会话的仓库是交互式仓库：

USE WAREHOUSE interactive_demo;

此后，您可以正常查询交互式表。

基准测试最佳实践¶

在测试环境中评估交互式表的性能时，请遵循以下最佳实践，以避免出现不一致或误导性的结果：

• 关闭查询结果缓存，使多次基准测试运行之间的基准测试结果保持一致。您可以通过设置 USE_CACHED_RESULT 会话参数，在账户、用户和会话级别关闭查询结果缓存。这样一来，查询仅使用来自交互式仓库的表数据缓存。如果您在生产环境中打开结果缓存，您可以获得与基准测试相当或更好的性能。

• 由于交互式仓库需要一些时间来预热表数据缓存，因此在创建或恢复交互式仓库后，请等待一段时间，然后再测试查询性能。这模拟了仓库长时间保持活动状态的典型生产配置。Snowflake 对缓存预热过程进行了优化。因此，让 Snowflake 完成此过程比通过运行示例查询自行预热缓存更高效。

• 在将交互式表的性能与标准 Snowflake 表进行比较时，不要在标准表和交互式表之间交错查询。应先在标准表上运行完整的基准测试，然后在交互式表上运行相同的测试。

• 在与其他数据库系统进行比较基准测试时，请确保交互式表中的群集列与查询中的 WHERE 子句谓词匹配。有关选择最佳群集列的更多信息，请参阅 群集密钥和聚类表。尤其要注意，请勿对具有高基数（例如唯一 IDs 或时间戳）的列进行聚类。

• 如果查询简短且简单，则可以将交互式仓库的 MAX_CONCURRENCY_LEVEL 参数设置为更高值，从而实现更高的并发性。